共用方式為

PublicHolidays 類別

表示公用假日公用數據集。

此數據集包含來自 PyPI 假日套件和維琪百科的全球公用假日數據，涵蓋 1970 到 2099 年 38 個國家或地區。 每個數據列都會指出特定日期、國家或地區的假日資訊，以及大多數人是否有帶薪休假。 如需此數據集的詳細資訊，包括數據行描述、存取數據集的不同方式和範例，請參閱 Azure 開放數據集目錄中的 Microsoft 公用假日 。

初始化篩選欄位。

建構函式

PublicHolidays(country_or_region: str = '', start_date: datetime = datetime.datetime(2008, 1, 1, 0, 0), end_date: datetime = datetime.datetime(2024, 12, 13, 0, 0), cols: List[str] | None = None, enable_telemetry: bool = True)

參數

名稱 Description
country_or_region
必要
str

要傳回數據的國家或地區。
start_date
datetime

開始載入資料的日期，包含。 如果為 None， default_start_date 則會使用 。

預設值: 2008-01-01 00:00:00
end_date
datetime

結束載入資料的日期，包含。 如果為 None， default_end_date 則會使用 。

預設值: 2024-12-13 00:00:00
cols
list[str]

要從數據集載入的數據列名稱清單。 如果為 None，則會載入所有數據行。 如需此數據集中可用資料行的資訊，請參閱 公用假日。

預設值: None
enable_telemetry
bool

是否要在此數據集上啟用遙測。

預設值: True
country_or_region
必要
str

您想要查詢的國家或地區。
start_date
必要
datetime

您想要以包容性方式查詢的開始日期。
end_date
必要
datetime

您想要以包容性方式查詢的結束日期。
cols
必要
Optional[List[str]]

您想要擷取的數據行名稱清單。 無會取得所有數據行。
enable_telemetry
必要
bool

指出是否要傳送遙測。

備註

下列範例示範如何存取數據集。


   from azureml.opendatasets import PublicHolidays
   from datetime import datetime
   from dateutil.relativedelta import relativedelta


   end_date = datetime.today()
   start_date = datetime.today() - relativedelta(months=1)
   hol = PublicHolidays(start_date=start_date, end_date=end_date)
   hol_df = hol.to_pandas_dataframe()

方法

filter

篩選時間。

filter

篩選時間。

filter(env: SparkEnv | PandasEnv, min_date: datetime, max_date: datetime)

參數

名稱 Description
env
必要
RuntimeEnv

運行時間環境。
min_date
必要
datetime

最小日期。
max_date
必要

最大日期。

傳回

類型 Description

篩選的數據框架。

屬性

country_or_region_column_name 

country_or_region_column_name = 'countryOrRegion'

countrycode_column_name 

countrycode_column_name = 'countryRegionCode'

default_end_date 

default_end_date = datetime.datetime(2024, 12, 13, 0, 0)

default_max_end_date 

default_max_end_date = datetime.datetime(2099, 1, 1, 0, 0)

default_start_date 

default_start_date = datetime.datetime(2008, 1, 1, 0, 0)