Calculadora de Días Laborables

Una calculadora de días laborables cuenta cuántos días de trabajo útiles hay dentro de un rango de fechas después de excluir fines de semana y un número indicado de festivos. Es útil para estimar entregas, revisar vacaciones, calcular nómina, organizar ciclos de facturación, planificar contrataciones y preparar cronogramas de proyectos donde los días calendario son demasiado generales. Un día laborable no equivale siempre a un día natural: fines de semana sábado-domingo o viernes-sábado, festivos regionales, cierres de empresa y días de recuperación pueden cambiar el resultado. La herramienta da una estimación rápida según el patrón de fin de semana y los festivos introducidos. Para RR. HH., contratos o asuntos legales, conviene revisar el calendario oficial.

El conteo de días laborables es el número de días naturales en el rango inclusivo `[inicio, fin]` que no son días de fin de semana ni festivos. La fórmula estándar de inclusión de extremos es `total_días = (fin - inicio) / 86_400_000 + 1` cuando ambos límites se normalizan a medianoche UTC, luego se restan los días de fin de semana y festivos. El día de la semana se obtiene de `Date.prototype.getDay()` que devuelve `0` para domingo hasta `6` para sábado — nótese la trampa de desviación de uno en que `getDay()` no es `getDate()` y que el resultado está en la zona horaria local del navegador, por lo que una cadena de fecha UTC que cruza medianoche puede caer en un día de semana diferente al esperado. El patrón de fin de semana varía por región: el valor global predeterminado es sábado-domingo (Occidente, India, la mayor parte de Asia), pero Oriente Medio históricamente usó jueves-viernes y desde 2024 la mayoría de los países del Golfo (Emiratos Árabes, Bahrein, Kuwait, Qatar) se han alineado en viernes-sábado o incluso sábado-domingo con medio viernes. Irán, Afganistán y partes del sur de Asia aún observan solo viernes; Israel observa viernes-sábado. La herramienta expone Sáb-Dom, Vie-Sáb y "ninguno" como los tres ajustes preestablecidos comunes, y deja que el conteo de festivos cubra todo lo demás por resta. El algoritmo de conteo en sí tiene dos implementaciones prácticas. La iteración ingenua recorre un día a la vez: `for (let d = inicio; d <= fin; d.setDate(d.getDate()+1)) if (![0,6].includes(d.getDay())) count++`. Esto es O(n) en días naturales y trivial de leer. La alternativa de forma cerrada calcula `semanas_completas * 5 + días_laborables_semana_parcial` y se ejecuta en O(1), lo que importa para rangos que abarcan muchos años. Los festivos que caen en fin de semana no deben restarse dos veces, por lo que el patrón canónico es filtrar el conjunto de festivos con `festivos.filter(h => !isFinDeSemana(h)).length`. La política de 调休 (días laborables desplazados) de China añade una complejidad que la lógica pura de patrón de fin de semana no puede representar: el Consejo de Estado publica anualmente una lista que convierte sábados o domingos específicos en días laborables para compensar las vacaciones extendidas del Año Nuevo o el Día Nacional, por lo que para calendarios chinos la lista de festivos debe combinarse con una lista explícita de "días laborables de recuperación" en lugar de depender únicamente de la regla del día de la semana.

• Fórmula de rango inclusivo: `total_días = (fin - inicio) / 86_400_000 + 1` con ambas fechas normalizadas a medianoche UTC para evitar desviación por horario de verano.
• `Date.prototype.getDay()` devuelve 0 (Dom) hasta 6 (Sáb) en la zona horaria local del navegador — no UTC, por lo que el código sensible a la zona horaria debería usar `getUTCDay()`.
• Ajustes preestablecidos de fin de semana: Sáb-Dom (Occidente, India, la mayor parte de Asia), Vie-Sáb (la mayoría de los estados del Golfo desde 2006-2013), solo Vie (Irán), ninguno (operaciones 24/7).
• Forma cerrada O(1): `semanas_completas * 5 + días_laborables_extra_en_semana_parcial`; preferida sobre la iteración día a día para rangos de varios años.
• Los festivos que caen en fin de semana no deben contarse dos veces: restar `festivos.filter(h => !isFinDeSemana(h)).length`, no el conteo bruto de festivos.
• 调休 del Consejo de Estado de China: ciertos sábados/domingos se convierten en días laborables oficiales para compensar vacaciones extendidas; requiere una lista explícita de días de recuperación.
• Los festivos federales de EE.UU. (según 5 U.S.C. § 6103) contribuyen 11 días laborables por año natural: Año Nuevo, MLK, Presidentes, Caídos, Juneteenth, Independencia, Trabajo, Colón, Veteranos, Acción de Gracias, Navidad.