X-Agents/account/admin/skills/datetime-tool/references/REFERENCE.md

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

常用格式组合

# 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:

{
  "error": "Invalid timezone: Invalid/Zone"
}

常见错误:

• 无效的时区名称
• 无效的日期格式
• 日期解析失败