_get_dstbias

Retrieves the daylight saving time offset in seconds.

Syntax

error_t _get_dstbias( long* seconds );

Parameters

seconds
The offset in seconds of daylight saving time.

Return value

Zero if successful or an errno value if an error occurs.

Remarks

The _get_dstbias function retrieves the number of seconds in daylight saving time as an integer. If daylight saving time is in effect, the default offset is 3600 seconds, which is the number of seconds in one hour (though a few regions do observe a two-hour offset).

If seconds is NULL, the invalid parameter handler is invoked as described in Parameter validation. If execution is allowed to continue, this function sets errno to EINVAL and returns EINVAL.

We recommend you use this function instead of the macro _dstbias or the deprecated function __dstbias.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine	Required header
_get_dstbias	<time.h>

For more information, see Compatibility.

See also

Time management
errno, _doserrno, _sys_errlist, and _sys_nerr
_get_daylight
_get_timezone
_get_tzname