Timezone

Get timezone information for any location by geographic coordinates or city name. Returns the IANA timezone identifier, UTC offset, current time, and DST status.

Get API Key

Overview

Use Cases

Display local time for a given location
Scheduling and calendar applications
Travel and logistics platforms
Location-aware notifications

Features

Lookup by latitude/longitude or city name

IANA timezone identifiers (e.g. "America/New_York")

DST detection for the current date

UTC offset in standard +HH:MM format

150+ major cities supported for city-based lookup

API Endpoints

Get Timezone

Returns timezone information for the given coordinates or city name. Provide either `city` or both `lat` and `lon`.

GET

https://api.requiems.xyz/v1/places/timezone

Parameters

Name	Type	Required	Description
lat	`float`	Optional	Latitude of the location (-90 to 90). Required when using coordinate-based lookup.
lon	`float`	Optional	Longitude of the location (-180 to 180). Required when using coordinate-based lookup.
city	`string`	Optional	City name for city-based lookup (e.g. 'Tokyo', 'London'). Required when not using coordinates.

Try it out

Live Demo

Request

lat (float)

Latitude of the location (-90 to 90). Required when using coordinate-based lookup.

lon (float)

Longitude of the location (-180 to 180). Required when using coordinate-based lookup.

city (string)

City name for city-based lookup (e.g. 'Tokyo', 'London'). Required when not using coordinates.

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

Code Examples

# Lookup by coordinates
curl "https://api.requiems.xyz/v1/places/timezone?lat=51.5&lon=-0.1" \
  -H "requiems-api-key: YOUR_API_KEY"

# Lookup by city
curl "https://api.requiems.xyz/v1/places/timezone?city=Tokyo" \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

# Lookup by coordinates
url = "https://api.requiems.xyz/v1/places/timezone"
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.get(url, params={"lat": 51.5, "lon": -0.1}, headers=headers)
print(response.json())

# Lookup by city
response = requests.get(url, params={"city": "Tokyo"}, headers=headers)
print(response.json())

// Lookup by coordinates
const response = await fetch(
  'https://api.requiems.xyz/v1/places/timezone?lat=51.5&lon=-0.1',
  { headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();
console.log(data.data.timezone);

// Lookup by city
const cityResponse = await fetch(
  'https://api.requiems.xyz/v1/places/timezone?city=Tokyo',
  { headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const cityData = await cityResponse.json();
console.log(cityData.data.timezone);

require 'net/http'
require 'json'

# Lookup by coordinates
uri = URI('https://api.requiems.xyz/v1/places/timezone')
uri.query = URI.encode_www_form(lat: 51.5, lon: -0.1)

request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data['data']['timezone']

No results found