Datetime

How it works

For prompts that depend on the current date or time, like scheduling and deadlines.

1. 1

   Your model calls the tool when it needs today’s date or the time.

2. 2

   OpenRouter returns the current datetime, in UTC or the timezone you set.

3. 3

   Your model answers from the real date instead of guessing from its training data.

Providers and pricing

Standard model token costs apply to every request.

Using this tool

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-5.2",
  "tools": [
    {
      "type": "openrouter:datetime"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "How many days are left until the end of this quarter?"
    }
  ]
}'

Related tools

Utilities

• Tool search

  Load tool definitions on demand instead of up front

  Utilities