_get_timezone

Retrieves the difference in seconds between coordinated universal time (UTC) and local time.

error_t _get_timezone(  
    long* seconds 
);

Parameters

  • seconds
    The difference in seconds between UTC and local time.

Return Value

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

Remarks

The _get_timezone function retrieves the difference in seconds between UTC and local time as an integer. The default value is 28,800 seconds, for Pacific Standard Time (eight hours behind UTC).

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.

Requirements

Routine

Required header

_get_timezone

<time.h>

For more information, see Compatibility.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

See Also

Reference

Time Management

errno, _doserrno, _sys_errlist, and _sys_nerr

_get_daylight

_get_dstbias

_get_tzname