curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

Time zone converter API

A moment in up to 25 time zones at once, with each zone's UTC offset and whether daylight saving time applies, from the IANA time zone database.

POST https://api.curatedapi.com/v1/calc/date/timezone-convert

Converts a date and time to other time zones. Give the moment with a UTC offset, or as a local time with the zone it is in, and the zones you want. Each answer has the local date and time, the day of the week, the UTC offset in force at that moment and whether daylight saving time applies. A local time that does not exist (the clocks skip it) or happens twice (the clocks go back) is refused with an explanation instead of being guessed.

Formula

local time = UTC + the zone's offset at that instant, from the IANA rules
  • Time zones come from the IANA time zone database in the pinned tzdata package; the version used is returned with each date-time result.
  • Leap seconds are not counted.

Inputs

Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).

InputTypeDescription
datetime required string The moment: an ISO 8601 date-time with a UTC offset, or a local time in from_timezone.
from_timezone string The IANA time zone of a datetime that has no UTC offset.
to_timezones required list of string The IANA time zones to convert to, such as America/New_York. 1 to 25 items.

Result

Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.

ResultTypeDescription
utcstringThe moment in UTC.
conversionslist of objectThe moment in each zone, in the order asked.
tz_databasestringThe time zone data used.

Examples

Nine in the morning in Berlin on the day the clocks go forward

Requestcurl
curl https://api.curatedapi.com/v1/calc/date/timezone-convert \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "datetime": "2026-03-29T09:00:00",
    "from_timezone": "Europe/Berlin",
    "to_timezones": ["America/New_York", "Asia/Kolkata"]
  }'
200 OKResponse
{
  "calculator": "date/timezone-convert@1",
  "result": {
    "utc": "2026-03-29T07:00:00Z",
    "conversions": [
      {
        "timezone": "America/New_York",
        "local": "2026-03-29T03:00:00-04:00",
        "weekday": "Sunday",
        "utc_offset": "-04:00",
        "abbreviation": "EDT",
        "daylight_saving": true
      },
      {
        "timezone": "Asia/Kolkata",
        "local": "2026-03-29T12:30:00+05:30",
        "weekday": "Sunday",
        "utc_offset": "+05:30",
        "abbreviation": "IST",
        "daylight_saving": false
      }
    ],
    "tz_database": "tzdata 2026.6 (IANA 2026f)"
  },
  "exactness": {},
  "precision": null,
  "inputs": {
    "datetime": "2026-03-29T09:00:00",
    "from_timezone": "Europe/Berlin",
    "to_timezones": [
      "America/New_York",
      "Asia/Kolkata"
    ]
  },
  "formula": "local time = UTC + the zone's offset at that instant, from the IANA rules",
  "references": [
    {
      "title": "IANA Time Zone Database",
      "url": "https://www.iana.org/time-zones"
    },
    {
      "title": "ISO 8601 date and time format",
      "url": "https://www.iso.org/iso-8601-date-and-time-format.html"
    }
  ],
  "warnings": []
}

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.