jpholiday
Pure-Python Japan Public Holiday Generate
Decision gist · record as of 2026-08-14
Yes. The package is lightweight, actively maintained, has no external dependencies, supports current Python versions, carries no known vulnerabilities, and solves a specific, well-defined problem for applications targeting Japanese calendars. Install it if you need reliable Japanese holiday lookups.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Holiday data is verified through 2026; accuracy beyond that year is not guaranteed.
- Low friction install with no runtime dependencies.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice.
last release 2025-12-26 (231 days) · last repo commit 2026-06-25 · 257 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 679,620 downloads/mo, #5,368 on PyPI
Alternatives
Verify before relying
pip install jpholiday
import jpholiday
import datetime
jpholiday.is_holiday(datetime.date(2017, 1, 1))
# True
jpholiday.is_holiday_name(datetime.date(2017, 1, 1))
# '元日'- Whether the library updates its holiday data automatically or requires manual updates for years beyond 2026.
- Performance characteristics when querying large date ranges or years far in the future.
What it is and what it does
JPHoliday is a pure-Python library that provides access to Japanese national holidays based on official government data published by the Cabinet Office. It lets you check whether a specific date is a holiday, retrieve the holiday name, and query holidays across various time ranges—by specific date, year, month, or custom date range. The library handles substitute holidays (振替休日) automatically when a national holiday falls on a Sunday.
The package is designed for applications that need to respect Japanese business calendars, such as scheduling systems, payroll processing, or calendar applications. It supports both class-based and function-based APIs and allows you to register custom holidays via the OriginalHolidayCheckerInterface. Holiday data is verified through 2026 based on official announcements; queries beyond that year are possible but not guaranteed to be accurate.
Use it for
- Check if a date is a Japanese national holiday when building scheduling or calendar applications.
- Generate lists of holidays for a given year or month to populate business calendars or time-off policies.
- Filter out Japanese holidays from work schedules or project timelines in payroll or project management systems.
- Query holidays within a date range to identify non-working days for compliance or reporting purposes.
- Register custom company holidays alongside national holidays for organization-specific calendar logic.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is lightweight, actively maintained, has no external dependencies, supports current Python versions, carries no known vulnerabilities, and solves a specific, well-defined problem for applications targeting Japanese calendars. Install it if you need reliable Japanese holiday lookups.
Install
jpholiday on PyPI
Before you install
Low friction install with no runtime dependencies. Actively maintained with recent commits and stable production status across Python 3.9 through 3.14.
Requires Python 3.9 or later. Holiday data is verified through 2026; accuracy beyond that year is not guaranteed.
License in practice
MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice.
Quickstart
pip install jpholiday
import jpholiday
import datetime
jpholiday.is_holiday(datetime.date(2017, 1, 1))
# True
jpholiday.is_holiday_name(datetime.date(2017, 1, 1))
# '元日'Verify before relying
- Whether the library updates its holiday data automatically or requires manual updates for years beyond 2026.
- Performance characteristics when querying large date ranges or years far in the future.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 231 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 679,620 / month, #5,368 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishNatural Language :: JapaneseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Topic :: Other/Nonlisted TopicTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed |
Evidence: jpholiday-1.0.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “japanese holiday calendar”
- jpholidayQueries Japanese national holidays and substitute holidays based on…
- chinese-calendarDetermines whether a specific date in China is a working day or…
- holidaysGenerates country- and subdivision-specific government holiday…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also chinese-calendar · holidays · workalendar · semantic-link-functions-holidays · govuk-bank-holidays · workadays · convertdate · hdate · pandas_market_calendars · pyluach