> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/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 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](/docs/ai-gateway/features/server-tools).

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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" }
      ]
    }'
  ```

  ```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)
  ```
</CodeGroup>

## 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`.