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

# Server tool Datetime

> Forneça a um modelo a data e a hora atuais em um fuso horário IANA escolhido com a server tool orq:datetime.

A ferramenta `orq:datetime` fornece a um modelo a data e a hora atuais. Defina um fuso horário IANA fixo na entrada da ferramenta ou omita-o para deixar o modelo escolher um.

## Início rápido

Os exemplos usam a configuração de cliente da [Visão geral das server tools](/docs/pt-BR/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)
```

## Configuração

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| - | - | - | - | - |
| `type` | string | Sim | | Deve ser `orq:datetime`. |
| `timezone` | string | Não | Nenhum | Fuso horário IANA fixo, como `Europe/Amsterdam` ou `America/New_York`. |

Quando `timezone` é definido, o modelo não pode escolher outro fuso horário: o parâmetro é removido da ferramenta que o modelo vê. Quando é omitido, o modelo informa um fuso horário em cada chamada, com padrão `UTC`.

Em cada chamada, o modelo também escolhe um `format` (`iso` para um timestamp no estilo ISO ou `human` para uma data legível) e um `locale` BCP 47 para o formato legível, com padrão `en-US`. Identificadores de fuso horário inválidos são retornados ao modelo como erros de ferramenta.

`orq:current_date` continua sendo aceito como alias legado.

## Custo e uso

As chamadas ao Datetime não têm cobrança adicional. O número de chamadas aparece em `usage.server_tool_use.datetime_requests`.


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