函式名稱: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()
函式獲取語言標籤的顯示變體。