Japan Holidays & Business Days Calculator (Cabinet Office Data)

Answer the questions every Japan-facing workflow runs into: Is this date a Japanese holiday? What is the next business day? What is the date 10 business days after the invoice? How many business days are in Q4?

• Official national holidays from the Cabinet Office of Japan (内閣府「国民の祝日」CSV, 1955 → next year), with Japanese and English names
• Beyond the official list (announced about a year ahead) the calendar is calculated from the Holiday Act (1970–2050) and marked holidaySource: "calculated"
• Substitute holidays (振替休日) and citizens' holidays (国民の休日) included
• Bank closure (Dec 31–Jan 3) or government / company closure (Dec 29–Jan 3) options
• Saturday-working businesses, your own closed days (Obon, company anniversary) and extra working days
• No API key, no scraping, runs in about 2 seconds

Typical uses

• Payment & delivery due dates – "payment due 10 business days after invoice", "ships in 3 business days", for Japanese customers or suppliers.
• Schedulers & automations – run a daily Apify schedule / Make / n8n / Zapier flow only on Japanese business days (check isBusinessDay for today).
• SLA and lead-time reports – count business days between two dates.
• Content calendars & campaigns – list all Japanese holidays (Golden Week, Silver Week, Obon is not a national holiday!) for the next two years in English.
• AI agents – a small, deterministic tool an agent can call instead of guessing Japanese holidays.

Input

{
  "years": [2026, 2027],
  "dates": ["today", "2026-12-31"],
  "addBusinessDays": [{ "from": "today", "days": 10, "label": "due date" }],
  "countBusinessDays": [{ "from": "2026-10-01", "to": "2026-12-31", "label": "Q4" }],
  "yearEndClosure": "bank"
}

today means today in Japan time (JST). Leave any list empty to skip it.

Output

Each row has a type:

{ "type": "holiday", "date": "2026-09-22", "weekday": "Tuesday", "weekdayJa": "火",
  "holidayName": "休日", "holidayNameEn": "Citizen's Holiday", "isBusinessDay": false,
  "nonBusinessReason": "national holiday", "holidaySource": "cabinet-office" }

{ "type": "date-check", "date": "2026-09-25", "isBusinessDay": true,
  "nextBusinessDay": "2026-09-28", "previousBusinessDay": "2026-09-24" }

{ "type": "add-business-days", "from": "2026-09-25", "businessDays": 10,
  "result": "2026-10-09", "resultWeekday": "Friday", "calendarDaysSpan": 14 }

{ "type": "count-business-days", "from": "2026-10-01", "to": "2026-12-31",
  "businessDays": 63, "calendarDays": 92, "nationalHolidays": 3 }

Accuracy

• Holidays inside the Cabinet Office list come straight from that list, and for 1970–2027 the calculated calendar matches it exactly (tested).
• Future holidays after the official list are calculated; the equinox days are fixed by the government each February for the following year, so very distant years can change. Such rows are marked "holidaySource": "calculated".
• Company-specific holidays (Obon, year-end) differ between companies – use the closure option and Extra closed dates.

Pricing

Pay per event: $0.0003 per result row plus a tiny start fee. Listing two years of holidays costs about one cent.

Source & license

Holiday list: Cabinet Office, Government of Japan, 「国民の祝日について」 (syukujitsu.csv), used under the Public Data License v1.0 (公共データ利用規約 第1.0版). Calculated years: holiday_jp (MIT). Processed by panda studio.