Cuenta atrás de calendario
Del 25 de julio de 2026 a la Navidad de 2026 faltan 153 días. Indique la fecha de hoy y la del evento y obtendrá los días de calendario con signo: positivos mientras falte, cero el mismo día y negativos cuando ya haya pasado. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Hoy
- 2026-07-25
- Fecha del evento
- 2026-12-25
- Días
- 153
- Estado
- upcoming
Una cuenta atrás de calendario responde a la pregunta de planificación que la gente escribe de verdad: cuántos días civiles enteros hay entre hoy y un acontecimiento concreto en el almanaque. Bodas, exámenes, salidas de viaje, lanzamientos de producto, fines de contrato y festivos públicos necesitan ese entero, no una duración de reloj en horas y minutos ni un aniversario de nacimiento que se repite cada año. Esta herramienta nunca inventa el hoy con el reloj del servidor. El resultado es el número con signo de días gregorianos desde hoy hasta el acontecimiento: positivo si aún no ha llegado, cero si es hoy y negativo si ya pasó.
Qué mide una cuenta atrás de calendario
Una cuenta atrás de calendario es una distancia de días enteros con signo desde un hoy explícito hasta una sola fecha de acontecimiento en el calendario gregoriano proléptico. No es un tramo desordenado entre dos fechas intercambiables, ni una duración de reloj partida en horas minutos y segundos, ni un motor de cumpleaños que adelanta el mes y el día de nacimiento al próximo aniversario.
Usted nombra un hoy civil y una fecha civil de acontecimiento; el motor convierte cada terna en un recuento serial de días y resta, de modo que la Navidad de dos mil veintiséis desde el veinticinco de julio de dos mil veintiséis deja ciento cincuenta y tres días restantes, el mismo par invertido son ciento cincuenta y tres días en el pasado, y un acontecimiento que cae en el propio hoy es cero.
Ese signo es el contrato del producto: upcoming si el acontecimiento aún no llega, today si ambas fechas coinciden y past si ya ocurrió. El mismo par de fechas civiles produce siempre el mismo entero porque el motor nunca consulta un reloj del anfitrión, una zona horaria ni tablas de horario de verano. El veintinueve de febrero se acepta solo en año bisiesto; un veintinueve de febrero de año común no se fuerza a marzo, se rechaza.
Los vecinos del catálogo responden a otras búsquedas: los días entre dos fechas miden un tramo absoluto, la cuenta atrás entre dos fechas devuelve un resto de reloj y los días hasta el cumpleaños siguen un aniversario recurrente. Use esta página cuando la búsqueda y el formulario pregunten cuántos días de calendario faltan para un acontecimiento concreto.
Dónde rinde una cuenta atrás de calendario
Los organizadores de bodas, los candidatos a examen y las agencias de viaje necesitan un solo recuento de días restantes frente a una fecha de referencia explícita, no un resto de reloj ni un aniversario de nacimiento. Los calendarios de lanzamiento, los mostradores de contratos y los tableros de curso escolar muestran un aviso cuando el entero llega a treinta, siete, uno o cero. Los sistemas de recordatorio y de fidelidad programan un mensaje para la mañana del acontecimiento sin incrustar una base de zonas horarias en cada cliente.
La incorporación de recursos humanos, el marketing de producto y los tablones municipales guardan la misma cuenta frente a una fecha de auditoría para que exportaciones y suites de regresión reproduzcan el número siempre. Las páginas para padres y los quioscos de tienda pueden ejecutar la cuenta atrás de calendario gratuita en el navegador sin instalar una biblioteca de fechas.
Mantenga expectativas honestas: esta capacidad mide días civiles gregorianos desde un hoy explícito hasta una fecha de acontecimiento; no omite fines de semana como días hábiles, no carga calendarios de festivos, no convierte fiestas lunares, no toma el hoy del reloj del servidor ni adelanta una fecha de nacimiento. Combínela con una herramienta de días entre fechas cuando la búsqueda sea un tramo desordenado, con una cuenta de reloj cuando importen horas y minutos, y con un auxiliar de cumpleaños cuando el acontecimiento se repita cada año.
Como la implementación es parse pura de nivel A, cada llamada correcta sigue siendo barata, determinista y libre de tokens de modelo o red saliente, exactamente lo que necesitan las suites de regresión al fijar casos límite de día bisiesto y de acontecimiento-hoy durante décadas de fechas.
Qué puede hacer con ella
Cuentas atrás de boda, examen y viaje
Pase el hoy y una fecha de acontecimiento para mostrar cuántos días civiles faltan para una boda, un examen o una salida, en invitaciones, planes de estudio y listas de equipaje.
Calendarios de lanzamiento y de contrato
Fije un lanzamiento de producto o el fin de un contrato frente a una fecha de planificación fija para que avisos y tablones coincidan en cada reimpresión.
Tuberías de recordatorio y marketing
Guarde la cuenta con signo frente a un hoy de auditoría para que los mensajes salgan la mañana del acontecimiento sin deriva del reloj del anfitrión entre trabajadores.
Preguntas frecuentes
¿Qué significa un valor negativo en days?
El acontecimiento ya quedó atrás respecto de today. Un days positivo indica upcoming, el cero indica que el acontecimiento es hoy, y status etiqueta ese signo.
¿Cuánto cuesta la cuenta atrás de calendario?
La herramienta del navegador es gratuita en su dispositivo.
¿Por qué tengo que escribir yo la fecha de hoy?
Porque la cuenta atrás nunca consulta un reloj ni una zona horaria por su cuenta. Usted indica qué día es hoy, así que las mismas dos fechas dan siempre el mismo número de días, las consulte donde y cuando las consulte.
¿La cuenta atrás incluye horas y minutos?
No. Cuenta días de calendario completos entre las dos fechas, que es lo que necesita una boda, un examen o una salida de viaje. Un resto en horas, minutos y segundos es otro tipo de cuenta atrás.
¿Qué obtengo si el evento es hoy?
Obtiene cero días y el evento queda marcado como hoy. La víspera muestra un día restante y el día siguiente muestra un día en el pasado, como número negativo.
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/life/calendar-countdown \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"event_date":"2026-12-25","today":"2026-07-25"}'const res = await fetch("https://api.kit.forhosting.com/life/calendar-countdown", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"event_date": "2026-12-25",
"today": "2026-07-25"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/calendar-countdown",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"event_date": "2026-12-25",
"today": "2026-07-25"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/calendar-countdown", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"event_date":"2026-12-25","today":"2026-07-25"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"event_date":"2026-12-25","today":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/calendar-countdown", 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
{
"event_date": "2026-12-25",
"today": "2026-07-25"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.calendar_countdown",
"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.
Límites
year_min | 1 |
year_max | 9999 |
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
Usted suministra el día de referencia y la fecha del acontecimiento como valores civiles YYYY-MM-DD, de modo que el mismo par produce siempre la misma cuenta atrás en el navegador, en la integración continua y en la API. Una fecha de destino vacía o inválida falla con invalid_input y no se factura. Las llamadas API correctas usan el precio base publicado $0.002.
Contrato de entrada, validación de calendario y forma de la respuesta
Cada valor debe ser un día civil en forma YYYY-MM-DD, por ejemplo dos mil veintiséis guion uno dos guion dos cinco para una Navidad y dos mil veintiséis guion cero siete guion dos cinco para el día de referencia. Los años van de uno a nueve mil novecientos noventa y nueve, los meses de uno a doce, y el día debe existir en ese mes bajo reglas de bisiesto gregorianas, incluido el veintinueve de febrero solo en años bisiestos. La validación fallida no se factura. Haga POST de un cuerpo JSON compacto con dos campos de cadena obligatorios: event_date y today. Los alias opcionales target, target_date, date, until y to se asocian al campo del acontecimiento; as_of, reference_date, reference, on y from se asocian a today para que constructores de formularios y SDK conserven nombres habituales. Pares imposibles como dos mil veintitrés guion cero dos guion veintinueve se rechazan con invalid_input en lugar de desplazarlos a marzo. Una cadena vacía, un event_date ausente, un valor que no es cadena o una forma errónea como dos mil veintiséis barra doce barra veinticinco fallan con un mensaje que nombra el campo. Si falta today también es invalid_input, porque el motor nunca inventa un día de referencia con el reloj del anfitrión.
Dónde rinde una cuenta atrás de calendario
Llame a la API de prepago cuando las tuberías de notificación, las imprentas o las herramientas de aula necesiten un contrato estable con saldo KIT a $0.002 por ítem correcto; los fallos de validación no consumen saldo tras el rechazo del motor.
Preguntas técnicas
¿Cómo se calcula una cuenta atrás de calendario hasta un acontecimiento?
Envíe JSON con event_date y today en YYYY-MM-DD. El motor devuelve days como cuenta de días civiles con signo, más status e is_today.
¿Esta cuenta atrás de calendario usa el reloj del servidor para el hoy?
No. today es obligatorio. El motor nunca lee el reloj del sistema, así que los resultados coinciden en CI, navegadores y trabajadores de la API.
¿Qué ocurre si la fecha del acontecimiento está vacía o no es un día real?
La petición falla con invalid_input. Se rechazan un event_date vacío, un campo ausente, el 29 de febrero en un año común y números de día imposibles.