std::chrono::from_stream (std::chrono::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風格日期和時間

 

std::chrono::local_t

時間點 I/O

運算子 << (operator<<)

格式化器<std::chrono::local_time> (formatter<std::chrono::local_time>)

從流讀取 (from_stream)

 

template< class CharT, class Traits, class Duration, class Alloc = std::allocator<CharT> > std::basic_istream<CharT, Traits>&     from_stream( std::basic_istream<CharT, Traits>& is, const CharT* fmt,                  std::chrono::local_time<Duration>& tp,                  std::basic_string<CharT, Traits, Alloc>* abbrev = nullptr,                  std::chrono::minutes* offset = nullptr );		(C++20 起)

嘗試根據格式字串 fmt 將輸入流 is 解析到時間點 tp。

行為類似於 未格式化輸入函式 (UnformattedInputFunction)，但對 is.gcount() 具有未指定的效果。構造並檢查守衛物件後，嘗試根據格式字串 fmt 將輸入流 is 解析到 tp。如果解析未能解碼出有效的時間點，則呼叫 is.setstate(std::ios_base::failbit)，並且 tp 不會被修改。

如果使用了格式說明符 %Z 併成功解析，則如果 abbrev 不為 null，則將解析後的值賦給 *abbrev。如果使用了格式說明符 %z 或其修改形式併成功解析，則如果 offset 不為 null，則將解析後的值賦給 *offset。

引數

is	-	一個輸入流
fmt	-	格式字串（見下文）
tp	-	用於儲存解析結果的時間點物件
abbrev	-	如果不為 null，則指向一個物件，該物件將儲存與 %Z 說明符對應時區縮寫或名稱
offset	-	如果不為 null，則指向一個物件，該物件將儲存與 %z 說明符對應的 UTC 偏移量

格式字串

格式字串由零個或多個轉換說明符和普通字元組成。每個普通字元，除了空白字元和終止 null 字元，都與輸入流中的一個相同字元匹配，如果流中的下一個字元不相等，則導致函式失敗。

每個空白字元匹配輸入流中的零個或多個空白字元。

每個未修改的轉換說明符都以 % 字元開頭，後跟一個確定說明符行為的字元。某些轉換說明符具有修改形式，其中在 % 字元後插入一個 E 或 O 修飾符字元。某些轉換說明符具有修改形式，其中在 % 字元後插入一個寬度引數，該引數表示為正十進位制整數（如下所示為 N）。每個轉換說明符都會根據下表將匹配的字元解釋為日期和時間型別的一部分。

格式字串中以%開頭但與下面任一轉換說明符不匹配的字元序列被解釋為普通字元。

如果 from_stream 未能解析格式字串中指定的所有內容，或者解析的資訊不足以指定完整結果，或者解析顯示了矛盾的資訊，則會呼叫 is.setstate(std::ios_base::failbit)。

以下轉換說明符可用

轉換 說明符	解釋
%%	匹配字面值%字元。
%n	匹配一個空白字元。
%t	匹配零個或一個空白字元。
年
%C %NC %EC	將世紀解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。 修改後的命令%EC解釋區域設定的世紀替代表示。
%y %Ny %Ey %Oy	解析年份的最後兩位十進位制數字。如果未另外指定世紀（例如使用 %C），則範圍 [69, 99] 中的值假定指 1969 年至 1999 年，範圍 [00, 68] 中的值假定指 2000 年至 2068 年。寬度 N 指定要讀取的最大字元數。預設寬度為 2。允許但不要求前導零。 修改後的命令%Ey和%Oy解釋區域設定的替代表示。
%Y %NY %EY	將年份解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為4。允許但不要求前導零。 修改後的命令%EY解釋區域設定的替代表示。
月
%b %B %h	解析區域設定的完整或縮寫的不區分大小寫的月份名稱。
%m %Nm %Om	將月份解析為十進位制數（一月為1）。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。 修改後的命令%Om解釋區域設定的替代表示。
日
%d %Nd %Od %e %Ne %Oe	將月份中的日期解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。 修改後的命令%Od和%Oe解釋區域設定的替代表示。
星期幾
%a %A	解析區域設定的完整或縮寫的不區分大小寫的星期幾名稱。
%u %Nu	將ISO星期幾解析為十進位制數（1-7），其中星期一為1。寬度N指定要讀取的最大字元數。預設寬度為1。允許但不要求前導零。
%w %Nw %Ow	將星期幾解析為十進位制數（0-6），其中星期日為0。寬度N指定要讀取的最大字元數。預設寬度為1。允許但不要求前導零。 修改後的命令%Ow解釋區域設定的替代表示。
ISO 8601 基於周的年份
在ISO 8601中，周以星期一開始，一年的第一週必須滿足以下要求 包含1月4日 包含一年中的第一個星期四
%g %Ng	解析ISO 8601 基於周的年份的最後兩位十進位制數字。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。
%G %NG	將ISO 8601 基於周的年份解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為4。允許但不要求前導零。
%V %NV	將ISO 8601 年份中的周解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。
年份中的周/天
%j %Nj	將年份中的日期解析為十進位制數（1月1日為1）。寬度N指定要讀取的最大字元數。預設寬度為3。允許但不要求前導零。
%U %NU %OU	將年份的週數解析為十進位制數字。一年中的第一個星期日是第 01 周的第一天。該年之前的天數在第 00 周。寬度 N 指定要讀取的最大字元數。預設寬度為 2。允許但不要求前導零。 修改後的命令%OU解釋區域設定的替代表示。
%W %NW %OW	將年份的週數解析為十進位制數字。一年中的第一個星期一是第 01 周的第一天。該年之前的天數在第 00 周。寬度 N 指定要讀取的最大字元數。預設寬度為 2。允許但不要求前導零。 修改後的命令%OW解釋區域設定的替代表示。
日期
%D	等效於"%m/%d/%y"。
%F %NF	等效於"%Y-%m-%d"。如果指定了寬度，則僅應用於%Y。
%x %Ex	解析區域設定的日期表示。 修改後的命令%Ex解釋區域設定的替代日期表示。
日間時間
%H %NH %OH	將小時（24小時制）解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。 修改後的命令%OH解釋區域設定的替代表示。
%I %NI %OI	將小時（12小時制）解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。 修改後的命令%OI解釋區域設定的替代表示。
%M %NM %OM	將分鐘解析為十進位制數。寬度N指定要讀取的最大字元數。預設寬度為2。允許但不要求前導零。 修改後的命令%OM解釋區域設定的替代表示。
%S %NS %OS	將秒解析為十進位制數字。寬度 N 指定要讀取的最大字元數。如果 Duration 可轉換為 std::chrono::seconds，則預設寬度為 2，否則由 Duration 的十進位制精度確定，並將該欄位解釋為固定格式的長雙精度浮點數，小數點字元由區域設定決定（如果遇到）。允許但不要求前導零。 修改後的命令%OS解釋區域設定的替代表示。
%p	解析區域設定的12小時制時鐘相關的AM/PM指示符的等效項。
%R	等效於"%H:%M"。
%T	等效於"%H:%M:%S"。
%r	解析區域設定的12小時制時間。
%X %EX	解析區域設定的時間表示。 修改後的命令%EX解釋區域設定的替代時間表示。
雜項
%c %Ec	解析區域設定的日期和時間表示。 修改後的命令%Ec解釋區域設定的替代日期和時間表示。
%z %Ez %Oz	解析UTC偏移量，格式為[+|-]hh[mm]。例如，-0430表示比UTC晚4小時30分鐘，04表示比UTC早4小時。 修改後的命令%Ez和%Oz解析格式[+|-]h[h][:mm]（即，小時和分鐘之間需要一個:，並且小時的前導零是可選的）。
%Z	解析時區縮寫或名稱，取最長序列的字元，其中只包含 A 到 Z、a 到 z、0 到 9、-、+、_ 和 /。

返回值

is

注意

與其他時鐘的 time_point 的 from_stream 過載不同，此過載不會從解析的時間戳中減去解析出的偏移量（如果有）。

另請參閱

解析 (parse) (C++20)

從流解析 chrono 物件 (函式模板)