Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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
       (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,
	  std::chrono::choose			  z)			 const
       (since 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  rep-
       resents 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  a	std::chrono::ambiguous_local_time if the conversion is
       ambiguous. Throws
	  a 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.

http://cppreference.com		  2022.07.31	  std::chrono...one::to_sys(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::chrono::time_zone::to_sys&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help