RtlTimeToSecondsSince1970 function (ntifs.h)

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

Syntax

NTSYSAPI BOOLEAN RtlTimeToSecondsSince1970(
  [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 1970 and ends around 2105.

[out] ElapsedSeconds

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

Return value

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

Remarks

The basis for system time is the start of 1601. The absolute system time is a LARGE_INTEGER value, accurate to 100-nanosecond resolution, assuming an accurate hardware clock. The value processed by RtlTimeToSecondsSince1970 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

See also

RtlSecondsSince1970ToTime

RtlTimeFieldsToTime

RtlTimeToSecondsSince1980

RtlTimeToTimeFields