Udostępnij za pośrednictwem

PublicHolidaysOffline Klasa

  • Odwołanie

Reprezentuje publiczny zestaw danych dni wolnych od pracy w trybie offline.

Aby zapoznać się z opisem wierszy, zobacz Artykuł Public Holidays in the Microsoft Azure Open Datasets catalog (Święta publiczne) w katalogu Microsoft Azure Open Datasets (Otwarte zestawy danych platformy Microsoft Azure).

Inicjowanie pól filtrowania.

Dziedziczenie
CountryOrRegionTimePublicData
PublicHolidaysOffline

Konstruktor

PublicHolidaysOffline(country_or_region: str = 'US', start_date: datetime = datetime.datetime(1970, 1, 1, 0, 0), end_date: datetime = datetime.datetime(2099, 1, 1, 0, 0), cols: List[str] | None = None, enable_telemetry: bool = True)

Parametry

Nazwa Opis
country_or_region
str

Kraj lub region, dla których mają być zwracane dane.

Domyślna wartość: US
start_date
datetime

Data rozpoczęcia ładowania danych włącznie. Jeśli wartość Brak, zostanie użyta default_start_date .

Domyślna wartość: 1970-01-01 00:00:00
end_date
datetime

Data zakończenia ładowania danych, włącznie z tą datą. Jeśli wartość Brak, zostanie użyta default_end_date .

Domyślna wartość: 2099-01-01 00:00:00
cols
list[str]

Lista nazw kolumn do załadowania z zestawu danych. Jeśli brak, wszystkie kolumny zostaną załadowane. Aby uzyskać informacje na temat dostępnych kolumn w tym zestawie danych, zobacz Dni wolne od pracy.

Domyślna wartość: None
enable_telemetry
bool

Czy włączyć telemetrię dla tego zestawu danych.

Domyślna wartość: True
country_or_region
Wymagane
str

Kraj lub region, względem którego chcesz wykonać zapytanie.
start_date
Wymagane
datetime

Data rozpoczęcia, o którą chcesz wykonać zapytanie włącznie.
end_date
Wymagane
datetime

Data zakończenia, która ma być wysyłana do zapytania włącznie.
cols
Wymagane
Optional[List[str]]

Lista nazw kolumn, które chcesz pobrać. Żadna z nich nie uzyska wszystkich kolumn.
enable_telemetry
Wymagane
bool

Wskazuje, czy wysyłać dane telemetryczne.

Uwagi

W poniższym przykładzie pokazano, jak uzyskać dostęp do zestawu danych.


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

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

Metody

filter

Filtruj czas.
get_holidays_dates

Pobierz Dict z kluczem dat świąt.
get_holidays_in_range

Pobierz listę informacji świątecznych bazowych na danym zakresie dat.
get_holidays_in_range_by_country_or_region

Pobierz listę informacji świątecznych bazowych na danym zakresie dat.
get_pandas_limit

Pobierz wystąpienie klasy limitu obciążenia danych biblioteki pandas.
is_holiday

Wykryj datę to święto lub nie.
is_holiday_by_country_or_region

Wykryj datę to święto lub nie.

filter

Filtruj czas.

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

Parametry

Nazwa Opis
env
Wymagane
RuntimeEnv

Środowisko uruchomieniowe.
min_date
Wymagane
datetime

Minimalna data.
max_date
Wymagane

Maksymalna data.

Zwraca

Typ Opis

Przefiltrowana ramka danych.

get_holidays_dates

Pobierz Dict z kluczem dat świąt.

get_holidays_dates(country_code: str | None = None, country_or_region: str | None = None) -> Dict[datetime, None] | None

Parametry

Nazwa Opis
country_code

Określ, które informacje o wakacjach w kraju/regionie będą używane do sprawdzania.

Domyślna wartość: None
country_or_region

Określ, które informacje o wakacjach w kraju/regionie będą używane do sprawdzania.

Domyślna wartość: None

Zwraca

Typ Opis

Dykt z datami świąt jako kluczami i Brak jako wartościami.

get_holidays_in_range

Pobierz listę informacji świątecznych bazowych na danym zakresie dat.

get_holidays_in_range(start_date: date, end_date: date, country_code: str = 'US') -> DataFrame

Parametry

Nazwa Opis
start_date
Wymagane

Data rozpoczęcia zakresu dat.
end_date
Wymagane

Data zakończenia zakresu dat.
country_code

Określ, które informacje o wakacjach w kraju/regionie będą używane do sprawdzania.

Domyślna wartość: US

Zwraca

Typ Opis

Ramka danych zawierająca dni wolne w docelowym zakresie dat.

get_holidays_in_range_by_country_or_region

Pobierz listę informacji świątecznych bazowych na danym zakresie dat.

get_holidays_in_range_by_country_or_region(start_date: date, end_date: date, country_or_region: str = 'United States') -> DataFrame

Parametry

Nazwa Opis
start_date
Wymagane

Data rozpoczęcia zakresu dat.
end_date
Wymagane

Data zakończenia zakresu dat.
country_or_region

Określ, które informacje o wakacjach w kraju/regionie będą używane do sprawdzania.

Domyślna wartość: United States

Zwraca

Typ Opis

Ramka danych zawierająca dni wolne w docelowym zakresie dat.

get_pandas_limit

Pobierz wystąpienie klasy limitu obciążenia danych biblioteki pandas.

get_pandas_limit()

is_holiday

Wykryj datę to święto lub nie.

is_holiday(target_date: date, country_code: str = 'US') -> bool

Parametry

Nazwa Opis
target_date
Wymagane

Data, która musi być sprawdzana.
country_code

Określ, które informacje o wakacjach w kraju/regionie będą używane do sprawdzania.

Domyślna wartość: US

Zwraca

Typ Opis

Niezależnie od tego, czy target_date jest wakacjami, czy nie. Prawda czy fałsz?

is_holiday_by_country_or_region

Wykryj datę to święto lub nie.

is_holiday_by_country_or_region(target_date: date, country_or_region: str = 'United States') -> bool

Parametry

Nazwa Opis
target_date
Wymagane

Data, która musi być sprawdzana.
country_or_region

Określ, które informacje o wakacjach w kraju/regionie będą używane do sprawdzania.

Domyślna wartość: United States

Zwraca

Typ Opis

Niezależnie od tego, czy target_date jest wakacjami, czy nie. Prawda czy fałsz?

Atrybuty

HOLIDAYS_DF 

HOLIDAYS_DF = countryOrRegion  ... isPaidTimeOff 0              Denmark  ...          None 1              Belgium  ...          None 2          Netherlands  ...          None 3              Croatia  ...          None 4                Czech  ...          None ...                ...  ...           ... 344981         Croatia  ...          None 344982          Norway  ...          None 344983          Sweden  ...          None 344984          Sweden  ...          None 344985          Norway  ...          None  [344986 rows x 5 columns]

data 

data = None

default_country_or_region 

default_country_or_region = 'US'

default_end_date 

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

default_start_date 

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