nonexistent_local_time 類別
嘗試將 轉換成 local_time 不存在 sys_time的 時，會擲回這個例外狀況。
語法
class nonexistent_local_time : public runtime_error; // C++20
備註
在從標準時間到春季日光節約時間的轉換期間，時鐘基本上會失去一小時。 這可能會造成混淆，因為轉換到日光節約時間是否意味著增加一小時？ 通過「向前跳動」一小時，轉換後的小時會有效移除。 請考慮紐約日光節約時間的變更，該時間發生在3月的第二個星期天淩晨2點。 上午 2 點，時鐘會轉換為日光節約時間，現在上午 3：00 讀取。 例如，如果轉換的 local_time 是上午 2：30，則該時間是在「移除」期間，因此為「不存在」。
下列範例示範不存在的時間轉換錯誤。 在此範例中，紐約的日光節約時間從上午 2：00 開始。 轉換的時間是上午 2：30。 那是在從標準時間轉換為日光節約時間而移除的一小時內。 因此， nonexistent_local_time 擲回例外狀況。
範例: nonexistent_local_time
#include <chrono>
#include <iostream>
using namespace std::chrono;
int main()
{
try
{
// The following will throw an exception because the local time being converted is during
// the hour that is "removed" when the clock advances an hour for daylight saving time.
auto zt = zoned_time{"America/New_York", local_days{Sunday[2]/March/2016} + 2h + 30min};
} catch (const nonexistent_local_time& e)
{
std::cout << e.what() << '\n';
}
return 0;
}
2016-03-13 02:30:00 is in a gap between
2016-03-13 02:00:00 EST and
2016-03-13 03:00:00 EDT which are both equivalent to
2016-03-13 07:00:00 UTC
成員
| 名稱 | 描述 |
|---|---|
| 建構函式 | nonexistent_local_time建構 。 |
what |
取得描述不存在時間的字串。 |
需求
標頭： <chrono> （自C++20起）
命名空間：std::chrono
編譯程序選項： /std:c++latest
建構函式
建構 nonexistent_local_time。
template<class Duration>
nonexistent_local_time(const local_time<Duration>& tp, const local_info& i);
參數
tp
轉換失敗的local_time。
i
嘗試轉換的相關信息。 如需詳細資訊，請參閱 local_info。
備註
您通常不會建立此例外狀況。 它會由將轉換成 local_time sys_time的函式擲回。
what
取得字串，描述時間不存在的原因。
[[nodiscard]] virtual const char* what() const noexcept;
傳回值
字串，描述時間不存在的原因。 例如：
2016-03-13 02:30:00 is in a gap between
2016-03-13 02:00:00 EST and
2016-03-13 03:00:00 EDT which are both equivalent to
2016-03-13 07:00:00 UTC