Tracking Issue for saturating `SystemTime` arithmetic

[cvengler]

Feature gate: #![feature(time_saturating_systemtime)]

This is a tracking issue for rust-lang/libs-team#718

This feature adds the following three methods to SystemTime:

• SystemTime::saturating_add
• SystemTime::saturating_sub
• SystemTime::saturating_duration_since

Public API

// std::time

impl SystemTime {
    // ...

    fn saturating_add(&self, rhs: Duration) -> Self {
        self.checked_add(rhs).unwrap_or(SystemTime::MAX)
    }

    fn saturating_sub(&self, rhs: Duration) -> Self {
        self.checked_sub(rhs).unwrap_or(SystemTime::MIN)
    }

    fn saturating_duration_since(&self, rhs: Self) -> Duration {
        self.duration_since(rhs).unwrap_or(Duration::ZERO)
    }
}

Steps / History

(Remember to update the S-tracking-* label when checking boxes.)

• ACP: ACP: Add saturating artihmetic for SystemTime libs-team#718
• Implementation: time: Add saturating arithmetic for SystemTime #151200
• Final comment period (FCP)¹
• Stabilization PR

Unresolved Questions

• None yet.

Footnotes

1. https://std-dev-guide.rust-lang.org/feature-lifecycle/stabilization.html ↩