Namespaces
Variants

std::chrono:: zoned_time

From cppreference.net
C++
Date and time library
std::chrono::zoned_time
헤더 파일에 정의됨 <chrono>
template <

class Duration,
class TimeZonePtr = const std:: chrono :: time_zone *

> class zoned_time ;
(C++20부터)
using zoned_seconds = std :: chrono :: zoned_time < std:: chrono :: seconds > ;
(C++20부터)

zoned_time 클래스는 시간대와 std::chrono::time_point 의 논리적 쌍을 나타내며, 그 해상도는 Duration 입니다.

zoned_time 의 불변 조건은 항상 유효한 시간대를 참조하며 해당 시간대에서 존재하고 명확한 시간 지점을 나타낸다는 것입니다. 이 불변 조건과 일관되게, zoned_time 은 이동 생성자나 이동 할당 연산자를 가지지 않습니다; zoned_time 을 이동하려는 시도는 복사를 수행합니다.

프로그램은 Duration 이 std::chrono::duration 의 특수화(specialization)가 아닌 경우 잘못된 형식(ill-formed)입니다.

템플릿 매개변수 TimeZonePtr 를 통해 사용자는 자신만의 시간대 포인터 타입을 제공하고 std::chrono::zoned_traits 를 통해 zoned_time 의 동작을 추가로 사용자 정의할 수 있습니다. 사용자 정의 시간대 타입은 std::chrono::time_zone 이 지원하는 모든 연산을 지원할 필요가 없으며, 실제로 zoned_time 에서 호출되는 함수들에서 사용되는 연산만 지원하면 됩니다.

TimeZonePtr 는 MoveConstructible 해야 합니다. Move-only TimeZonePtr 는 허용되지만 사용하기 어렵습니다. 왜냐하면 zoned_time 이 이동 불가능하게 되고 저장된 TimeZonePtr 에 접근하는 것이 불가능하기 때문입니다.

목차

멤버 타입

멤버 타입 정의
duration std:: common_type_t < Duration, std:: chrono :: seconds >

멤버 함수

zoned_time 를 생성합니다
(public member function)
zoned_time 에 값을 할당합니다
(public member function)
시간대 포인터의 복사본을 얻습니다
(public member function)
저장된 시간 포인트를 local_time 으로 얻습니다
(public member function)
저장된 시간 포인트를 sys_time 으로 얻습니다
(public member function)
저장된 시간 포인트에서 시간대 정보를 얻습니다
(public member function)

비멤버 함수

(C++20)
두 zoned_time 값을 비교
(함수 템플릿)
(C++20)
스트림에 zoned_time 출력
(함수 템플릿)

헬퍼 클래스

(C++20)
zoned_time 에 대한 포맷팅 지원
(클래스 템플릿 특수화)
(C++26)
std::chrono::zoned_time 에 대한 해시 지원
(클래스 템플릿 특수화)

헬퍼 특수화

template < class Duration >

constexpr bool enable_nonlocking_formatter_optimization

< chrono :: zoned_time < Duration, const chrono :: time_zone * >> = true ;
(C++23부터)

이 특수화는 std::enable_nonlocking_formatter_optimization 를 통해 std::print 및 std::println 이 chrono::zoned_time 객체를 출력하기 위한 효율적인 구현을 가능하게 합니다.

추론 가이드

예제

이 코드 실행 
#include <algorithm>
#include <chrono>
#include <iomanip>
#include <iostream>
#include <stdexcept>
#include <string_view>
int main()
{
    constexpr std::string_view locations[] =
    {
        "Africa/Casablanca",   "America/Argentina/Buenos_Aires",
        "America/Barbados",    "America/Indiana/Petersburg",
        "America/Tarasco_Bar", "Antarctica/Casey",
        "Antarctica/Vostok",   "Asia/Magadan",
        "Asia/Manila",         "Asia/Shanghai",
        "Asia/Tokyo",          "Atlantic/Bermuda",
        "Australia/Darwin",    "Europe/Isle_of_Man",
        "Europe/Laputa",       "Indian/Christmas",
        "Indian/Cocos",        "Pacific/Galapagos",
    };
    constexpr auto width = std::ranges::max_element(locations, {},
        [](const auto& s){ return s.length(); })->length();
    for (const auto location : locations)
        try
        {
            // 'location'이 시간대 데이터베이스에 없으면 예외를 발생시킬 수 있음
            const std::chrono::zoned_time zt{location, std::chrono::system_clock::now()};
            std::cout << std::setw(width) << location << " - 지역 시간: " << zt << '\n';
        }
        catch (std::runtime_error& ex)
        {
            std::cout << "오류: " << ex.what() << '\n';
        }
}

가능한 출력: 

             Africa/Casablanca - 지역 시간: 2023-06-29 20:58:34.697449319 +01
America/Argentina/Buenos_Aires - 지역 시간: 2023-06-29 16:58:34.709957354 -03
              America/Barbados - 지역 시간: 2023-06-29 15:58:34.709977888 AST
    America/Indiana/Petersburg - 지역 시간: 2023-06-29 15:58:34.709998072 EDT
오류: tzdb: cannot locate zone: America/Tarasco_Bar
              Antarctica/Casey - 지역 시간: 2023-06-30 06:58:34.710093685 +11
             Antarctica/Vostok - 지역 시간: 2023-06-30 01:58:34.710107932 +06
                  Asia/Magadan - 지역 시간: 2023-06-30 06:58:34.710121831 +11
                   Asia/Manila - 지역 시간: 2023-06-30 03:58:34.710134751 PST
                 Asia/Shanghai - 지역 시간: 2023-06-30 03:58:34.710153259 CST
                    Asia/Tokyo - 지역 시간: 2023-06-30 04:58:34.710172815 JST
              Atlantic/Bermuda - 지역 시간: 2023-06-29 16:58:34.710191043 ADT
              Australia/Darwin - 지역 시간: 2023-06-30 05:28:34.710236720 ACST
            Europe/Isle_of_Man - 지역 시간: 2023-06-29 20:58:34.710256834 BST
오류: tzdb: cannot locate zone: Europe/Laputa
              Indian/Christmas - 지역 시간: 2023-06-30 02:58:34.710360409 +07
                  Indian/Cocos - 지역 시간: 2023-06-30 02:28:34.710377520 +0630
             Pacific/Galapagos - 지역 시간: 2023-06-29 13:58:34.710389952 -06

참고 항목

(C++20)
시간대를 나타냄
(클래스)