Defines rules and symbols for formatting time and date information.
The LC_TIME category of a locale definition source file defines rules and symbols for formatting time and date information. This category begins with an LC_TIME category header and terminates with an END LC_TIME category trailer.
All operands for the LC_TIME category keywords are defined as string or integer values. String values are enclosed by " " (double-quotation marks). All values are separated from the keyword they define by one or more spaces. Two adjacent double-quotation marks indicate an undefined string value. A -1 indicates an undefined integer value. Field descriptors are used by commands and subroutines that query the LC_TIME category to represent elements of time and date formats. The following keywords are recognized in the LC_TIME category:
copy | The copy statement specifies the name of an existing locale to be used as the definition of this category. If a copy statement is included in the file, no other keyword can be specified. |
abday | Defines the abbreviated weekday names corresponding to the %a field descriptor. Recognized values consist of 7 semicolon-separated strings. Each string must be of equal length and contain 5 characters or less. The first string corresponds to the abbreviated name (Sun) for the first day of the week (Sunday), the second to the abbreviated name for the second day of the week, and so on. |
day | Defines the full spelling of the weekday names corresponding to the %A field descriptor. Recognized values consist of seven semicolon-separated strings. The first string corresponds to the full spelling of the name of the first day of the week (Sunday), the second to the name of the second day of the week, and so on. |
abmon | Defines the abbreviated month names corresponding to the %b field descriptor. Recognized values consist of 12 semicolon-separated strings. Each string must be of equal length and contain 5 characters or less. The first string corresponds to the abbreviated name (Jan) for the first month of the year (January), the second to the abbreviated name for the second month of the year, and so on. |
mon | Defines the full spelling of the month names corresponding to the %B field descriptor. Recognized values consist of 12 semicolon-separated strings. The first string corresponds to the full spelling of the name for the first month of the year (January), the second to the full spelling of the name for the second month of the year, and so on. |
d_t_fmt | Defines the string used for the standard date and time format corresponding to the %c field descriptor. The string can contain any combination of characters and field descriptors. |
d_fmt | Defines the string used for the standard date format corresponding to the %x field descriptor. The string can contain any combination of characters and field descriptors. |
t_fmt | Defines the string used for the standard time format corresponding to the %X field descriptor. The string can contain any combination of characters and field descriptors. |
am_pm | Defines the strings used to represent ante meridiem (before noon) and post meridiem (after noon) corresponding to the %p field descriptor. Recognized values consist of two semicolon-separated strings. The first string corresponds to the ante meridiem designation, the last string to the post meridiem designation. |
t_fmt_ampm | Defines the string used for the standard 12-hour time format that includes an am_pm value (the %p field descriptor). This statement corresponds to the %r field descriptor. The string can contain any combination of characters and field descriptors. |
era | Defines how the years are counted and displayed for each era (or emperor's reign) in a locale, corresponding to the %E
field descriptor modifier. For each era, there must be one string in the following format:
direction:offset:start_date:end_date:name:format The variables for the era-string format are defined as follows: An era value consists of one string for each era. If more than one era is specified, each era string is separated by a ; (semicolon). |
era_year | Defines the string used to represent the year in alternate-era format corresponding to the %Ey field descriptor. The string can contain any combination of characters and field descriptors. |
era_d_fmt | Defines the string used to represent the date in alternate-era format corresponding to the %Ex field descriptor. The string can contain any combination of characters and field descriptors. |
era_t_fmt | Defines the alternative time format of the locale, as represented by the %EX field descriptor for the strftime subroutine. |
era_d_t_fmt | Defines the alternative date and time format of the locale, as represented by the %Ec field descriptor for the strftime subroutine. |
alt_digits | Defines alternate strings for digits corresponding to the %o field descriptor. Recognized values consist of a group of semicolon-separated strings. The first string represents the alternate string for 0, the second string represents the alternate string for one, and so on. A maximum of 100 alternate strings can be specified. |
The LC_TIME locale definition source file uses field descriptors to represent elements of time and date formats. Combinations of these field descriptors create other field descriptors or create time-and-date format strings. When used in format strings containing field descriptors and other characters, field descriptors are replaced by their current values. All other characters are copied without change. The following field descriptors are used by commands and subroutines that query the LC_TIME category for time formatting:
The following is an example of a possible LC_TIME category listed in a locale definition source file:
LC_TIME # #Abbreviated weekday names (%a) abday "<S><u><n>";"<M><o><n>";"<T><u><e>";"<W><e><d>";\ "<T><h><u>";"<F><r><i>";"<S><a><t>" # #Full weekday names (%A) day "<S><u><n><d><a><y>";"<M><o><n><d><a><y>";\ "<T><u><e><s><d><a><y>";"<W><e><d><n><e><s><d><a><y>";\ "<T><h><u><r><s><d><a><y>";"<F><r><i><d><a><y>";\ "<S><a><t><u><r><d><a><y>" # #Abbreviated month names (%b) abmon "<J><a><n>";"<F><e><b>";"<M><a><r>";"<A><p><r>";\ "<M><a><y>";"<J><u><n>";"<J><u><l>";"<A><u><g>";\ "<S><e><p>";"<O><c><t>";"<N><o><v>";"<D><e><c>" # #Full month names (%B) mon "<J><a><n><u><a><r><y>";"<F><e><b><r><u><a><r><y>";\ "<M><a><r><c><h>";"<A><p><r><i><l>";"<M><a><y>";\ "<J><u><n><e>";"<J><u><l><y>";"<A><u><g><u><s><t>";\ "<S><e><p><t><e><m><b><e><r>";"<O><c><t><o><b><e><r>";\ "<N><o><v><e><m><b><e><r>";"<D><e><c><e><m><b><e><r>" # #Date and time format (%c) d_t_fmt "%a %b %d %H:%M:%S %Y" # #Date format (%x) d_fmt "%m/%d/%y" # #Time format (%X) t_fmt "%H:%M:%S" # #Equivalent of AM/PM (%p) am_pm "<A><M>";"<P><M>" # #12-hour time format (%r) t_fmt_ampm "%I:%M:%S %p" # era "+:0:0000/01/01:+*:AD:%o %N";\ "+:1:-0001/12/31:-*:BC:%o %N" era_year "" era_d_fmt "" alt_digits "<0><t><h>";"<1><s><t>";"<2><n><d>";"<3><r><d>";\ "<4><t><h>";"<5><t><h>";"<6><t><h>";"<7><t><h>";\ "<8><t><h>";"<9><t><h>";"<1><0><t><h>" # END LC_TIME
This category of the locale definition source file format is part of the Base Operating System (BOS) Runtime.
/usr/lib/nls/loc/* | Specifies locale definition source files for supported locales. |
/usr/lib/nls/charmap/* | Specifies character set description (charmap) source files for supported locales. |
The locale command, localedef command.
The strftime subroutine.
Character Set Description (charmap) Source File Format, Locale Definition Source File Format, Locale Method Source File Format.
For specific information about other locale categories and their keywords, see the LC_COLLATE category, LC_CTYPE category, LC_MESSAGES category, LC_MONETARY category, and LC_NUMERIC category for the locale definition source file format.
Changing Your Locale and Understanding the Locale Definition Source File in AIX Version 4.3 System Management Guide: Operating System and Devices.