TIMTBL(M) XENIX System V TIMTBL(M)
Name
timtbl - Create a time locale table.
Syntax
timtbl [ specfile ]
Description
The utility timtbl is provided to allow new LC_TIME locales
to be defined. It reads a specification file, which
contains definitions of the way in which time and date
information is presented for a particular locale, and
produces a binary table file, to be read by setlocale(S),
which determines the behavior of the strftime(S) routine.
The information supplied in the specification file consists
of lines in the following format:
item = string
The ``='' can be separated from the item and string fields
by zero or more space or tab characters. The following
values are meaningful for item:
DATE_FMT
specification of the format string for representing
the date. It will contain ``%'' directives
representing variable items such as the month number,
as used in the format string for strftime(S).
TIME_FMT
specification of the format string for representing
the time of day.
F_NOON
string indicating 12-hour clock times before midday,
e.g. ``AM''.
A_NOON
string indicating 12-hour clock times after midday,
e.g. ``PM''.
D_T_FMT
string for formatting combined date and time.
DAY_1 full name of the first day of the week (Sunday).
.
.
.
DAY_7 full name of the seventh day of the week.
ABDAY_1
Page 1 (printed 2/7/91)
TIMTBL(M) XENIX System V TIMTBL(M)
abbreviated name of the first day of the week, e.g.
``Sun''.
.
.
.
ABDAY_7
abbreviated name of the seventh day of the week.
MON_1 full name of the first month in the Gregorian
calendar.
.
.
.
MON_12
full name of the twelfth month.
ABMON_1
abbreviated name of the first month.
.
.
.
ABMON_12
full name of the twelfth month.
The string is a sequence of characters surrounded by quotes
("). Characters within the string can be specified both
literally and using ``\'' escapes; the following three
strings are equivalent:
"Tuesday" - literal
"\x54ue\x73da\x79" - hexadecimal escapes
"\124ue\163da\171" - octal escapes
The strings for the items DATE_FMT , TIME_FMT and D_T_FMT
will also include ``%'' directives as detailed in the
strftime(S) manual page, to specify variable portions of the
string.
All characters following a hash (``#'') are treated as a
comment and ignored up to the end of the line, unless the
hash is within a quoted string.
The various items may be specified in any order. If any
items are not specified, a warning message will be produced,
and the null string ("") substituted.
The binary table output is placed in a file named ``time'',
within the current directory. This file should be copied or
linked to the correct place in the setlocale file tree (see
Page 2 (printed 2/7/91)
TIMTBL(M) XENIX System V TIMTBL(M)locale(M)). To prevent accidental corruption of the output
data, the file is created with no write permission; if the
timtbl utility is run in a directory containing a write-
protected ``ctype'' file, the utility will ask if the
existing file should be replaced - any response other than
``yes'' or ``y'' will cause timtbl to terminate without
overwriting the existing file.
If the specfile argument is missing, the specification
information is read from the standard input.
See Also
chrtbl(M), locale(M), numtbl(M), setlocale(S), strftime(S)
Diagnostics
If the input table file cannot be opened for reading,
processing will terminate with the error message, ``Cannot
open specification file''.
Any lines in the specification file which are syntactically
incorrect, or contain an urecognized value for the item,
will cause an error message to be issued to the standard
error output, specifying the line number on which the error
was detected. The line will be ignored, and processing will
continue.
If a particular item is specified more than once, a warning
message will be produced, and processing will continue.
If the specification file does not contain specifications
for all possible items, a warning message will be produced.
If the output file, time , cannot be opened for writing,
processing will terminate with the error message, ``Cannot
create table file''.
Any error conditions encountered will cause the program to
exit with a non-zero return code; successful completion is
indicated with a zero return code.
Notes
The strings D_FMT , T_FMT , AM_STR and PM_STR may be used as
alternatives to DATE_FMT , TIME_FMT , F_NOON and A_NOON
respectively, if required. These alternatives are provided
for consistency with the identifiers used by nl_langinfo(S).
Page 3 (printed 2/7/91)
