ForHosting KIT · Utilidades de desarrollo

Minutos a desfase UTC

El formateador de minutos a desfase UTC convierte un valor entero con signo en una cadena numérica estable, como UTC+05:30 o UTC-04:00.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Solo utiliza el valor que usted envía, por lo que el resultado nunca depende de la fecha actual, el reloj del dispositivo, la configuración regional del navegador, la ubicación geográfica, las reglas del horario de verano ni una base de datos de zonas horarias. La salida siempre incluye el prefijo UTC, un signo explícito, dos cifras para la hora, dos puntos y dos cifras para los minutos; así resulta apropiada para pantallas de configuración, registros normalizados, pruebas, bitácoras e intercambio de datos.

Introduzca el desfase como minutos enteros con signo

Indique un único entero llamado minutes. Los valores positivos representan desfases por delante de UTC, los negativos representan desfases por detrás de UTC y cero significa que no existe diferencia respecto de UTC. Por ejemplo, 330 describe cinco horas y treinta minutos por delante, mientras que -240 describe cuatro horas por detrás. Expresar la entrada en minutos elimina la ambigüedad de las horas decimales: una persona puede comprender 5.5 horas, pero 330 minutos es exacto y no requiere interpretar números de coma flotante. El intervalo admitido es de -840 a 840, equivalente a UTC-14:00 y UTC+14:00, y cubre el rango práctico de los desfases UTC civiles. El formateador rechaza fracciones, cadenas numéricas, valores ausentes, números no finitos y valores fuera del intervalo, en lugar de redondearlos o convertirlos. Esta conducta estricta evita alteraciones sutiles del desfase previsto por usted. Calcule u obtenga el desfase correcto antes de invocar la capacidad: esta no lo deduce de una ciudad, país, abreviatura, zona horaria, marca temporal ni configuración del dispositivo.

Interprete el resultado canónico UTC±HH:MM

El algoritmo elige el signo directamente a partir de la entrada, toma su magnitud absoluta, la divide en horas completas y minutos restantes, y completa ambos componentes con dos cifras. La entrada 330 produce UTC+05:30, -75 produce UTC-01:15 y 60 produce UTC+01:00. El cero se representa como UTC+00:00 para conservar la misma estructura fija que todos los demás resultados; no se utiliza la abreviatura especial Z ni una etiqueta UTC acortada. Los dos puntos siempre están presentes y ningún componente se omite cuando vale cero. Este diseño estable es útil para interfaces, capturas de pruebas, configuraciones exportadas, documentación generada y sistemas que comparan cadenas normalizadas. La respuesta también devuelve offset_minutes, por lo que conserva la entrada numérica validada junto al desfase formateado. Usted puede mostrar la cadena y mantener el entero para ordenar, calcular o almacenar, sin volver a analizar el texto. El término canónico describe aquí la forma documentada de esta capacidad: UTC en mayúsculas, un signo explícito y HH:MM con ceros iniciales. No significa que el resultado identifique una zona horaria geográfica.

Distinga los desfases fijos de las zonas horarias

Un desfase UTC numérico no equivale a una zona con nombre, como Europe/London o America/New_York. Las zonas con nombre contienen reglas históricas y futuras, y su desfase activo puede cambiar por transiciones de horario de verano o por decisiones legislativas. Este formateador no realiza esas consultas: se limita a representar el número exacto proporcionado por usted. Úselo cuando un desfase fijo ya sea el dato correcto, cuando necesite normalizar un desfase calculado en otro sistema o cuando cree datos de prueba deterministas que no deban variar al actualizar las bases de zonas horarias. No lo utilice para descubrir la hora local de una persona, decidir qué desfase corresponde a una ciudad en una fecha ni convertir una zona con nombre en un valor estacional. No hay solicitudes de red, valores aleatorios, lecturas del reloj, dependencias regionales, inspección del entorno ni valores predeterminados ocultos. Por ello, el resultado es reproducible tanto en la API como en el navegador. Cada solicitud de API cuesta $0.002. Las entradas inválidas devuelven un error tipado y una explicación breve para que usted corrija el campo sin aceptar una suposición.

Normalizar valores de configuración

Convierta desfases guardados en minutos a una forma UTC±HH:MM uniforme para ajustes, API y exportaciones.

Crear etiquetas para selectores

Genere etiquetas numéricas coherentes para una interfaz sin mantener manualmente una tabla de equivalencias.

Preparar datos de prueba deterministas

Produzca cadenas de desfase previstas a partir de enteros sin depender de relojes, regiones ni versiones de bases horarias.

¿Qué devuelve un valor de cero minutos?

Cero devuelve UTC+00:00 y conserva el signo explícito y la anchura fija de los demás resultados.

¿Se redondean los minutos fraccionarios?

No. Los minutos deben ser enteros; una fracción produce un error de entrada inválida.

¿Puede obtener el desfase actual de una ciudad?

No. Solo formatea el valor con signo proporcionado y no consulta geografía ni horario de verano.

¿Por qué la hora y los minutos siempre tienen dos cifras?

Los ceros iniciales ofrecen una representación UTC±HH:MM predecible para interfaces, registros y pruebas.

¿Cuánto cuesta una solicitud de API?

Cada solicitud de API cuesta $0.002; el mismo solucionador determinista también puede ejecutarse en el navegador.

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/minutes-to-offset

¿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/minutes-to-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"minutes":330}'
{
  "minutes": 330
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.minutes_to_offset",
  "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 →