home | help 
std::chrono...one::to_sys(3)   C++ Standard Libary  std::chrono...one::to_sys(3)

NAME
     std::chrono::time_zone::to_sys - std::chrono::time_zone::to_sys

Synopsis
	template< class Duration >

	auto   to_sys(	 const	std::chrono::local_time<Duration>&  tp	)  const
     (1) (since
										     C++20)
	    -> std::chrono::sys_time<std::common_type_t<Duration,
	std::chrono::seconds>>;
	template< class Duration >

	auto	to_sys(     const     std::chrono::local_time<Duration>&     tp,
     (since
	std::chrono::choose		   z		   )		   const
     (2) C++20)

	    -> std::chrono::sys_time<std::common_type_t<Duration,
	std::chrono::seconds>>;

	Converts the local_time tp  in	this  time  zone  to  the  corresponding
     sys_time.

	1)  Throws  an	exception if the conversion is ambiguous or if tp repre-
     sents a
	nonexistent time.
	2) Resolves ambiguity according to the value of z:
	  * If z == std::chrono::choose::earliest, returns the earlier sys_time.
	  * If z == std::chrono::choose::latest, returns the later sys_time.
	If tp represents a nonexistent time between two UTC  time_points,  those
     two
	time_points will be the same, and that time_point will be returned.

Return value
	The UTC equivalent of tp according to the rules of this time zone.

Exceptions
	1) Throws:
	  * std::chrono::ambiguous_local_time if the conversion is ambiguous,
	  *  std::chrono::nonexistent_local_time  if tp represents a nonexistent
     time.

Notes
	The precision of the result is at least std::chrono::seconds,  and  will
     be finer if
	the argument has finer precision.

	Ambiguous and nonexistent local times can occur as a result of time zone
     transitions
	(such  as daylight saving time). For example, "2016-03-13 02:30:00" does
     not exist in
	the "America/New_York" time zone, while "2016-11-06  01:30:00"	in  that
     time zone can
	correspond   to  two  UTC  time  points:  2016-11-06  05:30:00	UTC  and
     2016-11-06 06:30:00
	UTC.

Example
	 This section is incomplete
	 Reason: no example

Category:
	  * Todo no example

http://cppreference.com 	   2024.06.10	    std::chrono...one::to_sys(3)
home | help