Locale (computer software)


In computing, a locale is a set of parameters that defines the user's language, region and any special variant preferences that the user wants to see in their user interface. Usually a locale identifier consists of at least a language code and a country/region code.
Locale is an important aspect of i18n.

General locale settings

These settings usually include the following display format settings:
The locale settings are about formatting output given a locale. So, the time zone information and daylight saving time are not usually part of the locale settings.
Less usual is the input format setting, which is mostly defined on a per application basis.

Programming and markup language support

In these environments,
and other Unicode-based environments, they are defined in a format similar to BCP 47. They are usually defined with just ISO 639 and ISO 3166-1 alpha-2 codes.

International standards

In standard C and C++, locale is defined in "categories" of , , , , and . The special category can be used to set all locale settings.
There is no standard locale names associated with C and C++ standards besides a "minimal locale" name "C", although the POSIX format is a commonly used baseline.

POSIX platforms

On POSIX platforms such as Unix, Linux and others, locale identifiers are defined in a way similar to the BCP 47 definition of language tags, but the locale variant modifier is defined differently, and the character set is optionally included as a part of the identifier. The POSIX or "XPG" format is. Separately, ISO/IEC 15897 describes a different form,, though it's highly dubious whether it is used at all.
In the next example there is an output of command locale for Czech language, Czech Republic with explicit UTF-8 encoding:
$ locale
LANG=cs_CZ.UTF-8
LC_CTYPE="cs_CZ.UTF-8"
LC_NUMERIC="cs_CZ.UTF-8"
LC_TIME="cs_CZ.UTF-8"
LC_COLLATE="cs_CZ.UTF-8"
LC_MONETARY="cs_CZ.UTF-8"
LC_MESSAGES="cs_CZ.UTF-8"
LC_PAPER="cs_CZ.UTF-8"
LC_NAME="cs_CZ.UTF-8"
LC_ADDRESS="cs_CZ.UTF-8"
LC_TELEPHONE="cs_CZ.UTF-8"
LC_MEASUREMENT="cs_CZ.UTF-8"
LC_IDENTIFICATION="cs_CZ.UTF-8"
LC_ALL=

Specifics for Microsoft platforms

Windows uses specific and strings.
The locale identifier for unmanaged code on Microsoft Windows is a number such as 1033 for English, or 2057 for English, or 1041 for Japanese. These numbers consist of a language code and a culture code, and are therefore often written in hexadecimal notation, such as 0x0409, 0x0809 or 0x0411.
Microsoft is starting to introduce managed code application programming interfaces for.NET that use this format. One of the first to be generally released is a function to mitigate issues with internationalized domain names, but more are in Windows Vista Beta 1.
Starting with Windows Vista, new functions that use BCP 47 locale names have been introduced to replace nearly all LCID-based APIs.
A POSIX-like locale name format of is available in the UCRT of Windows 10 and 11.