{"openapi":"3.1.0","info":{"title":"Time Zones and Dates","version":"1.0.0","description":"Exact time zone conversion, DST transitions, meeting overlap, business days, date differences and ISO weeks. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Time Zones and Dates: Exact time zone conversion, DST transitions, meeting overlap, business days, date differences and ISO weeks. Time Zones and Dates does exact calendar and clock math an agent should not guess: current time in a zone (/time-now), converting a date and time between zones (/time-convert), the offset between two zones (/tz-offset-diff), daylight saving transitions in a year (/dst-info), the overlap of working hours across several zones (/meeting-planner), adding and counting business days (/business-days), the difference between two dates (/date-diff), ISO week and quarter (/week-number) and age (/age-calc). Zones are IANA names such as America/New_York. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://timezone-time.x402tookit.com"}],"paths":{"/age-calc":{"get":{"operationId":"age_calc","summary":"Exact age in years, months and days from a birth date as of a date, plus next birthday and days until it.","description":"Exact age in years, months and days from a birth date as of a date, plus next birthday and days until it.","tags":["dates","age","birthday"],"parameters":[{"name":"birth_date","in":"query","required":true,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"as_of","in":"query","required":false,"description":"YYYY-MM-DD, default today (UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"birthDate":{"type":["null","string"]},"ageAsOf":{"type":["null","string"]},"years":{"type":["null","number"]},"months":{"type":["null","number"]},"days":{"type":["null","number"]},"totalDays":{"type":["null","number"]},"nextBirthday":{"type":["null","string"]},"daysToNextBirthday":{"type":["null","number"]},"adult18":{"type":["boolean","null"]},"adult21":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"AGE_COMPUTED","summary":"36 years, 7 months, 13 days old as of 2026-10-11; next birthday 2027-02-28 (in 140 days).","reasons":["A 29 February birthday is celebrated on 28 February in non-leap years here."],"birthDate":"1990-02-28","ageAsOf":"2026-10-11","years":36,"months":7,"days":13,"totalDays":13374,"nextBirthday":"2027-02-28","daysToNextBirthday":140,"adult18":true,"adult21":true,"degraded":false,"notChecked":["time zones","cultural age-counting systems"],"source":"computed locally","asOf":"2026-10-11T04:05:04.471Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/age-calc"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/age-calc"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/age-calc"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/age-calc"}}]}}},"/business-days":{"get":{"operationId":"business_days","summary":"Add business days to a date or count the business days between two dates, Monday-Friday, skipping holidays you list.","description":"Add business days to a date or count the business days between two dates, Monday-Friday, skipping holidays you list.","tags":["dates","business-days","calendar"],"parameters":[{"name":"start","in":"query","required":true,"description":"Start date YYYY-MM-DD","schema":{"type":"string"}},{"name":"add_days","in":"query","required":false,"description":"Business days to add (negative to subtract); give this or end","schema":{"type":"integer"}},{"name":"end","in":"query","required":false,"description":"End date to count to; give this or add_days","schema":{"type":"string"}},{"name":"holidays","in":"query","required":false,"description":"Comma-separated YYYY-MM-DD dates to skip","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"start":{"type":["null","string"]},"businessDaysAdded":{"type":["null","number"]},"result":{"type":["null","string"]},"weekday":{"type":["null","string"]},"holidaysSkipped":{"type":["array","null"],"items":{"type":"string"}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"DATE_COMPUTED","summary":"2026-10-09 + 5 business days = 2026-10-19 (Monday).","reasons":["1 listed holiday(s) were skipped."],"start":"2026-10-09","businessDaysAdded":5,"result":"2026-10-19","weekday":"Monday","holidaysSkipped":["2026-10-12"],"degraded":false,"notChecked":["public holidays unless you list them","country-specific work weeks (Friday-Saturday weekends)"],"source":"computed locally","asOf":"2026-10-11T04:05:04.733Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/business-days"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/business-days"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/business-days"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/business-days"}}]}}},"/date-diff":{"get":{"operationId":"date_diff","summary":"Exact difference between two dates as years, months and days, plus total days, weeks and whole months.","description":"Exact difference between two dates as years, months and days, plus total days, weeks and whole months.","tags":["dates","calendar","duration"],"parameters":[{"name":"start","in":"query","required":true,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"end","in":"query","required":true,"description":"YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"start":{"type":["null","string"]},"end":{"type":["null","string"]},"years":{"type":["null","number"]},"months":{"type":["null","number"]},"days":{"type":["null","number"]},"totalDays":{"type":["null","number"]},"totalWeeks":{"type":["null","number"]},"totalMonthsWhole":{"type":["null","number"]},"direction":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"END_AFTER_START","summary":"2024-02-28 to 2026-10-11: 2 year(s), 7 month(s), 13 day(s); 956 days in total (136 weeks and 4 days).","reasons":["Years and months count whole calendar units; days are what remains."],"start":"2024-02-28","end":"2026-10-11","years":2,"months":7,"days":13,"totalDays":956,"totalWeeks":136,"totalMonthsWhole":31,"direction":"forward","degraded":false,"notChecked":["time of day and time zones (whole calendar dates only)"],"source":"computed locally","asOf":"2026-10-11T04:05:04.996Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/date-diff"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/date-diff"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/date-diff"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/date-diff"}}]}}},"/dst-info":{"get":{"operationId":"dst_info","summary":"Daylight saving transitions of an IANA time zone in a year: exact UTC instants, offsets before and after, and the clock change.","description":"Daylight saving transitions of an IANA time zone in a year: exact UTC instants, offsets before and after, and the clock change.","tags":["time","dst","timezone"],"parameters":[{"name":"tz","in":"query","required":true,"description":"IANA time zone","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Year, 1970 to 2100, default current year","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"tz":{"type":["null","string"]},"year":{"type":["null","number"]},"transitions":{"type":["array","null"],"items":{"type":"object","properties":{"atUtc":{"type":["null","string"]},"offsetBefore":{"type":["null","string"]},"offsetAfter":{"type":["null","string"]},"change":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"OBSERVES_DST","summary":"America/New_York in 2026: 2026-03-08T07:00Z clocks forward 1 h; 2026-11-01T06:00Z clocks back 1 h.","reasons":["Transitions are found by scanning each hour of the year against the IANA database."],"tz":"America/New_York","year":2026,"transitions":[{"atUtc":"2026-03-08T07:00:00.000Z","offsetBefore":"-05:00","offsetAfter":"-04:00","change":"clocks forward 1 h"},{"atUtc":"2026-11-01T06:00:00.000Z","offsetBefore":"-04:00","offsetAfter":"-05:00","change":"clocks back 1 h"}],"degraded":false,"notChecked":["future legal changes to the zone's DST rules"],"source":"computed locally","asOf":"2026-10-11T04:05:05.629Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/dst-info"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/dst-info"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/dst-info"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/dst-info"}}]}}},"/meeting-planner":{"get":{"operationId":"meeting_planner","summary":"Find the meeting hours where everyone is within working hours across up to 6 time zones on a date, with local times.","description":"Find the meeting hours where everyone is within working hours across up to 6 time zones on a date, with local times.","tags":["time","meetings","timezone"],"parameters":[{"name":"zones","in":"query","required":true,"description":"Comma-separated IANA zones, 2 to 6","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today (UTC)","schema":{"type":"string"}},{"name":"start_hour","in":"query","required":false,"description":"Working day start, default 9","schema":{"type":"integer"}},{"name":"end_hour","in":"query","required":false,"description":"Working day end, default 17","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"date":{"type":["null","string"]},"workingHours":{"type":["null","string"]},"zones":{"type":["array","null"],"items":{"type":"object","properties":{"tz":{"type":["null","string"]},"utcOffset":{"type":["null","string"]}}}},"sharedStartHoursUtc":{"type":["array","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NO_COMMON_HOURS","summary":"No hour on 2026-01-15 falls inside 9:00 to 17:00 in all of New_York, London, Kolkata.","reasons":["Widen the working hours or ask someone to flex outside them."],"date":"2026-01-15","workingHours":"9:00-17:00","zones":[{"tz":"America/New_York","utcOffset":"-05:00"},{"tz":"Europe/London","utcOffset":"+00:00"}],"sharedStartHoursUtc":[],"degraded":false,"notChecked":["public holidays","half-hour offsets for slots (slots are whole UTC hours)","…1 more"],"source":"computed locally","asOf":"2026-10-11T04:05:05.892Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/meeting-planner"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/meeting-planner"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/meeting-planner"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/meeting-planner"}}]}}},"/time-convert":{"get":{"operationId":"time_convert","summary":"Convert a date and time from one IANA time zone to another, flagging times that do not exist or occur twice at DST changes.","description":"Convert a date and time from one IANA time zone to another, flagging times that do not exist or occur twice at DST changes.","tags":["time","timezone","convert"],"parameters":[{"name":"datetime","in":"query","required":true,"description":"Local date and time, YYYY-MM-DDTHH:MM","schema":{"type":"string"}},{"name":"from_tz","in":"query","required":true,"description":"Source zone, e.g. America/New_York","schema":{"type":"string"}},{"name":"to_tz","in":"query","required":true,"description":"Target zone, e.g. Asia/Tokyo","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"utc":{"type":["null","string"]},"from":{"type":["null","object"],"properties":{"tz":{"type":["null","string"]},"local":{"type":["null","string"]},"utcOffset":{"type":["null","string"]},"abbreviation":{"type":["null","string"]}}},"to":{"type":["null","object"],"properties":{"tz":{"type":["null","string"]},"local":{"type":["null","string"]},"utcOffset":{"type":["null","string"]},"abbreviation":{"type":["null","string"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"Jul 4, 2026, 15:30 EDT = Jul 5, 2026, 04:30 GMT+9 (2026-07-05 04:30).","reasons":["Converted through the exact UTC instant."],"utc":"2026-07-04T19:30:00.000Z","from":{"tz":"America/New_York","local":"Jul 4, 2026, 15:30","utcOffset":"-04:00","abbreviation":"EDT"},"to":{"tz":"Asia/Tokyo","local":"Jul 5, 2026, 04:30","utcOffset":"+09:00","abbreviation":"GMT+9"},"degraded":false,"notChecked":["future rule changes to either zone"],"source":"computed locally","asOf":"2026-10-11T04:05:06.151Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-convert"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-convert"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-convert"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-convert"}}]}}},"/time-now":{"get":{"operationId":"time_now","summary":"Current date and time in an IANA time zone, with UTC offset, abbreviation and whether daylight saving time is in effect.","description":"Current date and time in an IANA time zone, with UTC offset, abbreviation and whether daylight saving time is in effect.","tags":["time","timezone","clock"],"parameters":[{"name":"tz","in":"query","required":true,"description":"IANA time zone, e.g. America/New_York, Europe/London, Asia/Tokyo","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"tz":{"type":["null","string"]},"nowUtc":{"type":["null","string"]},"local":{"type":["null","string"]},"utcOffset":{"type":["null","string"]},"utcOffsetMinutes":{"type":["null","number"]},"abbreviation":{"type":["null","string"]},"observesDst":{"type":["boolean","null"]},"daylightTimeNow":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"DAYLIGHT_TIME","summary":"Sunday, October 11, 2026 at 00:05:06 EDT (UTC-04:00, EDT).","reasons":["Daylight saving time is in effect."],"tz":"America/New_York","nowUtc":"2026-10-11T04:05:06.414Z","local":"Sunday, October 11, 2026 at 00:05:06 EDT","utcOffset":"-04:00","utcOffsetMinutes":-240,"abbreviation":"EDT","observesDst":true,"daylightTimeNow":true,"degraded":false,"notChecked":["the accuracy of this server's clock (assumed correct)","recent legal changes to the zone's rules"],"source":"computed locally","asOf":"2026-10-11T04:05:06.415Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-now"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-now"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-now"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/time-now"}}]}}},"/tz-offset-diff":{"get":{"operationId":"tz_offset_diff","summary":"Hours of difference between two IANA time zones on a given date, with each offset, accounting for daylight saving.","description":"Hours of difference between two IANA time zones on a given date, with each offset, accounting for daylight saving.","tags":["time","timezone","offset"],"parameters":[{"name":"a","in":"query","required":true,"description":"First zone","schema":{"type":"string"}},{"name":"b","in":"query","required":true,"description":"Second zone","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today (UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"date":{"type":["null","string"]},"a":{"type":["null","object"],"properties":{"tz":{"type":["null","string"]},"utcOffset":{"type":["null","string"]}}},"b":{"type":["null","object"],"properties":{"tz":{"type":["null","string"]},"utcOffset":{"type":["null","string"]}}},"hoursBAheadOfA":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"OFFSET_DIFFERENCE","summary":"On 2026-03-20, Europe/London is ahead of America/Los_Angeles by 7 hours (America/Los_Angeles UTC-07:00, Europe/London UTC+00:00).","reasons":["Offsets are taken at noon UTC on the date."],"date":"2026-03-20","a":{"tz":"America/Los_Angeles","utcOffset":"-07:00"},"b":{"tz":"Europe/London","utcOffset":"+00:00"},"hoursBAheadOfA":7,"degraded":false,"notChecked":["transition days where the difference changes mid-day"],"source":"computed locally","asOf":"2026-10-11T04:05:06.678Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/tz-offset-diff"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/tz-offset-diff"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/tz-offset-diff"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/tz-offset-diff"}}]}}},"/week-number":{"get":{"operationId":"week_number","summary":"ISO 8601 week number and week year, day of the year, quarter, weekday and leap-year status for a date.","description":"ISO 8601 week number and week year, day of the year, quarter, weekday and leap-year status for a date.","tags":["dates","iso-week","calendar"],"parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today (UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"date":{"type":["null","string"]},"weekday":{"type":["null","string"]},"isoWeek":{"type":["null","number"]},"isoWeekYear":{"type":["null","number"]},"isoWeekLabel":{"type":["null","string"]},"dayOfYear":{"type":["null","number"]},"daysInYear":{"type":["null","number"]},"quarter":{"type":["null","number"]},"leapYear":{"type":["boolean","null"]},"daysLeftInYear":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"2026-01-01 is Thursday, ISO week 2026-W01, day 1 of 365, quarter 1.","reasons":["ISO weeks start on Monday; week 1 is the week containing the year's first Thursday."],"date":"2026-01-01","weekday":"Thursday","isoWeek":1,"isoWeekYear":2026,"isoWeekLabel":"2026-W01","dayOfYear":1,"daysInYear":365,"quarter":1,"leapYear":false,"daysLeftInYear":364,"degraded":false,"notChecked":["US week numbering (weeks starting Sunday)","fiscal calendars"],"source":"computed locally","asOf":"2026-10-11T04:05:06.941Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/week-number"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/week-number"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/week-number"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://timezone-time.x402tookit.com/week-number"}}]}}}}}