The LC_TIME category defines the interpretation of the
field descriptors used for parsing, then formatting, the date and
time. The descriptors identify the replacement portion of the string,
while the rest of a string is constant. The definition of descriptors
is included in z/OS XL C/C++ Runtime Library Reference. All these descriptors
can be used in the format specifier in the time formatting functions strftime().
The following keywords are supported:
- copy
- Specifies the name of an existing locale to be used as the source
for the definition of this category. If this keyword is specified,
no other keyword should be present in this category. If the locale
is not found, an error is reported and no locale output is created.
The copy keyword cannot specify a locale that also specifies
the copy keyword for the same category.
- abday
- Defines the abbreviated weekday names, corresponding to the %a field
descriptor. The operand consists of seven semicolon-separated strings.
The first string is the abbreviated name corresponding to Sunday,
the second string corresponds to Monday, and so forth.
- day
- Defines the full weekday names, corresponding to the %A field
descriptor. The operand consists of seven semicolon-separated strings.
The first string is the full name corresponding to Sunday, the second
string to Monday, and so forth.
- abmon
- Defines the abbreviated month names, corresponding to the %b field
descriptor. The operand consists of twelve strings separated by semicolons.
The first string is an abbreviated name that corresponds to January,
the second corresponds to February, and so forth.
- mon
- Defines the full month names, corresponding to the %B field
descriptor. The operand consists of twelve strings separated by semicolons.
The first string is an abbreviated name that corresponds to January,
the second corresponds to February, and so forth.
- d_t_fmt
- Defines the appropriate date and time representation, corresponding
to the %c field descriptor. The operand consists of a string,
which may contain any combination of characters and field descriptors.
- d_fmt
- Defines the appropriate date representation, corresponding to
the %x field descriptor. The operand consists of a string,
and may contain any combination of characters and field descriptors.
- t_fmt
- Defines the appropriate time representation, corresponding to
the %X field descriptor. The operand consists of a string,
which may contain any combination of characters and field descriptors.
- am_pm
- Defines the appropriate representation of the ante meridian
and post meridian strings, corresponding to the %p field
descriptor. The operand consists of two strings, separated by a semicolon.
The first string represents the ante meridian designation, the last
string the post meridian designation.
- t_fmt_ampm
- Defines the appropriate time representation in the 12-hour clock
format with am_pm, corresponding to the %r field descriptor.
The operand consists of a string and 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. No era is needed if the %E field
descriptor modifier is not used for the locale. See the description
of the strftime() function in z/OS XL C/C++ Runtime Library Reference for information
about this field descriptor.
For each
era, there must
be one string in the following format:
direction:offset:start_date:end_date:name:format
- direction
- Either a + or - character. The + character indicates the
time axis should be such that the years count in the positive direction
when moving from the starting date towards the ending date. The -
character indicates the time axis should be such that the years count
in the negative direction when moving from the starting date towards
the ending date.
- offset
- A number of the first year of the era.
- start_date
- A date in the form yyyy/mm/dd where yyyy, mm and dd are the
year, month and day numbers, respectively, of the start of the era.
Years prior to the year AD 0 are represented as negative
numbers. For example, an era beginning March 5th in the year 100 BC
would be represented as -100/3/5.
- end_date
- The ending date of the era in the same form as the start_date
above or one of the two special values -* or +*. A value of -*
indicates the ending date of the era extends to the beginning of time
while +* indicates it extends to the end of time. The ending date
may be either before or after the starting date of an era. For example,
the strings for the Christian eras AD and BC would be:
+0:0000/01/01:+*:AD:%EC %Ey
+:1:-0001/12/31:-*:BC:%EC %Ey
- name
- A string representing the name of the era which is substituted
for the %EC field descriptor.
- format
- A string for formatting the %EY field descriptor.
This string is usually a function of the %EC and %Ey field
descriptors.
The operand consists of one string for each era.
If there is more than one era, strings are separated by
semicolons.
- era_year
- Defines the format of the year in alternate era format,
corresponding to the %EY field descriptor.
- era_d_fmt
- Defines the format of the date in alternate era notation,
corresponding to the %Ex field descriptor.
- era_t_fmt
- Defines the locale's appropriate alternative time format, corresponding
to the %Ex field descriptor.
- era_d_t_fmt
- Defines the locale's appropriate alternative date and time format,
corresponding to the %Ec field descriptor.
- alt_digits
- Defines alternate symbols for digits, corresponding to the %O field
descriptor modifier. The operand consists of semicolon-separated strings.
The first string is the alternate symbol corresponding to zero, the
second string the symbol corresponding to one, and so forth. A maximum
of 100 alternate strings may be specified. The %O modifier
indicates that the string corresponding to the value specified by
the field descriptor is used instead of the value.
For the definitions of the time formatting descriptors, see the
description of the strftime() function in z/OS XL C/C++ Runtime Library Reference.