5. get_date

最終更新日時:
が更新

履歴 編集

function
<locale>

std::time_get::get_date

iter_type get_date(iter_type s, iter_type end, ios_base& str,
                  ios_base::iostate& err, tm* t) const; // (1) C++98

概要

入力イテレータ範囲[s, end)から日付を解析する。解析結果は*tの対応するメンバへ格納される。

戻り値

do_get_date(s, end, str, err, t)

例

#include <iostream>
#include <sstream>
#include <locale>
#include <iterator>
#include <ctime>
#include <stdexcept>

int main()
{
  const char* names[] = {"C", "en_US.UTF-8", "ja_JP.UTF-8", "de_DE.UTF-8"};

  // 各ロケールでの日付の書式
  const char* texts[] = {"08/25/26", "08/25/2026", "2026/08/25", "25.08.2026"};

  for (int i = 0; i < 4; ++i) {
    try {
      std::istringstream iss{texts[i]};
      iss.imbue(std::locale{names[i]});

      const auto& facet = std::use_facet<std::time_get<char>>(iss.getloc());

      std::tm t{};
      std::ios_base::iostate err = std::ios_base::goodbit;

      facet.get_date(std::istreambuf_iterator<char>{iss},
                     std::istreambuf_iterator<char>{},
                     iss, err, &t);

      std::cout << names[i] << " : " << texts[i] << " -> " << (t.tm_year + 1900) << '/' << (t.tm_mon + 1) << '/' << t.tm_mday << std::endl;
    }
    catch (const std::runtime_error&) {
      // 指定した名前のロケールが利用できない場合
      std::cout << names[i] << " : not available" << std::endl;
    }
  }
}

出力例

C : 08/25/26 -> 2026/8/25
en_US.UTF-8 : 08/25/2026 -> 2026/8/25
ja_JP.UTF-8 : 2026/08/25 -> 2026/8/25
de_DE.UTF-8 : 25.08.2026 -> 2026/8/25

  • 解析される日付の要素の並び順はdate_order()が返す値によって決まり、米国では月・日・年、日本では年・月・日、ドイツでは日・月・年となる
  • 妥当なロケール名は処理系定義である。指定した名前のロケールが利用できない場合、std::localeのコンストラクタはstd::runtime_errorを送出し、上記の例ではnot availableが出力される

バージョン

言語

  • C++98

関連項目