Skip to main content
GonkaGate Docs

Datetime

Give the model the current date and time during a chat-completions request.

Use gonkagate:datetime when a prompt depends on the current date, time, or weekday. GonkaGate adds the current datetime context before the model answers.

Quick start

datetime.sh
export GONKAGATE_API_KEY="gp-your-api-key"

curl https://api.gonkagate.com/v1/chat/completions \
  -H "Authorization: Bearer $GONKAGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
    "messages": [
      {
        "role": "user",
        "content": "What day of the week is it in Tokyo right now?"
      }
    ],
    "tools": [
      {
        "type": "gonkagate:datetime",
        "parameters": { "timezone": "Asia/Tokyo" }
      }
    ]
  }'

Configuration

request.json
{
  "tools": [
    {
      "type": "gonkagate:datetime",
      "parameters": {
        "timezone": "America/New_York"
      }
    }
  ]
}
ParameterTypeDefaultDescription
timezonestringUTCIANA timezone name such as America/New_York, Europe/London, or Asia/Tokyo.

If timezone is omitted, GonkaGate uses UTC.

Tool result

The model receives a datetime object like this:

Tool result
{
  "datetime": "2026-06-29T08:00:00.000-04:00",
  "timezone": "America/New_York"
}

Your application receives the normal chat-completions response. The raw datetime object is tool context for the model.

Common errors

Error codeWhat it meansFix
invalid_server_tool_parameterstimezone is empty, not a string, or not a valid IANA timezone name.Use a valid IANA timezone such as UTC, Europe/London, or Asia/Tokyo.
unsupported_server_toolThe request used an unknown gonkagate:* tool type.Use gonkagate:datetime, gonkagate:web_search, or gonkagate:web_fetch.

See also

Was this page helpful?