Día hábil más cercano a una fecha
Escriba una fecha y obtenga el día hábil más cercano de lunes a viernes: un sábado se convierte en el viernes anterior, un domingo en el lunes siguiente y los días laborables quedan igual. Útil para plazos y cierres de nómina. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Fecha
- 2024-03-16
- Resultado
- 2024-03-15
- Días de desplazamiento
- -1
- Día de la semana base
- Saturday
- Día de la semana base (ISO)
- 6
Esta calculadora del día hábil más cercano a una fecha toma un solo día del calendario gregoriano en formato estricto YYYY-MM-DD y devuelve el día de lunes a viernes más próximo, calculado como fecha civil pura en UTC. Cuando la entrada ya cae de lunes a viernes, el resultado es esa misma fecha con un desplazamiento de cero días. Cuando la entrada es un sábado, el motor retrocede un día hasta el viernes; cuando es un domingo, avanza un día hasta el lunes: el día laborable más cercano e inequívoco en una semana de siete días, sin festivos. Entre las comprobaciones clásicas están 2024-03-16 (sábado) que se asigna a 2024-03-15 (viernes), 2024-03-17 (domingo) a 2024-03-18 (lunes), y 2024-03-15 (viernes) que permanece sin cambio.
Dónde encaja la aritmética del día hábil más cercano en operaciones, nómina y software
Los equipos de operaciones y producto necesitan un día hábil más cercano cuando un corte debe caer en un día de calendario laborable aunque el usuario haya introducido un sello de fin de semana, cuando una fecha de liquidación o de aviso no debe quedar en sábado o domingo, o cuando un acuerdo de nivel de servicio define la entrega como el día hábil más cercano en lugar de una regla unilateral de siguiente o anterior.
Los flujos de nómina y finanzas ajustan fechas de eventos de forma libre a cubos de lun–vie para que los trabajos por lotes, las ventanas ACH y los vencimientos de factura queden fuera del fin de semana sin inventar un calendario completo de festivos por país.
Los analistas que construyen etiquetas de cohorte usan el mismo movimiento para alinear los inicios de observación lejos del ruido del fin de semana manteniendo exactos los días laborables, evitando errores de desfase de uno en los límites de año y en los días bisiestos.
Los desarrolladores llaman al contrato desde scripts para generar vectores de prueba deterministas para programadores de tareas y validadores de formularios, para sembrar calendarios de demostración en flujos de incorporación, o para satisfacer requisitos de producto que exigen un paso de calendario puro sin inicios de semana de configuración regional del sistema.
Los educadores y los redactores de normas usan la herramienta para demostrar que 2024-03-16 es un sábado cuyo día hábil más cercano es el viernes y que el domingo se asigna hacia adelante al lunes, sin depender de números de serie de hojas de cálculo que difieren entre productos ni de objetos Date en vivo que cambian con las zonas horarias.
Combínela con ayudantes de próximo día de la semana, suma de días laborables o conteo de fines de semana cuando necesite pasos de calendario relacionados, y con otras herramientas deterministas gratuitas cuando esté armando un pequeño laboratorio de utilidades de fecha.
Qué puede hacer con ella
Ajustes de corte y liquidación
Mueva cortes, sellos de liquidación y fechas de aviso introducidos en fin de semana al día de lunes a viernes más cercano, sin inventar una política unilateral de siguiente día hábil.
Alineación de nómina y trabajos por lotes
Normalice fechas de eventos de forma libre en cubos de lun–vie para ventanas ACH, vencimientos de factura y calendarios nocturnos por lotes que rechazan sábado y domingo.
Preguntas frecuentes
¿Cuánto cuesta la calculadora del día hábil más cercano a una fecha?
Es gratuita en su navegador en esta página.
¿Cómo se asignan el sábado y el domingo?
Esos son los días lun–vie más cercanos en una semana simple de siete días.
¿Omite esta herramienta los festivos oficiales?
No. Solo distingue lunes–viernes de sábado–domingo. Use una herramienta de días hábiles con festivos si necesita calendarios por país.
¿Qué formatos de fecha se aceptan?
Fechas de calendario ISO-8601 extendidas estrictas YYYY-MM-DD. Se validan longitudes de mes y días bisiestos; se admiten años de 1 a 9999. Solo día civil UTC: sin marcas de tiempo ni zonas horarias.
¿Por qué el sábado pasa al viernes y no al lunes?
Porque el viernes está a un día de distancia y el lunes a dos. La herramienta elige siempre el día laborable más cercano: el sábado retrocede y el domingo avanza.
Herramientas relacionadas
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/nearest-weekday \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-16"}'const res = await fetch("https://api.kit.forhosting.com/date/nearest-weekday", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-16"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/nearest-weekday",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-16"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/nearest-weekday", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-16"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-16"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/nearest-weekday", 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-03-16"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.nearest_weekday",
"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. |
Notas técnicas
Úsela gratis en el navegador para programación, cortes de nómina y alineación de SLA, o llame a la API a $0.002 por solicitud exitosa cuando necesite ajustes reproducibles del día hábil en CI, canalizaciones de informes o funciones de producto.
Qué significa el día hábil más cercano y qué contiene la respuesta
Encontrar el día de lunes a viernes más cercano responde una pregunta distinta del próximo día de la semana con nombre, del día de la semana anterior o de desplazamientos multi-día por días hábiles: pregunta qué único día civil está más cerca de la entrada permaneciendo dentro del conjunto de lunes a viernes, y trata el sábado y el domingo como no laborables que deben reasignarse. La distancia se mide en medianoches de calendario completas sobre la línea temporal gregoriana proléptica, interpretada como cadena de fecha UTC sin hora del día y sin conversión de zona horaria local. Para cualquier lunes a viernes el desplazamiento es cero y result es igual a la entrada normalizada. Si necesita un día de la semana con nombre en o después de una base, días hábiles con festivos, o conteos de fin de semana entre dos sellos, use esas herramientas específicas; esta página responde únicamente el ajuste al lun–vie más cercano para una fecha ISO explícita. Para el sábado, el viernes anterior está a un día y el lunes siguiente a dos, de modo que el día hábil más cercano es el viernes con offset_days igual a menos uno. Para el domingo, el lunes siguiente está a un día y el viernes anterior a dos, de modo que el día hábil más cercano es el lunes con offset_days igual a más uno. La calculadora devuelve la fecha base normalizada, la cadena result en ISO, offset_days, los indicadores booleanos is_weekend y shifted, el nombre del día de la semana base y el número de día de la semana ISO (lunes igual a uno hasta domingo igual a siete), el mismo par para el resultado, los campos year, month y day del resultado, los componentes base para facilitar el encadenamiento, y un breve recordatorio de la fórmula. Los casos rechazados incluyen el campo date ausente, formatos incorrectos como 2024/03/16, meses imposibles y días que no existen como 2023-02-29.
Cómo se lee la fecha y cómo el resultado se mantiene reproducible
La cadena debe coincidir con cuatro dígitos, un guion, dos dígitos, otro guion y dos dígitos; los espacios al inicio o al final se recortan, pero las fechas parciales, el día del año ordinal solo, los nombres de mes y las marcas de tiempo con componente de hora no se expanden aquí. Tras el análisis, el año debe estar entre 1 y 9999, el mes entre 1 y 12, y el día entre 1 y la longitud real de ese mes en ese año, siguiendo los años bisiestos la regla gregoriana de divisible entre cuatro salvo los años seculares no divisibles entre cuatrocientos. El campo preferido es date, pero se aceptan los alias iso_date, d, value, base y from, de modo que hojas de cálculo, cadenas de consulta y formularios tipados puedan reutilizar el mismo contrato sin renombrar columnas. Internamente, el motor obtiene el día de la semana base con aritmética entera pura de Sakamoto en escala domingo-cero, asigna al sábado un desplazamiento de menos uno y al domingo de más uno dejando de lunes a viernes en cero, convierte la terna civil en un conteo de día serial gregoriano proléptico con la conocida asignación days_from_civil, suma el desplazamiento entero y luego recupera año, mes y día con civil_from_days. Combine la ejecución gratuita en el navegador de esta página con la API de pago cuando necesite el mismo día hábil más cercano dentro de un flujo automatizado que no debe desviarse por la configuración regional del sistema ni por las transiciones de horario de verano.
Dónde encaja la aritmética del día hábil más cercano en operaciones, nómina y software
En esta página el trabajo se ejecuta enteramente en su navegador; a través de la API, cada consulta exitosa cuesta $0.002, la validación fallida no se cobra y no se almacena nada después de que se devuelve la respuesta. Esa división —exploración interactiva gratuita y una API de pago idéntica— coincide con el resto del catálogo tier A del KIT y le permite pasar de una comprobación puntual a un flujo automatizado sin cambiar el resultado matemático.
Casos de integración
Fixtures de prueba deterministas
Genere cadenas ISO reproducibles del día hábil más cercano para pruebas unitarias, validadores de formularios y aserciones de CI, sin depender de Date ni del reloj del sistema.
Preguntas técnicas
¿Qué ocurre si la entrada ya es un día laborable?
La fecha base se devuelve sin cambio. offset_days es 0, shifted es false y result es igual a la fecha de entrada normalizada.