winrt：：clock 結構 (C++/WinRT)

發行項
07/20/2023

型別，包含靜態協助程式函式，用於轉換Windows：：Foundation：:D ateTime (，也就是std：：chrono：：time_point) ，以及從 winrt：：file_time和 time_t。

winrt：：clock定義為使用與Windows：：Foundation：:D ateTime相同的單位， (100 奈秒間隔的帶正負號 64 位整數，自 1 月 1 日 1601) 起。其他 C++ 標準時鐘通常不會定義其解析度，也不會使用 epoch Jan 1 1601，這是Windows 執行階段/FILETIME epoch。

語法

struct clock

規格需求

最低支援的 SDK：Windows SDK 10.0.17134.0 版 (Windows 10版本 1803)

命名空間： winrt

標頭： %WindowsSdkDir%IncludeWindowsTargetPlatformVersion <> \cppwinrt\winrt\base. (h 預設包含)

成員類型別名

別名名稱	類型
clock：：rep	int64_t的同義字。
clock：:p eriod	Windows：：Foundation：：TimeSpan：:p eriod 的同義字。
clock：:d uration	Windows：：Foundation：：TimeSpan的同義字。
clock：：time_point	Windows：：Foundation：:D ateTime的同義字。

成員函數

函式	描述
clock：：now 函式	擷取目前時間做為Windows：：Foundation：:D ateTime。
clock：：from_file_time 函式	將winrt：：file_time值轉換為Windows：：Foundation：:D ateTime。
clock：：from_time_t 函式	將time_t值轉換成Windows：：Foundation：:D ateTime。
clock：：to_file_time 函式	將Windows：：Foundation：:D ateTime值轉換為winrt：：file_time。
clock：：to_time_t 函式	將Windows：：Foundation：:D ateTime值轉換成time_t。

clock：：now 函式

擷取目前時間做為Windows：：Foundation：:D ateTime。

語法

static Windows::Foundation::DateTime now() noexcept;

傳回值

目前的時間是Windows：：Foundation：:D ateTime。

clock：：from_file_time 函式

將winrt：：file_time值轉換為Windows：：Foundation：:D ateTime。

語法

static Windows::Foundation::DateTime from_file_time(winrt::file_time const& time) noexcept;

參數

time要轉換成Windows：：Foundation：:D ateTime 的winrt：：file_time 值。

傳回值

轉換成Windows：：Foundation：:D ateTime的winrt：：file_time值。

clock：：from_time_t 函式

將time_t值轉換成Windows：：Foundation：:D ateTime。

語法

static Windows::Foundation::DateTime from_time_t(time_t time) noexcept;

參數

time要轉換成Windows：：Foundation：:D ateTime 的time_t值。

傳回值

轉換成Windows：：Foundation：:D ateTime 的time_t值。

clock：：to_file_time 函式

將Windows：：Foundation：:D ateTime值轉換為winrt：：file_time。

語法

static file_time to_file_time(Windows::Foundation::DateTime const& time) noexcept;

參數

time要轉換成winrt：：file_time的Windows：：Foundation：:D ateTime值。

傳回值

轉換成winrt：：file_time的Windows：：Foundation：:D ateTime值。

clock：：to_time_t 函式

將Windows：：Foundation：:D ateTime值轉換成time_t。

語法

static time_t to_time_t(Windows::Foundation::DateTime const& time) noexcept;

參數

time要轉換成time_t*的Windows：：Foundation：:D ateTime值。

傳回值

轉換成time_t的 Windows：：Foundation：:D ateTime值。