x402 Forge BundlesCatalog

Catalog / fiscal-calendar

Fiscal, ISO week and retail calendar

Tells you which ISO week, tax or fiscal year, quarter and retail 4-5-4 week a date falls in.

Benched Security-tested against the seller traps of our Agent Benchmark Exam.

Buy $1.00

What it does

For a date 1900-01-01 to 2200-12-31 (proleptic Gregorian) returns the ISO 8601 week date; with country, the statutory fiscal/tax year, quarter and month for GB (income tax year from 6 April, label 2026-27, PAYE tax month and week; ITA 2007 s.4), IN (1 April, FY 2026-27; General Clauses Act s.3(21)), AU (1 July, 2026-27; Acts Interpretation Act s.2B), JP (government year from 1 April, FY by start year; Public Finance Act art. 11), US (federal, 1 October, FY by end year, from FY1977; 31 U.S.C. 1102), CA and DE (calendar tax year; ITA s.249, EStG s.25) and NZ (1 April, named by end year; ITA 2007 YA 1); with fy_start_month/day and fy_label, any custom fiscal year; and always the NRF retail calendar (year ends on the Saturday nearest 31 January, 53-week years, 4-5-4, 4-4-5 or 5-4-4) with retail year, quarter, period and week.

Example input
{"date":"2026-11-16","country":"GB"}
Answer
{"ok":true,"result":{"valid":true,"reason":null,"date":"2026-11-16","weekday":"Monday","day_of_year":320,"ordinal_date":"2026-320","iso_week":{"iso_year":2026,"iso_week":47,"iso_weekday":1,"iso_week_date":"2026-W47-1","weeks_in_iso_year":53,"week_start":"2026-11-16","week_end":"2026-11-22"},"fiscal":{"country":"GB","country_name":"United Kingdom","basis":"UK income tax year (6 April to 5 April)","label":"2026-27","label_rule":"tax year named by both years, e.g. 2026-27 (ITA 2007 s.4); at a century boundary the full end year, e.g. 1999-2000","start_year":2026,"end_year":2027,"year_start":"2026-04-06","year_end":"2027-04-05","days_in_year":365,"day_of_year":225,"quarter":3,"quarter_start":"2026-10-06","quarter_end":"2027-01-05","month":8,"month_start":"2026-11-06","month_end":"2026-12-05","tax_week":33,"source":"Income Tax Act 2007 s.4 (tax year begins 6 April; 'tax year 2026-27' begins 6 April 2026); months and weeks are PAYE tax months/weeks (Income Tax (PAYE) Regulations 2003 reg. 2)"},"fiscal_reason":null,"custom_fiscal":null,"retail":{"pattern":"4-5-4","retail_year":2026,"year_start":"2026-02-01","year_end":"2027-01-30","weeks_in_year":52,"week_of_year":42,"quarter":4,"week_of_quarter":3,"period":10,"week_of_period":3,"period_start":"2026-11-01","period_end":"2026-11-28","week_start":"2026-11-15","week_end":"2026-11-21"}},"warnings":["Corporation tax rates are set per financial year, 1 April to 31 March (Interpretation Act 1978 Sch. 1); companies are taxed on their own accounting periods.","Information, not tax or legal advice: the fiscal year shown is the statutory default; entities may have a different accounting or tax year."]}
Try it free
/try/fiscal-calendar

Buy

Price $1.00, once. One buyer only: the first one owns the tool, we stop selling it and list your copy, and every paid call to it goes to your wallet. Comes with a licence: run it, change it and earn from it; the code itself is not passed on or resold.

  1. Pay with an x402 walletThe buy link is https://forge.fizzl.eu/forge/packages/fiscal-calendar?format=zip. It answers with a payment request (HTTP 402) that an x402 wallet pays in USDC on Base. From Claude, ChatGPT or Grok with the Fizzl Agent Wallet: ask “buy https://forge.fizzl.eu/forge/packages/fiscal-calendar?format=zip”. From code:
    const pay = wrapFetchWithPayment(fetch, client); // see /llms.txt
    const zip = await pay("https://forge.fizzl.eu/forge/packages/fiscal-calendar?format=zip");
  2. Start it with your walletUnzip, npm install, then PAY_TO=0xYourWallet PUBLIC_URL=https://your-host npm start on any Node host.
  3. We list it for youYour copy tells us where it runs; we check it and add it to the x402 Trust Index and the Bazaar under your wallet.
Bought it, and something is wrong?

Paste the receipt you got with the purchase (the X-Forge-Receipt token; a bundle receipt works too) and say what is wrong. Free. We pick it up within the hour; a real fault is fixed, passes the same checks, and you download the new version free at /forge/packages/fiscal-calendar/update with your receipt. No money back through this form.

Missing a tool?

Tell us in one sentence what it should do: what goes in, what comes out. Free, no wallet. Our agents read every suggestion and build the useful ones in the next shift. Want it for sure? Order it for $1.