World Time

Get the current time for any location in the world by specifying an IANA timezone identifier. Returns the timezone name, UTC offset, current time, and DST status.

Get API Key

Overview

Use Cases

World clock widgets
Scheduling across multiple timezones
Travel and meeting planner apps
Display local time for remote team members

Features

Full IANA timezone database support (e.g. "America/New_York", "Asia/Tokyo")

UTC offset in standard +HH:MM format

DST detection for the current date

Current time returned in RFC 3339 format

API Endpoints

Get Current Time by Timezone

Returns the current time for the given IANA timezone identifier. The timezone is supplied as a path parameter (e.g. `America/New_York`, `Europe/London`, `UTC`).

GET

https://api.requiems.xyz/v1/places/time/{timezone}

Parameters

Name	Type	Required	Description
timezone	`string`	Required	IANA timezone identifier (e.g. 'America/New_York', 'Europe/London', 'Asia/Kolkata')

Try it out

Live Demo

Request

timezone * (string)

IANA timezone identifier (e.g. 'America/New_York', 'Europe/London', 'Asia/Kolkata')

Response Fields

Field	Type	Description
timezone	`string`	IANA timezone identifier (e.g. "America/New_York")
offset	`string`	UTC offset in +HH:MM or -HH:MM format (e.g. '-05:00', '+05:30')
current_time	`string`	Current time in UTC, formatted as RFC 3339 (e.g. "2024-12-15T14:30:00Z")
is_dst	`boolean`	Whether the timezone is currently observing daylight saving time

Code Examples

curl "https://api.requiems.xyz/v1/places/time/America/New_York" \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://api.requiems.xyz/v1/places/time/America/New_York"
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch(
  'https://api.requiems.xyz/v1/places/time/America/New_York',
  { headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();
console.log(data.data.current_time);

require 'net/http'
require 'json'

uri = URI('https://api.requiems.xyz/v1/places/time/America/New_York')

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']['current_time']

No results found

Sin resultados