Días laborables en un año
La calculadora de días laborables de un año recibe una fecha ISO explícita, identifica su año natural y cuenta todos los días de lunes a viernes.
Ejecutar — gratis
Puede añadir una lista opcional de festivos para descontar los que caigan entre semana, sin restar dos veces una fecha repetida ni un festivo que ya sea fin de semana. El cálculo aplica reglas gregorianas fijas y aritmética determinista, por lo que una misma entrada ofrece siempre el mismo resultado en cualquier zona horaria.
Seleccione el año mediante una fecha explícita
Introduzca una fecha con el formato ISO exacto YYYY-MM-DD. Aunque el cálculo solo utiliza el año, se exige la fecha completa para que las solicitudes de API sean inequívocas y no dependan del año actual, la configuración regional de la cuenta ni el reloj del servidor. Por ejemplo, 2024-07-25 selecciona todo el año natural 2024, desde el 1 de enero hasta el 31 de diciembre; el recuento no empieza el 25 de julio. El resultado muestra la fecha enviada, el año elegido, los días naturales, los días de fin de semana, los festivos entre semana y el total final de días laborables. Se admiten años entre 0001 y 9999 conforme al calendario gregoriano proléptico y su regla de años bisiestos. Las fechas inexistentes, como 2025-02-29, se rechazan en lugar de corregirse silenciosamente. Así obtiene cálculos reproducibles para planificación, auditorías, pruebas y reglas empresariales almacenadas.
Excluya correctamente fines de semana y festivos
Primero se excluyen todos los sábados y domingos del año seleccionado. Después puede facilitar los festivos como una lista de fechas ISO. Un festivo reduce el total únicamente si pertenece al año elegido y cae de lunes a viernes. Si cae en sábado o domingo, ya está excluido como fin de semana y no vuelve a restarse. Las fechas repetidas también se eliminan antes del recuento. Los festivos válidos de otros años se aceptan, pero se ignoran, por lo que puede enviar una lista común de varios años sin filtrarla en cada solicitud. La herramienta no inventa festivos oficiales, no aplica automáticamente días de sustitución ni deduce un país a partir de su ubicación. Esas normas cambian según la jurisdicción, la empresa, el convenio y el año. Indique exactamente las fechas de cierre que correspondan a su organización. El desglose separado permite explicar con claridad cómo se obtiene el resultado final.
Use un recuento determinista en su planificación
El cálculo emplea únicamente aritmética entera de calendario. No consulta servicios externos, no lee la hora actual, no utiliza el objeto Date de JavaScript ni aplica cambios de horario o ajustes regionales. En la práctica, UTC proporciona la interpretación estable: 2026-01-01 sigue siendo esa fecha tanto si la solicitud se ejecuta en Tokio como en Londres o California. Esto resulta útil para planes anuales de capacidad, modelos de personal, objetivos de utilización, previsiones de nivel de servicio o estimaciones de nómina. Guarde la fecha de entrada y la lista de festivos junto con el desglose devuelto para conservar una instantánea auditable. El resultado representa posibles días laborables de lunes a viernes, no las horas trabajadas por una persona concreta. No incluye vacaciones, jornadas parciales, cierres no indicados, fines de semana distintos de sábado y domingo ni medias jornadas. Puede ejecutarlo gratis en el navegador o usar la API por $0.002 en flujos automatizados.
Qué puede hacer con ella
Prepare un plan anual de capacidad
Parta de los días disponibles del año, reste sus cierres reales y multiplique el resultado transparente por la capacidad diaria del equipo.
Revise supuestos de nómina y utilización
Compare los días laborables previstos por un modelo con un desglose determinista de fines de semana y festivos efectivos.
Haga reproducibles sus previsiones
Conserve la fecha y la lista de festivos para que las ejecuciones futuras apliquen las mismas reglas y no el reloj actual.
Preguntas frecuentes
¿La fecha indica cuándo empieza el recuento?
No. La fecha selecciona todo su año natural; se consideran todos los días desde el 1 de enero hasta el 31 de diciembre.
¿Qué días se consideran fin de semana?
El sábado y el domingo. La herramienta no deduce otros patrones semanales de descanso.
¿Qué ocurre si un festivo cae en fin de semana?
No se resta otra vez, porque esa fecha ya forma parte del recuento de fines de semana.
¿La calculadora conoce los festivos nacionales?
No. Facilite las fechas exactas de festivos o cierres aplicables a su organización y jurisdicción.
¿Cuánto cuesta una solicitud de API?
Cada solicitud de API cuesta $0.002. El mismo cálculo determinista también está disponible gratis en el navegador.
Para desarrolladores — acceso por API
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.
Endpoint de API
¿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.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/date/workdays-in-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-07-25"}'const res = await fetch("https://api.kit.forhosting.com/date/workdays-in-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-07-25"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/workdays-in-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-07-25"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/workdays-in-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-07-25"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/workdays-in-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"date": "2024-07-25"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.workdays_in_year",
"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.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |