Calculadora de fines de semana hasta una fecha
La calculadora de fines de semana hasta una fecha cuenta los pares completos de sábado y domingo dentro del intervalo inclusivo entre una fecha de referencia y una fecha objetivo.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
Ofrece una respuesta práctica sin mezclar fines de semana parciales. Introduzca dos fechas del calendario gregoriano con el formato YYYY-MM-DD; la herramienta admite objetivos pasados o futuros, indica la dirección, informa del intervalo inclusivo y devuelve un resultado reproducible.
Qué se considera un fin de semana completo
Esta calculadora considera fin de semana el sábado y el domingo consecutivos del horario laboral habitual de lunes a viernes. Solo lo cuenta cuando ambas fechas están dentro del intervalo inclusivo formado por la fecha de referencia y la fecha objetivo. Por ejemplo, un periodo que termina en sábado no incluye ese fin de semana porque el domingo queda fuera. Un periodo que comienza en domingo tampoco incluye el par anterior. En cambio, uno que empieza en sábado y termina en domingo contiene exactamente un fin de semana completo. Esta regla evita presentar un descanso parcial como dos días disponibles. No se cuentan viernes, festivos, celebraciones locales ni otros modelos regionales de descanso. Los dos extremos se incluyen al comprobar el intervalo. Por tanto, el resultado responde a una pregunta precisa: ¿cuántos pares completos de sábado y domingo quedan totalmente comprendidos entre esas dos fechas?
Cómo introducir las fechas e interpretar el resultado
Indique la fecha de referencia y la fecha objetivo con el formato estricto YYYY-MM-DD, usando cuatro cifras para el año y dos para el mes y el día. La calculadora valida fechas gregorianas reales, por lo que rechaza valores imposibles como el 30 de febrero en vez de trasladarlos silenciosamente a otro mes. El objetivo puede ser posterior, anterior o igual a la referencia. El recuento es simétrico: invertir los mismos extremos no cambia el número de fines de semana completos. El campo de dirección aclara si el objetivo está en el futuro, en el pasado o en el mismo día respecto de la referencia indicada. También se devuelve el total inclusivo de días naturales para facilitar la comprobación. No se presupone la fecha actual. Para hacer una cuenta atrás desde hoy, introduzca hoy explícitamente como referencia; así, una solicitud guardada seguirá siendo comprensible y reproducible más adelante.
Cómo aplicar el recuento a planes reales
El número de fines de semana completos es una medida de planificación concisa, pero conviene combinarla con las restricciones de cada actividad. En un viaje, cada par contado representa un sábado y un domingo totalmente incluidos en el periodo; los desplazamientos del viernes por la tarde o del lunes por la mañana quedan fuera de esta medida. En un proyecto, el dato puede estimar cuántas sesiones de trabajo sin interrupciones o periodos de descanso habrá antes de un hito, pero no los convierte en horas laborables. Para eventos, permite comparar intervalos candidatos de forma coherente cuando una opción comienza o termina a mitad de un fin de semana. El algoritmo utiliza solo valores de calendario, sin zonas horarias, horas, cambios estacionales, red ni fecha actual del equipo. Así, la misma entrada produce el mismo resultado en el navegador o mediante API. Cada solicitud por API cuesta $0.002; la calculadora del navegador ejecuta localmente la misma lógica determinista.
Qué puede hacer con ella
Planificar las fechas de un viaje
Sepa cuántos pares completos de sábado y domingo caben entre las fechas de reserva, salida o regreso.
Estimar fines de semana de proyecto
Cuente los fines de semana completos disponibles antes de un lanzamiento, una entrega, una reforma o un examen.
Comparar intervalos para eventos
Evalúe varias fechas sin tratar por error un sábado o domingo situado en el límite como un fin de semana completo.
Preguntas frecuentes
¿Se incluyen las fechas de referencia y objetivo?
Sí. Ambos extremos forman parte del intervalo, pero el fin de semana solo cuenta si incluye tanto el sábado como el domingo.
¿Qué ocurre si la fecha objetivo es anterior?
La calculadora usa el mismo intervalo y marca la dirección como pasada. Invertir los extremos no modifica el recuento.
¿Se cuenta un intervalo que termina en sábado?
No. El domingo siguiente queda fuera del intervalo, por lo que ese par no constituye un fin de semana completo.
¿Se incluyen festivos o modelos regionales de descanso?
No. Un fin de semana es estrictamente sábado y domingo; no se consideran festivos ni otros días no laborables regionales.
¿Influyen la zona horaria o el horario de verano?
No. El cálculo usa únicamente fechas del calendario, sin horas, zonas horarias ni cambios de horario estacional.
¿Cuánto cuesta una solicitud por API?
Cada solicitud por API cuesta $0.002. La versión del navegador ejecuta gratis el mismo cálculo determinista.
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/weekends-until \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"reference_date":"2026-08-12","target_date":"2026-09-07"}'const res = await fetch("https://api.kit.forhosting.com/date/weekends-until", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"reference_date": "2026-08-12",
"target_date": "2026-09-07"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/weekends-until",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"reference_date": "2026-08-12",
"target_date": "2026-09-07"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weekends-until", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"reference_date":"2026-08-12","target_date":"2026-09-07"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"reference_date":"2026-08-12","target_date":"2026-09-07"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekends-until", 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
{
"reference_date": "2026-08-12",
"target_date": "2026-09-07"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.weekends_until",
"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. |