Convert time between time zones
convert_timeUse this when the user wants to convert a time between time zones or cities (time zone converter, e.g. 'convert 3pm PST to IST', 'time zone converter New York to London', 'what time is 9am EST in Warsaw on Nov 3'). Takes a date, a time, a source place (city, IANA zone, US state, country, UTC offset, or abbreviation) and up to 20 target places; returns the same instant in each place with UTC offset, abbreviation, +1/-1 day shift, the hour difference, and a note when a daylight saving change happens within 7 days. Explains times that are skipped or repeated by DST changes. Does not plan meetings (find_meeting_time covers that), look up flight times, or convert units.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Target places in the same formats, e.g. ["London", "Asia/Kolkata", "Sydney"]. | |
| date | No | Local date at the source place as YYYY-MM-DD, e.g. 2026-11-03. Defaults to today at the source. Always pass it when the user names a day, because DST depends on the date. | |
| from | Yes | Source place: a city ("New York", "Portland, Oregon"), an IANA zone ("Europe/Warsaw"), a US state, a country, a UTC offset ("UTC+5:30"), or an abbreviation ("PST", "CET", "IST"). Abbreviations mean the region's local clock on that date; ambiguous ones (IST, CST, AST, BST) use the first meaning and say so. | |
| time | No | Local time at the source place, 24-hour or 12-hour, e.g. "15:00", "3pm", "9:30 am". Omit (with date) to convert the current moment. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| notes | Yes | ||
| status | Yes | ||
| primary | Yes | ||
| alternate | Yes | ||
| status_note | Yes |