_get_timezone

Article
12/18/2017

The latest version of this topic can be found at _get_timezone.

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

Syntax

  
      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.