_get_daylight

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

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

Retrieves the daylight saving time offset in hours.

Syntax

  
      error_t _get_daylight(   
    int* hours  
);  

Parameters

hours
The offset in hours of daylight saving time.

Return Value

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

Remarks

The _get_daylight function retrieves the number of hours in daylight saving time as an integer. If daylight saving time is in effect, the default offset is one hour (although a few regions do observe a two-hour offset).

If hours 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 _daylight or the deprecated function __daylight.

.NET Framework Equivalent

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

Requirements

Routine	Required header
_get_daylight	<time.h>

For more information, see Compatibility.

See Also

Time Management
errno, _doserrno, _sys_errlist, and _sys_nerr
_get_dstbias
_get_timezone
_get_tzname