# LOCALE - get locale-specific information - man - [phpMan]

> **TLDR:** Get locale-specific information.
>
- List all global environment variables describing the user's locale:
  `locale`
- List all available locales:
  `locale {{-a|--all-locales}}`
- Display all available locales and the associated metadata:
  `locale {{-a|--all-locales}} {{-v|--verbose}}`
- Display the current date format:
  `locale date_fmt`

*Source: tldr-pages*

---

[_locale_(1)](https://www.chedong.com/phpMan.php/man/locale/1/markdown)                              General Commands 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:

### --all-locales
### -a      -v 
              metadata about each locale to be included in the output.

### --charmaps
### -m     
              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:

### --category-name
### -c     
              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.

### --keyword-name
### -k     
              word, so that the output has the format:

                  _keyword_="_value_"

       The **locale **command also knows about the following options:

### --verbose
### -v     

### --help
       **-?     **Display a summary of command-line options and arguments and exit.

### --usage
              Display a short usage message and exit.

### --version
### -V     

## FILES
       _/usr/lib/locale/locale-archive_
              Usual default locale archive location.

       _/usr/share/i18n/locales_
              Usual default path for locale definition files.

## STANDARDS
       POSIX.1-2008.

## HISTORY
       POSIX.1-2001.

## 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)

Linux man-pages 6.7                          2023-10-31                                    [_locale_(1)](https://www.chedong.com/phpMan.php/man/locale/1/markdown)