RtlTimeToSecondsSince1980 function (ntifs.h)

Article
02/22/2024

The RtlTimeToSecondsSince1980 routine converts a given absolute system time value to the elapsed time, in seconds, since the beginning of 1980.

Syntax

NTSYSAPI BOOLEAN RtlTimeToSecondsSince1980(
  [in]  PLARGE_INTEGER Time,
  [out] PULONG         ElapsedSeconds
);

Parameters

[in] Time

Pointer to a variable that specifies the system time value to be converted. The approximate valid range for this variable begins at 1980 and ends around 2115.

[out] ElapsedSeconds

Pointer to a caller-allocated variable that receives the corresponding number of seconds since midnight, December 31, 1979.

Return value

RtlTimeToSecondsSince1980 returns TRUE if the input Time falls within a range that it can accurately convert to ElapsedSeconds.

Remarks

The absolute system time is a LARGE_INTEGER value, accurate to 100-nanosecond resolution, assuming an accurate hardware clock. The basis for system time is the start of 1601. The value that is processed by RtlTimeToSecondsSince1980 is truncated to one-millisecond resolution.

For more information about converting time values, see Data Conversions.

Requirements

Requirement	Value
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL