跳转到主要内容
datetime Server Tool 为模型提供当前的日期和时间。

快速开始

{
  "model": "openai/gpt-5.4",
  "messages": [{"role": "user", "content": "What day of the week is today, and how many days until the end of the year?"}],
  "tools": [{"type": "arouter", "arouter": {"id": "datetime"}}]
}

配置

参数类型默认值描述
idstring必须为 "datetime"
timezonestring"UTC"IANA 时区标识符(例如 "America/New_York""Asia/Shanghai""Europe/London"

工具响应格式

{
  "datetime": "2026-04-03T14:32:00Z",
  "date": "2026-04-03",
  "time": "14:32:00",
  "timezone": "UTC",
  "day_of_week": "Friday",
  "unix_timestamp": 1775319120
}

使用场景

日程安排和规划:
response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[{"role": "user", "content": "Create a 2-week project plan starting from today."}],
    tools=[{"type": "arouter", "arouter": {"id": "datetime", "timezone": "Asia/Shanghai"}}],
)

定价

datetime 工具是免费的——除正常 LLM Token 费用外不收取额外费用。

下一步