Calculadora de días hábiles

Los días naturales y los días hábiles son monedas distintas, y los planes se tuercen sin que nadie lo note cuando alguien convierte de unos a otros a ojo. «Diez días» que abarcan dos fines de semana son seis días hábiles. La herramienta de arriba cuenta los días laborables entre dos fechas para que no tengas que hacerlo tú.

Cómo funciona

Elige una fecha de inicio y una fecha de fin. La herramienta recorre el intervalo día a día y muestra tres cifras: el número de días hábiles, el número de días de fin de semana y el total de días del intervalo.

Hay dos comportamientos que conviene dejar claros, porque son los que más sorprenden a la gente:

• Se cuentan ambos extremos. De lunes a viernes de la misma semana hay cinco días hábiles, no cuatro. Así es como se interpreta normalmente un plazo de entrega o un preaviso: «cinco días hábiles a partir del lunes» termina el viernes.
• El orden da igual. Si introduces la fecha de fin antes que la de inicio, la herramienta las intercambia y muestra los mismos valores positivos en lugar de un número negativo.

Las fechas se interpretan como medianoche en hora local, no en UTC, así que un intervalo nunca se desplaza un día según en qué lado de la línea internacional de cambio de fecha esté tu equipo. Ese desfase de un día es, con diferencia, el bug más habitual en la aritmética de fechas casera, y evitarlo es el motivo por el que el parseo es deliberadamente estricto con el formato YYYY-MM-DD que genera el selector de fecha.

Lo que no sabe

Los festivos. La herramienta considera no laborables los sábados y domingos, y laborables todos los demás días. No incluye ningún calendario de festivos, y es intencionado: los festivos son nacionales, regionales y a veces propios de cada empresa, y una lista integrada que no corresponde a tu país es peor que no tener ninguna. Resta tú mismo los festivos del resultado: si tres de los días laborables del intervalo son festivos donde se hace el trabajo, el número de días hábiles baja en tres.

Semanas no estándar. Los fines de semana de viernes a sábado, las semanas de cuatro días y los turnos rotativos son habituales, y ninguno está modelado aquí. Si tu semana no va de lunes a viernes, parte del total de días y aplica tu propia proporción.

Fracciones de día y zonas horarias. La unidad es un día natural completo en tu zona horaria local. Un SLA transfronterizo medido en horas hábiles necesita un cálculo por horas en la zona del destinatario, y ese es un problema bastante más difícil.

Dónde se usa este número

El recuento de días hábiles está detrás de casi toda la aritmética de planificación y contractual: preavisos, plazos de pago, ventanas de respuesta de un SLA, plazos de presentación ante reguladores y capacidad de un sprint. Pasar de una estimación en días laborables a una fecha del calendario en un plan, y volver atrás, es justo la conversión que hace que un cronograma se retrase antes de que nada haya ido mal en el trabajo. Gestión del cronograma trata las duraciones, las dependencias, los desfases y la ruta crítica, y estimación y planificación explica por qué las estimaciones en días laborables ideales necesitan un factor explícito antes de convertirse en fechas con las que alguien debería comprometerse.

En el código, resiste la tentación de escribir este bucle tú mismo. Las bibliotecas de fechas modernas modelan bien la distinción: java.time ofrece LocalDate, DayOfWeek y TemporalAdjusters.next(...), y todos los lenguajes habituales tienen un equivalente. Además, ya resuelven los años bisiestos, la duración de los meses y los cambios de horario de verano. Optional y la API de fecha y hora repasa estos tipos y cuándo recurrir a cada uno.

Para la diferencia simple en días naturales, sin filtrar los días laborables, la herramienta adecuada es días entre fechas. Ten en cuenta que mide el intervalo y, por tanto, muestra un día menos que esta herramienta para el mismo rango. Para identificar una fecha por su semana ISO, usa la herramienta número de semana.