RtlTimeToSecondsSince1970 函式 (winternl.h)

[RtlTimeToSecondsSince1970 可用於 Windows 2000 和 Windows XP。在後續版本中可能無法使用或修改。

將指定的64位系統時間轉換為自1970年1月1日起的秒數。

語法

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

[in] Time

指定系統時間之 LARGE_INTEGER 結構的指標。此值的有效年份包含 1970 到 2105。

[out] ElapsedSeconds

接收秒數之變數的指標。

如果函式成功，則會傳回 TRUE。如果失敗，則會傳回 FALSE。一般而言，如果 Time 參數的指定值不在參數描述中指定的有效時間範圍內，此函式將會失敗。

此函式沒有相關聯的匯入連結庫。您必須使用 LoadLibrary 和 GetProcAddress 函式，以動態方式連結至 Ntdll.dll。

沒有單一對等的公用函式。若要使用公用函式執行這項工作，請使用下列步驟：

呼叫 SystemTimeToFileTime 將系統時間複製到 FILETIME 結構。呼叫 GetSystemTime 以取得傳遞至 SystemTimeToFileTime 的目前系統時間。
將 FILETIME 結構的內容複製到 ULARGE_INTEGER 結構。
使用1970年1月1日第一秒的日期和時間，初始化 SYSTEMTIME 結構。
呼叫 SystemTimeToFileTime，將步驟 3 中初始化的 SYSTEMTIME 結構傳遞至呼叫。
將步驟 4 中 SystemTimeToFileTime 傳回的 FILETIME 結構內容複製到第二個ULARGE_INTEGER。複製的值應該小於或等於步驟 2 中複製的值。
從步驟 2 (目前系統時間) 中初始化之ULARGE_INTEGER結構的 64 位 ULARGE_INTEGER值減去步驟 5 (1970 年 1 月 1 日) 中初始化的 64 位值。這會產生自1970年1月1日起的100奈秒間隔值。若要將此值轉換成秒數，請除以 10,000,000。