Holidays ES

A small Python package to obtain the public holidays in Spain from 2006 to the current year. This application uses the web scraping technique to obtain the data from calendarioslaborales.net

Made with Python with ❤️

Package:
CI/CD:
Meta:

Install

Install via pip:

$ pip install holidays-es

Quick Start

1. Import the HolidaySpain class and set the province and year of the holidays you want to obtain.

from datetime import date
from holidays_es import Province, HolidaySpain, Scope

holiday_spain = HolidaySpain(province=Province.VALENCIA, year=2022)

holiday_date = date(day=1, month=1, year=2022)
expected_holiday = models.Holiday(
    scope=Scope.NATIONAL,
    date=holiday_date,
    description="Año nuevo",
)

assert expected_holiday == holiday_spain.find(date=holiday_date)

2. If you only need the national, regional, or local holidays, you can also obtain them in the following way:

from holidays_es import Province, HolidaySpain

holiday_spain = HolidaySpain(province=Province.MADRID, year=2020)

for holiday in holiday_spain.national:
    holiday.scope  # <Scope.NATIONAL: 'national'>
    holiday.date  # datetime.date(2023, 1, 1)
    holiday.description  # Año nuevo