# LOCALE(1) - man - phpman [LOCALE(1)](https://www.chedong.com/phpMan.php/man/LOCALE/1/markdown) Linux User Manual [LOCALE(1)](https://www.chedong.com/phpMan.php/man/LOCALE/1/markdown) ## NAME locale - get locale-specific information ## SYNOPSIS **locale** [_option_] **locale** [_option_] **-a** **locale** [_option_] **-m** **locale** [_option_] _name_... ## DESCRIPTION The **locale** command displays information about the current locale, or all locales, on standard output. When invoked without arguments, **locale** displays the current locale settings for each locale category (see [**locale**(5)](https://www.chedong.com/phpMan.php/man/locale/5/markdown)), based on the settings of the environment variables that control the locale (see [**locale**(7)](https://www.chedong.com/phpMan.php/man/locale/7/markdown)). Values for variables set in the environment are printed without dou‐ ble quotes, implied values are printed with double quotes. If either the **-a** or the **-m** option (or one of their long-format equivalents) is specified, the behavior is as follows: ### -a --all-locales Display a list of all available locales. The **-v** option causes the **LC**___**IDENTIFICATION** metadata about each locale to be included in the output. ### -m --charmaps Display the available charmaps (character set description files). To display the cur‐ rent character set for the locale, use **locale** **-c** **charmap**. The **locale** command can also be provided with one or more arguments, which are the names of locale keywords (for example, _date_fmt_, _ctype-class-names_, _yesexpr_, or _decimal_point_) or lo‐ cale categories (for example, **LC**___**CTYPE** or **LC**___**TIME**). For each argument, the following is dis‐ played: * For a locale keyword, the value of that keyword to be displayed. * For a locale category, the values of all keywords in that category are displayed. When arguments are supplied, the following options are meaningful: ### -c --category-name For a category name argument, write the name of the locale category on a separate line preceding the list of keyword values for that category. For a keyword name argument, write the name of the locale category for this keyword on a separate line preceding the keyword value. This option improves readability when multiple name arguments are specified. It can be combined with the **-k** option. ### -k --keyword-name For each keyword whose value is being displayed, include also the name of that key‐ word, so that the output has the format: _keyword_="_value_" The **locale** command also knows about the following options: ### -v --verbose Display additional information for some command-line option and argument combinations. **-?**, **--help** Display a summary of command-line options and arguments and exit. ### --usage Display a short usage message and exit. ### -V --version Display the program version and exit. ## FILES _/usr/lib/locale/locale-archive_ Usual default locale archive location. _/usr/share/i18n/locales_ Usual default path for locale definition files. ## CONFORMING TO POSIX.1-2001, POSIX.1-2008. ## EXAMPLES $ **locale** LANG=en_US.UTF-8 LC_CTYPE="en_US.UTF-8" LC_NUMERIC="en_US.UTF-8" LC_TIME="en_US.UTF-8" LC_COLLATE="en_US.UTF-8" LC_MONETARY="en_US.UTF-8" LC_MESSAGES="en_US.UTF-8" LC_PAPER="en_US.UTF-8" LC_NAME="en_US.UTF-8" LC_ADDRESS="en_US.UTF-8" LC_TELEPHONE="en_US.UTF-8" LC_MEASUREMENT="en_US.UTF-8" LC_IDENTIFICATION="en_US.UTF-8" LC_ALL= $ **locale** **date**___**fmt** %a %b %e %H:%M:%S %Z %Y $ **locale** **-k** **date**___**fmt** date_fmt="%a %b %e %H:%M:%S %Z %Y" $ **locale** **-ck** **date**___**fmt** LC_TIME date_fmt="%a %b %e %H:%M:%S %Z %Y" $ **locale** **LC**___**TELEPHONE** +%c (%a) %l (%a) %l 11 1 UTF-8 $ **locale** **-k** **LC**___**TELEPHONE** tel_int_fmt="+%c (%a) %l" tel_dom_fmt="(%a) %l" int_select="11" int_prefix="1" telephone-codeset="UTF-8" The following example compiles a custom locale from the _./wrk_ directory with the [**localedef**(1)](https://www.chedong.com/phpMan.php/man/localedef/1/markdown) utility under the _$HOME/.locale_ directory, then tests the result with the [**date**(1)](https://www.chedong.com/phpMan.php/man/date/1/markdown) command, and then sets the environment variables **LOCPATH** and **LANG** in the shell profile file so that the custom locale will be used in the subsequent user sessions: $ **mkdir** **-p** **$HOME/.locale** $ **I18NPATH=./wrk/** **localedef** **-f** **UTF-8** **-i** **fi**___**SE** **$HOME/.locale/fi**___**SE.UTF-8** $ **LOCPATH=$HOME/.locale** **LC**___**ALL=fi**___**SE.UTF-8** **date** $ **echo** **"export** **LOCPATH=\$HOME/.locale"** **>>** **$HOME/.bashrc** $ **echo** **"export** **LANG=fi**___**SE.UTF-8"** **>>** **$HOME/.bashrc** ## SEE ALSO [**localedef**(1)](https://www.chedong.com/phpMan.php/man/localedef/1/markdown), [**charmap**(5)](https://www.chedong.com/phpMan.php/man/charmap/5/markdown), [**locale**(5)](https://www.chedong.com/phpMan.php/man/locale/5/markdown), [**locale**(7)](https://www.chedong.com/phpMan.php/man/locale/7/markdown) ## COLOPHON This page is part of release 5.10 of the Linux _man-pages_ project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at . Linux 2020-06-09 [LOCALE(1)](https://www.chedong.com/phpMan.php/man/LOCALE/1/markdown)