std::chrono::nonexistent_local_time

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

日期和時間庫

時間點 時間點 (time_point) (C++11) 時鐘時間轉換 (clock_time_conversion) (C++20)   時鐘轉換 (clock_cast) (C++20) 時長 持續時間 (duration) (C++11) 時鐘 系統時鐘 (system_clock) (C++11) 穩態時鐘 (steady_clock) (C++11) 是時鐘 (is_clock) (C++20) UTC時鐘 (utc_clock) (C++20) TAI時鐘 (tai_clock) (C++20) 高精度時鐘 (high_resolution_clock) (C++11) GPS時鐘 (gps_clock) (C++20) 檔案時鐘 (file_clock) (C++20) 本地時間 (local_t) (C++20) 日間時間 是上午 (is_am)是下午 (is_pm) (C++20)(C++20) 生成12小時制 (make12)生成24小時制 (make24) (C++20)(C++20) 時分秒 (hh_mm_ss) (C++20)

日曆 日 (day) (C++20) 月 (month) (C++20) 年 (year) (C++20) 星期 (weekday) (C++20) 運算子/ (operator/) (C++20) 年月日 (year_month_day) (C++20) 年月日_最後 (year_month_day_last) (C++20) 年月星期 (year_month_weekday) (C++20) 年月星期_最後 (year_month_weekday_last) (C++20)   帶索引的星期 (weekday_indexed) (C++20) 最後一個星期 (weekday_last) (C++20) 月日 (month_day) (C++20) 月日_最後 (month_day_last) (C++20) 月星期 (month_weekday) (C++20) 月星期_最後 (month_weekday_last) (C++20) 年月 (year_month) (C++20) 最後指定 (last_spec)最後 (last) (C++20)(C++20) chrono I/O 解析 (parse) (C++20)

時區 時區資料庫 (tzdb) (C++20) 時區資料庫列表 (tzdb_list) (C++20) 獲取時區資料庫 (get_tzdb)獲取時區資料庫列表 (get_tzdb_list)重新載入時區資料庫 (reload_tzdb)遠端版本 (remote_version) (C++20)(C++20)(C++20)(C++20) 系統資訊 (sys_info) (C++20) 本地資訊 (local_info) (C++20) 不存在的本地時間 (nonexistent_local_time) (C++20) 模稜兩可的本地時間 (ambiguous_local_time) (C++20) 定位時區 (locate_zone) (C++20) 當前時區 (current_zone) (C++20) 時區 (time_zone) (C++20) 選擇 (choose) (C++20) 帶時區的特性 (zoned_traits) (C++20) 帶時區的時間 (zoned_time) (C++20) 時區連結 (time_zone_link) (C++20) 閏秒 (leap_second) (C++20) 閏秒資訊 (leap_second_info) (C++20) 獲取閏秒資訊 (get_leap_second_info) (C++20) C風格日期和時間

 

定義於標頭檔案 <chrono>
class nonexistent_local_time;		(C++20 起)

定義一種物件型別，當嘗試將不存在的 std::chrono::local_time 轉換為 std::chrono::sys_time 而未指定 std::chrono::choose (例如 choose::earliest 或 choose::latest) 時，作為異常丟擲。

此異常由 std::chrono::time_zone::to_sys 以及呼叫它的函式（例如接受 std::chrono::local_time 的 std::chrono::zoned_time 的建構函式）丟擲。

繼承圖

成員函式

(建構函式)	構造異常物件 (公開成員函式)
運算子= (operator=)	替換異常物件 (公開成員函式)
what	返回解釋字串 (公開成員函式)

std::chrono::nonexistent_local_time::nonexistent_local_time

template< class Duration > nonexistent_local_time( const std::chrono::local_time<Duration>& tp,                         const std::chrono::local_info& i );	(1)	(C++20 起)
nonexistent_local_time( const nonexistent_local_time& other ) noexcept;	(2)	(C++20 起)

構造異常物件。

1) what() 返回的解釋性字串等同於以下程式碼產生的 os.str()：

std::ostringstream os;
os << tp << " is in a gap between\n"
   << std::chrono::local_seconds(i.first.end.time_since_epoch()) + i.first.offset
   << ' ' << i.first.abbrev << " and\n"
   << std::chrono::local_seconds(i.second.begin.time_since_epoch()) + i.second.offset
   << ' ' << i.second.abbrev
   << " which are both equivalent to\n"
   << i.first.end << " UTC";

如果 i.result != std::chrono::local_info::nonexistent，則行為未定義。

2) 複製建構函式。如果 *this 和 other 都具有動態型別 std::chrono::nonexistent_local_time，則 std::strcmp(what(), other.what()) == 0。

引數

tp	-	嘗試轉換的時間點
i	-	描述轉換嘗試結果的 std::chrono::local_info
其他	-	另一個 nonexistent_local_time 物件，用於複製

異常

可能丟擲 std::bad_alloc

注意

由於複製標準庫中派生自 std::exception 的類不允許丟擲異常，因此此訊息通常在內部儲存為單獨分配的引用計數字符串。

std::chrono::nonexistent_locale_time::operator=

nonexistent_locale_time& operator=( const nonexistent_locale_time& other ) noexcept;		(C++20 起)

將內容賦值為 other 的內容。如果 *this 和 other 都具有動態型別 std::chrono::nonexistent_locale_time，則賦值後 std::strcmp(what(), other.what()) == 0。

引數

其他

-

用於賦值的另一個異常物件

返回值

*this

std::chrono::nonexistent_locale_time::what

virtual const char* what() const noexcept;		(C++20 起)

返回解釋字串。

返回值

指向一個實現定義的以空字元結尾的字串，其中包含解釋性資訊。該字串適合轉換為 std::wstring 並顯示。該指標保證在獲取它的異常物件被銷燬之前，或在異常物件上的非 const 成員函式（例如複製賦值運算子）被呼叫之前有效。

在常量求值期間，返回的字串使用普通字面量編碼進行編碼。

(C++26 起)

注意

允許但不要求實現重寫 what()。

繼承自 std::runtime_error

繼承自 std::exception

成員函式

(解構函式) [虛擬函式]	銷燬異常物件 (std::exception 的虛公共成員函式)
what [虛擬函式]	返回解釋字串 (std::exception 的虛公共成員函式)

參閱

模稜兩可的本地時間 (ambiguous_local_time) (C++20)

報告本地時間模糊時丟擲的異常 (類)