Calculadora de Diferencia de Fechas

Una calculadora de diferencia de fechas mide la distancia entre dos fechas del calendario y la expresa en días, semanas, meses aproximados, años aproximados y unidades como horas o minutos. Sirve para revisar duración de proyectos, rangos de vacaciones, periodos de facturación, aniversarios, ventanas de conservación de datos e intervalos históricos simples. El resultado es una diferencia entre fechas, no necesariamente un conteo inclusivo de ambos extremos: del 1 de enero al 3 de enero hay normalmente dos días de diferencia, salvo que la regla del caso indique contar ambos días. Los meses y años son aproximados porque los meses no tienen la misma duración. Para días laborables, festivos, zonas horarias o plazos legales, se necesitan reglas específicas.

La diferencia exacta en días se calcula como Math.floor((end.getTime() - start.getTime()) / 86_400_000), donde 86.400.000 es el número de milisegundos en un día de 24 horas sin cambio de horario. Esto da un intervalo exclusivo: del 1 de enero al 3 de enero hay 2 días, no 3, porque la resta mide el lapso entre dos instantes en lugar de contar casillas de calendario. Para un conteo inclusivo (contar ambos extremos), se suma 1 al resultado; muchas normas legales, de permisos y de facturación requieren esto, y el desfase de un día es la causa más habitual de discrepancias entre los informes de RR. HH. y finanzas. Las semanas son simplemente días / 7; la página también muestra horas = días * 24, minutos = días * 1.440 y segundos = días * 86.400 como totales derivados. Las diferencias en meses y años se etiquetan deliberadamente como "aproximadas" porque los meses y años calendario varían en duración. El enfoque simple es días / 30,436875 (promedio de mes gregoriano) y días / 365,2425 (promedio de año gregoriano en un ciclo de 400 años), lo cual es adecuado para informes de estado y paneles de control pero impreciso para contratos. Para un "X meses completos entre" preciso según el calendario, el algoritmo resta los componentes de año x 12 + mes y luego decrementa en 1 si el día del mes final es anterior al día del mes inicial; así es como la mayoría de las bibliotecas de fechas (date-fns differenceInMonths, dayjs $.diff('month'), Temporal Duration.from) lo calculan. El cálculo de años tiene la misma particularidad: del 2024-02-29 al 2025-02-28 a veces se cuenta como 1 año (ajustando al final del mes) y a veces como 0 años, 11 meses y 30 días, según la convención. Los años bisiestos siguen la regla gregoriana (divisible por 4, excepto los años de siglo no divisibles por 400, así 1900 = común, 2000 = bisiesto, 2024 = bisiesto). Un intervalo que incluye el 29 de febrero recoge un día extra automáticamente porque el conteo de días está anclado en milisegundos desde la época, no en campos de calendario. El manejo de zonas horarias es crítico cuando los dos extremos tienen resolución inferior al día: restar dos valores Date construidos a partir de cadenas de hora local puede desviarse por el desfase UTC local, y un intervalo que cruza una transición de horario de verano puede ser de 23 o 25 horas en lugar de las 24 nominales. El problema Y2038 (desbordamiento del time_t firmado de 32 bits de Unix el 2038-01-19T03:14:07Z) no afecta a esta página porque JavaScript Date usa un flotante de 64 bits capaz de representar fechas hasta aproximadamente 100 millones de días a cada lado de la época, pero los sistemas posteriores escritos en C de 32 bits aún requieren atención.

• Días exactos = Math.floor((end - start) / 86_400_000); 86,4 millones de ms por día sin cambio de horario.
• El resultado es exclusivo por defecto: 1 de enero al 3 de enero = 2 días; sumar 1 para conteo inclusivo (ambos extremos).
• El mes aproximado usa un promedio de 30,436875 días; el año usa 365,2425 días en el ciclo gregoriano de 400 años.
• Diferencia de meses precisa según calendario: (a2-a1)*12 + (m2-m1) y luego -1 si el día final < día inicial, igual que date-fns differenceInMonths.
• Años bisiestos: divisible por 4, excepto los años de siglo deben ser divisibles por 400 (1900 no, 2000 sí, 2024 sí).
• Las transiciones de horario de verano crean días calendario de 23h y 25h; una resta de 24h puede no equivaler a un día calendario.
• JavaScript Date es un flotante de 64 bits, inmune al Y2038 de Unix (desbordamiento de time_t de 32 bits el 2038-01-19 03:14:07 UTC).