time_timezone_converter
Convert wall-clock dates and times between IANA time zones with DST awareness, or compare an instant across up to 12 zones simultaneously.
Instructions
Time Zone Converter. Convert a wall-clock date and time from one IANA time zone to another with DST awareness, or render one UTC instant across up to 12 zones at once. The 'operation' field selects the mode. 'convert' takes a year/month/day (plus optional hour/minute/second), a fromTz and a toTz, and returns the source and target wall clocks, the shared UTC instant, and the signed hours difference. 'compare' takes the same wall clock with a sourceTz and a targetTzs list and renders each target zone. 'listSupportedTimezones' returns a curated IANA name list and ignores all other fields. Use this for zone-to-zone wall-clock math; use time_world_clock for a live ticking multi-city clock, time_iso_8601_formatter for ISO/RFC string parsing, or convert_timestamp for unix-epoch dates. Pure local computation against the bundled tz database, no network or storage; read-only, non-destructive, idempotent, rate-limited (60 req/min anonymous, no auth). Each rendered zone reports its UTC offset, abbreviation, and DST flag.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Mode to run. 'convert' converts one wall clock from fromTz to toTz. 'compare' renders the same instant across targetTzs. 'listSupportedTimezones' returns the curated IANA list and ignores all other fields. | |
| year | No | Wall-clock year 1900-2100. Required for convert and compare. | |
| month | No | Wall-clock month 1-12. Required for convert and compare. | |
| day | No | Wall-clock day 1-31; must be a real calendar date. Required for convert and compare. | |
| hour | No | Wall-clock hour 0-23. Optional, defaults to 0. | |
| minute | No | Wall-clock minute 0-59. Optional, defaults to 0. | |
| second | No | Wall-clock second 0-59. Optional, defaults to 0. | |
| fromTz | No | Source IANA time zone name such as America/New_York. Required for convert. | |
| toTz | No | Target IANA time zone name such as Europe/London. Required for convert. | |
| sourceTz | No | Source IANA time zone for the wall clock. Required for compare. | |
| targetTzs | No | IANA time zone names to render the instant in, 1-12 entries. Required for compare. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | No | The operation that was run, echoed back. | |
| data | No | Result payload; shape depends on operation (object for convert/compare, string array for listSupportedTimezones). |