[函数]Locale::getDisplayName()函数—用法及示例

函数名称：Locale::getDisplayName()

适用版本：PHP 5 >= 5.3.0, PHP 7

函数描述：Locale::getDisplayName() 函数根据给定的语言标签返回该语言的显示名称。

用法：

string Locale::getDisplayName ( string $locale [, string $in_locale ] )

参数：

• $locale：必需，要获取显示名称的语言标签。
• $in_locale：可选，用于获取显示名称的区域设置。如果未提供该参数，则使用当前的区域设置。

返回值：

• 如果成功，则返回指定语言标签的显示名称，如果失败则返回 FALSE。

示例：

// 获取英文语言标签的显示名称
$displayName = Locale::getDisplayName('en_US');
echo $displayName; // 输出：English (United States)

// 获取法语语言标签的显示名称，使用法国的区域设置
$displayName = Locale::getDisplayName('fr_FR', 'fr_FR');
echo $displayName; // 输出：français (France)

注意事项：

• 该函数依赖于 ICU 库，因此需要安装并启用该库才能正常使用。
• $locale 参数应该符合 BCP 47 标准语言标签格式。
• $in_locale 参数应该符合 BCP 47 标准区域设置格式。
• 如果指定的语言标签或区域设置无效，则函数可能会返回 FALSE。
• 可以使用 Locale::canonicalize() 函数将语言标签规范化为 BCP 47 标准格式。
• 可以使用 Locale::getAllVariants() 函数获取指定语言标签的所有变体。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::parseLocale() 函数解析语言标签为语言、脚本、区域设置和变体。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getDisplayLanguage()、Locale::getDisplayScript() 和 Locale::getDisplayRegion() 函数分别获取语言、脚本和区域设置的显示名称。
• 可以使用 Locale::filterMatches() 函数过滤与给定语言标签匹配的语言标签集合。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。
• 可以使用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion() 函数分别获取语言、脚本和区域设置的组成部分。
• 可以使用 Locale::lookup() 函数查找最佳匹配的语言标签。
• 可以使用 Locale::setDefault() 函数设置默认的区域设置。
• 可以使用 Locale::getKeywords() 函数获取语言标签中的关键字。
• 可以使用 Locale::getDisplayVariant() 函数获取语言标签的显示变体。