reload_tzdb.md

reload_tzdb

• chrono[meta header]
• std::chrono[meta namespace]
• function[meta id-type]
• cpp20[meta cpp]

namespace std::chrono {
  const tzdb& reload_tzdb();
}

• tzdb[link tzdb.md]

概要

リモートタイムゾーンデータベースを再読込する。

この関数は、IANAのタイムゾーンデータベースをダウンロードし、get_tzdb()関数で取得できるローカルのタイムゾーンデータベースを、スレッドセーフに最新バージョンへと更新する。

IANAのタイムゾーンデータベースは、毎月もしくは季節ごとに更新される。長期間動かすプログラムの場合は、タイムゾーンデータベースが更新されることを想定する必要がある。std::chrono::remote_version()関数を呼び出すことでダウンロード先にあるタイムゾーンデータベースの最新バージョンがいくつなのかを取得できる。それとローカルのバージョンを比較してタイムゾーンデータベースを更新することになる。

// 10日に一度などの周期で以下の処理を実行する
if (get_tzdb().version != remote_version()) {
  reload_tzdb(); // get_tzdb()で取得されるタイムゾーンデータベースを更新する
}

• get_tzdb()[link get_tzdb.md]
• remote_version()[link remote_version.md]

効果

• リモートタイムゾーンデータベースのバージョンを確認する。ローカルで保持しているタイムゾーンデータベースとバージョンが同じである場合、なにもしない
• そうでない場合、リモートタイムゾーンデータベースをダウンロードし、get_tzdb_list()関数で取得できるタイムゾーンデータベースリストの先頭要素の前に、リモートタイムゾーンデータベースを挿入する

戻り値

return get_tzdb_list().front();

• get_tzdb_list()[ink get_tzdb_list.md]
• front()[link tzdb_list/front.md]

例外

なんからの理由で有効なタイムゾーンデータベースを参照できない場合、この関数はruntime_error例外を送出する。

備考

• この関数によるget_tzdb_list().front()とget_tzdb_list().erase_after()の呼び出しはスレッドセーフに行われる
• IANAのタイムゾーンデータベースは、以下からダウンロードできる：
  • Time Zone Database - IANA

例

#include <iostream>
#include <chrono>

namespace chrono = std::chrono;

int main()
{
  // ローカルのタイムゾーンデータベースが古かったら更新する
  if (chrono::get_tzdb().version != chrono::remote_version()) {
    chrono::reload_tzdb();
  }
  std::cout << chrono::get_tzdb().version << std::endl;
}

• chrono::reload_tzdb()[color ff0000]
• chrono::get_tzdb()[link get_tzdb.md]
• chrono::remote_version()[link remote_version.md]

出力例

2019c

バージョン

言語

• C++20

処理系

• Clang: (9.0時点で実装なし)
• GCC: (9.2時点で実装なし)
• Visual C++: (2019 Update 3時点で実装なし)