ForHosting KIT · Utilidades de desarrollo

Contar días laborables entre fechas y festivos

Este contador calcula los días de lunes a viernes dentro de un intervalo inclusivo y permite descontar una lista opcional de festivos.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Resulta útil para plazos, condiciones de pago, turnos y cualquier proceso en el que los días naturales den una respuesta incorrecta. Se tienen en cuenta ambas fechas límite, los festivos duplicados se ignoran y un festivo en sábado o domingo no se descuenta dos veces. El cálculo usa aritmética de calendario, no la hora local, por lo que una misma entrada siempre produce el mismo resultado.

Elija el intervalo y comprenda sus límites

Introduzca la fecha inicial y la final con el formato exacto YYYY-MM-DD. El cálculo es inclusivo: cada límite puede aportar un día laborable. Si ambas fechas corresponden al mismo miércoles, el resultado será uno, salvo que ese día figure como festivo. Si el intervalo de un solo día cae en domingo, el resultado será cero. Esta regla explícita es importante al comparar calculadoras, pues algunas omiten silenciosamente el primer día o interpretan el último como un vencimiento ajeno al intervalo. Aquí se revisan todos los días naturales desde el inicio hasta el final. La fecha final no puede ser anterior a la inicial; un intervalo invertido genera un error de entrada, no una cifra negativa o engañosa. También se comprueba que las fechas existan en el calendario gregoriano, de modo que valores imposibles como el 30 de febrero se rechazan en lugar de desplazarse a otro mes.

Excluya festivos sin alterar los fines de semana

Añada los festivos como una lista opcional de fechas YYYY-MM-DD. Un festivo solo reduce el resultado cuando está dentro del intervalo y cae de lunes a viernes. Si cae en sábado o domingo, no produce otro descuento porque ese día ya está fuera del recuento semanal. Las fechas ajenas al intervalo se aceptan, pero no influyen, lo que permite reutilizar un calendario corporativo en muchos cálculos. Las entradas duplicadas cuentan una sola vez, incluso si varios calendarios incluyen el mismo cierre. La herramienta no selecciona automáticamente los festivos de un país: usted aporta los que correspondan a su contrato, oficina, centro, mercado o jurisdicción. Así no se presuponen días sustitutorios, cierres regionales ni políticas internas. Cada festivo se valida, y una fecha mal formada o imposible devuelve un error claro en vez de ignorarse sin aviso.

Aplique el resultado a planes y automatizaciones

La respuesta separa el total definitivo de dos datos de auditoría: los días de lunes a viernes antes de restar festivos y el número de festivos laborables realmente excluidos. Así resulta sencillo explicar y comprobar el cálculo. Por ejemplo, un responsable puede mostrar que un intervalo contenía ocho días entre semana y un festivo aplicable, por lo que quedan siete días laborables. Nóminas, facturación, soporte, logística y cumplimiento pueden usar la misma estructura para verificar ventanas de servicio sin depender de la zona horaria del equipo. El algoritmo emplea aritmética entera determinista y no consulta la red, la fecha actual ni valores aleatorios. Por ello, la misma entrada ofrece idéntica salida en el navegador y en la API. El uso interactivo es gratuito; cada solicitud de API cuesta $0.002. En procesos recurrentes, conserve la jurisdicción y la política junto con su lista de festivos, ya que la herramienta evalúa las fechas indicadas, pero no decide cuáles observa oficialmente su organización.

Medir un plazo de servicio

Cuente los días de trabajo disponibles entre la recepción y la finalización, excluyendo los cierres aplicables al equipo.

Comprobar condiciones de pago

Calcule un intervalo inclusivo para revisar pagos e indique expresamente los festivos bancarios o de oficina pertinentes.

Planificar personal y entregas

Compare periodos de proyecto con un recuento uniforme de lunes a viernes y una lista reutilizable de festivos internos.

¿Se incluyen las fechas inicial y final?

Sí. Cada límite cuenta si cae de lunes a viernes y no es uno de los festivos excluidos.

¿Qué ocurre si un festivo cae en fin de semana?

No tiene ningún efecto adicional, porque sábados y domingos ya quedan fuera del recuento.

¿Los festivos duplicados se cuentan varias veces?

No. Una misma fecha festiva se excluye como máximo una vez.

¿La herramienta conoce los festivos de mi país?

No. Indique las fechas aplicables a su jurisdicción u organización, incluidos los días sustitutorios observados.

¿Qué sucede si la fecha final precede a la inicial?

El cálculo devuelve un error de entrada no válida en lugar de un resultado negativo.

¿Cuánto cuesta un cálculo mediante API?

Cada solicitud de API utiliza el precio base publicado de $0.002; la calculadora del navegador es gratuita.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/calc2/business-days-count

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/calc2/business-days-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date":"2026-07-01","end_date":"2026-07-10"}'
{
  "start_date": "2026-07-01",
  "end_date": "2026-07-10"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc2.business_days_count",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →