Endpoint
GET https://requiems.xyz/v1/places/timezone
Get Timezone
Returns timezone information for the given coordinates or city name. Provide either city or both lat and lon.
Parameters
| Name | Type | Required | Location | Description |
|---|---|---|---|---|
lat |
number | no | query | Latitude of the location (-90 to 90). Required when using coordinate-based lookup. |
lon |
number | no | query | Longitude of the location (-180 to 180). Required when using coordinate-based lookup. |
city |
string | no | query | City name for city-based lookup (e.g. 'Tokyo', 'London'). Required when not using coordinates. |
Response Example
{
"timezone": "Europe/London",
"offset": "+00:00",
"current_time": "2024-12-15T14:30:00Z",
"is_dst": false
}
Response Fields
| Field | Type | Description |
|---|---|---|
timezone |
string | IANA timezone identifier (e.g. "Europe/London", "Asia/Tokyo") |
offset |
string | UTC offset in +HH:MM or -HH:MM format (e.g. '+05:30', '-05:00') |
current_time |
string | Current time in UTC, formatted as RFC 3339 (e.g. "2024-12-15T14:30:00Z") |
is_dst |
boolean | Whether the location is currently observing daylight saving time |