ForHosting KIT · Strumenti per sviluppatori

Formattatore di offset GMT in testo leggibile

Il formattatore di etichette per offset GMT converte un singolo valore con segno, espresso in minuti interi, in un testo italiano leggibile senza consultare orologio, posizione, banca dati dei fusi orari o regole stagionali.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Se Lei inserisce 120, riceve un’etichetta stabile equivalente a GMT più due. Gli offset con frazioni d’ora mantengono i minuti, i valori negativi usano meno e zero diventa GMT. Il risultato è adatto a interfacce, report, testi accessibili, messaggi generati e procedure che richiedono una formulazione prevedibile a partire da un valore numerico.

Parta da un offset firmato in minuti

Indichi la differenza rispetto a GMT come un unico numero intero di minuti. I numeri positivi rappresentano orari avanti rispetto a GMT, quelli negativi orari indietro, mentre zero corrisponde a GMT stesso. Per esempio, 120 indica due ore avanti e -240 quattro ore indietro. L’uso dei minuti rende il contratto inequivocabile e permette di gestire offset che non coincidono con un’ora intera. L’intervallo accettato va da -840 a 840 minuti, cioè da quattordici ore indietro a quattordici ore avanti. Il formattatore non ricava l’offset da città, Paese, abbreviazione, data e ora o impostazioni del dispositivo. La separazione è intenzionale: i fusi geografici possono cambiare per legge o per l’ora legale, mentre questa capacità deve soltanto esprimere l’esatto valore numerico fornito. Calcoli o verifichi prima le regole dell’ora locale, quindi passi il valore firmato definitivo. Poiché l’input è esplicito, valori uguali producono sempre etichette uguali in ogni ambiente.

Comprenda come viene composta l’etichetta

Il valore zero restituisce la forma sintetica GMT. Per ogni valore diverso da zero, il formattatore sceglie prima più o meno in base al segno, poi divide la durata assoluta in ore intere e minuti rimanenti. Un numero esatto di ore omette la parola ore per mantenere compatto il risultato: 120 diventa GMT più due e -60 diventa GMT meno uno. Se rimangono minuti, le unità chiariscono la struttura: 330 diventa GMT più cinque ore trenta minuti, mentre 30 diventa GMT più trenta minuti. Il singolare viene usato per una sola ora o un solo minuto e i numeri composti seguono una forma italiana naturale. L’oggetto restituito comprende sia l’etichetta leggibile sia l’offset originale in offset_minutes. Mantenere il numero accanto al testo rende l’output utile alle persone e ai programmi: Lei può mostrare l’etichetta, ordinare o confrontare tramite il numero ed evitare di reinterpretare la frase. Nessuna localizzazione, ricerca di abbreviazioni o impostazione nascosta modifica questa procedura.

Usi etichette deterministiche senza indicare un fuso

Gli offset GMT e i fusi orari con nome sono collegati, ma non equivalenti. Un offset comunica soltanto la distanza di un orologio da GMT; non identifica una regione e non stabilisce quando avvengono i cambi stagionali. Usi questo formattatore quando la fonte contiene già un offset fisso e il pubblico trae beneficio dalle parole anziché da una notazione compatta come +05:30. È indicato per etichette accessibili accanto ai selettori, riepiloghi vocali, registri di controllo, anteprime di configurazione e risposte API normalizzate. Non usi il risultato per sostenere che una persona si trovi attualmente in uno specifico fuso e non lo consideri un calcolo dell’ora legale. L’algoritmo non invia richieste di rete e non legge orologio, impostazioni locali, sistema operativo o banca dati dei fusi. È quindi riproducibile in build, test, documenti memorizzati e browser. L’automazione via API costa $0.002 per richiesta. Se l’input manca, è frazionario, non numerico o fuori intervallo, la capacità restituisce un errore tipizzato anziché indovinare o arrotondare.

Casi d'uso

Etichettare un selettore di offset

Trasformi valori memorizzati in minuti in opzioni leggibili per una schermata di impostazioni, senza gestire una tabella separata.

Creare metadati temporali accessibili

Offra a lettori di schermo o output vocali una descrizione chiara dell’offset anziché una notazione numerica ricca di segni.

Uniformare report ed esportazioni

Generi etichette GMT stabili da valori numerici di configurazione, così che esportazioni ripetute mantengano la stessa formulazione.

Domande frequenti

Calcola l’offset di una città o di un fuso orario?

No. Formatta soltanto il valore firmato in minuti fornito da Lei, senza consultare dati geografici o regole stagionali.

Che cosa restituisce un input uguale a zero?

Zero restituisce GMT, senza più, meno, ore o minuti.

Può formattare offset di mezz’ora e di un quarto d’ora?

Sì. Ogni valore intero in minuti compreso nell’intervallo ammesso può conservare i minuti nell’etichetta.

Il formattatore arrotonda i minuti frazionari?

No. I valori frazionari vengono rifiutati perché l’arrotondamento modificherebbe l’offset fornito.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Il formattatore puro può essere eseguito anche direttamente nel browser.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/date/gmt-offset-label

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/date/gmt-offset-label \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"minutes":330}'

const res = await fetch("https://api.kit.forhosting.com/date/gmt-offset-label", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "minutes": 330
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/gmt-offset-label",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "minutes": 330
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/gmt-offset-label", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"minutes":330}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"minutes":330}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/gmt-offset-label", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "minutes": 330
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.gmt_offset_label",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →