Datetime server tool - Orq.ai Documentation

The orq:datetime tool gives a model the current date and time. Set a default IANA timezone on the tool entry, or omit it to use UTC.

Quick start

The examples use the client configuration from the Server tools overview.

curl -X POST https://api.orq.ai/v3/router/chat/completions \
  -H "Authorization: Bearer $ORQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "Is the Amsterdam support desk open now?" }
    ],
    "tools": [
      { "type": "orq:datetime", "timezone": "Europe/Amsterdam" }
    ]
  }'

const response = await client.chat.completions.create({
  model: 'openai/gpt-5.4-mini',
  messages: [
    { role: 'user', content: 'Is the Amsterdam support desk open now?' },
  ],
  tools: [{ type: 'orq:datetime', timezone: 'Europe/Amsterdam' }] as any,
});

console.log(response.choices[0].message.content);

response = client.chat.completions.create(
    model="openai/gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "Is the Amsterdam support desk open now?"}
    ],
    tools=[
        {"type": "orq:datetime", "timezone": "Europe/Amsterdam"}
    ],
)

print(response.choices[0].message.content)

Configuration

Parameter	Type	Required	Default	Description
`type`	string	Yes		Must be `orq:datetime`.
`timezone`	string	No	`UTC`	Default IANA timezone, such as `Europe/Amsterdam` or `America/New_York`.

The model can request an ISO timestamp or a human-readable date during the tool call. Invalid timezone identifiers are returned to the model as tool errors.

Cost and usage

Datetime calls have no additional charge. The number of calls appears at usage.server_tool_use.datetime_requests.

⌘I