python-shukujitsu

Python Japanese holidays library based on static data published by Cabinet Office, Government of Japan

Important notices

This python-shukujitsu package covers only holidays in Japan from 1955 to 2024; will expand to holidays in 2025 in February 2024.
This python-shukujitsu package has ZERO relation to the Government of Japan - NEVER EVER assume any authorization as this is just a personal project.
The signature key 8A124CD64688ABCC was expired Mon Nov 21 11:31:15 2022 UTC; please file an issue if you hit troubles around DEB/RPM packages due to the expiry.

Installation

pip3 install python-shukujitsu

Usage

Play the dict-like object.

import shukujitsu

jp_holidays = shukujitsu.Japan()
# or:
# jp_holidays = shukujitsu.JP()
# or:
# jp_holidays = shukujitsu.CountryHoliday('JP')

from datetime import date

date(2020, 7, 24) in jp_holidays  # True
date(2019, 7, 24) in jp_holidays  # False

# The dict-like object also accepts misc. date(time)-like strings
# and int/float representing a Unix timestamp
'2014-01-01' in jp_holidays  # True
'1/1/2014' in jp_holidays    # True
1388597445 in jp_holidays    # True

jp_holidays.get('2014-01-01')  # "元日"

jp_holidays['2014-01-01': '2014-01-03']  # [date(2014, 1, 1)]

Command-Line interface

shukujitsu command is bundled.

$ shukujitsu --help  # or python3 -m shukujitsu --help
usage: shukujitsu [-h] [-i] [-n] [-V] [DATE ...]

Select Japanese holidays from 1955 to 2024

positional arguments:
  DATE                date to be examined

options:
  -h, --help          show this help message and exit
  -i, --invert-match  select non-holidays
  -n, --holiday-name  output holiday name instead
  -V, --version       display version information and exit

With no DATE, read standard input. Exit status is 0 if any date is selected, 1 otherwise.

Pass any dates through command-line arguments or STDIN.

$ # With logical operators
$ shukujitsu 1/1/2020 && echo Holiday found || echo Holiday not found
1/1/2020
Holiday found

$ # Select holidays
$ cat <<EOF | shukujitsu > holidays.txt
> 2020-05-02
> 2020-05-03
> 2020-05-04
> 2020-05-05
> 2020-05-06
> 2020-05-07
> EOF

$ # Select holidays
$ shukujitsu 2020/7/22 2020/7/23 2020/7/24
2020/7/23
2020/7/24

$ # Output each holiday name
$ shukujitsu -n 2020/7/22 2020/7/23 2020/7/24
海の日
スポーツの日

$ # Select non-holidays
$ shukujitsu -i 2020/7/22 2020/7/23 2020/7/24
2020/7/22

Docker image

$ docker run -it sakuraiyouhei/shukujitsu --help

yum repository

$ sudo yum install -y curl
$ curl -fsSL https://sakurai-youhei.github.io/python-shukujitsu/rpm/python-shukujitsu.repo | sudo tee /etc/yum.repos.d/python-shukujitsu.repo
$ sudo yum install -y python-shukujitsu
$ shukujitsu --help

apt repository

$ sudo apt install -y curl gpg
$ curl -fsSL https://sakurai-youhei.github.io/python-shukujitsu/gpg | sudo apt-key add -
$ curl -fsSL https://sakurai-youhei.github.io/python-shukujitsu/deb/python-shukujitsu.list | sudo tee /etc/apt/sources.list.d/python-shukujitsu.list
$ sudo apt update
$ sudo apt install -y python-shukujitsu
$ shukujitsu --help

Source data

This python-shukujitsu package bundles the following source data, which is distributed by the Government of Japan under the CC BY compatible conditions according to 内閣府ホームページ利用規約.

2023年2月1日時点の内閣府ホームページで公開されていた「昭和30年（1955年）から令和6年（2024年）国民の祝日（csv形式：20KB）」（ https://www8.cao.go.jp/chosei/shukujitsu/shukujitsu.csv ）
2022年2月1日時点の内閣府ホームページで公開されていた「昭和30年（1955年）から令和5年（2023年）国民の祝日（csv形式：20KB）」（ https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv ）
2021年2月1日時点の内閣府ホームページで公開されていた「昭和30年（1955年）から令和4年（2022年）国民の祝日（csv形式：19KB）」（ https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv ）
2020年11月27日時点の内閣府ホームページで公開されていた「昭和30年（1955年）から令和3年（2021年）国民の祝日（csv形式：19KB）」（ https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv ）
2020年11月18日時点の内閣府ホームページで公開されていた「昭和30年（1955年）から令和3年（2021年）国民の祝日（csv形式：19KB）」（ https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv ）

Release files for python-shukujitsu 2023.2.1.post11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-shukujitsu 2023.2.1.post11
File	Size	Uploaded
python-shukujitsu-2023.2.1.post11.tar.gz	13.1 kB	Feb 1, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-shukujitsu 2023.2.1.post11
File	Interpreter	ABI	Platform	Reset
python_shukujitsu-2023.2.1.post11-py3-none-any.whl 39.6 kB Feb 1, 2023	Python 3	none	any	Details

Total release size:52.7 kB

Release files / python-shukujitsu-2023.2.1.post11.tar.gz

Download URL	python-shukujitsu-2023.2.1.post11.tar.gz
Size	13.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`0abb9ad47c750d4b1a46c61de5dbc516cb71a0e198531022bd524b385461476a`
BLAKE2b-256 checksum How to use checksums	`fa67d1158f8458fc5caff5cd51efa1ffce28e5f3ba3f7cb316020bc6f079949c`
Upload date	Feb 1, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.1`

Release files / python_shukujitsu-2023.2.1.post11-py3-none-any.whl

Download URL	python_shukujitsu-2023.2.1.post11-py3-none-any.whl
Size	39.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`92cf39e6bcb90b5b78d210673311376a5ac93f71ffa75c0e481109fbf24d3958`
BLAKE2b-256 checksum How to use checksums	`a8479c9a83a859fe9f4fb53f2d55ddbaabf8ad5b72bb82f383fe2584a68c991b`
Upload date	Feb 1, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.1`