Locale::getDisplayName

locale_get_display_name

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

Locale::getDisplayName -- locale_get_display_name — Returns an appropriately localized display name for the input locale

Description

Object-oriented style

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

Procedural style

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

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

Parameters

locale

The locale to return a display name for.

displayLocale

optional format locale

Return Values

Display name of 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_name() example

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

Example #2 OO example

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

The above example will output:

Slovenian (Latin, Italy, Natisone dialect);
slov\xc3\xa8ne (latin, Italie, dialecte de Natisone;
Slowenisch (Lateinisch, Italien, NEDIS)

See Also