Time Zone Converter applies a UTC offset or IANA time zone to a timestamp and returns the corresponding local time. You can convert one moment into one zone, compare the same instant across up to 10 additional zones, or read a local wall-clock time in a source zone and have the platform account for daylight saving transitions.
Send utcIso with either zone or offset to convert a UTC timestamp into local time. If you need to work from a wall-clock input instead, provide localTime and fromZone. The request schema also supports toZones for multi-zone comparisons, workStart and workEnd for checking overlapping working hours, and nextChange to include each zone’s next clock change or null when no change is scheduled.
Use Time Zone Converter when scheduling meetings across regions, normalizing event timestamps, or validating business-hour logic in distributed systems. Because it relies on IANA zones, it handles daylight saving rules for real locations instead of just applying a fixed offset.
POST
Apply a UTC offset to a timestamp and return the local time
Returns a JSON object. The output schema does not declare any specific fields, so the exact response shape is not described here.
{
"utc": "2026-11-11T12:00:00.000Z",
"conversions": [
{
"zone": "Asia/Kolkata",
"name": "Mumbai, India",
"display": "Mumbai, India (IST, UTC+5:30)",
"offset": "+05:30",
"offsetMinutes": 330,
"localIso": "2026-11-11T17:30:00"
},
{
"zone": "America/New_York",
"name": "New York, United States",
"display": "New York, United States (EST, UTC−5)",
"offset": "-05:00",
"offsetMinutes": -300,
"localIso": "2026-11-11T07:00:00"
},
{
"zone": "Europe/London",
"name": "London, United Kingdom",
"display": "London, United Kingdom (GMT, UTC+0)",
"offset": "+00:00",
"offsetMinutes": 0,
"localIso": "2026-11-11T12:00:00"
},
{
"zone": "Asia/Tokyo",
"name": "Tokyo, Japan",
"display": "Tokyo, Japan (UTC+9)",
"offset": "+09:00",
"offsetMinutes": 540,
"localIso": "2026-11-11T21:00:00"
}
]
}
TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
About this endpoint
What it does
Applies a UTC timestamp or a local wall-clock time to one or more time zones and returns the converted local time information. You can provide either utcIso or the pair localTime and fromZone, and optionally ask for additional zones, working-hour calculations, or the next clock change.
Request Body
Parameter
Type
Mandatory
Description
zone
String
No
An IANA time zone such as America/New_York. Daylight saving is handled from the platform's time zone database.
offset
String
No
A fixed offset such as +05:30 or -08:00. Use zone for a real time zone with daylight saving.
utcIso
String
No
The moment as a UTC timestamp, such as 2026-10-30T12:00:00Z. Required unless localTime and fromZone are sent.
toZones
String Array
No
More IANA zones to convert the same moment to, up to 10 total together with zone.
workEnd
Integer
No
End of working hours. Default is 17. Minimum 1, maximum 24.
fromZone
String
No
The IANA zone that localTime is read in.
localTime
String
No
A wall-clock time such as 2026-11-01T01:30, read in fromZone. A time the clocks skip or repeat is detected and explained.
workStart
Integer
No
Start of working hours. Default is 9. Minimum 0, maximum 23. With workEnd, returns the hours when every zone is at work.
nextChange
Boolean
No
Add, for every zone, the next time its clocks change to the minute, or null when they do not.
Response
Parameter
Type
Description
utc
string
Original UTC timestamp provided for conversion.
conversions
array
Contains the converted time details for each requested time zone.
conversions[].zone
string
IANA time zone identifier.
conversions[].name
string
City and country name associated with the time zone.
conversions[].display
string
Human-readable time zone name, abbreviation, and UTC offset.
conversions[].offset
string
UTC offset for the specified time zone.
conversions[].offsetMinutes
number
UTC offset expressed in minutes.
conversions[].localIso
string
Converted local date and time in ISO 8601 format.
▣ COMMON ERRORS
Errors any endpoint can return
400bad_request
Required parameter missing or malformed body.
401unauthorized
API key missing, revoked, or not authorized for this service.
429rate_limited
Your plan's per-second rate exceeded. Retry with exponential backoff.
503upstream_busy
Backend temporarily unavailable. Try again in a few seconds.
Similar APIs
Closest matches in the catalog based on this service.
