Python holidays假期模块

Python holidays假期模块

在本教程中，我们将学习一个有趣的 Python 库，名为 holidays， 它可以确定特定日期的给定年份的假期。它返回给定日期的具体结果。我们只需要传递国家名称即可。然而，它只能检测固定的假期，如 圣诞节，新年节 等等。

安装

在终端中输入以下命令并按Enter键。

pip install holidays

导入 holidays 模块以检查是否安装。

HolidayBase() 方法

holidays 模块提供了 HolidayBase() 方法，用于检测特定日期的节假日。让我们看下面的语法。

语法 –

holidays.HolidayBase(years=[], expand=True, observed=True, prov=None, state=None)

参数 –

它接受以下参数。

• years- 这是一个整数的可迭代列表，指定应该预生成的假期对象。只有在设置为False时才可以使用该参数。
• expand- 它表示一个布尔值，表示是否在新年加入假期。默认为true。
• observed – 当我们将观察到的布尔值设置为True时，它将包括在周末放假的假日的观察日。
• Prov – 它是一个字符串值，指定具有唯一宪法假期的省份。默认是（Australia=’ACT’，Canada=’ON’，NewZealand=None）。
• state- 它代表有独特宪法假日的州。 （默认-美国=无）。

让我们理解以下示例 –

范例 –

from datetime import date
import holidays
# Select country
USA_holidays_list = holidays.US()
# printing all the holiday of USA year 2020
for p in holidays.US(years = 2020).items():
    print(p)

输出：

(datetime.date(2020, 1, 1), "New Year's Day")
(datetime.date(2020, 1, 20), 'Martin Luther King Jr. Day')
(datetime.date(2020, 2, 17), "Washington's Birthday")
(datetime.date(2020, 5, 25), 'Memorial Day')
(datetime.date(2020, 7, 4), 'Independence Day')
(datetime.date(2020, 7, 3), 'Independence Day (Observed)')
(datetime.date(2020, 9, 7), 'Labor Day')
(datetime.date(2020, 10, 12), 'Columbus Day')
(datetime.date(2020, 11, 11), 'Veterans Day')
(datetime.date(2020, 11, 26), 'Thanksgiving')
(datetime.date(2020, 12, 25), 'Christmas Day')

示例2

from datetime import date
import holidays

# Select country
India_holidays_list = holidays.India()

# printing all the holiday of India year 2020
for p in holidays.India(years = 2020).items():
    print(p)

输出:

(datetime.date(2021, 1, 14), 'Makar Sankranti / Pongal')
(datetime.date(2021, 1, 26), 'Republic Day')
(datetime.date(2021, 8, 15), 'Independence Day')
(datetime.date(2021, 10, 2), 'Gandhi Jayanti')
(datetime.date(2021, 5, 1), 'Labour Day')
(datetime.date(2021, 12, 25), 'Christmas')

注意 – 如我们在输出中所看到的，假期模块只返回固定日期的假期。

示例3：

from datetime import date
import holidays
# Select country
uk_holidays_list = holidays.UnitedKingdom()
# printing all the holiday of India year 2020
for p in holidays.UnitedKingdom(years = 2021).items():
    print(p)

输出：

 (datetime.date(2021, 1, 1), "New Year's Day")
(datetime.date(2021, 1, 2), 'New Year Holiday [Scotland]')
(datetime.date(2021, 1, 4), 'New Year Holiday [Scotland] (Observed)')
(datetime.date(2021, 3, 17), "St. Patrick's Day [Northern Ireland]")
(datetime.date(2021, 7, 12), 'Battle of the Boyne [Northern Ireland]')
(datetime.date(2021, 8, 2), 'Summer Bank Holiday [Scotland]')
(datetime.date(2021, 11, 30), "St. Andrew's Day [Scotland]")
(datetime.date(2021, 12, 25), 'Christmas Day')
(datetime.date(2021, 12, 27), 'Christmas Day (Observed)')
(datetime.date(2021, 4, 2), 'Good Friday')
(datetime.date(2021, 4, 5), 'Easter Monday [England, Wales, Northern Ireland]')
(datetime.date(2021, 5, 3), 'May Day')
(datetime.date(2021, 5, 31), 'Spring Bank Holiday')
(datetime.date(2021, 8, 30), 'Late Summer Bank Holiday [England, Wales, Northern Ireland]')
(datetime.date(2021, 12, 26), 'Boxing Day')
(datetime.date(2021, 12, 28), 'Boxing Day (Observed)')

我们可以获取所需国家的节假日列表。

如何检查给定日期是否是节假日

假设我们想要检查特定日期是否是节假日。我们可以按照以下步骤进行。

示例

from datetime import date
import holidays

# Select country
uk_holidays = holidays.UnitedKingdom()
date1 = '25-25-2021'

j = date1 in uk_holidays

# Cheking whether given data is a holiday
if j == True:
    print("Yes: ")
    print (uk_holidays.get(date1))

else:
    print("No Holiday")

输出：

Yes: 
Christmas Day

为印度添加自定义节假日

很多国家在下面的表格中都被漏掉了，但幸运的是我们可以为特定国家添加自定义节假日。在下面的示例中，我们将为印度添加自定义节假日。

示例

import holidays

add_holidays = holidays.HolidayBase()
print('28-03-2021' in add_holidays) # checking for holiday

# here we are adding Holiday without description
add_holidays.append('28-03-2021')

print('28-03-2021' in add_holidays) # True

# Add Holiday with description
add_holidays.append({'28-03-2021':'Holi: Festival of Colors, Holiday'})
print(add_holidays.get('28-03-2021'))

输出：

False
True
Holi: Festival of Colors, Holiday

说明：

在上面的代码中，首先导入了日期和假日模块。然后创建了 HolidayBase() 的对象，并检查给定的日期是否包含假日。它返回了false，所以我们添加了没有描述的自定义假日。

在另一个语句中，我们添加了一个带有描述的假日，并打印了结果。

假日库中可用的国家

以下是受假日库支持的国家。