PHP 8.1.0 Beta 1 available for testing


(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)

IntlCalendar::getLocaleGet the locale associated with the object


Object oriented style

public IntlCalendar::getLocale(int $localeType): string|false

Procedural style

intlcal_get_locale(IntlCalendar $cal, int $localeType): string|false

Returns the locale used by this calendar object.



The IntlCalendar resource.


Whether to fetch the actual locale (the locale from which the calendar data originates, with Locale::ACTUAL_LOCALE) or the valid locale, i.e., the most specific locale supported by ICU relatively to the requested locale – see Locale::VALID_LOCALE. From the most general to the most specific, the locales are ordered in this fashion – actual locale, valid locale, requested locale.

Return Values

A locale string or false on failure.


Example #1 IntlCalendar::getLocale()

IntlCalendar::createInstance(IntlTimeZone::getGMT(), 'en_US_CALIFORNIA');

The above example will output:

string(2) "en"
string(5) "en_US"

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top