Metadata-Version: 2.4
Name: jcal
Version: 2026.5.4
Summary: `jcal` is a package for Japanese holiday.
Author: Saito Tsutomu
Author-email: Saito Tsutomu <tsutomu7@hotmail.co.jp>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 1 - Planning
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.14
Project-URL: homepage, https://github.com/SaitoTsutomu/jcal
Description-Content-Type: text/markdown

# jcal

`jcal` is a package for Japanese holiday at 2000-2027.
https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html

## Installation

```sh
uv add jcal
```

## Example

```python
from pprint import pprint
from jcal import holidays

pprint(holidays(2026))
```

```output
{2026-01-01 (元日),
 2026-01-12 (成人の日),
 2026-02-11 (建国記念の日),
 2026-02-23 (天皇誕生日),
 2026-03-20 (春分の日),
 2026-04-29 (昭和の日),
 2026-05-03 (憲法記念日),
 2026-05-04 (みどりの日),
 2026-05-05 (こどもの日),
 2026-05-06 (振替休日),
 2026-07-20 (海の日),
 2026-08-11 (山の日),
 2026-09-21 (敬老の日),
 2026-09-22 (国民の休日),
 2026-09-23 (秋分の日),
 2026-10-12 (スポーツの日),
 2026-11-03 (文化の日),
 2026-11-23 (勤労感謝の日)}
```

```sh
jcal 2026
```

```output
                                  2026

      January                   February                   March
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
          1  2  3  4                         1                         1
 5  6  7  8  9 10 11       2  3  4  5  6  7  8       2  3  4  5  6  7  8
12 13 14 15 16 17 18       9 10 11 12 13 14 15       9 10 11 12 13 14 15
19 20 21 22 23 24 25      16 17 18 19 20 21 22      16 17 18 19 20 21 22
26 27 28 29 30 31         23 24 25 26 27 28         23 24 25 26 27 28 29
                                                    30 31

       April                      May                       June
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
       1  2  3  4  5                   1  2  3       1  2  3  4  5  6  7
 6  7  8  9 10 11 12       4  5  6  7  8  9 10       8  9 10 11 12 13 14
13 14 15 16 17 18 19      11 12 13 14 15 16 17      15 16 17 18 19 20 21
20 21 22 23 24 25 26      18 19 20 21 22 23 24      22 23 24 25 26 27 28
27 28 29 30               25 26 27 28 29 30 31      29 30

        July                     August                  September
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
       1  2  3  4  5                      1  2          1  2  3  4  5  6
 6  7  8  9 10 11 12       3  4  5  6  7  8  9       7  8  9 10 11 12 13
13 14 15 16 17 18 19      10 11 12 13 14 15 16      14 15 16 17 18 19 20
20 21 22 23 24 25 26      17 18 19 20 21 22 23      21 22 23 24 25 26 27
27 28 29 30 31            24 25 26 27 28 29 30      28 29 30
                          31

      October                   November                  December
Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
          1  2  3  4                         1          1  2  3  4  5  6
 5  6  7  8  9 10 11       2  3  4  5  6  7  8       7  8  9 10 11 12 13
12 13 14 15 16 17 18       9 10 11 12 13 14 15      14 15 16 17 18 19 20
19 20 21 22 23 24 25      16 17 18 19 20 21 22      21 22 23 24 25 26 27
26 27 28 29 30 31         23 24 25 26 27 28 29      28 29 30 31
                          30
```
