Skip to main content

Japanese holiday for Python

Project description

Build Status PyPI version PyPI downloads GitHub release Codacy Badge


Japanese holiday for Python 3+ using dataset from


pip3 install holiday-jp

If you want to contribute

Build on linux with python 3.x

Clone the project or download the source

git clone


pip3 install -r requirements.txt


python3 -m unittest holiday_jp.test

Build command:

python3 sdist


Run ./ build the package that will be available in the dist/ directory

alternative install

download the release and install this way: pip3 install holiday_jp-xxx.tar.gz


from holiday_jp import HolidayJp
# with string date YYYY-MM-DD
if HolidayJp('1990-01-01').is_holiday:

import datetime
from holiday_jp import HolidayJp
# or date object
if HolidayJp(

# Between return holidays between 2 dates in text
holidays = HolidayJp.between('2009-01-01', '2009-01-31')
new_year_day = holidays[0]
self.assertEqual(, month=1, day=1), new_year_day.date_obj)

# Or date object
holidays = HolidayJp.between(, month=12, day=23),, month=1, day=12))

For more usage check the unit test holiday_jp/

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for holiday-jp, version 20.12.2
Filename, size File type Python version Upload date Hashes
Filename, size holiday_jp-20.12.2.tar.gz (13.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page