Duration::from_secs, Duration::from_millis, Duration::checked_add, Duration::saturating_add, Duration::checked_sub
pub const fn from_secs(secs: u64) -> Duration
pub const fn from_millis(millis: u64) -> Duration
pub const fn as_secs(&self) -> u64
pub const fn as_millis(&self) -> u128
pub const fn checked_add(self, rhs: Duration) -> Option<Duration>
pub const fn saturating_add(self, rhs: Duration) -> Duration
pub const fn checked_sub(self, rhs: Duration) -> Option<Duration>Build a Duration and add or subtract it with checked or saturating arithmetic. These helpers do not read the system clock.
| Parameter | Description |
|---|---|
secs / millis | Non-negative counts used to construct a Duration. as_secs and as_millis then read those units back; as_secs truncates a fractional second. |
rhs | The Duration to add or subtract. Overflow and underflow are reported, not wrapped, by the checked methods. |
Returns: from_secs and from_millis return a Duration. as_secs returns u64. as_millis returns u128. checked_add and checked_sub return Option; saturating_add always returns a Duration.
- The Debug output 3.5s was measured with rustc 1.90.0. Duration does not implement Display on this version.
use std::time::Duration;
fn main() {
let one = Duration::from_secs(1);
let two = Duration::from_millis(2500);
println!("{:?}", one + two);
println!("{} {}", two.as_secs(), two.as_millis());
println!("{:?}", Duration::MAX.checked_add(one));
println!("{}", Duration::MAX.saturating_add(one) == Duration::MAX);
println!("{:?}", one.checked_sub(Duration::from_secs(2)));
}Expected output
3.5s
2 2500
None
true
None