### Python `datetime` 模块中 `timedelta` 类的方法及其用法 `timedelta` 是 Python 的标准库模块 `datetime` 中的一个类，用于表示两个日期或时间之间的差异。它可以用来执行日期和时间的加减运算。 以下是关于 `timedelta` 类的主要方法及其用法： #### 1. 创建 `timedelta` 对象 可以通过指定天数 (`days`)、秒数 (`seconds`)、微秒数 (`microseconds`)、毫秒数 (`milliseconds`)、分钟数 (`minutes`)、小时数 (`hours`) 和周数 (`weeks`) 来创建一个 `timedelta` 对象[^1]。 ```python from datetime import timedelta # 示例：创建一个代表5分钟的时间差对象 delta = timedelta(minutes=5) print(delta) # 输出: 0:05:00 ``` #### 2. 使用 `timedelta` 进行日期/时间计算 可以将 `timedelta` 添加到或从中减去 `datetime` 或 `date` 对象，从而获得新的日期或时间[^1]。 ```python from datetime import datetime, timedelta # 获取当前时间 now = datetime.now() # 定义一天之前的偏移量 offset = timedelta(days=-1) # 计算一天之前的具体时间 one_day_ago = now + offset # 打印结果 print(one_day_ago.strftime('%Y-%m-%d %H:%M:%S')) # 格式化输出时间为字符串形式 ``` #### 3. 属性访问 `timedelta` 提供了一些属性来获取其内部存储的不同时间段单位的值[^1]。 - `.days`: 返回总天数部分。 - `.seconds`: 返回剩余的秒数部分（不足一天的部分）。 - `.microseconds`: 返回剩余的微秒数部分（不足一秒的部分）。 ```python delta = timedelta(days=2, hours=3, minutes=45, seconds=30) print(f"Days: {delta.days}") # 输出: Days: 2 print(f"Seconds: {delta.seconds}") # 输出: Seconds: 13530 (即3小时45分30秒转换成秒) print(f"Microseconds: {delta.microseconds}") # 输出: Microseconds: 0 ``` #### 4. 总持续时间 通过 `.total_seconds()` 方法可以获得整个 `timedelta` 表达为浮点类型的秒数。 ```python delta = timedelta(hours=1, minutes=30) total_seconds = delta.total_seconds() print(total_seconds) # 输出: 5400.0 秒 ``` --- ### 注意事项 尽管可以直接定义 `timedelta` 时间间隔，但它无法单独提供具体的时间戳或日期信息。它仅能表达相对的时间差值。如果需要具体的日期或时间，则需将其与其他 `datetime` 对象配合使用[^1]。 ---