# Time and Date API: Convert time between cities > Converts a meeting time in one city to local times in other cities, with time zones and 09:00-17:00 working-hours status. Supports dates from 1970 to 2030; ambiguous clock-change times use the first occurrence. Unofficial. Not affiliated with or endorsed by Time and Date. - Page: https://fous.com/methods/timeanddate.com/convert-time-between-cities - Method: `timeanddate.com/convert_time_between_cities`, version 1 - Website: timeanddate.com - Returns: city, country, local date and time, weekday, time zone abbreviation, UTC offset, working-hours status, page link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | no | `"2026-10-15"` | Starting city date as YYYY-MM-DD, for example 2026-10-15. Defaults to today in the starting city. | | `time` | string | yes | `"3pm"` | Meeting time in the starting city, for example 15:00 or 3pm. | | `from_city` | string | yes | `"New York"` | Starting city, for example New York. | | `to_cities` | array of string | yes | `["London","Tokyo"]` | Destination city names (at least one), for example London and Tokyo. | ## Output From a run on Oct 31, 2026. Its input: ```json { "date": "2026-10-15", "time": "3pm", "from_city": "New York", "to_cities": [ "London", "Tokyo" ] } ``` Its output: ```json { "cities": [ { "city": "New York", "country": "USA", "weekday": "Thursday", "page_link": "https://www.timeanddate.com/worldclock/usa/new-york", "local_date": "2026-10-15", "local_time": "2026-10-15T15:00:00-04:00", "utc_offset": "UTC-04:00", "time_as_text": "Thu 3:00 PM", "within_working_hours": "yes", "time_zone_abbreviation": "EDT" }, { "city": "London", "country": "United Kingdom", "weekday": "Thursday", "page_link": "https://www.timeanddate.com/worldclock/uk/london", "local_date": "2026-10-15", "local_time": "2026-10-15T20:00:00+01:00", "utc_offset": "UTC+01:00", "time_as_text": "Thu 8:00 PM", "within_working_hours": "no", "time_zone_abbreviation": "BST" }, { "city": "Tokyo", "country": "Japan", "weekday": "Friday", "page_link": "https://www.timeanddate.com/worldclock/japan/tokyo", "local_date": "2026-10-16", "local_time": "2026-10-16T04:00:00+09:00", "utc_offset": "UTC+09:00", "time_as_text": "Fri 4:00 AM", "within_working_hours": "no", "time_zone_abbreviation": "JST" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"timeanddate.com/convert_time_between_cities","input":{"date":"2026-10-15","time":"3pm","from_city":"New York","to_cities":["London","Tokyo"]}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - If I schedule a call for 3pm in New York on October 15, 2026, what time will it be in London and Tokyo, and is that within business hours there? - Using timeanddate.com, convert 9:30 on 2025-11-03 in Sydney to local times in Berlin, São Paulo, and Toronto. - What time is 14:00 Paris time tomorrow in Mumbai and Los Angeles? I need to know whether each falls between 9 and 5. - Team standup is at 8am in Chicago on March 9, 2026 — show me the local time, weekday, and UTC offset for Singapore, Dubai, and Auckland. - Check on timeanddate what 4:30pm in Johannesburg on 2026-06-22 is in Seoul and Mexico City, including time zone abbreviations. ## Input schema ```json { "type": "object", "required": [ "time", "from_city", "to_cities" ], "properties": { "date": { "type": "string", "description": "Starting city date as YYYY-MM-DD, for example 2026-10-15. Defaults to today in the starting city." }, "time": { "type": "string", "description": "Meeting time in the starting city, for example 15:00 or 3pm." }, "from_city": { "type": "string", "description": "Starting city, for example New York." }, "to_cities": { "type": "array", "items": { "type": "string" }, "description": "Destination city names (at least one), for example London and Tokyo." } } } ``` ## Output schema ```json { "type": "object", "required": [ "cities" ], "properties": { "cities": { "type": "array", "items": { "type": "object", "required": [ "city", "country", "local_date", "local_time", "time_as_text", "weekday", "time_zone_abbreviation", "utc_offset", "within_working_hours", "page_link" ], "properties": { "city": { "type": "string" }, "country": { "type": "string" }, "weekday": { "type": "string" }, "page_link": { "type": "string" }, "local_date": { "type": "string" }, "local_time": { "type": "string" }, "utc_offset": { "type": "string" }, "time_as_text": { "type": "string" }, "within_working_hours": { "type": "string" }, "time_zone_abbreviation": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Time and Date API: Get time in city](https://fous.com/methods/timeanddate.com/get-time-in-city.md): Gets the current local time, time zone, and next daylight saving change for a city listed on Time and Date. Add a state or country to distinguish cities with the same name. - [Time and Date API: Get sunrise and sunset](https://fous.com/methods/timeanddate.com/get-sunrise-and-sunset.md): Gets daily sunrise, sunset, solar noon, day length and civil twilight for a place from Time and Date, for one or more consecutive days. Times are local with UTC offset; days without sunrise or sunset are marked. - [Time and Date API: Count business days](https://fous.com/methods/timeanddate.com/count-business-days.md): Counts weekdays between two dates, excluding nationwide public holidays or, optionally, public holidays in a state or province, from Time and Date's published holiday calendar. - [Numbeo API: Compare cost of living between two cities](https://fous.com/methods/numbeo.com/compare-cost-of-living.md): Compares living costs in two Numbeo cities: six price and purchasing-power differences, plus the monthly take-home salary needed in the destination for a similar standard of living (rent assumed in both cities). - [OpenTable API: Check restaurant availability](https://fous.com/methods/opentable.com/check-restaurant-availability.md): Checks reservation times at an OpenTable restaurant by name and city or restaurant link. Shows times near the requested time; availability can change, and some restaurants limit online bookings for large parties. - [Meetup API: Search events](https://fous.com/methods/meetup.com/search-events.md): Finds upcoming public Meetup events by topic and city, sorted by start time. Only events that mention the topic are included; external costs and undisclosed venues may not be shown. - [OpenTable API: Search available tables](https://fous.com/methods/opentable.com/search-available-tables.md): Finds OpenTable restaurants with bookable slots within two hours of the selected time in a city or neighborhood, in OpenTable search order, optionally for one cuisine. Examines up to 300 listings; availability may change. - [XE API: Get historical exchange rate](https://fous.com/methods/xe.com/get-historical-rate.md): Gets XE's daily mid-market exchange rate for a past UTC date and converts an amount with it. - [All Time and Date methods](https://fous.com/methods/timeanddate.com.md)