# Time zone converter

Convert a date and time from one time zone to others, with daylight saving handled for that date.

- Endpoint: `POST https://setget.net/v1/tools/timezone-convert` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `timezone-convert`
- Page: https://setget.net/tools/timezone-convert

## Inputs

- `time` (required, string): The date and time to convert. An offset such as +01:00 or Z overrides from_zone.
- `to` (required, array): Time zones to convert to, as IANA names.
- `from_zone` (optional, string, default `"UTC"`): Time zone the time is written in.

## Example 1

```json
{"input":{"time":"2026-07-01 12:00","from_zone":"Europe/London","to":["America/New_York","Asia/Tokyo"]}}
```

Result:

```json
{"input":{"zone":"Europe/London","iso":"2026-07-01T12:00:00+01:00","utc_offset":"+01:00","status":"ok"},"note":null,"utc":"2026-07-01T11:00:00Z","results":[{"zone":"America/New_York","iso":"2026-07-01T07:00:00-04:00","date":"2026-07-01","time":"07:00:00","weekday":"Wednesday","utc_offset":"-04:00","abbreviation":"EDT","dst":true,"day_shift":0},{"zone":"Asia/Tokyo","iso":"2026-07-01T20:00:00+09:00","date":"2026-07-01","time":"20:00:00","weekday":"Wednesday","utc_offset":"+09:00","abbreviation":"JST","dst":false,"day_shift":0}]}
```

## Example 2: A time skipped by daylight saving

```json
{"input":{"time":"2026-03-29 02:30","from_zone":"Europe/Oslo","to":["UTC"]}}
```

Result:

```json
{"input":{"zone":"Europe/Oslo","iso":"2026-03-29T03:30:00+02:00","utc_offset":"+02:00","status":"skipped"},"note":"02:30 on 2026-03-29 does not exist in Europe/Oslo because the clocks go forward. It was read as 03:30 (+02:00).","utc":"2026-03-29T01:30:00Z","results":[{"zone":"UTC","iso":"2026-03-29T01:30:00+00:00","date":"2026-03-29","time":"01:30:00","weekday":"Sunday","utc_offset":"+00:00","abbreviation":"UTC","dst":false,"day_shift":0}]}
```

**Which time zone names work?** IANA names such as Europe/London, America/New_York or Asia/Kolkata. Abbreviations like PST or IST are not accepted because several places share them.

**What if the time falls in a daylight saving change?** A time skipped when clocks go forward is moved forward by the size of the change. A time that happens twice when clocks go back uses the first occurrence. Either way "status" and "note" tell you, and you can add an explicit offset to choose.

**What does day_shift mean?** It is 1 when the converted time falls on the next calendar day, -1 for the previous day.
