Datetime
openrouter:datetime
Gives the model reliable temporal context. When a prompt depends on today’s date or the current time, the model calls the tool and OpenRouter returns the current datetime, optionally in a configured timezone.
How it works
For prompts that depend on the current date or time, like scheduling and deadlines.
Your model calls the tool when it needs today’s date or the time.
OpenRouter returns the current datetime, in UTC or the timezone you set.
Your model answers from the real date instead of guessing from its training data.
Providers and pricing
OpenRouter
Free
Runs in-process on OpenRouter during the request.
Standard model token costs apply to every request.
Using this tool
OpenRouter runs the tool during the request and returns the result to the model, so no client-side tool loop is needed.
Supported APIs: Chat Completions, Responses, and Anthropic Messages.
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?"
}
]
}'Setup, parameters, and examples in the docs.
Read the integration guide