函数名称: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()
函数获取语言标签的显示变体。