61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
|
# DateTime Tool Reference
|
||
|
|
|
||
|
|
## 支持的时区
|
||
|
|
|
||
|
|
常用时区:
|
||
|
|
- `UTC` - 协调世界时
|
||
|
|
- `Asia/Shanghai` - 中国标准时间 (UTC+8)
|
||
|
|
- `Asia/Tokyo` - 日本标准时间 (UTC+9)
|
||
|
|
- `America/New_York` - 美国东部时间
|
||
|
|
- `America/Los_Angeles` - 美国太平洋时间
|
||
|
|
- `Europe/London` - 英国时间
|
||
|
|
- `Europe/Paris` - 中欧时间
|
||
|
|
|
||
|
|
## 日期格式代码
|
||
|
|
|
||
|
|
| 代码 | 含义 | 示例 |
|
||
|
|
|------|------|------|
|
||
|
|
| `%Y` | 四位年份 | 2024 |
|
||
|
|
| `%m` | 月份 (01-12) | 01 |
|
||
|
|
| `%d` | 日期 (01-31) | 15 |
|
||
|
|
| `%H` | 小时 (00-23) | 14 |
|
||
|
|
| `%M` | 分钟 (00-59) | 30 |
|
||
|
|
| `%S` | 秒 (00-59) | 45 |
|
||
|
|
| `%A` | 星期全名 | Monday |
|
||
|
|
| `%a` | 星期缩写 | Mon |
|
||
|
|
| `%B` | 月份全名 | January |
|
||
|
|
| `%b` | 月份缩写 | Jan |
|
||
|
|
| `%Z` | 时区名称 | CST |
|
||
|
|
| `%z` | UTC 偏移 | +0800 |
|
||
|
|
|
||
|
|
## 常用格式组合
|
||
|
|
|
||
|
|
```python
|
||
|
|
# ISO 格式
|
||
|
|
"%Y-%m-%dT%H:%M:%S%z" # 2024-01-15T14:30:00+0800
|
||
|
|
|
||
|
|
# 中文格式
|
||
|
|
"%Y年%m月%d日 %H:%M:%S" # 2024年01月15日 14:30:00
|
||
|
|
|
||
|
|
# 美式格式
|
||
|
|
"%m/%d/%Y %I:%M %p" # 01/15/2024 02:30 PM
|
||
|
|
|
||
|
|
# 文件名安全格式
|
||
|
|
"%Y%m%d_%H%M%S" # 20240115_143000
|
||
|
|
```
|
||
|
|
|
||
|
|
## 错误处理
|
||
|
|
|
||
|
|
脚本在遇到错误时会返回包含 `error` 字段的 JSON:
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"error": "Invalid timezone: Invalid/Zone"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
常见错误:
|
||
|
|
- 无效的时区名称
|
||
|
|
- 无效的日期格式
|
||
|
|
- 日期解析失败
|