World Clock API

Current (or given) time in several IANA time zones, with date, UTC offset, day/night and the difference from a reference zone.

POST /api/v1/tools/world-clockMCP world_clockTime & Date

Live clocks for the cities you choose, each with the date, UTC offset, day or night, and how far ahead or behind your own time it is. Your list is remembered.

Input

Send these as a JSON object. Unknown fields are rejected.

zones: Comma-separated IANA time zones, up to 24, e.g. "America/New_York,Europe/London,Asia/Tokyo". Defaults to America/New_York, Europe/London, Europe/Paris, Asia/Kolkata, Asia/Tokyo, Australia/Sydney. (string, up to 2000 characters, default "America/New_York,Europe/London,Europe/Paris,Asia/Kolkata,Asia/Tokyo,Australia/Sydney")
reference: IANA zone the differences are measured from. (string, up to 64 characters, default "UTC")
at: ISO 8601 instant to show, e.g. 2026-10-20T12:00:00Z. Defaults to now. (string, up to 40 characters)

Try it in the browser JSON Schema Get an API key

curl https://pithlab.com/api/v1/tools/world-clock \n  -H "Authorization: Bearer $PITHLAB_KEY" \n  -H "Content-Type: application/json" \n  -d '{"zones":"America/New_York,Europe/London,Asia/Tokyo","reference":"Europe/London","at":"2026-10-20T12:00:00Z"}'

Example response

{
  "ok": true,
  "result": {
    "at": "2026-10-20T12:00:00.000Z",
    "reference": "Europe/London",
    "clocks": [
      {
        "zone": "America/New_York",
        "city": "New York",
        "time": "08:00:00",
        "date": "Tue 20 Oct 2026",
        "offset": "UTC-04:00",
        "offsetMinutes": -240,
        "isDay": true,
        "diffMinutes": -300,
        "difference": "5 h behind",
        "dayShift": 0,
        "text": "New York: 08:00:00, Tue 20 Oct 2026 (UTC-04:00), day, 5 h behind"
      },
      {
        "zone": "Europe/London",
        "city": "London",
        "time": "13:00:00",
        "date": "Tue 20 Oct 2026",
        "offset": "UTC+01:00",
        "offsetMinutes": 60,
        "isDay": true,
        "diffMinutes": 0,
        "difference": "same time",
        "dayShift": 0,
        "text": "London: 13:00:00, Tue 20 Oct 2026 (UTC+01:00), day, same time"
      },
      {
        "zone": "Asia/Tokyo",
        "city": "Tokyo",
        "time": "21:00:00",
        "date": "Tue 20 Oct 2026",
        "offset": "UTC+09:00",
        "offsetMinutes": 540,
        "isDay": false,
        "diffMinutes": 480,
        "difference": "8 h ahead",
        "dayShift": 0,
        "text": "Tokyo: 21:00:00, Tue 20 Oct 2026 (UTC+09:00), night, 8 h ahead"
      }
    ]
  }
}