Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

mktime(3) OSS 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−206 Hewlett-Packard Company 527187-017