Calcule la cuenta regresiva hasta una fecha objetivo
Sepa cuánto falta para una fecha: del 25 de julio de 2026 a las 10:15 UTC al 28 de julio de 2026 a las 12:45 UTC hay 3 días, 2 horas y 30 minutos, es decir, 4470 minutos. Usted fija el punto de partida. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Actual
- 2026-07-25T10:15:00Z
- Objetivo
- 2026-07-28T12:45:00Z
- Días
- 3
- Horas
- 2
- Minutos
- 30
- Minutos totales
- 4 470
Calcule una cuenta regresiva hasta una fecha objetivo sin depender del reloj del equipo. Indique la fecha y hora actuales y el objetivo futuro como valores ISO-8601 para obtener un desglose estable en días completos, horas restantes y minutos restantes. Las entradas explícitas permiten reproducir la misma solicitud en pruebas, tareas programadas, herramientas web y procesos de servidor. Los desfases horarios se normalizan antes de la resta. Si el objetivo ya pasó, la solicitud devuelve un error salvo que habilite deliberadamente el modo transcurrido, lo que impide confundir un plazo vencido con tiempo restante.
Indique una hora actual y una hora objetivo explícitas
Cada una acepta una fecha de calendario con formato YYYY-MM-DD o una fecha y hora ISO-8601. Una fecha sin hora se interpreta como medianoche UTC, algo útil para hitos definidos por día. Para plazos precisos, incluya horas y minutos y, preferiblemente, una Z final o un desfase numérico como +02:00.
La calculadora convierte ambas entradas a una línea temporal absoluta común antes de restarlas; por ello, dos cadenas que describan el mismo instante producen una cuenta de cero aunque muestren horas locales distintas. El motor valida la duración de los meses gregorianos y los años bisiestos, y no desplaza fechas imposibles al mes siguiente. También rechaza horas mal formadas, desfases inválidos, campos ausentes y valores que no sean cadenas.
Se admiten fracciones de segundo, pero el resultado solo usa minutos completos; los segundos sobrantes se descartan para evitar un redondeo inesperado hacia arriba.
Interprete la cuenta y gestione con seguridad los objetivos vencidos
El tratamiento de fechas vencidas es más estricto. Este valor predeterminado evita convertir silenciosamente un intervalo negativo en una cuenta aparentemente positiva. Si su proceso realmente debe indicar cuánto tiempo hace que venció un plazo, envíe elapsed como true.
Así, el texto posterior puede mostrar “restante” para un plazo activo y “transcurrido” o “vencido” para uno terminado sin deducirlo de las cifras. Un objetivo idéntico a current es válido y devuelve todos los componentes en cero.
Utilice resultados deterministas en aplicaciones y automatizaciones
Esta capacidad sirve para lanzamientos, cierres de inscripción, preparación de eventos, ventanas de mantenimiento, recordatorios de pago y cualquier proceso que ya conozca el instante considerado actual. Los desfases numéricos se aplican directamente; interpretar el horario de verano corresponde al cliente, que debe enviar el desfase correcto para cada instante local en vez del nombre de una ciudad. El cálculo mide tiempo ordinario en días fijos de veinticuatro horas.
No cuenta días laborables, omite fines de semana, consulta festivos, programa avisos ni se actualiza continuamente. Para refrescar una pantalla activa, envíe un valor current más reciente. Gestione aparte los errores de validación para pedir una corrección ante una fecha inválida o un objetivo pasado no autorizado.
Qué puede hacer con ella
Cuenta para un lanzamiento
Convierta un instante actual conocido y la fecha de publicación de un producto en cifras normalizadas para una página de lanzamiento.
Supervisión de plazos
Compruebe el tiempo que queda antes de cerrar una inscripción o un pago y trate como error los objetivos vencidos inesperados.
Informe de hitos transcurridos
Active el modo transcurrido para informar de los días, horas y minutos completos desde que ocurrió un evento conocido.
Preguntas frecuentes
¿La calculadora usa la hora actual del sistema?
No. Debe indicar current explícitamente, por lo que cada cálculo es determinista y reproducible.
¿Qué sucede si el objetivo está en el pasado?
Si lo habilita, la respuesta indica el tiempo desde el objetivo y marca direction como elapsed.
¿Se admiten desfases de zona horaria?
Sí. Use Z o un desfase numérico como +02:00. Ambas entradas se normalizan a la misma línea temporal absoluta antes de restarlas.
¿Cómo se tratan los segundos?
Puede indicarlos, pero el resultado expresa minutos completos. La fracción final de minuto se descarta y no se redondea hacia arriba.
¿La cuenta regresiva descuenta fines de semana y feriados?
No. Mide el tiempo transcurrido en días fijos de 24 horas, así que los fines de semana y los feriados cuentan como cualquier otro día. Para días hábiles necesita otro cálculo.
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/math/countdown-to-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"current":"2026-07-25T10:15:00Z","target":"2026-07-28T12:45:00Z"}'const res = await fetch("https://api.kit.forhosting.com/math/countdown-to-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"current": "2026-07-25T10:15:00Z",
"target": "2026-07-28T12:45:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/math/countdown-to-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"current": "2026-07-25T10:15:00Z",
"target": "2026-07-28T12:45:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/countdown-to-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"current":"2026-07-25T10:15:00Z","target":"2026-07-28T12:45:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"current":"2026-07-25T10:15:00Z","target":"2026-07-28T12:45:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/countdown-to-date", 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
{
"current": "2026-07-25T10:15:00Z",
"target": "2026-07-28T12:45:00Z"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "math.countdown_to_date",
"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
Indique una hora actual y una hora objetivo explícitas
Comience con dos cadenas obligatorias: current y target. Indicar current en vez de pedir al servicio que consulte su reloj es una decisión deliberada: vuelve deterministas los ejemplos guardados, las pruebas automáticas, los procesos de facturación y las llamadas repetidas a la API.
Interprete la cuenta y gestione con seguridad los objetivos vencidos
Una cuenta futura correcta devuelve days, hours, minutes, total_minutes, direction e is_past. Los tres campos de presentación forman una duración normalizada: hours siempre está entre cero y veintitrés, y minutes entre cero y cincuenta y nueve. total_minutes contiene el número absoluto de minutos completos y resulta práctico para ordenar registros, comparar umbrales o decidir cuándo cambiar una interfaz. Para un objetivo futuro o exactamente coincidente, direction vale remaining e is_past es false. Si target representa un instante anterior a current, la solicitud normal falla e indica que debe habilitar elapsed. El resultado conserva los componentes no negativos, direction pasa a elapsed e is_past pasa a true.
Utilice resultados deterministas en aplicaciones y automatizaciones
Un cliente puede asignar days, hours y minutes directamente a tarjetas de cuenta regresiva y conservar total_minutes para alertas y ordenación. Como la implementación nunca consulta Date, el reloj del sistema, una base de zonas horarias, la red ni valores aleatorios, un JSON idéntico siempre genera la misma salida. Esto es valioso cuando una cola reintenta una tarea o se debe reconstruir después un informe histórico. La versión web ejecuta localmente la misma operación pura, mientras que la automatización por API cuesta $0.002 por elemento.
Preguntas técnicas
¿Cuánto cuesta un cálculo mediante API?
Cada elemento correcto de la API cuesta $0.002. La calculadora web puede ejecutar localmente la misma lógica determinista.