HP-UX Reference (11i v1 05/09) - 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 directive 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 and %z directives. The time zone name is deter-
mined 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
HP-UX 11i Version 1: September 2005 − 3 − Hewlett-Packard Company Section 3−−917