The absl::Duration class represents a signed, fixed‐length amount of time. A Duration is generated using a unit‐specific factory function, or is the result of subtracting one absl::Time from another. Durations behave like unit‐safe integers and they support all the natural integer‐like arithmetic operations. Arithmetic overflows and saturates at +/‐ infinity. Duration is trivially destructible and should be passed by value rather than const reference.
Synopsis
Declared in <absl/time/time.h>
class Duration;Description
Factory functions Nanoseconds(), Microseconds(), Milliseconds(), Seconds(), Minutes(), Hours() and InfiniteDuration() allow for creation of constexpr Duration values
Examples:
constexpr absl::Duration ten_ns = absl::Nanoseconds(10); constexpr absl::Duration min = absl::Minutes(1); constexpr absl::Duration hour = absl::Hours(1); absl::Duration dur = 60 * min; // dur == hour absl::Duration half_sec = absl::Milliseconds(500); absl::Duration quarter_sec = 0.25 * absl::Seconds(1);
Duration values can be easily converted to an integral number of units using the division operator.
Example:
constexpr absl::Duration dur = absl::Milliseconds(1500); int64_t ns = dur / absl::Nanoseconds(1); // ns == 1500000000 int64_t ms = dur / absl::Milliseconds(1); // ms == 1500 int64_t sec = dur / absl::Seconds(1); // sec == 1 (subseconds truncated) int64_t min = dur / absl::Minutes(1); // min == 0
See the IDivDuration() and FDivDuration() functions below for details on how to access the fractional parts of the quotient.
Alternatively, conversions can be performed using helpers such as ToInt64Microseconds() and ToDoubleSeconds().
Member Functions
Name |
Description |
|
Constructors |
Assigns a copy of another duration. |
|
Sets this duration to its remainder modulo another duration. |
|
Multiplication assignment operators |
|
Adds a duration to this one. |
|
Subtracts a duration from this one. |
|
Division assignment operators |
Friends
Name |
Description |
Combines this duration into a hash state. |
Non-Member Functions
Name |
Description |
Returns the absolute value of a duration. |
|
Unparses a Duration value into a command‐line string representation using the format specified by |
|
Returns the ceiling of a duration using the passed duration unit to its smallest value not less than the duration. |
|
Converts a |
|
Converts a |
|
Divides a |
|
Floors a duration using the passed duration unit to its largest value not greater than the duration. |
|
Returns a string representing the duration in the form "72h3m0.5s". Returns "inf" or "‐inf" for +/‐ |
|
Converts a std::chrono::microseconds value to an absl::Duration. |
|
Converts a std::chrono::hours value to an absl::Duration. |
|
Converts a std::chrono::nanoseconds value to an absl::Duration. |
|
Converts a std::chrono::milliseconds value to an absl::Duration. |
|
Converts a std::chrono::seconds value to an absl::Duration. |
|
Converts a std::chrono::minutes value to an absl::Duration. |
|
Constructs a |
|
Constructs a |
|
Divides a numerator |
|
Returns an infinite |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Constructs a |
|
Sleeps for the specified duration, expressed as an |
|
Converts an absl::Duration to a std::chrono::hours value. |
|
Converts an absl::Duration to a std::chrono::microseconds value. |
|
Converts an absl::Duration to a std::chrono::milliseconds value. |
|
Converts an absl::Duration to a std::chrono::minutes value. |
|
Converts an absl::Duration to a std::chrono::nanoseconds value. |
|
Converts an absl::Duration to a std::chrono::seconds value. |
|
Converts a Duration to a floating‐point count of hours. |
|
Converts a Duration to a floating‐point count of microseconds. |
|
Converts a Duration to a floating‐point count of milliseconds. |
|
Converts a Duration to a floating‐point count of minutes. |
|
Converts a Duration to a floating‐point count of nanoseconds. |
|
Converts a Duration to a floating‐point count of seconds. |
|
Converts a Duration to an integral count of hours. |
|
Converts a Duration to an integral count of microseconds. |
|
Converts a Duration to an integral count of milliseconds. |
|
Converts a Duration to an integral count of minutes. |
|
Converts a Duration to an integral count of nanoseconds. |
|
Converts a Duration to an integral count of seconds. |
|
Converts an |
|
Converts an |
|
Truncates a duration (toward zero) to a multiple of a non‐zero unit. |
|
Deprecated. Use |
|
Returns a zero‐length duration. This function behaves just like the default constructor, but the name helps make the semantics clear at call sites. |
|
Returns whether two durations are unequal. |
|
Returns the remainder of one duration divided by another. |
|
Returns the product of a scalar and a duration. |
|
Returns the product of a duration and a scalar. |
|
Returns the time obtained by advancing a time by a duration. |
|
Returns the sum of two durations. |
|
Returns the difference of two durations. |
|
Returns the negation of a duration. |
|
Returns the duration between two times. |
|
Returns the integer quotient of one duration divided by another. |
|
Returns the quotient of a duration divided by a scalar. |
|
Returns whether one duration is less than another. |
|
Returns whether one duration is less than or equal to another. |
|
Three‐way‐compares two durations. |
|
Returns whether two durations are equal. |
|
Returns whether one duration is greater than another. |
|
Returns whether one duration is greater than or equal to another. |
Created with MrDocs