Metodología y fuentes de datos
Calendarios Nacionales obtiene sus datos mediante tres métodos: cálculo algorítmico (festivos CO/MX/AR/US), descarga de fuentes oficiales (festivos y fiscal ES) y transcripción manual de publicaciones gubernamentales (escolar y fiscal CO/MX/AR/US). Esta página explica las fuentes, la metodología y la frecuencia de actualización.
Fuentes de datos por país
| País | Tipo | Fuente oficial | Método | Frecuencia |
|---|---|---|---|---|
| España | Festivos | BOE + TGSS (CSV) | Descarga HTTP | Cada sincronización |
| España | Fiscal | AEAT (iCal) | Descarga HTTP | Cada sincronización |
| España | Escolar | CC.AA. (PDF) | Transcripción manual | Anual |
| Colombia | Festivos | Ley 51 de 1983 | Algorítmico | Automático |
| Colombia | Fiscal | DIAN (Decreto de Plazos) | Transcripción manual | Anual |
| Colombia | Escolar | MEN (PDF) | Transcripción manual | Anual |
| México | Festivos | LFT art. 74 | Algorítmico | Automático |
| México | Fiscal | SAT (Calendario del Contribuyente) | Transcripción manual | Anual |
| México | Escolar | SEP (PDF) | Transcripción manual | Anual |
| Argentina | Festivos | Ley 27.399 + Decretos PEN | Algorítmico | Automático |
| Argentina | Fiscal | AFIP/ARCA (RG) | Transcripción manual | Anual |
| Argentina | Escolar | Ministerios provinciales (PDF) | Transcripción manual | Anual |
| EE. UU. | Festivos | 5 U.S.C. § 6103 / OPM | Algorítmico | Automático |
| EE. UU. | Fiscal | IRS (Internal Revenue Code) | Transcripción manual | Anual |
Metodología de cálculo
Festivos fijos
Los festivos con fecha fija (1 de enero, 25 de diciembre, etc.) se toman directamente de la legislación vigente de cada país. No requieren cálculo adicional.
Festivos móviles y reglas de traslado
- Colombia (Ley Emiliani): determinados festivos (entre ellos los 3 relativos a Pascua y varios de fecha fija) se trasladan al lunes siguiente si no caen en lunes. Calculado algorítmicamente según la Ley 51 de 1983.
- México (lunes móviles): 3 festivos se celebran en lunes específicos (primer lunes de febrero, tercer lunes de marzo, tercer lunes de noviembre) según la reforma del DOF 17-01-2006.
- Argentina (trasladables): los feriados trasladables se mueven al lunes más cercano según la Ley 27.399. Los feriados con fines turísticos se determinan por decreto del Poder Ejecutivo Nacional.
- Estados Unidos (observed rule): cuando un festivo federal cae en sábado se observa el viernes anterior; cuando cae en domingo, el lunes siguiente (Executive Order 11582, 1971). Además, 5 festivos siempre caen en lunes por la Uniform Monday Holiday Act de 1968.
- España: el calendario laboral se configura cada año con festivos nacionales, autonómicos y locales. Algunas fechas pueden ser objeto de sustitución o ajuste en el calendario oficial del territorio correspondiente, por lo que conviene comprobar siempre el año y la jurisdicción concretos.
Semana Santa
La fecha de Pascua se calcula mediante el algoritmo de Butcher (computus), que determina el Domingo de Resurrección a partir del cual se derivan Jueves Santo, Viernes Santo, Ascensión, Corpus Christi y Sagrado Corazón. Este cálculo se aplica en España, Colombia, México y Argentina.
Días laborables
El cálculo de días laborables sigue la fórmula: días naturales − fines de semana − festivos en día laborable. La calculadora de cada país permite seleccionar el territorio específico para incluir festivos regionales y locales cuando están disponibles.
Proceso de actualización
- Scripts automatizados: el comando
npm run syncregenera todos los datos. Puede ejecutarse selectivamente por país (--country=es,co). - Validación con umbrales: cada sincronización verifica que el número mínimo de regiones, festivos y municipios se mantenga, alertando si hay anomalías.
- Escritura atómica: los archivos de datos se escriben de forma atómica para evitar corrupción si el proceso se interrumpe.
- Manifiesto de versiones: cada directorio de datos incluye
manifest.jsoncon los años disponibles y el timestamp de generación. - Datos algorítmicos (CO, MX, AR, US): no requieren intervención manual. Son correctos para cualquier año pasado o futuro.
- Datos manuales (escolar, fiscal CO/MX/AR/US): se actualizan una vez al año cuando las agencias publican sus calendarios oficiales.
Limitaciones y aviso legal
- Los datos se proporcionan con fines informativos. No constituyen asesoramiento legal, fiscal ni laboral.
- Pueden existir errores en datos transcritos manualmente de PDFs oficiales.
- Consulte siempre la fuente oficial de cada país antes de tomar decisiones laborales, fiscales o jurídicas.
- Los festivos del sector privado en Estados Unidos dependen del empleador, no de la ley federal.
- Los feriados con fines turísticos de Argentina dependen de decretos anuales del Poder Ejecutivo Nacional y pueden no estar disponibles hasta su publicación en el Boletín Oficial.
- Los datos escolares se basan en el calendario oficial publicado y pueden ser modificados durante el curso académico por las autoridades educativas.
- Los festivos locales de España dependen de la cobertura del CSV de la Seguridad Social, que no siempre incluye todos los municipios.
Para más información sobre quiénes somos, consulta la página Sobre nosotros. Para cuestiones de privacidad, consulta nuestra política de privacidad.