openrouter:datetime 是 OpenRouter 的 Server Tool，让任何 LLM 模型都能在推理过程中获取当前日期和时间，无需客户端实现。只需在 tools 数组中添加 { "type": "openrouter:datetime" } 即可启用。适用于需要时间感知的场景：日程安排、"今天是星期几"、时效性问答等。没有额外费用，只计标准 token 用量。

openrouter:datetime Server Tool 让任何模型都能在处理请求时获取当前日期和时间，无需在客户端实现时间获取逻辑。

快速开始

在 tools 数组中添加 openrouter:datetime：

const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <OPENROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-4o',
    messages: [
      {
        role: 'user',
        content: '今天是星期几？'
      }
    ],
    tools: [
      { type: 'openrouter:datetime' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

适用场景

• 日程与提醒：计算相对日期（"下周一"、"三天后"）
• 时效性问答：需要知道"现在是几月"、"今年是哪一年"
• 时间戳生成：在响应中添加准确的时间信息
• 会话记录：自动添加对话时间

费用

使用 openrouter:datetime 工具不产生额外费用，只计标准 token 用量（工具调用和响应的 token 消耗）。

与其他 Server Tools 组合使用

可以在同一请求中组合多个 Server Tools：

tools: [
  { type: 'openrouter:datetime' },
  { type: 'openrouter:web_search' }
]

常见问题

Q: datetime 工具返回的时间精度是多少？

A: 返回当前的完整日期和时间，包含年月日时分秒和时区信息。具体格式由 OpenRouter 服务端确定，模型会根据用户的问题选择合适的呈现方式。

Q: 模型一定会调用 datetime 工具吗？

A: 不一定。模型会根据用户的请求内容自主决定是否需要调用该工具。只有当请求明确需要当前时间信息时，模型才会触发工具调用。如需强制使用，可在系统提示中明确说明需要获取当前时间。

Q: datetime 工具和 web_search 工具有什么区别？

A: datetime 只提供时间信息，不访问外部网络，延迟极低；web_search 需要访问互联网，适合获取实时新闻或动态数据，但会产生额外费用（每次搜索计费）。仅需时间信息时优先用 datetime。