jpholiday

Name	jpholiday JSON
Version	1.0.0 JSON
	download
home_page	https://github.com/Lalcs/jpholiday
Summary	Pure-Python Japan Public Holiday Generate
upload_time	2025-03-20 13:38:01
maintainer	None
docs_url	None
author	Vatis
requires_python	None
license	MIT License
keywords	japan holiday
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # JPHoliday

[![image](https://img.shields.io/pypi/v/jpholiday.svg)](https://pypi.org/project/jpholiday/)
[![image](https://img.shields.io/pypi/l/jpholiday.svg)](https://pypi.org/project/jpholiday/)
[![image](https://img.shields.io/pypi/pyversions/jpholiday.svg)](https://pypi.org/project/jpholiday/)
[![image](https://img.shields.io/github/contributors/lalcs/jpholiday.svg)](https://github.com/lalcs/jpholiday/graphs/contributors)
[![image](https://img.shields.io/pypi/dm/jpholiday)](https://pypistats.org/packages/jpholiday)
![Unittest](https://github.com/Lalcs/jpholiday/workflows/Unittest/badge.svg)

![image](./docs/images/logo.png)

このライブラリは、[内閣府](https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html)
が公表しているデータを基に、日本の国民の祝日を簡単に取得できるようにしたものです。  
**2026年**までの祝日は公式発表された内容に基づいて動作確認済みです。  
それ以降についても取得は可能ですが、内閣府からの正式な公表がないため、正確性は保証されません。

## Installation

```bash
pip install jpholiday
```

## Class

### 指定日の祝日名を取得

```python
from jpholiday import JPHoliday
import datetime

jpholiday = JPHoliday()

jpholiday.holidays(datetime.date(2017, 1, 1))
> [
    Holiday(
        date=datetime.date(2017, 1, 1),
        name='元日'
    )
]
jpholiday.holidays(datetime.date(2017, 1, 2))
> [
    Holiday(
        date=datetime.date(2017, 1, 2),
        name='元日 振替休日'
    )
]
jpholiday.holidays(datetime.date(2017, 1, 3))
> []
```

### 指定日が祝日か判定

```python
from jpholiday import JPHoliday
import datetime

jpholiday = JPHoliday()

# datetime.date
jpholiday.is_holiday(datetime.date(2017, 1, 1))
> True
jpholiday.is_holiday(datetime.date(2017, 1, 2))
> True
jpholiday.is_holiday(datetime.date(2017, 1, 3))
> False

# datetime.datetime
jpholiday.is_holiday(datetime.datetime(2017, 1, 1, 1, 1, 1))
> True
jpholiday.is_holiday(datetime.datetime(2017, 1, 2, 1, 1, 1))
> True
jpholiday.is_holiday(datetime.datetime(2017, 1, 3, 1, 1, 1))
> False
```

### 指定年の祝日を取得

```python
from jpholiday import JPHoliday
import datetime

jpholiday = JPHoliday()

jpholiday.year_holidays(2017)
> [
    Holiday(
        date=datetime.date(2017, 1, 1),
        name='元日'
    ),
    Holiday(
        date=datetime.date(2017, 1, 2),
        name='元日 振替休日'
    ),
    ...
]
```

### 指定月の祝日を取得

```python
from jpholiday import JPHoliday
import datetime

jpholiday = JPHoliday()

jpholiday.month_holidays(2017, 5)
> [
    Holiday(
        date=datetime.date(2017, 5, 3),
        name='憲法記念日'
    ),
    Holiday(
        date=datetime.date(2017, 5, 4),
        name='みどりの日'
    ),
    Holiday(
        date=datetime.date(2017, 5, 5),
        name='こどもの日'
    )
]
```

### 指定範囲の祝日を取得

```python
from jpholiday import JPHoliday
import datetime

jpholiday = JPHoliday()

# datetime.date
jpholiday.between(datetime.date(2017, 1, 1), datetime.date(2017, 5, 3))
> [
    Holiday(
        date=datetime.date(2017, 1, 1),
        name='元日'
    ),
    Holiday(
        date=datetime.date(2017, 1, 2),
        name='元日 振替休日'
    ),
    ...
]

# datetime.datetime
jpholiday.between(datetime.datetime(2017, 1, 1, 3, 15, 0), datetime.datetime(2017, 5, 3, 12, 30, 12))
> [
    Holiday(
        date=datetime.date(2017, 1, 1),
        name='元日'
    ),
    Holiday(
        date=datetime.date(2017, 1, 2),
        name='元日 振替休日'
    ),
    ...
]
```

### 独自の休日を追加

```python
from jpholiday import JPHoliday, OriginalHolidayCheckerInterface
import datetime

jpholiday = JPHoliday()


class TestHoliday(OriginalHolidayCheckerInterface):
    def is_holiday(self, date):
        if date == datetime.date(2020, 2, 9):
            return True
        return False

    def holiday_name(self, date):
        return '特別休暇'


jpholiday.register(TestHoliday())

jpholiday.holidays(datetime.date(2020, 2, 9))
> [
    Holiday(
        date=datetime.date(2020, 2, 9),
        name='特別休暇'
    )
]

jpholiday.is_holiday(datetime.date(2020, 2, 9))
> True
```

### 独自の休日を削除

```python
from jpholiday import JPHoliday, OriginalHolidayCheckerInterface
import datetime

jpholiday = JPHoliday()


class TestHoliday(OriginalHolidayCheckerInterface):
    def is_holiday(self, date):
        if date == datetime.date(2020, 2, 9):
            return True
        return False

    def holiday_name(self, date):
        return '特別休暇'


jpholiday.unregister(TestHoliday())

jpholiday.holidays(datetime.date(2020, 2, 9))
> []

jpholiday.is_holiday(datetime.date(2020, 2, 9))
> False
```

## Functions

### 指定日の祝日名を取得

```python
import jpholiday
import datetime

# datetime.date
jpholiday.is_holiday_name(datetime.date(2017, 1, 1))
> '元日'
jpholiday.is_holiday_name(datetime.date(2017, 1, 2))
> '元日 振替休日'
jpholiday.is_holiday_name(datetime.date(2017, 1, 3))
> None

# datetime.datetime
jpholiday.is_holiday_name(datetime.datetime(2017, 1, 1, 1, 1, 1))
> '元日'
jpholiday.is_holiday_name(datetime.datetime(2017, 1, 2, 1, 1, 1))
> '元日 振替休日'
jpholiday.is_holiday_name(datetime.datetime(2017, 1, 3, 1, 1, 1))
> None
```

### 指定日が祝日か判定

```python
import jpholiday
import datetime

# datetime.date
jpholiday.is_holiday(datetime.date(2017, 1, 1))
> True
jpholiday.is_holiday(datetime.date(2017, 1, 2))
> True
jpholiday.is_holiday(datetime.date(2017, 1, 3))
> False

# datetime.datetime
jpholiday.is_holiday(datetime.datetime(2017, 1, 1, 1, 1, 1))
> True
jpholiday.is_holiday(datetime.datetime(2017, 1, 2, 1, 1, 1))
> True
jpholiday.is_holiday(datetime.datetime(2017, 1, 3, 1, 1, 1))
> False
```

### 指定年の祝日を取得

```python
import jpholiday

jpholiday.year_holidays(2017)
> [(datetime.date(2017, 1, 1), '元日'),
   (datetime.date(2017, 1, 2), '元日 振替休日'),
   (datetime.date(2017, 1, 9), '成人の日'),
   (datetime.date(2017, 2, 11), '建国記念の日'),
   (datetime.date(2017, 3, 20), '春分の日'),
   (datetime.date(2017, 4, 29), '昭和の日'),
   (datetime.date(2017, 5, 3), '憲法記念日'),
   (datetime.date(2017, 5, 4), 'みどりの日'),
   (datetime.date(2017, 5, 5), 'こどもの日'),
   (datetime.date(2017, 7, 17), '海の日'),
   (datetime.date(2017, 8, 11), '山の日'),
   (datetime.date(2017, 9, 18), '敬老の日'),
   (datetime.date(2017, 9, 23), '秋分の日'),
   (datetime.date(2017, 10, 9), '体育の日'),
   (datetime.date(2017, 11, 3), '文化の日'),
   (datetime.date(2017, 11, 23), '勤労感謝の日'),
   (datetime.date(2017, 12, 23), '天皇誕生日')]
```

### 指定月の祝日を取得

```python
import jpholiday

jpholiday.month_holidays(2017, 5)
> [(datetime.date(2017, 5, 3), '憲法記念日'),
   (datetime.date(2017, 5, 4), 'みどりの日'),
   (datetime.date(2017, 5, 5), 'こどもの日')]
```

### 指定範囲の祝日を取得

```python
import jpholiday
import datetime

# datetime.date
jpholiday.between(datetime.date(2017, 1, 1), datetime.date(2017, 5, 3))
> [(datetime.date(2017, 1, 1), '元日'),
   (datetime.date(2017, 1, 2), '元日 振替休日'),
   (datetime.date(2017, 1, 9), '成人の日'),
   (datetime.date(2017, 2, 11), '建国記念の日'),
   (datetime.date(2017, 3, 20), '春分の日'),
   (datetime.date(2017, 4, 29), '昭和の日'),
   (datetime.date(2017, 5, 3), '憲法記念日')]

# datetime.datetime
jpholiday.between(datetime.datetime(2017, 1, 1, 3, 15, 0), datetime.datetime(2017, 5, 3, 12, 30, 12))
> [(datetime.date(2017, 1, 1), '元日'),
   (datetime.date(2017, 1, 2), '元日 振替休日'),
   (datetime.date(2017, 1, 9), '成人の日'),
   (datetime.date(2017, 2, 11), '建国記念の日'),
   (datetime.date(2017, 3, 20), '春分の日'),
   (datetime.date(2017, 4, 29), '昭和の日'),
   (datetime.date(2017, 5, 3), '憲法記念日')]
```

### 独自の休日を追加

```python
import jpholiday
import datetime


class TestHoliday(jpholiday.OriginalHolidayCheckerInterface):
    def is_holiday(self, date):
        if date == datetime.date(2020, 2, 9):
            return True
        return False

    def holiday_name(self, date):
        return '特別休暇'


jpholiday.register(TestHoliday())

jpholiday.is_holiday_name(datetime.date(2020, 2, 9))
> '特別休暇'

jpholiday.is_holiday(datetime.date(2020, 2, 9))
> True
```

### 独自の休日を削除

```python
import jpholiday
import datetime


class TestHoliday(jpholiday.OriginalHolidayCheckerInterface):
    def is_holiday(self, date):
        if date == datetime.date(2020, 2, 9):
            return True
        return False

    def holiday_name(self, date):
        return '特別休暇'


jpholiday.unregister(TestHoliday())

jpholiday.is_holiday_name(datetime.date(2020, 2, 9))
> None

jpholiday.is_holiday(datetime.date(2020, 2, 9))
> False
```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Lalcs/jpholiday",
    "name": "jpholiday",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "Japan, Holiday",
    "author": "Vatis",
    "author_email": "vatis@lalcs.com",
    "download_url": "https://files.pythonhosted.org/packages/cc/11/0e35047e0d66dae11a145abde21599cd166e6a438268ac83179cf8fc2388/jpholiday-1.0.0.tar.gz",
    "platform": "POSIX",
    "description": "# JPHoliday\n\n[![image](https://img.shields.io/pypi/v/jpholiday.svg)](https://pypi.org/project/jpholiday/)\n[![image](https://img.shields.io/pypi/l/jpholiday.svg)](https://pypi.org/project/jpholiday/)\n[![image](https://img.shields.io/pypi/pyversions/jpholiday.svg)](https://pypi.org/project/jpholiday/)\n[![image](https://img.shields.io/github/contributors/lalcs/jpholiday.svg)](https://github.com/lalcs/jpholiday/graphs/contributors)\n[![image](https://img.shields.io/pypi/dm/jpholiday)](https://pypistats.org/packages/jpholiday)\n![Unittest](https://github.com/Lalcs/jpholiday/workflows/Unittest/badge.svg)\n\n![image](./docs/images/logo.png)\n\n\u3053\u306e\u30e9\u30a4\u30d6\u30e9\u30ea\u306f\u3001[\u5185\u95a3\u5e9c](https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html)\n\u304c\u516c\u8868\u3057\u3066\u3044\u308b\u30c7\u30fc\u30bf\u3092\u57fa\u306b\u3001\u65e5\u672c\u306e\u56fd\u6c11\u306e\u795d\u65e5\u3092\u7c21\u5358\u306b\u53d6\u5f97\u3067\u304d\u308b\u3088\u3046\u306b\u3057\u305f\u3082\u306e\u3067\u3059\u3002  \n**2026\u5e74**\u307e\u3067\u306e\u795d\u65e5\u306f\u516c\u5f0f\u767a\u8868\u3055\u308c\u305f\u5185\u5bb9\u306b\u57fa\u3065\u3044\u3066\u52d5\u4f5c\u78ba\u8a8d\u6e08\u307f\u3067\u3059\u3002  \n\u305d\u308c\u4ee5\u964d\u306b\u3064\u3044\u3066\u3082\u53d6\u5f97\u306f\u53ef\u80fd\u3067\u3059\u304c\u3001\u5185\u95a3\u5e9c\u304b\u3089\u306e\u6b63\u5f0f\u306a\u516c\u8868\u304c\u306a\u3044\u305f\u3081\u3001\u6b63\u78ba\u6027\u306f\u4fdd\u8a3c\u3055\u308c\u307e\u305b\u3093\u3002\n\n## Installation\n\n```bash\npip install jpholiday\n```\n\n## Class\n\n### \u6307\u5b9a\u65e5\u306e\u795d\u65e5\u540d\u3092\u53d6\u5f97\n\n```python\nfrom jpholiday import JPHoliday\nimport datetime\n\njpholiday = JPHoliday()\n\njpholiday.holidays(datetime.date(2017, 1, 1))\n> [\n    Holiday(\n        date=datetime.date(2017, 1, 1),\n        name='\u5143\u65e5'\n    )\n]\njpholiday.holidays(datetime.date(2017, 1, 2))\n> [\n    Holiday(\n        date=datetime.date(2017, 1, 2),\n        name='\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'\n    )\n]\njpholiday.holidays(datetime.date(2017, 1, 3))\n> []\n```\n\n### \u6307\u5b9a\u65e5\u304c\u795d\u65e5\u304b\u5224\u5b9a\n\n```python\nfrom jpholiday import JPHoliday\nimport datetime\n\njpholiday = JPHoliday()\n\n# datetime.date\njpholiday.is_holiday(datetime.date(2017, 1, 1))\n> True\njpholiday.is_holiday(datetime.date(2017, 1, 2))\n> True\njpholiday.is_holiday(datetime.date(2017, 1, 3))\n> False\n\n# datetime.datetime\njpholiday.is_holiday(datetime.datetime(2017, 1, 1, 1, 1, 1))\n> True\njpholiday.is_holiday(datetime.datetime(2017, 1, 2, 1, 1, 1))\n> True\njpholiday.is_holiday(datetime.datetime(2017, 1, 3, 1, 1, 1))\n> False\n```\n\n### \u6307\u5b9a\u5e74\u306e\u795d\u65e5\u3092\u53d6\u5f97\n\n```python\nfrom jpholiday import JPHoliday\nimport datetime\n\njpholiday = JPHoliday()\n\njpholiday.year_holidays(2017)\n> [\n    Holiday(\n        date=datetime.date(2017, 1, 1),\n        name='\u5143\u65e5'\n    ),\n    Holiday(\n        date=datetime.date(2017, 1, 2),\n        name='\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'\n    ),\n    ...\n]\n```\n\n### \u6307\u5b9a\u6708\u306e\u795d\u65e5\u3092\u53d6\u5f97\n\n```python\nfrom jpholiday import JPHoliday\nimport datetime\n\njpholiday = JPHoliday()\n\njpholiday.month_holidays(2017, 5)\n> [\n    Holiday(\n        date=datetime.date(2017, 5, 3),\n        name='\u61b2\u6cd5\u8a18\u5ff5\u65e5'\n    ),\n    Holiday(\n        date=datetime.date(2017, 5, 4),\n        name='\u307f\u3069\u308a\u306e\u65e5'\n    ),\n    Holiday(\n        date=datetime.date(2017, 5, 5),\n        name='\u3053\u3069\u3082\u306e\u65e5'\n    )\n]\n```\n\n### \u6307\u5b9a\u7bc4\u56f2\u306e\u795d\u65e5\u3092\u53d6\u5f97\n\n```python\nfrom jpholiday import JPHoliday\nimport datetime\n\njpholiday = JPHoliday()\n\n# datetime.date\njpholiday.between(datetime.date(2017, 1, 1), datetime.date(2017, 5, 3))\n> [\n    Holiday(\n        date=datetime.date(2017, 1, 1),\n        name='\u5143\u65e5'\n    ),\n    Holiday(\n        date=datetime.date(2017, 1, 2),\n        name='\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'\n    ),\n    ...\n]\n\n# datetime.datetime\njpholiday.between(datetime.datetime(2017, 1, 1, 3, 15, 0), datetime.datetime(2017, 5, 3, 12, 30, 12))\n> [\n    Holiday(\n        date=datetime.date(2017, 1, 1),\n        name='\u5143\u65e5'\n    ),\n    Holiday(\n        date=datetime.date(2017, 1, 2),\n        name='\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'\n    ),\n    ...\n]\n```\n\n### \u72ec\u81ea\u306e\u4f11\u65e5\u3092\u8ffd\u52a0\n\n```python\nfrom jpholiday import JPHoliday, OriginalHolidayCheckerInterface\nimport datetime\n\njpholiday = JPHoliday()\n\n\nclass TestHoliday(OriginalHolidayCheckerInterface):\n    def is_holiday(self, date):\n        if date == datetime.date(2020, 2, 9):\n            return True\n        return False\n\n    def holiday_name(self, date):\n        return '\u7279\u5225\u4f11\u6687'\n\n\njpholiday.register(TestHoliday())\n\njpholiday.holidays(datetime.date(2020, 2, 9))\n> [\n    Holiday(\n        date=datetime.date(2020, 2, 9),\n        name='\u7279\u5225\u4f11\u6687'\n    )\n]\n\njpholiday.is_holiday(datetime.date(2020, 2, 9))\n> True\n```\n\n### \u72ec\u81ea\u306e\u4f11\u65e5\u3092\u524a\u9664\n\n```python\nfrom jpholiday import JPHoliday, OriginalHolidayCheckerInterface\nimport datetime\n\njpholiday = JPHoliday()\n\n\nclass TestHoliday(OriginalHolidayCheckerInterface):\n    def is_holiday(self, date):\n        if date == datetime.date(2020, 2, 9):\n            return True\n        return False\n\n    def holiday_name(self, date):\n        return '\u7279\u5225\u4f11\u6687'\n\n\njpholiday.unregister(TestHoliday())\n\njpholiday.holidays(datetime.date(2020, 2, 9))\n> []\n\njpholiday.is_holiday(datetime.date(2020, 2, 9))\n> False\n```\n\n## Functions\n\n### \u6307\u5b9a\u65e5\u306e\u795d\u65e5\u540d\u3092\u53d6\u5f97\n\n```python\nimport jpholiday\nimport datetime\n\n# datetime.date\njpholiday.is_holiday_name(datetime.date(2017, 1, 1))\n> '\u5143\u65e5'\njpholiday.is_holiday_name(datetime.date(2017, 1, 2))\n> '\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'\njpholiday.is_holiday_name(datetime.date(2017, 1, 3))\n> None\n\n# datetime.datetime\njpholiday.is_holiday_name(datetime.datetime(2017, 1, 1, 1, 1, 1))\n> '\u5143\u65e5'\njpholiday.is_holiday_name(datetime.datetime(2017, 1, 2, 1, 1, 1))\n> '\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'\njpholiday.is_holiday_name(datetime.datetime(2017, 1, 3, 1, 1, 1))\n> None\n```\n\n### \u6307\u5b9a\u65e5\u304c\u795d\u65e5\u304b\u5224\u5b9a\n\n```python\nimport jpholiday\nimport datetime\n\n# datetime.date\njpholiday.is_holiday(datetime.date(2017, 1, 1))\n> True\njpholiday.is_holiday(datetime.date(2017, 1, 2))\n> True\njpholiday.is_holiday(datetime.date(2017, 1, 3))\n> False\n\n# datetime.datetime\njpholiday.is_holiday(datetime.datetime(2017, 1, 1, 1, 1, 1))\n> True\njpholiday.is_holiday(datetime.datetime(2017, 1, 2, 1, 1, 1))\n> True\njpholiday.is_holiday(datetime.datetime(2017, 1, 3, 1, 1, 1))\n> False\n```\n\n### \u6307\u5b9a\u5e74\u306e\u795d\u65e5\u3092\u53d6\u5f97\n\n```python\nimport jpholiday\n\njpholiday.year_holidays(2017)\n> [(datetime.date(2017, 1, 1), '\u5143\u65e5'),\n   (datetime.date(2017, 1, 2), '\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'),\n   (datetime.date(2017, 1, 9), '\u6210\u4eba\u306e\u65e5'),\n   (datetime.date(2017, 2, 11), '\u5efa\u56fd\u8a18\u5ff5\u306e\u65e5'),\n   (datetime.date(2017, 3, 20), '\u6625\u5206\u306e\u65e5'),\n   (datetime.date(2017, 4, 29), '\u662d\u548c\u306e\u65e5'),\n   (datetime.date(2017, 5, 3), '\u61b2\u6cd5\u8a18\u5ff5\u65e5'),\n   (datetime.date(2017, 5, 4), '\u307f\u3069\u308a\u306e\u65e5'),\n   (datetime.date(2017, 5, 5), '\u3053\u3069\u3082\u306e\u65e5'),\n   (datetime.date(2017, 7, 17), '\u6d77\u306e\u65e5'),\n   (datetime.date(2017, 8, 11), '\u5c71\u306e\u65e5'),\n   (datetime.date(2017, 9, 18), '\u656c\u8001\u306e\u65e5'),\n   (datetime.date(2017, 9, 23), '\u79cb\u5206\u306e\u65e5'),\n   (datetime.date(2017, 10, 9), '\u4f53\u80b2\u306e\u65e5'),\n   (datetime.date(2017, 11, 3), '\u6587\u5316\u306e\u65e5'),\n   (datetime.date(2017, 11, 23), '\u52e4\u52b4\u611f\u8b1d\u306e\u65e5'),\n   (datetime.date(2017, 12, 23), '\u5929\u7687\u8a95\u751f\u65e5')]\n```\n\n### \u6307\u5b9a\u6708\u306e\u795d\u65e5\u3092\u53d6\u5f97\n\n```python\nimport jpholiday\n\njpholiday.month_holidays(2017, 5)\n> [(datetime.date(2017, 5, 3), '\u61b2\u6cd5\u8a18\u5ff5\u65e5'),\n   (datetime.date(2017, 5, 4), '\u307f\u3069\u308a\u306e\u65e5'),\n   (datetime.date(2017, 5, 5), '\u3053\u3069\u3082\u306e\u65e5')]\n```\n\n### \u6307\u5b9a\u7bc4\u56f2\u306e\u795d\u65e5\u3092\u53d6\u5f97\n\n```python\nimport jpholiday\nimport datetime\n\n# datetime.date\njpholiday.between(datetime.date(2017, 1, 1), datetime.date(2017, 5, 3))\n> [(datetime.date(2017, 1, 1), '\u5143\u65e5'),\n   (datetime.date(2017, 1, 2), '\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'),\n   (datetime.date(2017, 1, 9), '\u6210\u4eba\u306e\u65e5'),\n   (datetime.date(2017, 2, 11), '\u5efa\u56fd\u8a18\u5ff5\u306e\u65e5'),\n   (datetime.date(2017, 3, 20), '\u6625\u5206\u306e\u65e5'),\n   (datetime.date(2017, 4, 29), '\u662d\u548c\u306e\u65e5'),\n   (datetime.date(2017, 5, 3), '\u61b2\u6cd5\u8a18\u5ff5\u65e5')]\n\n# datetime.datetime\njpholiday.between(datetime.datetime(2017, 1, 1, 3, 15, 0), datetime.datetime(2017, 5, 3, 12, 30, 12))\n> [(datetime.date(2017, 1, 1), '\u5143\u65e5'),\n   (datetime.date(2017, 1, 2), '\u5143\u65e5 \u632f\u66ff\u4f11\u65e5'),\n   (datetime.date(2017, 1, 9), '\u6210\u4eba\u306e\u65e5'),\n   (datetime.date(2017, 2, 11), '\u5efa\u56fd\u8a18\u5ff5\u306e\u65e5'),\n   (datetime.date(2017, 3, 20), '\u6625\u5206\u306e\u65e5'),\n   (datetime.date(2017, 4, 29), '\u662d\u548c\u306e\u65e5'),\n   (datetime.date(2017, 5, 3), '\u61b2\u6cd5\u8a18\u5ff5\u65e5')]\n```\n\n### \u72ec\u81ea\u306e\u4f11\u65e5\u3092\u8ffd\u52a0\n\n```python\nimport jpholiday\nimport datetime\n\n\nclass TestHoliday(jpholiday.OriginalHolidayCheckerInterface):\n    def is_holiday(self, date):\n        if date == datetime.date(2020, 2, 9):\n            return True\n        return False\n\n    def holiday_name(self, date):\n        return '\u7279\u5225\u4f11\u6687'\n\n\njpholiday.register(TestHoliday())\n\njpholiday.is_holiday_name(datetime.date(2020, 2, 9))\n> '\u7279\u5225\u4f11\u6687'\n\njpholiday.is_holiday(datetime.date(2020, 2, 9))\n> True\n```\n\n### \u72ec\u81ea\u306e\u4f11\u65e5\u3092\u524a\u9664\n\n```python\nimport jpholiday\nimport datetime\n\n\nclass TestHoliday(jpholiday.OriginalHolidayCheckerInterface):\n    def is_holiday(self, date):\n        if date == datetime.date(2020, 2, 9):\n            return True\n        return False\n\n    def holiday_name(self, date):\n        return '\u7279\u5225\u4f11\u6687'\n\n\njpholiday.unregister(TestHoliday())\n\njpholiday.is_holiday_name(datetime.date(2020, 2, 9))\n> None\n\njpholiday.is_holiday(datetime.date(2020, 2, 9))\n> False\n```\n",
    "bugtrack_url": null,
    "license": "MIT License",
    "summary": "Pure-Python Japan Public Holiday Generate",
    "version": "1.0.0",
    "project_urls": {
        "Homepage": "https://github.com/Lalcs/jpholiday"
    },
    "split_keywords": [
        "japan",
        " holiday"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ef2824bca6bfb06a64429cdfa69bddc00a4c053c8fd5f446adde5476826efb53",
                "md5": "dbb29839a336a59f2d7aedb44209ffdc",
                "sha256": "ce5527a4f91fbd2b59a24108877df042cd5d9a6e2f7fcb70e6af420f74831d0a"
            },
            "downloads": -1,
            "filename": "jpholiday-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "dbb29839a336a59f2d7aedb44209ffdc",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 8107,
            "upload_time": "2025-03-20T13:38:00",
            "upload_time_iso_8601": "2025-03-20T13:38:00.526359Z",
            "url": "https://files.pythonhosted.org/packages/ef/28/24bca6bfb06a64429cdfa69bddc00a4c053c8fd5f446adde5476826efb53/jpholiday-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cc110e35047e0d66dae11a145abde21599cd166e6a438268ac83179cf8fc2388",
                "md5": "c8f993e8b764ddafd58fccdeaeda20a1",
                "sha256": "451fdcf4479f957b6d24f24ae480b73ab204a084becaef980e97f1c2b5ca91fa"
            },
            "downloads": -1,
            "filename": "jpholiday-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "c8f993e8b764ddafd58fccdeaeda20a1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 13759,
            "upload_time": "2025-03-20T13:38:01",
            "upload_time_iso_8601": "2025-03-20T13:38:01.937659Z",
            "url": "https://files.pythonhosted.org/packages/cc/11/0e35047e0d66dae11a145abde21599cd166e6a438268ac83179cf8fc2388/jpholiday-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-03-20 13:38:01",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Lalcs",
    "github_project": "jpholiday",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "jpholiday"
}