29 Time library [time]

29.11 Time zones [time.zone]

29.11.5 Class time_zone [time.zone.timezone]

29.11.5.2 Member functions [time.zone.members]

string_view name() const noexcept;

Returns: The name of the time_zone.

[Example 1:

"America/New_York".

— end example]

🔗

template<class Duration>
  sys_info get_info(const sys_time<Duration>& st) const;

Returns: A sys_info i for which st is in the range [i.begin, i.end).

🔗

template<class Duration>
  local_info get_info(const local_time<Duration>& tp) const;

Returns: A local_info for tp.

🔗

template<class Duration>
  sys_time<common_type_t<Duration, seconds>>
    to_sys(const local_time<Duration>& tp) const;

Returns: A sys_time that is at least as fine as seconds, and will be finer if the argument tp has finer precision.

This sys_time is the UTC equivalent of tp according to the rules of this time_zone.

Throws: If the conversion from tp to a sys_time is ambiguous, throws ambiguous_local_time.

If the tp represents a non-existent time between two UTC time_points, throws nonexistent_local_time.

🔗

template<class Duration>
  sys_time<common_type_t<Duration, seconds>>
    to_sys(const local_time<Duration>& tp, choose z) const;

Returns: A sys_time that is at least as fine as seconds, and will be finer if the argument tp has finer precision.

This sys_time is the UTC equivalent of tp according to the rules of this time_zone.

If the conversion from tp to a sys_time is ambiguous, returns the earlier sys_time if z == choose::earliest, and returns the later sys_time if z == choose::latest.

If the tp represents a non-existent time between two UTC time_points, then the two UTC time_points will be the same, and that UTC time_point will be returned.

🔗

template<class Duration>
  local_time<common_type_t<Duration, seconds>>
    to_local(const sys_time<Duration>& tp) const;

Returns: The local_time associated with tp and this time_zone.