Catalog/maps-tz-overlap

Maps

Timezone overlap & working-hours window API

Given two IANA timezones, report the current local time and UTC offset in each, the signed hour difference, and COMPUTE the overlapping slice of a 9-17 working day shared by both zones — DST-correct offset math evaluated via Intl that an LLM cannot perform. Answers 'what time is it in Tokyo when it's noon in New York', 'how many hours ahead is London', 'overlapping working hours between two timezones', 'best meeting window across zones'.

Price$0.01per request
MethodPOST
Route/v1/maps/tz-overlap
StatusLive
MIME typeapplication/json
Rate limit60/minute
CacheNo cache
mapstimezonetzoverlapworking-hoursutc-offsetianascheduling
API URLhttps://x402.hexl.dev/v1/maps/tz-overlap
Integration docs
Example request
{
  "from": "America/New_York",
  "to": "Europe/London",
  "at": "2026-06-03T12:00:00Z"
}
Example response
{
  "from": {
    "timezone": "America/New_York",
    "offset": "UTC-04:00",
    "offsetMinutes": -240,
    "localTime": "08:00"
  },
  "to": {
    "timezone": "Europe/London",
    "offset": "UTC+01:00",
    "offsetMinutes": 60,
    "localTime": "13:00"
  },
  "hourDifference": 5,
  "workingHours": {
    "start": 9,
    "end": 17
  },
  "overlap": {
    "hours": 3,
    "inToZone": {
      "start": "14:00",
      "end": "17:00"
    },
    "inFromZone": {
      "start": "09:00",
      "end": "12:00"
    }
  }
}
Input schema
{
  "type": "object",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "from": {
      "type": "string",
      "examples": [
        "America/New_York"
      ]
    },
    "to": {
      "type": "string",
      "examples": [
        "Europe/London"
      ]
    },
    "workStart": {
      "type": "number",
      "examples": [
        9
      ]
    },
    "workEnd": {
      "type": "number",
      "examples": [
        17
      ]
    },
    "at": {
      "type": "string",
      "examples": [
        "2026-06-03T12:00:00Z"
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}