GET/v1/time/convert
Convert a time from one zone to another
at is a wall-clock time in from (e.g. 2026-03-08T02:30) or an explicit instant with Z or offset. Wall times that fall in a DST gap are moved forward like most calendar apps do.
PARAMETERS
- atquery · stringREQUIRED
- Wall time in `from`, or an ISO-8601 instante.g. 2026-10-08T09:00
- toquery · stringREQUIRED
- Zone to convert toe.g. Asia/Tokyo
- fromquery · string
- Zone `at` is expressed ine.g. America/New_York
REQUEST
curl "https://api.apialmanac.com/v1/time/convert?at=2026-10-08T09%3A00&to=Asia%2FTokyo" \ -H "X-API-Key: YOUR_KEY"
import requests
r = requests.get("https://api.apialmanac.com/v1/time/convert?at=2026-10-08T09%3A00&to=Asia%2FTokyo", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())
const r = await fetch("https://api.apialmanac.com/v1/time/convert?at=2026-10-08T09%3A00&to=Asia%2FTokyo", {
headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());
RESPONSE
200OK
{
"input": "2026-10-08T09:00",
"from": {
"zone": "America/New_York",
"iso": "2026-10-08T09:00:00-04:00",
"offset": "-04:00"
},
"to": {
"zone": "Asia/Tokyo",
"iso": "2026-10-08T22:00:00+09:00",
"offset": "+09:00"
},
"utc": "2026-10-08T13:00:00Z",
"unix": 1791464400,
"difference_minutes": 780,
"difference": "+13:00"
}