# 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"
}
```

常见错误:
- 无效的时区名称
- 无效的日期格式
- 日期解析失败