ForHosting KIT · Utilidades de desarrollo

Sumar minutos a una fecha y hora

Sume minutos a una fecha y hora cuando una agenda, un registro, una caducidad, una entrega o una prueba necesite un instante desplazado exacto.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Indique una fecha y hora ISO completa con Z o un desfase horario numérico, además de una cantidad entera de minutos positiva, negativa o cero. La calculadora valida el calendario y el desfase, convierte el instante indicado a UTC, realiza una operación determinista y devuelve una fecha y hora UTC canónica. Nunca consulta la hora actual, adivina una zona horaria ni depende del equipo donde se ejecuta.

Indique un instante inicial completo e inequívoco

Introduzca el valor inicial como fecha y hora ISO con fecha de calendario, separador T, horas, minutos, segundos y un indicador explícito de zona horaria. Un valor terminado en Z ya representa UTC. Un valor terminado en un desfase como +02:00 o -05:30 combina la hora local con su diferencia exacta respecto de UTC. Exigir este sufijo evita errores habituales de planificación: una hora local sin zona cambia de significado según el ordenador, navegador o servidor que la interprete. La parte de calendario se comprueba con las reglas gregorianas de años bisiestos y duración de los meses, por lo que las fechas imposibles se rechazan en vez de normalizarse silenciosamente. Las horas deben estar entre 00 y 23, y los minutos y segundos entre 00 y 59. Las fracciones de segundo opcionales pueden tener de uno a tres dígitos. No se admiten nombres como Europe/London, porque requieren reglas históricas y pueden crear ambigüedad por el horario de verano. Use un desfase que identifique expresamente el instante deseado.

Comprenda la suma de minutos y la conversión a UTC

La operación interpreta primero la fecha, la hora y el desfase numérico facilitados como un único instante absoluto. Convierte ese instante a UTC mediante aritmética de calendario y después suma la cantidad solicitada de minutos enteros con signo. Los números positivos avanzan, los negativos retroceden y cero solo normaliza a UTC. Los acarreos atraviesan cualquier límite: hora, día, mes, día bisiesto, año o siglo. El resultado siempre termina en Z, de modo que su zona queda explícita y uniforme para almacenarlo o compararlo. Los segundos y sus fracciones no cambian porque el incremento es un múltiplo exacto de un minuto. La implementación no invoca el constructor Date de JavaScript ni consulta el reloj del sistema. Cuenta días gregorianos, aplica como enteros el desfase y los minutos, y reconstruye los campos UTC. Así, la misma entrada produce idéntica salida en navegador, worker, prueba automatizada o servidor, sin importar la configuración regional ni la zona del equipo anfitrión.

Use el resultado con seguridad en automatizaciones y pruebas

Esta capacidad sirve para flujos que ya conocen su instante inicial y necesitan una marca temporal derivada y reproducible. Puede crear un recordatorio treinta minutos después de un evento, calcular un plazo fijo de cortesía, convertir registros importados desde sus desfases declarados a UTC o preparar pruebas en torno a medianoche y días bisiestos. El objeto devuelto incluye la fecha y hora original recortada, la cantidad entera normalizada, el resultado desplazado y una etiqueta UTC explícita. Guarde o compare el campo de resultado cuando otro sistema espere una marca canónica. Se trata de aritmética de minutos transcurridos, no de planificación civil por región. Sumar sesenta minutos añade siempre exactamente 3,600 segundos; no consulta cambios de horario de verano ni calendarios laborales. Si una cita debe conservar la misma hora de pared tras un cambio regional, resuelva antes la región y el desfase previsto. Una entrada incompleta devuelve un error tipado de entrada no válida. La ejecución por API cuesta $0.002 por elemento y el navegador utiliza el mismo cálculo puro.

Fijar una caducidad exacta

Añada un periodo fijo de cortesía a la marca temporal de un token, una reserva o una carga y guarde el límite UTC.

Normalizar marcas con desfase

Desplace cero minutos una fecha y hora con desfase para obtener su representación UTC canónica equivalente.

Crear pruebas de límites

Genere casos deterministas que crucen medianoche, fin de mes, día bisiesto o fin de año sin consultar el reloj actual.

¿Cuánto cuesta una llamada a la API?

Cada elemento cuesta $0.002. La versión del navegador ejecuta localmente el mismo cálculo determinista.

¿Se usa la fecha o la hora actual?

No. Solo se utilizan la fecha y hora explícita y la cantidad de minutos proporcionadas en la solicitud.

¿Se admiten cantidades negativas de minutos?

Sí. Un entero negativo resta minutos transcurridos y cero únicamente normaliza el instante a UTC.

¿Por qué la fecha y hora debe incluir Z o un desfase?

Sin ese dato, una hora local no identifica un instante único y podría variar según la zona del equipo anfitrión.

¿Gestiona el horario de verano?

Respeta el desfase numérico explícito, pero no deduce reglas regionales de horario de verano a partir de nombres de zona.

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/add-minutes

¿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/add-minutes \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-07-25T23:45:30Z","minutes":30}'
{
  "datetime": "2026-07-25T23:45:30Z",
  "minutes": 30
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.add_minutes",
  "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.

Ver la documentación completa del KIT →