Home › Everyday Life › Count Japan National Working Days
Count Japan National Working Days
Counts Japan statutory-baseline working and non-working dates for a pinned year range.
When to use
You need an auditable Japan statutory national-holiday working-day count.
Do not use when: You need a company, school, bank, exchange or prefectural closure calendar.
Example user requests
- Count Japan working days from 2027-03-01 to 2027-03-31.
Formula
for each included date: working_days += Japan national status.is_working_day
Normalize endpoints, apply endpoint flags, and count the pinned Japan calendar over the CLDR weekend baseline.
Inputs
| Parameter | Type | Unit | Required | Description |
|---|---|---|---|---|
start_date | date | yes | First date in 2026-2027. | |
end_date | date | yes | Last date in 2026-2027. | |
include_start_date | boolean | default true | Whether start_date participates. | |
include_end_date | boolean | default true | Whether end_date participates. |
Outputs
| Output | Type | Unit | Description |
|---|---|---|---|
normalized_start_date | date | Earlier endpoint. | |
normalized_end_date | date | Later endpoint. | |
working_days | integer | Japan statutory-baseline working dates. | |
non_working_days | integer | Weekend and statutory holiday dates. | |
national_holidays_counted | list | Cabinet Office events in the range. | |
territory | string | JP. | |
territory_name | string | Japan. | |
day_type | string | Regular weekday, regular weekend or statutory national holiday. | |
holiday_names | string_list | Japanese statutory holiday names applying on the date. | |
holiday_kinds | string_list | National holiday or statutory holiday under the Cabinet Office table. | |
holiday_legal_bases | string_list | Holiday Act or Cabinet Office legal classification. | |
weekend_days | string_list | CLDR Saturday/Sunday baseline. | |
calendar_scope | string | Japan statutory national holidays only. | |
rest_day_policy | string | Company, school, bank and exchange closures are not inferred. | |
calendar_profile | string | jp-cabinet-office-national-holidays. | |
dataset_version | string | Pinned Cabinet Office evidence package. | |
sources | list | Official Cabinet Office and legislation sources. |
Example
March 2027: {"start_date":"2027-03-01","end_date":"2027-03-31","include_start_date":true,"include_end_date":true} → {"working_days":22}
GET https://tttkmbb.com/api/v1/calculate/japan-national-working-days-between?start_date=2027-03-01&end_date=2027-03-31&include_start_date=true&include_end_date=true
Machine access
- API:
GET https://tttkmbb.com/api/v1/calculate/japan-national-working-days-between(query parameters) orPOSTwith a JSON body{"inputs": {...}} - Schema: https://tttkmbb.com/api/v1/calculators/japan-national-working-days-between · Markdown: https://tttkmbb.com/everyday/japan-national-working-days-between.md · JSON definition: https://tttkmbb.com/everyday/japan-national-working-days-between.json
- MCP: server
https://tttkmbb.com/mcp, toolcount_japan_national_working_days - OpenAPI operationId:
count_japan_national_working_days - Freshness:
static. Authentication: none. Rate limit: fair use (see rate limits).
Sources
- Cabinet Office of Japan - National Holidays (government)
- Act on National Holidays (Act No. 178 of 1948) (legislation)
FAQ
Is this a general Japanese business calendar?
No. It is explicitly scoped to statutory national holidays.
Related calculators
- Japan National Holiday Working Day — Inspect a date and its official legal basis.