get-daylight.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _get_daylight	_get_daylight	4/2/2020	__daylight _get_daylight _o___daylight _o__get_daylight	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-time-l1-1-0.dll	DLLExport	apiref	TIME/_get_daylight _get_daylight get_daylight __daylight	get_daylight function daylight saving time offset _get_daylight function	f85a6ba3-e187-4ca7-aed7-ffc694c8ac4c

_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.

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_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