Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

mktime(3) Guardian Native C Library Calls Reference Manual

RETURN VALUES

Upon successful completion, the mktime() function returns the speciﬁed time since the Epoch as

a value of type time_t. On error, or whenever the time since the Epoch cannot be represented,

this function returns the value (time_t)-1 and sets errno to indicate the error.

The value returned is affected by the setting of the TZ environment variable and calls to the

tzset( ) function. Refer to the tzset(3) reference page for more information about the TZ environ-

ment variable.

ERRORS

If the following condition occurs, the mktime() function sets errno to the corresponding value:

[EINVAL] The speciﬁed broken-down time cannot be represented as a time since the

Epoch.

RELATED INFORMATION

Functions: asctime(3), ctime(3), difftime(3), localtime(3), getenv(3), gmtime(3), strftime(3),

time(3), tzset(3), utime(3).

STANDARDS CONFORMANCE

The value returned by the mktime() function for errno is an HP extension to the XPG4 Version

2 speciﬁcation.

4−56 Hewlett-Packard Company 527192-005