operator==,!=,<,<=,>,>=,<=>(std::chrono::time_point)

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Technical specifications

Symbols index

External libraries

 

Utilities library

Language support Type support (basic types, RTTI) Library feature-test macros (C++20) Dynamic memory management Program utilities Coroutine support (C++20) Variadic functions is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Three-way comparison (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)    is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

General utilities Date and time Function objects Formatting library (C++20) bitset hash (C++11) Relational operators (deprecated in C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Integer comparison functions cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)    cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap and type operations swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Common vocabulary types pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Elementary string conversions to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

Date and time utilities

Time point
time_point (C++11)	clock_time_conversion (C++20)	clock_cast (C++20)
Duration
duration (C++11)
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)
Time of day
is_amis_pm (C++20)(C++20)	make12make24 (C++20)(C++20)	hh_mm_ss (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) last_speclast (C++20)(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) sys_info (C++20)	local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20)	zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20)
chrono I/O
parse (C++20)
C-style date and time

 

std::chrono::time_point

Member functions

time_point::time_point

time_point::time_since_epoch

time_point::operator+time_point::operator-

time_point::operator++time_point::operator-- (C++20)(C++20)

time_point::min

time_point::max

Non-member functions

operator+operator-

operator==operator!=operator<operator<=operator>operator>=operator<=> (until C++20)(C++20)

time_point_cast

floor (C++17)

ceil (C++17)

round (C++17)

Helper classes

common_type

 

Defined in header <chrono>
	(1)
template< class Clock, class Dur1, class Dur2 > bool operator==( const std::chrono::time_point<Clock,Dur1>& lhs,                  const std::chrono::time_point<Clock,Dur2>& rhs );			(since C++11) (until C++14)
template< class Clock, class Dur1, class Dur2 > constexpr bool operator==( const std::chrono::time_point<Clock,Dur1>& lhs,                            const std::chrono::time_point<Clock,Dur2>& rhs );			(since C++14)
		(2)
template< class Clock, class Dur1, class Dur2 > bool operator!=( const std::chrono::time_point<Clock,Dur1>& lhs,                  const std::chrono::time_point<Clock,Dur2>& rhs );				(since C++11) (until C++14)
template< class Clock, class Dur1, class Dur2 > constexpr bool operator!=( const std::chrono::time_point<Clock,Dur1>& lhs,                            const std::chrono::time_point<Clock,Dur2>& rhs );				(since C++14) (until C++20)
			(3)
template< class Clock, class Dur1, class Dur2 > bool operator<( const std::chrono::time_point<Clock,Dur1>& lhs,                 const std::chrono::time_point<Clock,Dur2>& rhs );					(since C++11) (until C++14)
template< class Clock, class Dur1, class Dur2 > constexpr bool operator<( const std::chrono::time_point<Clock,Dur1>& lhs,                           const std::chrono::time_point<Clock,Dur2>& rhs );					(since C++14)
				(4)
template< class Clock, class Dur1, class Dur2 > bool operator<=( const std::chrono::time_point<Clock,Dur1>& lhs,                  const std::chrono::time_point<Clock,Dur2>& rhs );						(since C++11) (until C++14)
template< class Clock, class Dur1, class Dur2 > constexpr bool operator<=( const std::chrono::time_point<Clock,Dur1>& lhs,                            const std::chrono::time_point<Clock,Dur2>& rhs );						(since C++14)
					(5)
template< class Clock, class Dur1, class Dur2 > bool operator>( const std::chrono::time_point<Clock,Dur1>& lhs,                 const std::chrono::time_point<Clock,Dur2>& rhs );							(since C++11) (until C++14)
template< class Clock, class Dur1, class Dur2 > constexpr bool operator>( const std::chrono::time_point<Clock,Dur1>& lhs,                           const std::chrono::time_point<Clock,Dur2>& rhs );							(since C++14)
						(6)
template< class Clock, class Dur1, class Dur2 > bool operator>=( const std::chrono::time_point<Clock,Dur1>& lhs,                  const std::chrono::time_point<Clock,Dur2>& rhs );								(since C++11) (until C++14)
template< class Clock, class Dur1, class Dur2 > constexpr bool operator>=( const std::chrono::time_point<Clock,Dur1>& lhs,                            const std::chrono::time_point<Clock,Dur2>& rhs );								(since C++14)
template<class Clock, class Dur1, std::three_way_comparable_with<Dur1> Dur2> constexpr auto operator<=>( const std::chrono::time_point<Clock,Dur1>& lhs,                             const std::chrono::time_point<Clock,Dur2>& rhs );							(7)	(since C++20)

Compares two time points. The comparison is done by comparing the results time_since_epoch() for the time points.

1-2) Checks if the time points lhs and rhs refer to the same time point for the given clock.

3-6) Compares the time points lhs and rhs.

7) Compares the time points lhs and rhs. The return type is deduced from lhs.time_since_epoch() <=> rhs.time_since_epoch(), and hence the three-way comparison result type of Dur1 and Dur2.

The != operator is synthesized from operator==.

(since C++20)

Parameters

lhs, rhs

-

time points to compare

Return value

1) true if the lhs and rhs refer to the same time point, false otherwise.

2) true if the lhs and rhs refer to different time points, false otherwise.

3) true if the lhs refers to time point before rhs, false otherwise.

4) true if the lhs refers to time point before rhs, or to the same time point as rhs, false otherwise.

5) true if the lhs refers to time point after rhs, false otherwise.

6) true if the lhs refers to time point after rhs, or to the same time point as rhs, false otherwise.

7) lhs.time_since_epoch() <=> rhs.time_since_epoch().

Exceptions

May throw implementation-defined exceptions.

Notes

Two-way comparison operators of time_point were not constexpr in C++11, this was corrected in C++14.