简介
日期时间相关接口用于处理时间数据的格式化、解析及时区转换。以下是核心功能说明:
- 格式支持:兼容 ISO 8601、RFC 2822 等标准格式
- 时间戳处理:可转换 Unix 时间戳(UTC 时间)
- 时区功能:支持时区偏移量和时区缩写(如 UTC+8、PST)
- 时间运算:提供日期加减、间隔计算等操作
⚠️ 注意:所有时间数据默认使用 UTC 时间 作为基准
常用格式示例
格式类型 | 示例 | 说明 |
---|---|---|
ISO 8601 | 2023-10-15T14:30:00+08:00 |
推荐使用标准格式 |
RFC 2822 | Sun, 15 Oct 2023 14:30:00 GMT |
邮件协议常用 |
Unix 时间戳 | 1697376600 |
秒级时间戳(UTC 时间) |
时间戳处理规范
- 时间戳需为 10 位整数(秒级)或 13 位整数(毫秒级)
- 默认解析为 UTC 时间,可通过参数指定时区
- 支持
Date
头部字段的格式验证 - 时间戳范围:
1970-01-01T00:00:00Z
至2038-01-19T03:14:07Z
时区说明 🌍
- 时区标识:支持
+08:00
、UTC-5
、EST
等格式 - 时区转换:自动识别并转换为 UTC 时间
- 本地时间:通过
timezone
参数可获取本地时间(如Asia/Shanghai
)