namespace std::chrono {
  template <class charT, class traits, class Alloc, class Parsable>
  unspecified
    parse(const std::basic_string<charT, traits, Alloc>& fmt,
          Parsable& tp);                                      // (1) C++20

  template <class charT, class traits, class Alloc, class Parsable>
  unspecified
    parse(const std::basic_string<charT, traits, Alloc>& fmt,
          Parsable& tp,
          std::basic_string<charT, traits, Alloc>& abbrev);   // (2) C++20

  template <class charT, class traits, class Alloc, class Parsable>
  unspecified
    parse(const std::basic_string<charT, traits, Alloc>& fmt,
          Parsable& tp,
          minutes& offset);                                   // (3) C++20

  template <class charT, class traits, class Alloc, class Parsable>
  unspecified
    parse(const std::basic_string<charT, traits, Alloc>& fmt,
          Parsable& tp,
          std::basic_string<charT, traits, Alloc>& abbrev,
          minutes& offset);                                   // (4) C++20
}

概要

日時文字列を解析する入力マニピュレータ。

• (1) タイムゾーン関係の入力を受け取らない単純な解析を行う
• (2) chronoオブジェクトと、タイムゾーンの略称を解析する
• (3) chronoオブジェクトと、UTCタイムゾーンからのオフセット時間を解析する
• (4) chronoオブジェクトと、タイムゾーンの略称、UTCタイムゾーンからのオフセット時間を解析する

fmtパラメータに指定できるフォーマットフラグは、以下である。Nとして10進整数を指定できる場合があり、それを指定することでより多くの文字数を読み込める。

テンプレートパラメータ制約

• (1) : from_stream(declval<basic_istream<charT, traits>&>(), fmt.c_str(), tp)が評価されないオペランドとして扱われた場合に適格な式であること
• (2) : from_stream(declval<basic_istream<charT, traits>&>(), fmt.c_str(), tp, addressof(abbrev))が評価されないオペランドとして扱われた場合に適格な式であること
• (3) : 式from_stream(declval<basic_istream<charT, traits>&>(), fmt.c_str(), tp, declval<basic_string<charT, traits, Alloc>*>(), &offset)が評価されないオペランドとして扱われた場合に適格な式であること
• (4) : from_stream(declval<basic_istream<charT, traits>&>(), fmt.c_str(), tp, addressof(abbrev), &offset)が評価されないオペランドとして扱われた場合に適格な式であること

戻り値

• (1) : このマニピュレータは、basic_istream<charT, traits>型オブジェクトisに対してfrom_stream(is, fmt.c_str(), tp)を呼び出した結果のisを返す
• (2) : このマニピュレータは、basic_istream<charT, traits>型オブジェクトisに対してfrom_stream(is, fmt.c_str(), tp, addressof(abbrev))を呼び出した結果のisを返す
• (3) : このマニピュレータは、basic_istream<charT, traits>型オブジェクトisに対してfrom_stream(is, fmt.c_str(), tp, static_cast<basic_string<charT, traits, Alloc>*>(nullptr), &offset)を呼び出した結果のisを返す
• (4) : このマニピュレータは、basic_istream<charT, traits>型オブジェクトisに対してfrom_stream(is, fmt.c_str(), tp, addressof(abbrev), &offset)を呼び出した結果のisを返す

以下、オーバーロード全体について、

• これらの関数をADL (引数依存の名前探索、argument dependent lookup) で呼び出すために、from_streamを修飾せずに呼び出している
• これらの関数は書式化されていない入力関数として動作するが (std::boolalpha, std::quotedなどの影響を受けない)、後続で呼び出されたstd::basic_istream<>::gcount()の戻り値に未規定の影響がある
• 概要欄に示したフォーマットフラグに含まれておらず、スペースを除くフォーマット文字列のすべての文字は、ストリームから変更されずに解析される
• スペース文字は、入力ストリーム内の「ゼロ個以上のスペース文字」と合致する
• 解析するtpの型が、フォーマットフラグの情報を表現できない場合、is.setstate(ios_base::failbit)が呼び出される
  • 例として、durationはweekdayを表現できない
  • ただし、フォーマットフラグが時刻を表すものである場合 ("%H", "%I", "%p"など)、durationの特殊化は、その日の深夜0時からの経過時間だと見なして読み込む
• フォーマット文字列で指定されたいずれの解析にも失敗した場合、もしくは完全なduration、時間点、カレンダーデータ構造を指定するために十分な情報が解析されなかった場合、is.setstate(ios_base::failbit)が呼び出される

例

#include <iostream>
#include <sstream>
#include <chrono>
#include <string>

namespace chrono = std::chrono;

int main()
{
  // タイムゾーン情報を含まない日時の解析
  {
    std::stringstream ss;
    ss << "2019-10-24 20:15:10";

    chrono::sys_seconds tp;
    ss >> chrono::parse("%Y-%m-%d %H:%M:%S", tp);

    if (ss) {
      std::cout << tp << std::endl;
    }
    else {
      std::cout << "解析失敗" << std::endl;
    }
  }

  // タイムゾーン情報を含む日時の解析
  {
    std::stringstream ss;
    ss << "2019-10-24 20:15:10 JST +0900";

    chrono::sys_seconds tp;
    std::string abbrev;
    chrono::minutes offset;
    ss >> chrono::parse("%Y-%m-%d %H:%M:%S %Z %z", tp, abbrev, offset);

    if (ss) {
      std::cout << tp << std::endl;
      std::cout << abbrev << std::endl;
      std::cout << chrono::floor<chrono::hours>(offset) << std::endl;
    }
    else {
      std::cout << "解析失敗" << std::endl;
    }
  }
}

出力

2019-10-24 20:15:10
2019-10-24 11:15:10
JST
9h

バージョン

言語

• C++20

処理系

• Clang: 9.0 ❌
• GCC: 9.2 ❌, 15.1 ✅
• Visual C++: 2019 Update 3 ❌

参照

• LWG Issue 3131. addressof all the things
• LWG Issue 3218. Modifier for %d parse flag does not match POSIX and format specification
• LWG Issue 3235. parse manipulator without abbreviation is not callable
• LWG Issue 3245. Unnecessary restriction on '%p' parse specifier
• LWG Issue 3269. Parse manipulators do not specify the result of the extraction from stream
• LWG Issue 3270. Parsing and formatting %j with durations
• LWG Issue 3272. %I%p should parse/format duration since midnight
• LWG Issue 3831. Two-digit formatting of negative year is ambiguous
  • C++26で、%yが年の符号によらず年のうしろ2桁を表すことが明確化された
• LWG Issue 3956. chrono::parse uses from_stream as a customization point
  • C++26で、from_streamが実引数依存の名前探索（ADL）で解決されるカスタマイゼーションポイントであることが、ライブラリ全体の一般規定に明記された