HP-UX Reference (11i v2 04/09) - 3 Library Functions N-Z (vol 7)

w
wcsftime(3C) wcsftime(3C)
NAME
wcsftime( ) - convert date and time to wide-character string
SYNOPSIS
#include <wchar.h>
size_t wcsftime(
wchar_t *ws,
size_t maxsize,
const char *format,
const struct tm *timeptr
);
_INCLUDE__STDC_A1_SOURCE only
size_t wcsftime(
wchar_t *ws,
size_t maxsize,
const wchar_t *format,
const struct tm *timeptr
);
Remarks:
This function is compliant with the XPG4 Worldwide Portability Interface wide-character formatting
functions. It parallels the 8-bit character formatting function defined in strftime (3C).
DESCRIPTION
wcsftime() converts the contents of a tm structure (see ctime(3C)) to a formatted date and time
wide-character string.
wcsftime() places wide characters into the array pointed to by ws as controlled by the string pointed
to by format. The format string consists of zero or more directives and ordinary characters. A directive
consists of a % character, an optional field width and precision specification, and a terminating character
that determines the directive’s behavior. All ordinary characters (including the terminating null charac-
ter) are converted into corresponding wide characters and are copied into the array. No more than max-
size wide characters are placed into the array. Each directive is replaced by the appropriate wide charac-
ters as described in the following list. The appropriate wide characters are determined by the program’s
locale, by the values contained in the structure pointed to by timeptr , and by the
TZ environment vari-
able (see External Influences below).
The definition for this function and the type
wchar_t are provided in the <
wchar.h>header.
_INCLUDE__STDC_A1_SOURCE only
wcsftime() places wide characters into the array pointed to by ws as controlled by the wide-character
string pointed by format . The functionality of
wcsftime() is the same except for data type of format.
Directives
The following directives, shown without the optional field width and precision specification, are replaced
by the corresponding wide characters as indicated:
%a Locale’s abbreviated weekday name.
%A Locale’s full weekday name.
%b Locale’s abbreviated month name.
%B Locale’s full month name.
%c Locale’s appropriate date and time representation.
%C The century number (the year divided by 100 and truncated to an integer) as a decimal
number [00-99].
%d Day of the month as a decimal number [01,31].
%D Equivalent to the directive string %m/%d/%y.
%e Day of the month as a decimal number [1,31]; a single digit is preceded by a space.
%h Equivalent to %b.
%H Hour (24-hour clock) as a decimal number [00,23].
%I Hour (12-hour clock) as a decimal number [01,12].
%j Day of the year as a decimal number [001,366].
%m Month as a decimal number [01,12].
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 3−−1155