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.Configuration
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 atusage.server_tool_use.datetime_requests.