当前位置：首页 > news >正文

【quantity】4 Duration 类型及其实现（time.rs）

news 来源：原创 2025/4/29 13:59:03

一、源码

下面代码定义了一个表示持续时间（Duration）的类型及其相关操作。Duration 是基于 Quantity 类型的类型别名，专门用于表示以秒为单位的时间量。

use super::unit::Second;
use super::quantity::{Quantity, NoPrefix};
use std::ops::{Add, Sub, Mul, Div, AddAssign, SubAssign};
use std::fmt::{Display, Debug};/// 表示以秒为单位的持续时间类型
///
/// 这是 `Quantity<T, NoPrefix, Second>` 的类型别名
/// 其中:
/// - `T`: 存储的数值类型(如i32, f64等)
/// - `NoPrefix`: 表示没有单位前缀
/// - `Second`: 表示时间单位(秒)的维度
///
/// # 示例
/// ```
/// let duration = crate::time::Duration::from_seconds(30);
/// println!("Duration: {}", duration);
/// ```
pub type Duration<T> = Quantity<T, NoPrefix, Second>;impl<T> Duration<T> 
whereT: Copy + Add<Output = T> + Mul<Output = T> + Div<Output = T> + From<i64> + Display + Debug,
{/// 从秒数创建持续时间////// # 参数/// - `seconds`: 秒数////// # 返回值/// 返回对应的 `Duration` 实例////// # 示例/// ```/// let duration = crate::time::Duration::from_seconds(60);/// ```pub fn from_seconds(seconds: T) -> Self {Self::new(seconds)}/// 从分钟数创建持续时间////// # 参数/// - `minutes`: 分钟数////// # 返回值/// 返回对应的 `Duration` 实例////// # 示例/// ```/// let duration = crate::time::Duration::from_minutes(1.5);/// ```pub fn from_minutes(minutes: T) -> Self {Self::new(minutes * T::from(60))}/// 从小时数创建持续时间////// # 参数/// - `hours`: 小时数////// # 返回值/// 返回对应的 `Duration` 实例////// # 示例/// ```/// let duration = crate::time::Duration::from_hours(2);/// ```pub fn from_hours(hours: T) -> Self {Self::new(hours * T::from(3600))}/// 从天数创建持续时间////// # 参数/// - `days`: 天数////// # 返回值/// 返回对应的 `Duration` 实例////// # 示例/// ```/// let duration = crate::time::Duration::from_days(3);/// ```pub fn from_days(days: T) -> Self {Self::new(days * T::from(86400))}/// 从时分秒创建持续时间////// # 参数/// - `hours`: 小时数/// - `minutes`: 分钟数/// - `seconds`: 秒数////// # 返回值/// 返回对应的 `Duration` 实例////// # 示例/// ```/// let duration = crate::time::Duration::from_hms(1, 30, 15);/// ```pub fn from_hms(hours: T, minutes: T, seconds: T) -> Self whereT: Add<Output = T>,{Self::from_hours(hours) + Self::from_minutes(minutes) + Self::from_seconds(seconds)}/// 获取总秒数////// # 返回值/// 返回持续时间的总秒数////// # 示例/// ```/// let secs = crate::time::Duration::from_minutes(1).as_seconds();/// assert_eq!(secs, 60);/// ```pub fn as_seconds(self) -> T {self.get()}/// 获取总分钟数////// # 返回值/// 返回持续时间的总分钟数////// # 示例/// ```/// let mins = crate::time::Duration::from_seconds(120).as_minutes();/// assert_eq!(mins, 2);/// ```pub fn as_minutes(self) -> T {self.get() / T::from(60)}/// 获取总小时数////// # 返回值/// 返回持续时间的总小时数////// # 示例/// ```/// let hours = crate::time::Duration::from_minutes(120).as_hours();/// assert_eq!(hours, 2);/// ```pub fn as_hours(self) -> T {self.get() / T::from(3600)}/// 获取总天数////// # 返回值/// 返回持续时间的总天数////// # 示例/// ```/// let days = crate::time::Duration::from_hours(48).as_days();/// assert_eq!(days, 2);/// ```pub fn as_days(self) -> T {self.get() / T::from(86400)}
}// 运算符重载实现impl<T> AddAssign for Duration<T>
whereT: Add<Output = T> + Copy,
{/// 实现持续时间的加法赋值操作fn add_assign(&mut self, rhs: Self) {self.set(self.get() + rhs.get());}
}impl<T> SubAssign for Duration<T>
whereT: Sub<Output = T> + Copy,
{/// 实现持续时间的减法赋值操作fn sub_assign(&mut self, rhs: Self) {self.set(self.get() - rhs.get());}
}

二、主要组成部分

1. 类型定义

pub type Duration<T> = Quantity<T, NoPrefix, Second>;

+Duration 是 Quantity<T, NoPrefix, Second> 的类型别名

T 是数值类型（如 i32, f64 等）
NoPrefix 表示没有单位前缀
Second 表示时间单位是秒

2. 构造方法

提供了多种创建 Duration 的方法：

from_seconds(seconds) - 直接从秒数创建
from_minutes(minutes) - 从分钟数转换（×60）
from_hours(hours) - 从小时数转换（×3600）
from_days(days) - 从天数转换（×86400）
from_hms(hours, minutes, seconds) - 从时分秒组合创建

3. 转换方法

可以将 Duration 转换为不同单位表示：

as_seconds() - 获取总秒数
as_minutes() - 转换为分钟数（÷60）
as_hours() - 转换为小时数（÷3600）
as_days() - 转换为天数（÷86400）

4. 运算符重载

实现了 AddAssign 和 SubAssign trait，支持 += 和 -= 操作：

duration1 += duration2;  // 相当于 duration1 = duration1 + duration2
duration1 -= duration2;  // 相当于 duration1 = duration1 - duration2

使用示例

// 创建持续时间
let d1 = Duration::from_seconds(30);       // 30秒
let d2 = Duration::from_minutes(1.5);     // 90秒
let d3 = Duration::from_hms(1, 30, 15);   // 1小时30分15秒 = 5415秒// 转换单位
let hours = d3.as_hours();  // 1.504166...小时// 运算符使用
let mut total = Duration::from_seconds(0);
total += d1;
total += d2;