feat(time): add Duration::{WEEK, DAY, HOUR, MINUTE}

[sorairolake]

• Tracking issue: Tracking issue for duration_constants #57391

This pull request adds associated constants for representing one week, one day, one hour, or one minute to Duration.

In the same way as #162195 and #162199, the exact number of seconds corresponding to one week, one day, one hour, and one minute are clearly specified in the documentation. Documentation tests are used to verify the correctness of these descriptions.

I initially proposed this as an ACP. However, the duration_constants feature is still unstable, and the ACP simply adds associated constants for units larger than the second to the feature, I determined that it could be incorporated into the feature.

By making Duration::WEEK and Duration::DAY dependent on the duration_constructors feature, these associated constants can be removed if Duration::from_weeks and Duration::from_days are not stabilized. Therefore, even if the duration_constructors feature is not stabilized, the duration_constants feature can be stabilized.

impl Duration {
    pub const WEEK: Duration = Duration::from_weeks(1);
    pub const DAY: Duration = Duration::from_days(1);
    pub const HOUR: Duration = Duration::from_hours(1);
    pub const MINUTE: Duration = Duration::from_mins(1);
}

• See also: ACP: Add Duration::{WEEK, DAY, HOUR, MINUTE} associated constants libs-team#869

[rustbot]

r? @clarfonthey

rustbot has assigned @clarfonthey.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

Why was this reviewer chosen?

The reviewer was selected based on:

• Owners of files modified in this PR: libs
• libs expanded to 12 candidates
• Random selection from Darksonn, JohnTitor, Mark-Simulacrum, clarfonthey, jhpratt

[clarfonthey]

@bors r+ rollup

Thank you!

[rust-bors]

📌 Commit 99ad525 has been approved by clarfonthey

It is now in the queue for this repository.