strftime(4) DG/UX R4.11 strftime(4)
NAME
strftime - language-specific strings
DESCRIPTION
There can exist one printable file per locale to specify its date and
time formatting information. These files must be kept in the
directory /usr/lib/locale/locale/LCTIME. The contents of these
files are:
1. optional abbreviated month names (in calendar order)
2. optional month names (in calendar order)
3. optional abbreviated weekday names (in calendar order)
4. optional weekday names (in calendar order)
5. optional default strings that specify formats for locale time
(%X) and locale date (%x)
6. optional default format for cftime, if the argument for cftime is
a null
7. optional ante meridian string
8. optional post meridian string
9. optional default format for date command output
10. optional default format for local time for 12 hour clock (AM/PM
form)
11. optional separator
12. optional alternate digit and era information for the locale
For 1-11 above, 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. If item 12 is
present and any of 1-10 are not specified, item 11 must be present.
The separator is a lone % character.
Alternate digit and era information may be omitted. If present, the
amount of information is variable, and fields are delimited by use of
the following keywords. They can be specified in any order.
altdigits semicolon separated strings, each surrounded by
double-quotes. The first string is the alternate
symbol for zero, the second is the alternate for one,
and so on up to a maximum of 100. Less than 100
alternate digit symbols may be specified. Lines may be
continued using the backslash (\) character.
eradfmt definition of the date format in the alternate era
notation. This is a single string surrounded by
double-quotes.
eratfmt definition of the time format in the alternate era
notation. This is a single string surrounded by
double-quotes.
eradtfmt definition of the date and time format in the
alternate era notation. This is a single string
surrounded by double-quotes.
era semicolon separated strings, each surrounded by
double-quotes. Within each string is an era
description segment which has the following format:
dir:offset:startdate:enddate:eraname:eraformat
dir a + or - character. + denotes that years closer to the
startdate have lower numbers than those closer to the
enddate. - denotes that years closer to the
startdate have higher numbers than those closer to
the enddate.
offset the year number closest to the startdate in the era.
startdate the date for the start of the era, in the form
yyyy/mm/dd, where yyyy is the year, mm is the month,
and dd is the day. Years prior to AD 1 are
represented as negative.
enddate the date for the end of the era. This has the same
format as startdate except the two special values -*
and +*, denote that the end date is the beginning of
time, and the end of time, respectively.
eraname a string for the name of the era
eraformat a string for formatting the year in the era
Multiple era segments may be specified. Additional segments may be
added using the backslash (\) character as a continuation character
for the era.
EXAMPLE
Here are the contents of /usr/lib/locale/C/LCTIME:
Jan
Feb
...
January
February
...
Sun
Mon
...
Sunday
Monday
...
%H:%M:%S
%m/%d/%y
%a %b %d %T %Z %Y
AM
PM
%a %b %d %T %Z %Y
%I:%M:%S %p
Alternate digit and era information may be defined as follows:
altdigits "0th";"1st";"2nd";"3rd";"4th";"5th";"6th";"7th";\
"8th";"9th";"10th";"11th";"12th";"13th";"14th";"15th"
eradfmt "The alternative date format is %Y (%a) in %EC"
eratfmt "The alternative time format is %h (%S) in %EC"
eradtfmt "The alternative date and time is %Y %H :%M:%S (%a) in %EC"
era "+:0:1992/10/22:+*:XPG4-Era:The Year of %EC";\
"+:1:1989/01/01:1992/10/21:XPG3-Era:The Year of %EC";\
"+:0:0000/01/01:1988/12/31:Pre-XPG:The Year of %EC";\
"+:1:-0001/12/31:-*:BC:%Ey %EC"
FILES
/usr/lib/locale/locale/LCTIME
REFERENCES
ctime(3C), setlocale(3C), strftime(3C)
Licensed material--property of copyright holder(s)