file_clock 類別

這個時鐘可以代表檔案系統中使用的檔案時間值範圍和解析度。

語法

using file_clock = std::filesystem::_File_time_clock; // C++20

備註

在 Microsoft 實作中，epoch 或開始 file_clock 測量時間的時間是 1/1/1601 00：00：00。

ISO C++ 標準提供 和 to_sys()from_sys() 或 to_utc()from_utc() 之間的選擇。 Microsoft 實作選擇 to_utc 和 from_utc 。

成員

名稱	描述
from_utc	靜態。 將 utc_time 轉換成 file_time。
now	靜態。 傳回目前的國際原子時間。
to_utc	靜態。 將 file_timeutc_time 轉換為 。

非成員

名稱	描述
from_stream	file_clock使用指定的格式，從指定的資料流程剖析 。
operator<<	輸出 file_time 至指定的資料流程。

便利類型別名

名稱	描述
file_clock::duration	在 Microsoft 的實作中，它是 的 duration<long long, ratio<1, 10'000'000> 同義字。 它代表以 100 奈秒為單位測量的時間持續時間。
file_clock::time_point	time_point<File_time_clock> 的同義字。 用來表示 time_point 這個時鐘的 。
file_clock::period	在 Microsoft 的實作中，它是 的 ratio<1, 10'000'000> 同義字。 它代表持續時間中每個刻度之間的秒數 （100 奈秒） 時間。
file_clock::rep	型別 （ long long ） 的同義字，用來表示這個時鐘中整數單位。 file_clock::duration

相關

名稱	描述
file_time	time_point<file_clock, Duration> 的同義字。 表示 time_point 的 file_clock 。 您可以指定 Duration 。 在 中定義 std::chrono

公用常數

名稱	描述
file_clock::is_steady constant	指出時鐘類型是否穩定。 其值為 false 。

需求

標頭： <chrono> （自 C++20 起）

命名空間：std::chrono

編譯器選項：/std:c++latest

from_utc

將 轉換成 utc_time 的 file_time 靜態方法。

template <class Duration>
static file_time<common_type_t<_Duration, chrono::seconds>>
from_utc(const utc_time<Duration>& t);

參數

t
要進行轉換的 utc_time。

傳回值

file_time，表示對等 utc_time 的 t 。 它會計算為 utc_clock::to_sys(utc_time).time_since_epoch() 減去 2017 年 1 月 1 日 （27） 之前的閏秒數。 Windows 10 版本 1809 和 Windows Server 2019 引進了閏秒的支援。 預設會啟用該支援，但可以停用。 啟用時，只有在 2018 年 7 月之後的閏秒（不是 2017 年 1 月 1 日到 2018 年 7 月之間）才會包含在時間中。

建議您使用 std::chrono::clock_cast 來轉換時鐘之間的時間點，而不是直接呼叫此函式。 這特別相關， file_clock 因為 ISO C++ 標準允許此類型定義 to_utc 和 from_utc 、 或 to_sys 和 from_sys 。 由於實作可能會因廠商而異，因此您可以改用 clock_cast ，而所有程式庫廠商都會提供。

範例: from_utc

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    std::cout << clock_cast<file_clock>(utc_clock::now());

    return 0;
}

2021-08-17 00:20:41.2594557

to_utc

將 轉換成 file_time 的 utc_time 靜態方法。

template <class Duration>
static utc_time<common_type_t<Duration, seconds>>
to_utc(const file_time<Duration>& t);

參數

t
要進行轉換的 file_time。

傳回值

utc_time，表示對等 file_time 的 t 。 建議您使用 std::chrono::clock_cast 來轉換時鐘之間的時間點，而不是直接呼叫此函式。 這特別相關， file_clock 因為 ISO C++ 標準允許此類型定義 to_utc 和 from_utc 、 或 to_sys 和 from_sys 。 由於實作可能會因廠商而異，因此您可以改用 clock_cast ，而所有程式庫廠商都會提供。

範例: to_utc

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    std::cout << clock_cast<std::chrono::utc_clock>(file_clock::now());

    return 0;
}

2021-08-17 00:20:41.2594557

is_steady

指定計時類型是否具「穩定性」。 在 Microsoft 實作中， is_steady 是 false 。 這讓這個時鐘不適合測量作業所花費的時間，因為當您計時某個專案時，可以調整不穩定的時鐘，因此測量的時間可能會關閉，甚至為負數。 high_resolution_clock請改用 to time 事件。

static const bool is_steady = false;

立即

會傳回目前系統時間的靜態方法，其解析度為 nanosecond，由 的 file_clock epoch 調整。

static time_point now() noexcept;

傳回值

time_point 物件，代表目前的時間。

另請參閱

<chrono>
gps_clock class
high_resolution_clock
local_t 結構
steady_clock 結構
system_clock 結構
tai_clock 類別
utc_clock 類別
標頭檔參考