> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Datetime server tool

> Give a model the current date and time in a chosen IANA timezone with the orq:datetime server tool.

The `orq:datetime` tool gives a model the current date and time. Set a fixed IANA timezone on the tool entry, or omit it to let the model choose one.

## Quick start

The examples use the client configuration from the [Server tools overview](/docs/ai-gateway/features/server-tools.md).

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://router.toqan.ai/eu/v3/router/chat/completions \
  -H "Authorization: Bearer $TOQAN_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" }
    ]
  }'
```

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
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);
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 | None | Fixed IANA timezone, such as `Europe/Amsterdam` or `America/New_York`. |

When `timezone` is set, the model cannot pick another timezone: the parameter is removed from the tool the model sees. When it is omitted, the model supplies a timezone in each call and defaults to `UTC`.

In each call the model also chooses a `format` (`iso` for an ISO-style timestamp or `human` for a readable date) and a BCP 47 `locale` for the human format, defaulting to `en-US`. Invalid timezone identifiers are returned to the model as tool errors.

`orq:current_date` remains accepted as a legacy alias.

## Cost and usage

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.