> Для получения чистого Markdown любой страницы добавьте .md к URL страницы.  
> Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.  
> Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.  
> Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к серверу MCP по адресу https://api.vega.chat/docs/_mcp/server.

# Дата и время

Инструменты сервера находятся в бета‑версии. API и поведение могут измениться.

Инструмент сервера `openrouter:datetime` предоставляет любой модели доступ к текущей дате и времени. Это полезно для запросов, требующих временной осведомлённости — планирования, вопросов, чувствительных ко времени, или любой задачи, где модели необходимо знать «сейчас».

## Быстрый старт

```typescript title="TypeScript"
const response = await fetch('https://api.vega.chat/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer {{API_KEY_REF}}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: '{{MODEL}}',
    messages: [
      {
        role: 'user',
        content: 'What day of the week is it today?'
      }
    ],
    tools: [
      { type: 'openrouter:datetime' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);
```

```python title="Python"
import requests

response = requests.post(
  "https://api.vega.chat/api/v1/chat/completions",
  headers={
    "Authorization": f"Bearer {{API_KEY_REF}}",
    "Content-Type": "application/json",
  },
  json={
    "model": "{{MODEL}}",
    "messages": [
      {
        "role": "user",
        "content": "What day of the week is it today?"
      }
    ],
    "tools": [
      {"type": "openrouter:datetime"}
    ]
  }
)

data = response.json()
print(data["choices"][0]["message"]["content"])
```

```bash title="cURL"
curl https://api.vega.chat/api/v1/chat/completions \
  -H "Authorization: Bearer {{API_KEY_REF}}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "{{MODEL}}",
    "messages": [
      {
        "role": "user",
        "content": "What day of the week is it today?"
      }
    ],
    "tools": [
      {"type": "openrouter:datetime"}
    ]
  }'
```

## Конфигурация

Инструмент datetime принимает необязательный параметр `timezone`:

```json
{
  "type": "openrouter:datetime",
  "parameters": {
    "timezone": "America/New_York"
  }
}
```

| Параметр   | Тип    | По умолчанию | Описание |
| ---------- | ------ | ------------ | -------- |
| `timezone` | string | `UTC`        | Название часового пояса в формате IANA (например, `"America/New_York"`, `"Europe/London"`, `"Asia/Tokyo"`) |

## Ответ

Когда модель вызывает инструмент datetime, она получает ответ, похожий на:

```json
{
  "datetime": "2025-07-15T14:30:00.000-04:00",
  "timezone": "America/New_York"
}
```

## Ценообразование

Инструмент datetime не имеет дополнительных расходов помимо стандартного использования токенов.

## Следующие шаги

* [Обзор серверных инструментов](/docs/guides/features/server-tools) — Узнайте о серверных инструментах  
* [Веб‑поиск](/docs/guides/features/server-tools/web-search) — Поиск в интернете для получения актуальной информации  
* [Вызов инструментов](/docs/guides/features/tool-calling) — Узнайте о пользовательском вызове инструментов