PHP 8.3.4 Released!

Locale::getDisplayLanguage

locale_get_display_language

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Locale::getDisplayLanguage -- locale_get_display_languageReturns an appropriately localized display name for language of the inputlocale

Description

Object-oriented style

public static Locale::getDisplayLanguage(string $locale, ?string $displayLocale = null): string|false

Procedural style

locale_get_display_language(string $locale, ?string $displayLocale = null): string|false

Returns an appropriately localized display name for language of the input locale. If is null then the default locale is used.

Parameters

locale

The locale to return a display language for

displayLocale

Optional format locale to use to display the language name

Return Values

Display name of the language for the locale in the format appropriate for displayLocale, or false on failure.

Changelog

Version Description
8.0.0 displayLocale is nullable now.

Examples

Example #1 locale_get_display_language() example

<?php
echo locale_get_display_language('sl-Latn-IT-nedis', 'en');
echo
";\n";
echo
locale_get_display_language('sl-Latn-IT-nedis', 'fr');
echo
";\n";
echo
locale_get_display_language('sl-Latn-IT-nedis', 'de');
?>

Example #2 OO example

<?php
echo Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'en');
echo
";\n";
echo
Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'fr');
echo
";\n";
echo
Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'de');
?>

The above example will output:

Slovenian;
slov\xc3\xa8ne;
Slowenisch

See Also

add a note

User Contributed Notes 2 notes

up
1
jake at qzdesign dot co dot uk
4 years ago
If `$locale` is invalid, the return value is actually the value of `$locale`, not `NULL` or `FALSE` as you might expect.

(If `$in_locale` is invalid, but `$locale` is valid, the return value is the language name in the default locale.)
up
-10
heitor dot siller at gmail dot com
12 years ago
To display special characters correctly in a web browser, it's a good idea to decode the result data with utf8_decode:

<?php

echo utf8_decode(Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'fr'));

echo
utf8_decode(Locale::getDisplayLanguage('sl-Latn-IT-nedis', 'pt-BR'));

?>
To Top