strptime.3c (2010 09)

strptime(3C) strptime(3C)

the maximum time representable by the

time_t data type in 32-bit HP-UX (which represents Tuesday

January 19 03:14:07 UTC, 2038) or if the date exceeds the maximum date supported in 64-bit HP-UX

(which is Friday December 31 23:59:59 UTC, 9999),

strptime() fails and a null pointer is returned.

EXTERNAL INFLUENCES

Environment Variables

LC_NUMERIC may deﬁne the alternative symbols (alt_digit; see localedef (4)) used by the

%O modiﬁer.

The alt_digit deﬁnition has precedence over alt_digits (

LC_TIME). Support for alt_digit may be removed

in a future release of HP-UX.

LC_TIME determines the characters to be interpreted for those directives described above as being from

the locale.

LC_CTYPE determines the interpretation of the bytes within format as single- and/or multibyte charac-

ters.

International Code Set Support

Single- and multibyte character code sets are supported.

RETURN VALUE

Upon successful completion,

strptime() returns a pointer to the character following the last character

parsed. Otherwise, a null pointer is returned.

EXAMPLES

The following program segment uses

strptime() to convert the string (ﬁrst argument) to values

according to the format speciﬁed in the second argument.

struct tm t;

setlocale(LC_TIME, "en_US.iso88591");

strptime("1:04:23 PM on 10/6/92", "%I:%M:%S %p on %D", &t);

The converted value is stored in the structure t as follows:

t.tm_sec = 23

t.tm_min = 4

t.tm_hour = 13

t.tm_mday = 6

t.tm_mon = 9

t.tm_year = 92

t.tm_wday = 2

t.tm_yday = 279

t.tm_isdst = 1

AUTHOR

strptime() was developed by OSF and HP.