.TFMT - format time number into date/time string.

Alternate Entry Name: _TFMT

Usage:

B:
   %b/manif/t_ctrl
   size = .tfmt(string, ssize, format, timenum,
                tzloc, parse);

C:
   #include <time.h>
   #include <t_ctrl.h>
   size_t _tfmt(char *string, size_t ssize,
                const char *format, time_t timenum,
                _T_locale tzloc, const _D_ctrl *parse);

Where:

string

points to a region of memory where .TFMT can store the date/time string it produces.

ssize

is the maximum number of bytes that .TFMT may store in "string".

format

points to a string which describes the format of the date/time string you want .TFMT to produce. This string is similar to a "printf"-style format string, with "%" placeholders to stand for date/time values. For further information on format strings, see "expl b lib .tmfmt".

timenum

is an integer representing a date and time, expressed as the number of seconds since 0:00 a.m. 1 January 1970 GMT.

tzloc

is a time zone locale reference value. A value of zero will use the default locale. For more information on such values, see "expl b tz".

parse

points to a table of names: names of the days ("Monday", "Tuesday", etc.), names of months ("January", "February", etc.) and so on. If you supply a NULL pointer for this argument, you get names in the default locale (as set by .DLANG).

size

is the number of characters in the string that .TFMT produces. If the date/time string that .TFMT produces is too big to fit in "string", .TFMT returns zero and the contents of "string" are indeterminate.

Description:

.TFMT creates a date/time string of a given "format", based on the given time number and time zone locale. In all other respects, .TFMT works like the .TMFMT function.

See Also:

expl b lib .tmfmt

for further information on names tables and format strings.

expl b lib .dlang

for making a new names table the default.

expl c lib strftime

for a similar function.

Copyright © 1996, Thinkage Ltd.