Python Holidays Module: Documentación oficial

El módulo de vacaciones de Python es una herramienta muy útil para trabajar con fechas y días festivos en diferentes países. Este módulo proporciona una amplia gama de funciones y opciones para calcular y manipular fechas festivas, lo que lo convierte en una herramienta imprescindible para cualquier desarrollador de Python que necesite trabajar con fechas festivas en sus proyectos.

Instalación

Para instalar el módulo de vacaciones de Python, puedes utilizar el administrador de paquetes pip. Abre tu terminal y ejecuta el siguiente comando:

pip install holidays

Esto instalará el módulo de vacaciones y todas sus dependencias necesarias en tu entorno de Python.

Uso básico

Una vez que hayas instalado el módulo de vacaciones, puedes importarlo en tu script de Python utilizando la siguiente línea de código:

import holidays

Una vez que hayas importado el módulo, puedes utilizar sus funciones y métodos para trabajar con fechas festivas. Por ejemplo, puedes utilizar la función holidays.CountryHoliday para obtener una lista de todas las fechas festivas de un país específico. A continuación se muestra un ejemplo:

import holidays

# Obtener todas las fechas festivas de Estados Unidos
us_holidays = holidays.CountryHoliday('US')

# Imprimir todas las fechas festivas
for date, name in sorted(us_holidays.items()):
    print(date, name)

Este código imprimirá todas las fechas festivas de Estados Unidos en el formato «YYYY-MM-DD: Nombre de la festividad».

Funciones principales

El módulo de vacaciones de Python proporciona varias funciones principales para trabajar con fechas festivas. A continuación se presentan algunas de las funciones más utilizadas:

• holidays.CountryHoliday(country): Esta función devuelve un diccionario con todas las fechas festivas de un país específico.
• holidays.get_supported_countries(): Esta función devuelve una lista de todos los países compatibles con el módulo de vacaciones.
• holidays.get_list(year, country): Esta función devuelve una lista de todas las fechas festivas de un país y año específicos.
• holidays.get(date, country): Esta función devuelve el nombre de la festividad para una fecha y país específicos.

Parámetros y opciones

El módulo de vacaciones de Python también proporciona varios parámetros y opciones para personalizar su comportamiento. A continuación se presentan algunas de las opciones más comunes:

• observed: Esta opción determina si se deben incluir las fechas festivas observadas. Por defecto, esta opción está establecida en True.
• state: Esta opción permite especificar un estado o provincia específicos para obtener las fechas festivas correspondientes. Por defecto, esta opción está establecida en None.
• prov: Esta opción es similar a la opción «state», pero utiliza un código de provincia en lugar de un nombre completo. Por defecto, esta opción está establecida en None.

Ejemplos de código

A continuación se presentan algunos ejemplos de código que muestran cómo utilizar el módulo de vacaciones de Python en diferentes situaciones:

Ejemplo 1: Obtener todas las fechas festivas de un país específico

import holidays

# Obtener todas las fechas festivas de Estados Unidos
us_holidays = holidays.CountryHoliday('US')

# Imprimir todas las fechas festivas
for date, name in sorted(us_holidays.items()):
    print(date, name)

Ejemplo 2: Obtener todas las fechas festivas de un país y año específicos

import holidays

# Obtener todas las fechas festivas de Estados Unidos en el año 2022
us_holidays_2022 = holidays.get_list(2022, 'US')

# Imprimir todas las fechas festivas
for holiday in us_holidays_2022:
    print(holiday)

Ejemplo 3: Obtener el nombre de la festividad para una fecha y país específicos

import holidays

# Obtener el nombre de la festividad para el 1 de enero de 2022 en Estados Unidos
holiday_name = holidays.get('2022-01-01', 'US')

# Imprimir el nombre de la festividad
print(holiday_name)

Preguntas frecuentes

A continuación se presentan algunas preguntas frecuentes sobre el módulo de vacaciones de Python:

¿Qué países son compatibles con el módulo de vacaciones de Python?

El módulo de vacaciones de Python es compatible con una amplia gama de países de todo el mundo. Puedes utilizar la función holidays.get_supported_countries() para obtener una lista completa de los países compatibles.

¿Cómo puedo agregar fechas festivas personalizadas al módulo de vacaciones de Python?

Puedes agregar fechas festivas personalizadas al módulo de vacaciones de Python utilizando la función holidays.HolidayBase. Esta función te permite crear una clase personalizada que define las fechas festivas y sus nombres correspondientes.

Recursos adicionales

A continuación se presentan algunos recursos adicionales que pueden ser útiles al trabajar con el módulo de vacaciones de Python:

• Página oficial del módulo de vacaciones de Python en PyPI
• Repositorio oficial del módulo de vacaciones de Python en GitHub
• Documentación oficial del módulo de vacaciones de Python

Contribuir al proyecto

Si estás interesado en contribuir al desarrollo del módulo de vacaciones de Python, puedes hacerlo a través del repositorio oficial en GitHub. Puedes enviar solicitudes de extracción, informar problemas o contribuir con documentación adicional para mejorar el proyecto.

Información de contacto

Si tienes alguna pregunta o necesitas ayuda adicional con el módulo de vacaciones de Python, puedes ponerte en contacto con el equipo de desarrollo a través de los siguientes canales:

• Email: holidays@python.org
• Foro de discusión: https://discuss.python.org/c/libs/holidays
• Grupo de chat en línea: https://gitter.im/python-holidays/community