locale(1)

locale1

Display locale settings

Usage

locale [{-a | m}]

locale [-ck] name []

Overview

locale displays information about the current locale, or a list of all available locales.

When locale is run with no arguments, it will display the current source of each locale category.

When locale is given the name of a category, it acts as if it had been given each keyword in that category. For each keyword it is given, the current value is displayed.

Options

-a

Lists all public locales.

-c name ...

Lists the category name before each keyword, unless it is the same category as the previously displayed keyword.

-k name ...

Displays the name of each keyword prior to its value.

-m

Lists all available public charmaps. Darwin locales do not support charmaps, so list all CODESETs instead.

Operands

The following operand is supported:

name is the name of a keyword or category to display. A list of all keywords and categories can be shown with the following command:

locale -ck LC_ALL

Environment

LANG

Used as a substitute for any unset LC_* variable. If LANG is unset, it will act as if set to "C". If any of LANG or LC_* are set to invalid values, locale acts as if they are all unset.

LC_ALL

Will override the setting of all other LC_* variables.

LC_COLLATE

Sets the locale for the LC_COLLATE category.

LC_CTYPE

Sets the locale for the LC_CTYPE category.

LC_MESSAGES

Sets the locale for the LC_MESSAGES category.

LC_MONETARY

Sets the locale for the LC_MONETARY category.

LC_NUMERIC

Sets the locale for the LC_NUMERIC category.

LC_TIME

Sets the locale for the LC_TIME category.

Releases

135 releases since Mac OS X 10.4; the text changed 2 times.

  1. 10.4–10.4.11
  2. 10.5–10.5.8
  3. 10.6–26.5

-c until Mac OS X 10.4.11.x86; -k until Mac OS X 10.4.11.x86.

Standards

The locale utility conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

History

locale appeared in Mac OS X 10.4

From adv_cmds 237 in macOS 26.5. Parsed by carta from the page's mdoc source.