登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  java教程

Java Locale getDisplayCountry 怎样按指定语言显示地区名称

来源:17golang原创

时间:2026-11-20 11:14:10 262浏览 收藏

Java 的 Locale.getDisplayCountry(Locale) 解决的是“把一个地区代码显示成用户看得懂的地区名称”。关键在于分清两个 Locale:调用对象代表被显示的地区,参数 inLocale 代表名称使用的语言。例如,en-US 是美国这个地区,传入中文显示 Locale 后才会得到中文地区名称。

要按指定语言显示地区名称,使用 sourceLocale.getDisplayCountry(displayLocale),不要把显示语言混在地区 Locale 本身里;无参重载依赖 JVM 的 DISPLAY 默认 Locale。

官方文档:https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Locale.html#getDisplayCountry(java.util.Locale)

先分清“地区是谁”和“用什么语言显示”

Locale 可以同时包含 language、script、country 等字段。getDisplayCountry 只读取调用对象里的 country,再按照传入的 inLocale 选择地区名称的表达语言。也就是说,Locale.forLanguageTag("en-US") 的 US 是被显示的地区,而不是要求结果一定用英文显示。

import java.util.Locale;

public class DisplayCountryDemo {
    public static void main(String[] args) {
        // sourceLocale 表示要显示的地区,US 是地区代码。
        Locale sourceLocale = Locale.forLanguageTag("en-US");
        // displayLocale 只控制地区名称使用哪种语言。
        Locale displayLocale = Locale.SIMPLIFIED_CHINESE;

        String countryName = sourceLocale.getDisplayCountry(displayLocale);
        System.out.println(countryName);
    }
}

这段写法的重点不是把两个对象都设成中文,而是保留 sourceLocale 的地区信息,再单独指定 displayLocale。在常见 Java 运行时中,输出会是中文的“美国”一类地区名称;具体文字属于运行时 Locale 数据,不能把它当成固定的业务编码。

Java Locale 被显示的地区与显示语言通过 getDisplayCountry 关联的结构说明图
图1:结构说明图,左侧是被显示的地区,右侧是名称显示语言;两者通过 getDisplayCountry(Locale) 建立静态关系。

显式传入 inLocale,避免服务器默认语言影响结果

如果接口、报表或地区选择器要固定显示语言,优先使用带参数的重载。下面让同一个美国地区分别用中文、英文和日文表达:

import java.util.Locale;

public class DisplayCountryLanguages {
    public static void main(String[] args) {
        // 被显示的地区始终是美国,结果语言由第二个参数决定。
        Locale region = Locale.forLanguageTag("en-US");
        Locale[] displayLocales = {
            Locale.SIMPLIFIED_CHINESE,
            Locale.ENGLISH,
            Locale.JAPANESE
        };

        for (Locale displayLocale : displayLocales) {
            // 显式传入显示 Locale,避免依赖机器的默认 DISPLAY 设置。
            System.out.println(region.getDisplayCountry(displayLocale));
        }
    }
}
调用方式真正控制的内容适合场景
region.getDisplayCountry(Locale.SIMPLIFIED_CHINESE)固定使用简体中文显示接口返回、导出报表、可重复测试
region.getDisplayCountry(Locale.ENGLISH)固定使用英文显示英文后台或跨语言日志
region.getDisplayCountry()使用 DISPLAY 类别默认 Locale跟随用户或运行环境的交互界面

无参版本并不是“自动识别最合适的语言”,它使用当前默认的 DISPLAY Locale。部署环境、启动参数或应用代码改变默认值后,同一段代码的展示结果就可能改变;需要稳定输出时,把 inLocale 作为调用方的明确依赖传入。

空地区、默认 Locale 和回退行为怎么判断

这个 API 有三个容易混淆的边界。第一,调用对象没有 country 字段时,返回空字符串,不会凭语言字段猜一个地区。第二,如果目标显示语言没有可用的本地化名称,Java 会尝试回退到英文名称,最后才使用 ISO 地区代码。第三,inLocale 不能传 null,否则会抛出 NullPointerException。

import java.util.Locale;

public class DisplayCountryBoundaries {
    public static void main(String[] args) {
        // 只有语言,没有 country;getDisplayCountry 不会推断地区。
        Locale languageOnly = Locale.forLanguageTag("en");
        String emptyCountry = languageOnly.getDisplayCountry(Locale.SIMPLIFIED_CHINESE);
        System.out.println(emptyCountry); // 预期为空字符串

        // 不传参数时,名称语言来自 DISPLAY 类别的默认 Locale。
        Locale region = Locale.forLanguageTag("fr-FR");
        String environmentDependent = region.getDisplayCountry();
        System.out.println(environmentDependent);
    }
}

因此,业务代码不要用“返回空字符串”去表示“地区未知”和“地区名称尚未翻译”这两种不同状态。前者是输入 Locale 没有 country,后者才涉及显示数据的回退;如果要在界面上区分它们,应该先检查 getCountry() 是否为空,再决定展示占位文本。

Java Locale 地区字段缺失、显示名称回退和 null 参数约束的边界说明图
图2:边界说明图,展示地区字段缺失、名称回退和 null 显示语言的约束关系。

工程代码怎样写得更稳定

如果地区来自用户输入或接口字段,可以把“解析地区”和“选择显示语言”放在一个小方法中。这样调用方不必依赖 JVM 默认 Locale,也能在输入没有地区时提前决定产品策略:

import java.util.Locale;
import java.util.Objects;

public final class CountryNames {
    private CountryNames() {
        // 工具类不需要被实例化。
    }

    public static String displayCountry(String languageTag, Locale displayLocale) {
        // 显示语言是调用约束,显式拒绝 null,避免在更深层才出现 NPE。
        Objects.requireNonNull(displayLocale, "displayLocale");
        Locale sourceLocale = Locale.forLanguageTag(languageTag);

        // 没有地区代码时交给上层决定占位文案,不把语言误当成地区。
        if (sourceLocale.getCountry().isEmpty()) {
            return "";
        }
        return sourceLocale.getDisplayCountry(displayLocale);
    }
}

这个封装保留了 Java API 的语义:地区由输入标签中的 country 决定,名称语言由 displayLocale 决定。若产品需要“未知地区”文案,可以在方法外把空字符串映射为业务提示;若需要固定语言,则从请求上下文明确传入对应 Locale,而不是修改全局默认值。

常见问题

为什么 getDisplayCountry() 在本地和服务器上结果不同? 因为无参重载使用 DISPLAY 类别默认 Locale。把目标显示语言显式传入,就不会把展示结果交给部署环境决定。

为什么只有 Locale.ENGLISH 却拿不到国家名称? 因为它只有 language 字段,没有 country。getDisplayCountry 不会根据语言自动推断地区,所以返回空字符串是符合 API 语义的结果。

应该用 getDisplayName 代替吗? 如果只想展示地区,就用 getDisplayCountry;getDisplayName 会把语言、脚本、地区和变体组合成更完整的 Locale 名称,输出范围更大。

小结

  • 调用对象的 Locale 决定“哪个地区”,inLocale 决定“用什么语言命名”。
  • 固定语言的接口、报表和测试应使用 getDisplayCountry(displayLocale)。
  • 没有 country 时返回空字符串,名称无法本地化时按英文和 ISO 代码回退,null 显示 Locale 会抛出 NullPointerException。
声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>