Cómo funciona este generador de calendarios en el navegador

Por qué los datos de días festivos son un archivo estático y no una consulta en vivo

La librería más precisa para calcular días festivos en más de 200 países es un paquete de Node.js. No tiene una versión para navegador, y tampoco importaría si la tuviera, ya que la premisa entera de este sitio es que nada se ejecuta en un servidor. En lugar de descartar la función o construir a mano una versión peor de las mismas reglas, los datos festivos de cada país y año compatible se calculan una sola vez, fuera de línea, y se guardan como un archivo JSON plano que se entrega junto con el resto del sitio, igual que cualquier otro recurso estático. La única tarea del navegador en tiempo de ejecución es un fetch() y una búsqueda en un diccionario por fecha, no se hace ningún cálculo de calendario en el navegador para los días festivos civiles. La contrapartida es un rango de años fijo (2020–2036 en este caso) en vez de "cualquier año para siempre", lo cual es razonable: recalcular el archivo para extenderlo es una tarea de cinco minutos, no un rediseño.

Por qué las fechas islámicas llevan un aviso visible y las judías no

Estos dos calendarios se parecen desde fuera. Ambos no son gregorianos, y ambos determinan algunas fechas que otros calendarios no pueden predecir con aritmética simple, pero la certeza subyacente es genuinamente distinta, y el aviso sigue esa diferencia en vez de aplicar una advertencia genérica de "las fechas religiosas pueden variar" a todo por igual. El calendario hijri depende tradicionalmente del avistamiento local de la luna, así que la misma fecha islámica puede, en la práctica, anunciarse con un día de diferencia según el país: cualquier fecha calculada es una estimación astronómica bien fundamentada de cuándo se espera ese avistamiento, no una certeza. El calendario hebreo, en cambio, es un cálculo matemático fijo desde el siglo IV d.C., sin observación alguna involucrada, la misma categoría de certeza que calcular la fecha del Domingo de Pascua cristiano. Por eso el aviso está delimitado de forma estricta: aparece solo cuando las fechas islámicas están activadas, y solo junto a las fechas islámicas mismas, sin filtrarse a una vista combinada donde también estén activadas fechas cristianas, judías o hindúes.

Por qué los días festivos cristianos se calculan a partir de la fecha de Pascua, y no se buscan por país

La Navidad es una fecha fija en el calendario y aparece directamente en los datos de días festivos de la mayoría de los países. El Viernes Santo, el Miércoles de Ceniza, el Domingo de Ramos y Pentecostés son otra historia: la mayoría de los países que los observan no los declaran días festivos oficiales, así que buscarlos en el calendario civil de un solo país simplemente no devuelve nada para cuatro de las ocho fechas. Los cuatro se definen de la misma forma en la tradición cristiana, un número fijo de días antes o después del Domingo de Pascua, así que, una vez conocida la fecha de Pascua de un año determinado (un cálculo bien definido y ya resuelto), el resto es solo aritmética de fechas: el Miércoles de Ceniza es 46 días antes, el Domingo de Ramos 7 días antes, el Viernes Santo 2 días antes, Pentecostés 49 días después. El Día de Reyes (6 de enero) y el Día de Todos los Santos (1 de noviembre) completan la lista como otras dos fechas fijas del calendario, la misma categoría que la Navidad. No hace falta ninguna consulta al calendario civil para ninguna de las cinco fechas relativas a la Pascua.

Por qué el calendario judío usa una librería dedicada en vez del conjunto de datos festivos general

La librería general de días festivos cubre bien los calendarios civiles, pero solo conoce un puñado de fechas ancla judías y no tiene ningún concepto de un día de Jol HaMoed, una cuenta del Omer, ni de convertir una fecha gregoriana cualquiera a su equivalente hebreo. Una librería perpetua dedicada al calendario hebreo llena ese vacío: es el mismo enfoque de calcular una vez fuera de línea y guardar en JSON que los días festivos civiles, solo que apuntando a un motor construido específicamente para esto. De ahí salen dos archivos. Uno es una tabla de consulta simple que mapea cada día gregoriano de 2020 a 2036 con su día, mes y año hebreo, y es lo que alimenta la pequeña fecha secundaria que se muestra en cada celda del calendario y el rango "Elul 5786 - Tishrei 5787" bajo el encabezado del mes. El otro es una lista completa de cada fecha dentro del alcance: de Rosh Hashaná a Simjat Torá, Purim, Tu BiShvat, los 49 días completos de la cuenta del Omer, los cuatro ayunos menores, Tisha B'Av y más, cada una con su propia regla de presentación ya integrada.

Por qué Janucá tiene días numerados y ninguna otra festividad los tiene

Las festividades de varios días como Sucot y Pésaj repiten su nombre simple en cada día que abarcan. Janucá es la única excepción, etiquetada "Día 1" hasta "Día 8", porque así es como realmente se hace referencia a la festividad día a día (qué vela, qué noche), a diferencia de Sucot o Pésaj, donde los días no tienen nombre individual en el uso cotidiano. La cuenta del Omer tiene su propio formato por la misma razón: "Omer, día 33 (4 semanas y 5 días)" refleja la fórmula tradicional para contarlo en voz alta, y se sigue para los 49 días aunque solo Lag BaOmer (día 33) sea lo bastante importante como para interrumpir la cuenta simple con su propio nombre.

Por qué el sombreado de los días usa cinco colores distintos en vez de un solo resaltado genérico

Un único resaltado de "este día importa" aplanaría una distinción real: un Iom Tov, un ayuno menor y Tisha B'Av no son la misma categoría de día, y tratarlos igual enterraría esa diferencia bajo un color uniforme. Cinco categorías mantienen todo legible de un vistazo: ámbar para los días de Iom Tov, Jol HaMoed, Yom Kipur y cada Shabat; gris para los cuatro ayunos menores; azul para Purim, Janucá y Lag BaOmer; negro solo para Tisha B'Av, por ser el ayuno más severo del año; y rosa para Tu B'Av. El color propio de la festividad de un día siempre gana sobre el sombreado genérico de Shabat de viernes o sábado si ambos aplicarían de otro modo, así que una noche de Janucá que cae en viernes muestra el azul de Janucá, no el ámbar del Shabat.

Por qué el diseño de foto de fondo oscurece cada foto en la misma cantidad fija

Una foto de calendario puede ser cualquier cosa: una foto brillante de playa o un retrato interior tenue, y los números de los días necesitan seguir siendo legibles impresos encima de cualquiera de las dos. En lugar de intentar detectar el brillo de cada foto y ajustar la capa dinámicamente (algo frágil, e inconsistente de una impresión a otra), el diseño de fondo siempre aplica la misma capa oscura semitransparente fija antes de dibujar encima la cuadrícula de días. Es un tratamiento ligeramente más fuerte de lo que estrictamente necesita una foto brillante, pero garantiza el mismo contraste fiable en cada página sin importar qué se suba. Aquí la consistencia le ganó a la sofisticación.

Respuestas rápidas

¿Por qué no puedo generar más de un año en un mismo PDF? Cada descarga construye un año de calendario, un mes por página, para mantener simples tanto el modelo de datos como el diseño del PDF en esta primera versión.

¿Qué pasa si elijo un país que no está en la lista? Aun así puedes crear un calendario sin días festivos automáticos y añadir todo lo que necesites mediante la sección de eventos personalizados. Ninguna otra parte de la herramienta depende de la selección de país.

¿Qué le queda entonces al Generador de Calendario Hebreo dedicado, si esta página ya muestra el calendario judío completo? Dos cosas que necesitan tu ubicación: horarios de encendido de velas y tzeit hakojavim calculados a partir de la puesta de sol real, y la porción semanal de la Torá. Elegir esas opciones activa una confirmación, no una redirección silenciosa, ya que navegar a una página que pide tu ubicación debería ser una elección deliberada.

¿Mis fotos o eventos personalizados se envían a algún lado? No. La consulta de datos festivos, las fotos, los eventos personalizados y la generación del PDF ocurren todos localmente en el navegador. No se sube nada a un servidor.

En resumen: la precisión de los días festivos es un problema de datos, no de tiempo de ejecución, así que se resuelve una sola vez fuera de línea y se entrega como un archivo estático; cada aviso de precisión está delimitado al sistema de calendario específico que realmente tiene incertidumbre, no aplicado de forma genérica; y el calendario judío tiene un motor dedicado en vez de una tabla mantenida a mano, porque un calendario matemático fijo con cuentas del Omer, días de Jol HaMoed y ayunos menores merece una implementación real, no una aproximación.