API Almanac
API reference › Time

Convert a time from one zone to another

GET/v1/time/convert

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 instant
e.g. 2026-10-08T09:00
toquery · stringREQUIRED
Zone to convert to
e.g. Asia/Tokyo
fromquery · string
Zone `at` is expressed in
e.g. America/New_York
In the full reference
REQUEST
curl "https://api.apialmanac.com/v1/time/convert?at=2026-10-08T09%3A00&to=Asia%2FTokyo" \
  -H "X-API-Key: YOUR_KEY"
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"
}
Try it — sign in first
Runs on a sandbox key: 200 requests a month. Your real key is for production.