LC_TIME(4) LC_TIME(4)
NAME
LCTIME - language specific time and date strings
SYNOPSIS
/usr/lib/locale/locale/LCTIME
DESCRIPTION
A readable file exists for each local environment which contains
information on the respective date and time formats. This file is
located in the /usr/lib/locale/locale directory and is called LCTIME.
Among other information, this file contains entries for the name of
the month (including abbreviations), the names of the weekdays
(including abbreviations), and the standard character strings for
specifying the local time (%X) and date format (%x).
LC_TIME Locale Definition
For locale definition, the following mandatory keywords are recog-
nized:
abmon Define the abbreviated month names, corresponding to the
%b field descriptor. The operand consists of twelve semi-
colon-separated strings, each surrounded by double-quotes.
The first string is the abbreviated name of the first
month of the year (January), the second the abbreviated
name of the second month, and so on.
mon Define the full month names, corresponding to the %B field
descriptor. The operand consists of twelve semicolon-
separated strings, each surrounded by double-quotes. The
first string is the full name of the first month of the
year (January), the second the full name of the second
month, and so on.
abday Define the abbreviated weekday names corresponding to the
%a field descriptor (conversion specification in the
strftime(), wcsftime() and strptime() functions). The
operand consists of seven semicolon-separated strings,
each surrounded by double-quotes. The first string is the
abbreviated name of the day corresponding to Sunday, the
second the abbreviated name of the day corresponding to
Monday, and so on.
day Define the full weekday names, corresponding to the %A
field descriptor. The operand consists of seven semico-
lon-separated strings, each surrounded by double-quotes.
The first string is the full name of the day corresponding
to Sunday, the second the full name of the day correspond-
ing to Monday, and so on.
Page 1 Reliant UNIX 5.44 Printed 11/98
LC_TIME(4) LC_TIME(4)
tfmt Define the appropriate time representation, corresponding
to the %X field descriptor. The operand consists of a
string, and can contain any combination of characters and
field descriptors. In addition, the string can contain
escape sequences.
dfmt Define the appropriate date representation, corresponding
to the %x field descriptor. The operand consists of a
string, and can contain any combination of characters and
field descriptors. In addition, the string can contain
escape sequences.
dtfmt Define the appropriate date and time representation,
corresponding to the %c field descriptor. The operand con-
sists of a string, and can contain any combination of
characters and field descriptors. In addition, the string
can contain escape sequences (\\, \a, \b, \f, \n, \r, \t,
\v).
ampm Define 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, each surrounded by double-quotes. The
first string represents the ante meridian designation, the
last string the post meridian designation.
tfmtampm Define the appropriate time representation in the 12-hour
clock format with ampm, corresponding to the %r field
descriptor. The operand consists of a string and can con-
tain any combination of characters and field descriptors.
If the string is empty, the 12-hour format is not sup-
ported in the locale.
era Define how years are counted and displayed for each era in
a locale. The operand consists of semicolon-separated
strings. Each string is an era description segment with
the format:
direction:offset:startdate:enddate:eraname:eraformat
according to the definitions below. There can be as many
era description segments as are necessary to describe the
different eras.
Note: The start of an era might not be the earliest point
in the era it may be the latest. For example, the Chris-
tian era BC starts on the day before January 1, AD 1, and
increases with earlier time.
Page 2 Reliant UNIX 5.44 Printed 11/98
LC_TIME(4) LC_TIME(4)
direction Either a + or a - character. The + character
indicates that years closer to the startdate
have lower numbers than those closer the
enddate. The - character indicates that years
closer to the startdate have higher numbers
than those closer to the enddate.
offset The number of the year closest to the
startdate in the era, corresponding the %Ey
field descriptor.
startdate A date in the form yyy/mm/dd, where yyyy, mm,
and dd are the year, month and day numbers
respectively of the start of the era. Years
prior to AD 1 are represented as negative
numbers.
enddate The ending date of the era, in the same format
as the startdate, or one of the two special
values -* or +*. The value -* indicates that
the ending date is the beginning of time. The
value +* indicates that the ending date is the
end of time.
eraname A string representing the name of the era,
corresponding to the %EC field descriptor.
eraformat A string for formatting the year in the era,
corresponding to the %EY field descriptor.
eradfmt Define the format of the date in alternative era notation,
corresponding to the %Ex field descriptor.
eratfmt Define the locale's appropriate alternative time format,
corresponding to the %EX field descriptor.
eradtfmt Define the locale's appropriate alternative date and time
format, corresponding to the %Ec field descriptor.
altdigits Define alternative symbols for digits, corresponding to
the %O field descriptor modifier. The operand consists of
semicolon-separated strings, each surrounded by double-
quotes. The first string is the alternative symbol
corresponding with zero, the second string the symbol
corresponding with one and so on. Up to 100 alternative
symbol strings can be specified. The %O modifier indicates
that the string corresponding to the value specified via
the field descriptor will be used instead of the value.
copy Specify the name of an existing locale to be used as the
definition of this category. If this keyword is specified,
no other keyword can be specified.
Page 3 Reliant UNIX 5.44 Printed 11/98
LC_TIME(4) LC_TIME(4)
Each string is on a line by itself. All white space is significant.
The order of the strings in the above list is the same order in which
they must appear in the file.
LC_TIME C-language Access
The following information can be accessed. These correspond to con-
stants defined in <langinfo.h> and used as arguments to the
nllanginfo() function.
ABDAYx The abbreviated weekday names (for example Sun), where x
is a number from 1-7.
DAYx The full weekday names (for example Sunday), where x is a
number from 1 to 7.
ABMONx The abbreviated month names (for example Jan), where x is
a number from 1 to 12.
MONx The full month names (for example January), where x is a
number from 1 to 12.
DTFMT The appropriate date and time representation.
DFMT The appropriate date representation.
TFMT The appropriate time representation.
AMSTR The appropriate ante-meridian affix.
PMSTR The appropriate post-meridian affix.
TFMTAMPM The appropriate time representation in the 12-hour clock
format with AMSTR and PMSTR.
ERA See description of era in "LCTIME Locale Definition"
above.
ERADFMT The era date format.
ERATFMT The locale's appropriate alternative time format,
corresponding the %EX field descriptor.
ERADTFMT The locale's appropriate alternative date and time format,
corresponding to the %Ec field descriptor.
ALTDIGITS The alternative symbols for digits, corresponding to the
%O conversion specification modifier. The value consists
of semicolon-separated symbols. The first is the alterna-
tive symbol corresponding to zero, the second is the sym-
bol corresponding to one, and so on. Up to 100 alternative
symbols may be specified.
Page 4 Reliant UNIX 5.44 Printed 11/98
LC_TIME(4) LC_TIME(4)
The following table displays the correspondence between the items
described above and the conversion specifiers used by the date utility
and the strftime(), wcsftime() and strptime() functions.
______________________________________________
| Localedef | langinfo | Conversion |
| Keyword | Constant | Specifier |
|_____________|______________|________________|
| abmon | ABMONx | %b |
| mon | MON | %B |
| abday | ABDAYx | %a |
| day | DAYx | %A |
| tfmt | TFMT | %X |
| dfmt | DFMT | %x |
| dtfmt | DTFMT | %c |
| ampm | AMSTR | %p |
| ampm | PMSTR | %p |
| tfmtampm | TFMTAMPM | %r |
| era | ERA | %EC, %Ey, %EY |
| eradfmt | ERADFMT | %Ex |
| eratfmt | ERATFMT | %EX |
| eradtfmt | ERADTFMT | %Ec |
| altdigits | ALTDIGITS | %O |
|_____________|______________|________________|
Each string is on a line by itself. All white space is significant.
The order of the strings in the above list is the same order in which
they must appear in the file.
EXAMPLES
Beginning of /usr/lib/locale/EnUS.ASCII/LCTIME file:
Jan
Feb
...
January
February
...
Sun
Mon
...
Sunday
Monday
...
%T %Z
%m/%d/%y
%a %h %d %T %Z %Y
AM
PM
...
Page 5 Reliant UNIX 5.44 Printed 11/98
LC_TIME(4) LC_TIME(4)
SEE ALSO
ctime(3C), nllanginfo(3C), setlocale(3C), strftime(3C), strptime(3C),
wcsftime(3C), langinfo(5).
Page 6 Reliant UNIX 5.44 Printed 11/98