当前位置:首页 > 文章列表 > 文章 > java教程 > Java Locale getDisplayCountry 怎样按指定语言显示地区名称

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

来源:17golang原创 2026-11-20 11:14:10 0浏览 收藏

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删除
Java 25 Compact Source Files 怎样减少小程序样板代码Java 25 Compact Source Files 怎样减少小程序样板代码
上一篇
Java 25 Compact Source Files 怎样减少小程序样板代码
Java Currency getNumericCodeAsString 怎样保留货币编号前导零
下一篇
Java Currency getNumericCodeAsString 怎样保留货币编号前导零
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1141次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1126次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1303次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1242次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1093次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码