Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (j - m) mktime(3)

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.

527192-018 Hewlett-Packard Company 4−109