Поделиться через

PublicHolidaysOffline Класс

Представляет общедоступный набор данных для государственных праздников в автономном режиме.

Описание строк см. в разделе " Общедоступные праздники " в каталоге открытых наборов данных Microsoft Azure.

Инициализация полей фильтрации.

Конструктор

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)

Параметры

Имя Описание
country_or_region
str

Страна или регион для возврата данных.

Default value: US
start_date
datetime

Дата начала загрузки данных включительно. Если нет, default_start_date используется.

Default value: 1970-01-01 00:00:00
end_date
datetime

Дата завершения загрузки данных включительно. Если нет, default_end_date используется.

Default value: 2099-01-01 00:00:00
cols
list[str]

Список имен столбцов для загрузки из набора данных. Если нет, все столбцы загружаются. Сведения о доступных столбцах в этом наборе данных см. в разделе " Общедоступные праздники".

Default value: None
enable_telemetry
bool

Включение телеметрии в этом наборе данных.

Default value: True
country_or_region
Обязательно
str

Страна или регион, к который вы хотите запросить.
start_date
Обязательно
datetime

Дата начала запроса включительно.
end_date
Обязательно
datetime

Дата окончания, которую вы хотите запрашивать включительно.
cols
Обязательно
Optional[List[str]]

Список имен столбцов, которые вы хотите получить. Ни один из них не получит все столбцы.
enable_telemetry
Обязательно
bool

Указывает, следует ли отправлять данные телеметрии.

Комментарии

В приведенном ниже примере показано, как получить доступ к набору данных.


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

Методы

filter

Время фильтрации.
get_holidays_dates

Получите дикт с ключом дат праздников.
get_holidays_in_range

Получите список сведений о празднике в заданном диапазоне дат.
get_holidays_in_range_by_country_or_region

Получите список сведений о празднике в заданном диапазоне дат.
get_pandas_limit

Получение экземпляра класса ограничения нагрузки данных Pandas.
is_holiday

Обнаружение даты является праздником или нет.
is_holiday_by_country_or_region

Обнаружение даты является праздником или нет.

filter

Время фильтрации.

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

Параметры

Имя Описание
env
Обязательно
RuntimeEnv

Среда выполнения.
min_date
Обязательно
datetime

Минимальная дата.
max_date
Обязательно

Максимальная дата.

Возвращаемое значение

Тип Описание

Отфильтрованный кадр данных.

get_holidays_dates

Получите дикт с ключом дат праздников.

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

Параметры

Имя Описание
country_code

Укажите, какие сведения о празднике страны или региона будут использоваться для проверки.

Default value: None
country_or_region

Укажите, какие сведения о празднике страны или региона будут использоваться для проверки.

Default value: None

Возвращаемое значение

Тип Описание

Дикт с датами праздников в качестве ключей и None в качестве значений.

get_holidays_in_range

Получите список сведений о празднике в заданном диапазоне дат.

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

Параметры

Имя Описание
start_date
Обязательно

Дата начала диапазона дат.
end_date
Обязательно

Дата окончания диапазона дат.
country_code

Укажите, какие сведения о празднике страны или региона будут использоваться для проверки.

Default value: US

Возвращаемое значение

Тип Описание

Кадр данных, содержащий праздники в целевом диапазоне дат.

get_holidays_in_range_by_country_or_region

Получите список сведений о празднике в заданном диапазоне дат.

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

Параметры

Имя Описание
start_date
Обязательно

Дата начала диапазона дат.
end_date
Обязательно

Дата окончания диапазона дат.
country_or_region

Укажите, какие сведения о празднике страны или региона будут использоваться для проверки.

Default value: United States

Возвращаемое значение

Тип Описание

Кадр данных, содержащий праздники в целевом диапазоне дат.

get_pandas_limit

Получение экземпляра класса ограничения нагрузки данных Pandas.

get_pandas_limit()

is_holiday

Обнаружение даты является праздником или нет.

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

Параметры

Имя Описание
target_date
Обязательно

Дата, которую необходимо проверить.
country_code

Укажите, какие сведения о празднике страны или региона будут использоваться для проверки.

Default value: US

Возвращаемое значение

Тип Описание

Является ли target_date праздником или нет. Верно или неверно.

is_holiday_by_country_or_region

Обнаружение даты является праздником или нет.

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

Параметры

Имя Описание
target_date
Обязательно

Дата, которую необходимо проверить.
country_or_region

Укажите, какие сведения о празднике страны или региона будут использоваться для проверки.

Default value: United States

Возвращаемое значение

Тип Описание

Является ли target_date праздником или нет. Верно или неверно.

Атрибуты

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)