HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
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 con-
sists 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 character) are
converted into corresponding wide characters and are copied into the array. No more than maxsize wide
characters are placed into the array. Each directive is replaced by the appropriate wide characters 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 variable (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].
Section 3−−1010 − 1 − HP-UX Release 11i: December 2000
___
___