Python holidays模塊

在本教程中，我們將學習一個有趣的名為假日的 Python 庫，確定了一年中某一天的假日。它返回給定日期的具體結果。我們只需要傳遞國名。但只能檢測聖誕節、新年等固定節假日。

裝置

向終端鍵入以下命令，然後按回車鍵。

pip install holidays

導入節假日模塊檢查是否安裝。

假日基數()方法

節假日模塊提供假日基地()方法，用於檢測特定日期的節假日。讓我們看看下面的語法。

語法-

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

參數-

它採用以下參數。

• 年份- 它是一個可迭代的整數列表，指定應該預先生成的假日對象。僅當設置增加到「假」時，才能使用此參數。
• expand – 表示一個布爾值，表示新年是否增加節假日。默認情況下，這是真的。
• observed – 當我們將觀察到的布爾值設置為 True 時，它將包括周末假日的觀察日。
• prov – 它是一個字符串值，指定具有唯一憲法假日的省份。默認情況下(澳大利亞=’ACT ‘，加拿大=’ON ‘，新西蘭=無)。
• 州- 它代表了一個擁有獨特憲法假日的州。(默認值-美國=無)。

讓我們理解下面的例子-

示例-

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')

注意——正如我們在輸出中看到的，holidays模塊只返回固定日期的假日。

示例- 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

說明:

在上面的代碼中，首先，我們已經導入了日期和holidays模塊。然後，我們創建了 HolidayBase() 的對象，並檢查給定日期是否包含假日。它返回 false，因此我們添加了沒有描述的自定義假日。

在另一個語句中，我們添加了帶有描述的假日，並打印了結果。

假日圖書館中的可用國家

以下是假日圖書館支持的國家。

| 國家縮寫 | 省/州 |
| 阿根廷。亦作 THE ARGENTINE | 阿肯色州 | 沒有人 |
| 澳大利亞 | 你好 | prov = ACT (默認值)，NSW，NT，QLD，SA，TAS，VIC，WA |
| 奧地利 | (At)人名ˌ(越)乙 | prov = B、K、N、O、S、ST、T、V、 W (默認) |
| 比利時 | 存在 | 沒有人 |
| 加拿大 | 加利福尼亞 | prov = AB、BC、MB、NB、NL、NS、NT、NU、(默認值)、PE、QC、SK、YU |
| 哥倫比亞 | 哥倫比亞 | 沒有人 |
| 捷克人 | 捷克(Czech Republic) | 沒有人 |
| 丹麥 | 丹麥 | 沒有人 |
| 英格蘭 | | 沒有人 |
| 歐洲中央銀行 | 歐洲央行，西藏自治區 | 跨歐洲自動實時總結算(目標 2) |
| 芬蘭 | 船方不負擔裝貨費用 | 沒有人 |
| 法國 | 聯邦鐵路局(Federal Railroad Administration) | 大都市(默認值)，Alsace-Moselle、Guadeloupe、圭亞那、馬提尼克、馬約特、新喀里多尼亞、會議、法屬波利尼西亞、聖巴特雷米、聖馬丁、瓦利斯和富圖納 |
| 德國 | 特拉華州 | BW、BY、BE、BB、HB、HH、HE、MV、NI、NW、RP、SL、SN、ST、SH、TH |
| 匈牙利 | 胡（漢語拼音） | 沒有人 |
| 愛爾蘭 | | 工業管理學(Industrial Engineering) |
| 馬恩島 | | 沒有人 |
| 意大利 | 信息技術 | S7-1200 可編程控制器 |
| 日本 | 地方官 | 沒有人 |
| 墨西哥 | 麥克斯韋(maxwellˌ磁通量單位)ˌ中性(Middlesex) | 沒有人 |
| 荷蘭。亦稱 HＯＬＬＡＮＤ | 荷蘭 | 沒有人 |
| 新西蘭 | 新西蘭 | prov = NTL、AUK、TKI、HKB、WGN、MBH、NSN、CAN、STC、WTL、OTA、STL、CIT |
| 北愛爾蘭 | | 沒有人 |
| 挪威 | 不 | 沒有人 |
| 拋光劑 | 波蘭 | 沒有人 |
| 葡萄牙 | 體育鍛煉 | 沒有人 |
| 葡萄牙石 | 客運管理處 | 葡萄牙加上大部分人放假的延長天數 |
| 蘇格蘭 | | 沒有人 |
| 斯洛文尼亞 | 國際度量單位制 | 沒有人 |
| 斯洛伐克 | 薩斯喀徹溫 | 沒有人 |
| 南非 | 為 | 沒有人 |
| 西班牙 | 是嗎 | prov = AND、ARG、AST、CAN、CAM、CAL、CAT、CVA、EXT、GAL、
IBA、ICA、MAD、MUR、NAV、PVA、RIO |
| 瑞典 | 如果 | 沒有人 |
| 瑞士 | 榮譽勛位爵士 | prov = AG，AR，AI，BL，BS，BE，FR，GE，GL，GR，JU，LU，
NE，NW，OW，SG，SH，SZ，SO，TG，TI，UR，VD，VS，ZG，ZH |
| 大不列顛及北愛爾蘭聯合王國 | 聯合王國 | 沒有人 |
| 美國 | 美國 | state = AL，AK，AS，AZ，AR，CA，CO，CT，DE，DC，FL，GA，
GU，HI，ID，IL，IN，IA，KS，KY，LA，ME，MD，MH，MA，MI，
FM，MN，MS，MT，NE，NV，NH，NJ，NM，NY，NC，ND，MP，
哦，OK，OR，PW，PA，PR，RI，SC |
| 威爾士 | | 沒有人 |