Share via

time_zone 类

  • 项目

time_zone 表示特定地理区域的时区。 它具有每个区域的时区规则的完整历史记录，因此，如果在时区的规则与今天的规则不同的情况下转换一个日期的时间，时间转换会很准确。

语法

class time_zone;  // Since C++20

备注

在时区数据库初始化期间，<chrono> 库会创建 time_zone 对象。 它提供对已创建对象的 const 访问权限。

不能构造或复制 time_zone 对象，使用默认移动构造函数或默认移动赋值运算符会导致未定义的行为。

下面是获取 time_zone 实例的方式：

const auto& timeZoneDatabase = get_tzdb(); // initialize the time zone database
const auto& currentZone = timeZoneDatabase.current_zone();

Microsoft C++ 从 Visual Studio 2019 版本 16.10 开始支持 time_zone 类。 time_zone 类是一项 C++20 功能。 /std:c++latest 编译器选项是必需的。

成员

公共成员函数和函数模板

名称 描述
get_info 获取此 time_zone 的 sys_info 或 local_info。
name 获取此 time_zone 的名称。
to_local 在此 time_zone 中将 sys_time 转换为 local_time。
to_sys 在此 time_zone 中将 local_time 转换为 sys_time。

要求

标头<chrono>：

时区数据仅适用于 Windows 10 版本 1903/19H1 及更高版本，以及 Windows Server 2022 及更高版本。

命名空间：std::chrono

get_info

函数模板 get_info 有两个重载，用于获取此 time_zone 的 sys_info 或 local_info。

template<class Duration>
sys_info get_info(const sys_time<Duration>& st) const;  // Since C++20
    
template<class Duration>
local_info get_info(const local_time<Duration>& lt) const;  // Since C++20

参数

Duration
sys_time 或 local_time 参数的 duration 类。

st
用于获得 sys_info 结果的 sys_time 时间点。

lt
用于获得 local_info 结果的 local_time 时间点。

返回值

在采用 sys_time 时间点 st 的 get_info 函数模板中，它返回一个 sys_info 对象 i，使得 st 在范围 [i.begin, i.end) 内。

在采用 local_time 时间点 lt 的 get_info 函数模板中，它返回一个 local_info 对象。

备注

Microsoft C++ 从 Visual Studio 2019 版本 16.10 开始支持 time_zone::get_info。 该函数是一项 C++20 功能，需要 /std:c++latest 编译器选项。

name

获取此 time_zone 的名称。

string_view name() const noexcept;  // Since C++20

返回值

以 string_view 形式返回时区名称。

备注

Microsoft C++ 从 Visual Studio 2019 版本 16.10 开始支持 time_zone::name。

to_local

函数模板 to_local 在此 time_zone 中将 sys_time 转换为 local_time。

template<class Duration>
local_time<common_type_t<Duration, seconds>>
to_local(const sys_time<Duration>& st) const;  // Since C++20

参数

Duration
sys_time 或 local_time 参数的 duration 类。

st
用于获得 sys_info 结果的 sys_time 时间点。

返回值

to_local 在此 time_zone 中返回与 st 关联的 local_time。

注解

Microsoft C++ 从 Visual Studio 2019 版本 16.10 开始支持 time_zone::to_local。 该函数是一项 C++20 功能，需要 /std:c++latest 编译器选项。

示例：将 sys_time 转换为 local_time

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    const auto& timeZoneDatabase = get_tzdb();
    const auto& currentZone = timeZoneDatabase.current_zone();
    local_time<system_clock::duration> lt = currentZone->to_local(system_clock::now());

    std::cout << "local_time: " << lt << "\n";
   
    return 0;
}

local_time: 2021-09-08 15:15:53.1830646

to_sys

函数模板 to_sys 有两个重载，用于在此 time_zone 中将 local_time 转换为 sys_time。

template<class Duration>
sys_time<common_type_t<Duration, seconds>>
to_sys(const local_time<Duration>& lt) const;  // Since C++20

template<class Duration>
sys_time<common_type_t<Duration, seconds>>
to_sys(const local_time<Duration>& lt, choose z) const;  // Since C++20

参数

Duration
local_time 参数的 duration 类。

lt
要转换的 local_time 时间点。

z
choose::earliest 或 choose::latest 的值。 它用于解析其他不明确的结果。

返回值

to_sys 返回的 sys_time 至少与 seconds 一样精细。 如果自变量 lt 具有更高的精度，它就会更精细。 根据此 time_zone 的规则，返回的 sys_time 是 lt 的 UTC 等效项。

如果从 lt 到 sys_time 的转换不明确，则单参数重载会引发 ambiguous_local_time 异常，如果本地时间点表示不存在的本地时间点，则会引发 nonexistent_local_time 异常。 在夏令时到标准时间的转换期间，可能会出现不明确的情况。 同一本地时间点在一天内可能会出现两个实例。 一个不存在的本地时间点表示从标准时间转换到夏令时的时间点。

在这些情况下，双参数重载不会引发异常。 如果从 lt 到 sys_time 的转换不明确，并且 z 是 choose::earliest，则 to_sys 返回前面的 sys_time，如果 z 是 choose::latest，则返回后面的 sys_time。 如果 lt 表示两个 UTC 时间点之间不存在的时间，则这两个 UTC 时间点相同，因此 to_sys 返回该 UTC 时间点。

注解

Microsoft C++ 从 Visual Studio 2019 版本 16.10 开始支持 time_zone::to_sys。 该函数是一项 C++20 功能，需要 /std:c++latest 编译器选项。

示例：将 local_time 转换为 sys_time

// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    const auto& timeZoneDatabase = get_tzdb();
    const auto& currentZone = timeZoneDatabase.current_zone();

    auto st = currentZone->to_sys(local_days{2021y/September/15d}+16h+45min, choose::earliest);

    std::cout << "sys_time: " << st << "\n";
   
    return 0;
}

sys_time: 2021-09-15 23:45:00.0000000

另请参阅

<chrono>
头文件引用