HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

s
strftime(3C) strftime(3C)
Field Width and Precision
An optional field width and precision specification can immediately follow the initial
% of a directive in the
following order:
[
-0]w The decimal digit string w specifies a minimum field width in which the result of the conversion
is right- or left-justified. It is right-justified (with space padding) by default. If the optional flag
- is specified, it is left-justified with space padding on the right. If the optional flag
0 is
specified, it is right-justified and padded with zeros on the left.
.p The decimal digit string p specifies the minimum number of digits to appear for the
d, H, I,
j,
m, M, o, S,
U, w, W, y and Y directives, and the maximum number of bytes to be used from the
a,
A, b, B, c,
D, E, F, h, n, N, p, r,
t, T, x, X, z, Z, and % directives. In the first case, if a direc-
tive supplies fewer digits than specified by the precision, it will be expanded with leading zeros.
In the second case, if a directive supplies more bytes than specified by the precision, excess bytes
will truncated on the right.
If no field width or precision is specified for a
d, H, I, m, M, S,
U, W, y,orj directive, a default of .2 is used
for all but
j for which .3 is used.
EXTERNAL INFLUENCES
Locale
The
LC_TIME category determines the characters to be substituted for those directives described above as
being from the locale.
The LC_CTYPE category determines the interpretation of the bytes within format as single and/or multi-
byte characters.
The
LC_NUMERIC category determines the characters used to form numbers for those directives that pro-
duce numbers in the output. If ALT_DIGITS (see langinfo(5)) is defined for the locale, the characters so
specified are used in place of the default ASCII characters. If both ALT_DIGITS and
ALT_DIGIT is
defined for the locale,
ALT_DIGITS will take precedence over ALT_DIGIT .
Environment Variables
TZ determines the time zone name substituted for the %Z directive. The time zone name is determined by
calling the function tzset() which sets the external variable tzname (see ctime(3C)).
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE
If the total number of resulting bytes including the terminating null byte is not more than maxsize,
strftime() returns the number of bytes placed into the array pointed to by s, not including the ter-
minating null byte. Otherwise, zero is returned and the contents of the array are indeterminate.
EXAMPLES
If the timeptr argument contains the following values:
timeptr->tm_sec = 4;
timeptr->tm_min = 9;
timeptr->tm_hour = 15;
timeptr->tm_mday = 4;
timeptr->tm_mon = 6;
timeptr->tm_year = 88;
timeptr->tm_wday = 1;
timeptr->tm_yday = 185;
timeptr->tm_isdst = 1;
the following combinations of the LC_TIME category and format strings produce the indicated output:
LC_TIME Format String Output
en_US.roman8 %x Mon, Jul 4, 1988
de_De.roman8 %x Mo., 4. Juli 1988
476 Hewlett-Packard Company − 3 − HP-UX 11i Version 3: February 2007