ForHosting KIT · Fechas y tiempo

Interpretar fechas relativas

Desde el 10 de enero de 2020 a las 12:00 UTC, la frase in 3 days da el 13 de enero de 2020 a las 12:00 UTC. Escriba una frase corta en inglés o español y una referencia para obtener la fecha y hora exactas. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Texto
in 3 days
Fecha de referencia
2020-01-10T12:00:00.000Z
Obtiene
Fecha y hora ISO
2020-01-13T12:00:00.000Z
Marca de tiempo Unix (milisegundos)
1 578 916 800 000

Interprete frases relativas finitas en inglés y en español para obtener marcas de tiempo ISO absolutas, calculadas a partir de un ancla que usted proporciona.

De una frase a un momento exacto

Escribimos fechas relativas a cada rato: dentro de 3 días, en unas semanas, hace un tiempo. Una frase así no tiene un significado fijo hasta que se dice desde dónde empieza, y por eso la herramienta pide un momento de referencia. A partir de él cuenta hacia delante o hacia atrás y le da el resultado exacto. La hora del día se mantiene, de modo que una frase contada desde el mediodía cae también al mediodía: desde el 10 de enero de 2020 a las 12:00 UTC, in 3 days se convierte en el 13 de enero de 2020 a las 12:00 UTC. Recibe el resultado como fecha y hora legibles y como una sola cifra de milisegundos.

Cómo obtener respuestas fiables

La sorpresa más habitual viene del momento de referencia. Contada desde otro punto de partida, la misma frase señala otro día, así que guarde la referencia junto con el resultado cuando importe. La herramienta trabaja con un conjunto limitado de frases cortas en inglés y en español, no con cualquier oración, y una frase vacía o un valor que no sea texto se rechaza antes de calcular nada. Todo ocurre en su equipo, sin consultar nada en línea, así que la misma frase y el mismo momento de referencia dan siempre la misma respuesta, sin necesidad de una hoja de cálculo.

Entradas y salidas

Los campos obligatorios del esquema deben estar presentes y correctamente tipados, mientras que los campos opcionales utilizan valores por defecto documentados. Las respuestas de éxito incluyen siempre los campos de salida principales, de manera que sus enlaces de interfaz permanezcan estables y predecibles de una ejecución a otra.

Le recomendamos leer con atención los ejemplos de referencia relativos al orden de validación, al determinismo de los resultados y a las cadenas de correspondencia de error destinadas a la certificación, antes de conectar esta capacidad a sistemas críticos o a conjuntos de pruebas automatizadas que deben mantenerse fiables a lo largo del tiempo.

Casos límite y restricciones

Las cadenas vacías, los tipos erróneos y los rangos contradictorios se rechazan muy pronto, antes del menor cálculo, lo que vuelve el comportamiento predecible frente a datos mal formados. Las fechas civiles sin zona horaria se tratan como simples fechas de calendario, sin ninguna conversión implícita que pudiera falsear el resultado. Las tablas de referencia viajan dentro de la carpeta de la capacidad y no se realiza ninguna petición de red durante la ejecución, lo que preserva a la vez la confidencialidad y la rapidez.

Trabajo diario

Obtenga una respuesta fiable sin recurrir a una hoja de cálculo.

Docencia

Ejemplos de referencia estables para sus demostraciones.

¿Usa red?

Sin red; el análisis se realiza en su dispositivo.

¿Qué es una fecha relativa?

Es una expresión como in 3 days o «dentro de unos días» que solo tiene sentido a partir de un punto de partida. Por sí sola no nombra ningún día; con un momento de referencia señala una fecha y hora exactas.

¿Para qué sirve el momento de referencia?

Es el instante desde el que se cuenta la frase. La misma frase da resultados distintos desde momentos distintos, así que anote cuál usó si necesita repetir el cálculo más adelante.

¿En qué idiomas puedo escribir la frase?

En inglés o en español. La herramienta entiende un conjunto limitado de frases relativas cortas en esos dos idiomas, no texto libre, y así cada respuesta es previsible.

¿Qué contiene el resultado?

La fecha y la hora en formato ISO, por ejemplo el 2020-01-13 a las 12:00 UTC, y el mismo instante como una cifra de milisegundos, aquí 1578916800000, lista para una hoja de cálculo u otra herramienta.

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.

POSThttps://api.kit.forhosting.com/date/relative-parse

¿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.

curl -X POST https://api.kit.forhosting.com/date/relative-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"in 3 days"}'
{
  "text": "in 3 days"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.relative_parse",
  "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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Cómo funciona

Esta capacidad interpreta frases relativas finitas redactadas en inglés o en español y las convierte en marcas de tiempo ISO-8601 absolutas, calculadas a partir de un ancla que usted proporciona. El cálculo es enteramente determinista y se ejecuta gratis en su navegador gracias a la misma función pura que emplea la API, lo que garantiza resultados idénticos tanto sin conexión como en línea. Cada entrada se valida antes de cualquier operación aritmética: por tanto, los tipos incorrectos se señalan de inmediato mediante un error invalid_input claro y estable. Antes de integrar esta función en sus flujos de producción o en sus pruebas automatizadas, revise los ejemplos de referencia, que cubren tanto los casos correctos como las rutas de error, el orden de validación, la paridad entre el navegador y la API, y el tratamiento seguro de los valores en coma flotante situados fuera de los límites permitidos.

Entradas y salidas

Los valores intermedios extremadamente grandes que rebasan la precisión IEEE-754 producen un error explícito de desbordamiento de rango en lugar de un valor nulo silencioso, lo que evita malas sorpresas en los cálculos posteriores.

Casos límite y restricciones

Examine siempre los ejemplos facilitados antes de la integración: documentan el orden de validación, la paridad entre el navegador y la API, las cadenas de correspondencia de error estables para la certificación y el tratamiento seguro de los valores en coma flotante que quedan fuera de los límites aceptados por el formato.

Automatización

La misma función pura en el widget y en la API.

¿Es gratis?

Sí, nivel A directamente en el navegador.

¿Entrada inválida?

Un error invalid_input con una correspondencia clara.

¿Es estable?

Los ejemplos deterministas fijan el contrato.

¿Autor?

samurai.

Ver la documentación completa del KIT →