std::chrono::zoned_time::zoned_time

C++

Language

Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

Utilities library

Type support (basic types, RTTI, type traits)
Dynamic memory management
Error handling
Program utilities
Variadic functions
Library feature-test macros
Date and time
Function objects
initializer_list (C++11)
bitset
hash (C++11)
integer_sequence (C++14)
Relational operators (deprecated)
rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=
Comparisons (C++20)
strong_order weak_order partial_order strong_equal weak_equal	strong_ordering weak_ordering partial_ordering strong_equality weak_equality	is_eqis_neqis_ltis_lteqis_gtis_gteq
common_comparison_category
Common vocabulary types
pair tuple (C++11) apply (C++17) make_from_tuple (C++17)	optional (C++17) any (C++17) variant (C++17)
Swap, forward and move
swap
exchange (C++14)
forward (C++11)
move (C++11)
move_if_noexcept (C++11)
Elementary string conversions
to_chars (C++17)
from_chars (C++17)
chars_format (C++17)
Type operations
declval (C++11)
as_const (C++17)

Date and time utilities

duration (C++11) time_point (C++11) time_of_day (C++20)	clock_time_conversion (C++20) clock_cast (C++20)
Clocks
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11) is_clock (C++20)	utc_clock (C++20) tai_clock (C++20) gps_clock (C++20) file_clock (C++20) local_t (C++20)
Calendars
day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)	weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20)
Time zones
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20)	time_zone (C++20) locate_zone (C++20) current_zone (C++20) zoned_time (C++20) link (C++20) leap (C++20)
C-style date and time

std::chrono::zoned_time

Member functions

zoned_time::zoned_time

zoned_time::operator=

zoned_time::get_time_zone

zoned_time::get_sys_timezoned_time::operator sys_time

zoned_time::get_local_timezoned_time::operator local_time

zoned_time::get_info

Nonmember functions

operator==operator!=

operator<<

to_stream

Deduction guides

zoned_time();	(1)	(since C++20)
zoned_time(const std::chrono::sys_time<Duration>& st);	(2)	(since C++20)
zoned_time(const zoned_time& other) = default;	(3)	(since C++20)
template< class Duration2 > zoned_time(const std::chrono::zoned_time<Duration2, TimeZonePtr>& other);	(4)	(since C++20)
explicit zoned_time(TimeZonePtr z);	(5)	(since C++20)
explicit zoned_time(std::string_view name);	(6)	(since C++20)
zoned_time(TimeZonePtr z, const std::chrono::sys_time<Duration>& st);	(7)	(since C++20)
zoned_time(std::string_view name, const std::chrono::sys_time<Duration>& st);	(8)	(since C++20)
zoned_time(TimeZonePtr z, const std::chrono::local_time<Duration>& tp);	(9)	(since C++20)
zoned_time(std::string_view name, const std::chrono::local_time<Duration>& tp);	(10)	(since C++20)
zoned_time(TimeZonePtr z, const std::chrono::local_time<Duration>& tp, std::chrono::choose c);	(11)	(since C++20)
zoned_time(std::string_view name, const std::chrono::local_time<Duration>& tp, std::chrono::choose c);	(12)	(since C++20)
template< class Duration2, class TimeZonePtr2 > zoned_time(TimeZonePtr z, const std::chrono::zoned_time<Duration2, TimeZonePtr2>& zt);	(13)	(since C++20)
template< class Duration2, class TimeZonePtr2 > zoned_time(TimeZonePtr z, const std::chrono::zoned_time<Duration2, TimeZonePtr2>& zt, choose);	(14)	(since C++20)
template< class Duration2, class TimeZonePtr2 > zoned_time(std::string_view name, const std::chrono::zoned_time<Duration2, TimeZonePtr2>& zt);	(15)	(since C++20)
template< class Duration2, class TimeZonePtr2 > zoned_time(std::string_view name, const std::chrono::zoned_time<Duration2, TimeZonePtr2>& zt, choose);	(16)	(since C++20)

Constructs a zoned_time object, initializing the stored time zone pointer and time point according to the following table, where traits is std::chrono::zoned_traits<TimeZonePtr>:

Overload	Time zone pointer (denoted zone)	Time point (a std::chrono::sys_time<duration>)	Notes
(1)	traits::default_zone()	default constructed	(a)
(2)		st
(3)	other.get_time_zone()	other.get_sys_time()	(b)
(4)	other.get_time_zone()	other.get_sys_time()	(e)
(5)	std::move(z)	default constructed
(6)	traits::locate_zone(name)		(c)
(7)	std::move(z)	st
(8)	traits::locate_zone(name)		(c)
(9)	std::move(z)	zone->to_sys(tp)	(d)
(10)	traits::locate_zone(name)		(c,d)
(11)	std::move(z)	zone->to_sys(tp, c)	(d)
(12)	traits::locate_zone(name)		(c,d)
(13-14)	std::move(z)	zt.get_sys_time()	(e)
(15-16)	traits::locate_zone(name)		(c,e)

a) Constructors specified to call traits::default_zone() (1-2) do not participate in overload resolution if that expression is not well-formed.

b) The defaulted copy constructor (3) is defined as deleted if std::is_copy_constructible_v<TimeZonePtr> is false.

c) Constructors with a std::string_view parameter name (6,8,10,12,15-16) do not participate in overload resolution if traits::locate_zone(name) is not well-formed or if that expression is not convertible to TimeZonePtr.

d) Constructors specified to call zone->to_sys (9-12) do not participate in overload resolution if that call expression is not well-formed or if the result is not convertible to std::chrono::sys_time<duration>.

e) Constructors with a template parameter Duration2 (4,13-16) do not participate in overload resolution if Duration2 is not convertible to Duration.

The behavior is undefined if the time zone pointer (initialized as described above) does not refer to a time zone.

Notes

zoned_time does not have a move constructor and attempting to move one will perform a copy instead using the defaulted copy constructor (3). Thus, when TimeZonePtr is a move-only type, zoned_time is immovable: it can be neither moved nor copied.

The constructors (14,16) accept a std::chrono::choose parameter, but that parameter has no effect.