跳轉到主要內容
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 費用外不收取額外費用。

下一步