Creation:2024-08-11Last update:2025-06-29
将此文档参考到您的 AI 助手ChatGPTClaudeDeepSeekGoogle AI modeGeminiPerplexityMistralGrok
使用您最喜欢的AI助手总结文档，并引用此页面和AI提供商
此文档已过期，基础版本已在以下日期更新 2025年8月23日.
前往英文文档版本历史
- "为 React Native 和旧环境添加 polyfills"v7.5.02025/12/18
- "初始化历史"v5.5.102025/6/29
此页面的内容已使用 AI 翻译。
查看英文原文的最新版本编辑此文档
如果您有改善此文档的想法，请随时通过在GitHub上提交拉取请求来贡献。
文档的 GitHub 链接Copy
复制文档 Markdown 到剪贴板
文档：intlayer 中的 getLocaleName 函数
描述
getLocaleName 函数返回给定语言环境（targetLocale）在显示语言环境（displayLocale）中的本地化名称。如果未提供 targetLocale，则返回 displayLocale 自身语言的名称。
参数
displayLocale: Locales- 描述：用于显示目标语言环境名称的语言环境。
- 类型：表示有效语言环境的枚举或字符串。
targetLocale?: Locales- 描述：需要本地化名称的语言环境。
- 类型：可选。表示有效语言环境的枚举或字符串。
返回值
- 类型：
string - 描述：
targetLocale在displayLocale中的本地化名称，如果未提供targetLocale，则返回displayLocale自身的名称。如果未找到翻译，则返回"Unknown locale"。
示例用法
typescript
复制代码
复制代码到剪贴板
import { Locales, getLocaleName } from "intlayer";
getLocaleName(Locales.ENGLISH); // 输出: "English"
getLocaleName(Locales.ENGLISH, Locales.FRENCH); // 输出: "Anglais"
getLocaleName(Locales.ENGLISH, Locales.ESPANOL); // 输出: "Inglés"
getLocaleName(Locales.ENGLISH, Locales.ENGLISH); // 输出: "English"
getLocaleName(Locales.FRENCH); // 输出: "Français"
getLocaleName(Locales.FRENCH, Locales.FRENCH); // 输出: "Français"
getLocaleName(Locales.FRENCH, Locales.ESPANOL); // 输出: "Francés"
getLocaleName(Locales.FRENCH, Locales.ENGLISH); // 输出: "French"
getLocaleName(Locales.CHINESE); // 输出: "中文"
getLocaleName(Locales.CHINESE, Locales.FRENCH); // 输出: "Chinois"
getLocaleName(Locales.CHINESE, Locales.ESPANOL); // 输出: "Chino"
getLocaleName(Locales.CHINESE, Locales.ENGLISH); // 输出: "Chinese"
getLocaleName("unknown-locale"); // 输出: "未知语言"边界情况
- 未提供
targetLocale：- 该函数默认返回
displayLocale自身的名称。
- 该函数默认返回
- 缺少翻译：
- 如果
localeNameTranslations中不包含targetLocale或特定displayLocale的条目，函数将回退到ownLocalesName，或者返回"Unknown locale"。
- 如果
React Native 和旧环境的 Polyfills
getLocaleName 函数依赖于 Intl.DisplayNames API，该 API 在 React Native 或较旧的 JavaScript 环境中不可用。如果您在这些环境中使用 getLocaleName，需要添加 polyfills。
在应用程序的早期导入 polyfills，最好在入口文件中（例如 index.js、App.tsx 或 main.tsx）：
typescript
复制代码
复制代码到剪贴板
import "intl";import "@formatjs/intl-locale/polyfill";import "@formatjs/intl-displaynames/polyfill";更多详细信息，请参阅 FormatJS polyfills 文档。