Porcentaje de tiempo transcurrido en un intervalo ISO
Indique un inicio, un final y el momento que quiere evaluar, y vea cuánto del intervalo ha pasado: las 14:00 en una franja de 08:00 a 20:00 UTC son el 50 %. Nada depende del reloj actual. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Inicio
- 2026-07-25T08:00:00Z
- End
- 2026-07-25T20:00:00Z
- Referencia
- 2026-07-25T14:00:00Z
- Progreso (%)
- 50
- Transcurrido (ms)
- 21 600 000
- Duración (ms)
- 43 200 000
- Relación con la referencia
- within
Esta calculadora de porcentaje de tiempo transcurrido mide el avance dentro de un intervalo explícito sin consultar el reloj actual. Indique una fecha y hora de inicio, otra de fin y el instante de referencia que desea evaluar. Cada valor debe incluir Z o un desplazamiento UTC numérico; así, dos instantes equivalentes producen el mismo resultado con independencia del equipo o navegador. La salida incluye el porcentaje redondeado y limitado, los milisegundos transcurridos con signo, la duración total, el estado del límite y la posición de la referencia respecto al intervalo.
Defina un intervalo completo y un instante de referencia
El avance solo es significativo cuando los límites y el punto de observación son inequívocos. Tras normalizar ambos desplazamientos, end debe representar un instante posterior a start. La referencia puede estar dentro del intervalo, antes o después.
Por ello, la calculadora sirve para comprobaciones históricas, hitos programados, cuentas regresivas, ventanas de servicio y pruebas reproducibles, ya que nunca sustituye el dato por el reloj del equipo. Un valor como 2026-07-25T14:00:00Z es explícito; una hora local sin desplazamiento se rechaza. Formatos con distinto desplazamiento pueden señalar el mismo instante: 2026-07-25T16:00:00+02:00 y 2026-07-25T14:00:00Z son iguales aquí.
Antes de convertir, se validan los campos del calendario, incluidos los días de cada mes y las reglas gregorianas de años bisiestos, para impedir que una fecha imposible cambie silenciosamente de día.
Comprenda el cálculo en UTC y la limitación
El cálculo convierte primero cada fecha y hora a una escala común de milisegundos UTC. El porcentaje bruto es el tiempo transcurrido dividido por la duración y multiplicado por cien. De forma predeterminada, la respuesta queda entre cero y cien: una referencia anterior al inicio devuelve cero y otra posterior al final devuelve cien.
Usted puede indicar porcentajes mínimo y máximo diferentes si necesita otra escala acotada, siempre que el máximo no sea inferior al mínimo. Un instante exactamente situado en cualquiera de los límites se considera dentro del intervalo y produce de forma natural el porcentaje del extremo correspondiente.
Qué puede hacer con ella
Medir una ventana de lanzamiento
Calcule un porcentaje estable para un despliegue o mantenimiento en un punto de control registrado explícitamente.
Reproducir un valor de panel
Guarde el instante de referencia con el intervalo y regenere exactamente el porcentaje que vio una persona.
Probar los límites
Compruebe estados anteriores, interiores y posteriores con límites configurables y una salida esperada determinista.
Preguntas frecuentes
¿Utiliza la hora actual?
No. Usted debe indicar reference de forma explícita y el cálculo nunca consulta un reloj.
¿Admite desplazamientos de zona horaria?
Sí. Use Z o un desplazamiento numérico como +02:00 o -05:30; todas las entradas se normalizan a UTC.
¿Pueden coincidir el inicio y el final?
No. end debe ser posterior a start porque un intervalo de duración cero no tiene un porcentaje transcurrido definido.
¿Qué pasa si el momento es anterior al inicio o posterior al final?
Por defecto el porcentaje se queda en 0 antes del inicio y en 100 después del final. El tiempo transcurrido conserva su signo, así que sigue viendo cuánto queda fuera del intervalo.
¿Con cuántos decimales sale el porcentaje?
Con seis por defecto. Puede elegir entre cero y doce decimales, y el redondeo se aplica solo después de mantener el porcentaje dentro de sus límites.
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/time-progress-percent \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"start":"2026-07-25T08:00:00Z","end":"2026-07-25T20:00:00Z","reference":"2026-07-25T14:00:00Z"}'const res = await fetch("https://api.kit.forhosting.com/date/time-progress-percent", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/time-progress-percent",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/time-progress-percent", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"start":"2026-07-25T08:00:00Z","end":"2026-07-25T20:00:00Z","reference":"2026-07-25T14:00:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"start":"2026-07-25T08:00:00Z","end":"2026-07-25T20:00:00Z","reference":"2026-07-25T14:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/time-progress-percent", 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
{
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.time_progress_percent",
"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
Defina un intervalo completo y un instante de referencia
Proporcione start, end y reference como fechas y horas ISO 8601 completas, con segundos y Z o un desplazamiento UTC numérico explícito.
Comprenda el cálculo en UTC y la limitación
Resta start de end para obtener la duración completa y start de reference para obtener el tiempo transcurrido con signo. La limitación solo afecta a progress_percent; elapsed_ms conserva el signo y muestra cuánto se aleja la referencia por delante o por detrás del intervalo. clamped indica si el límite modificó el valor bruto y reference_relation devuelve before, within o after.
Elija la precisión y obtenga resultados deterministas
La implementación no accede a la red, no usa aleatoriedad, no invoca Date ni consulta la zona horaria del sistema. Guarde la referencia exacta junto al resultado si necesita reproducirlo. Para mostrar avance en vivo, genere explícitamente la referencia en su aplicación y envíela: la capacidad es deliberadamente un cálculo puro, sin una lectura oculta del reloj. Con precision puede elegir entre cero y doce decimales para progress_percent; el valor predeterminado es seis. El redondeo se aplica después de limitar el porcentaje bruto, de modo que los extremos configurados siguen siendo autoritativos. duration_ms y elapsed_ms permanecen como diferencias enteras en milisegundos, lo que permite auditar el porcentaje o presentar una duración aparte. La conversión gregoriana es aritmética; por tanto, una misma solicitud válida produce el mismo JSON en un Worker del servidor y en el navegador.
Preguntas técnicas
¿Cuánto cuesta mediante la API?
Cada solicitud cuesta $0.002. El mismo cálculo puro también puede ejecutarse en el navegador.
¿Qué ocurre si la referencia queda fuera del intervalo?
El porcentaje se restringe al rango configurado, mientras elapsed_ms con signo y reference_relation conservan su posición real.