ForHosting KIT · Strumenti per sviluppatori

Ora locale da offset UTC

Il calcolatore dell’ora locale da offset UTC trasforma un orario UTC noto nell’ora visualizzata in una città quando Lei conosce già il relativo offset fisso.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca l’ora UTC, l’etichetta della città e le componenti con segno delle ore e dei minuti. Il risultato mostra l’ora locale e indica se cade nel giorno precedente, nello stesso giorno o nel successivo. Nessuna ricerca del fuso, connessione di rete, ora di sistema o ipotesi sull’ora legale influenza il calcolo.

Inserisca l’ora UTC di riferimento e la città

Parta da un orario espresso in tempo coordinato universale e utilizzi rigorosamente il formato a 24 ore HH:MM. Mezzanotte è 00:00, mezzogiorno è 12:00 e l’ultimo minuto valido è 23:59. Il campo della città identifica il risultato e non avvia una ricerca geografica. Per esempio, inserire Kathmandu non induce il calcolatore a interrogare un servizio di fusi orari o a stabilire quale offset sia attualmente valido. Lei deve fornire l’offset adatto alla data e alle circostanze. La distinzione è importante: le città possono adottare l’ora legale, le autorità possono cambiare le regole civili e gli offset storici possono differire da quelli odierni. Consulti una fonte affidabile, determini prima l’offset applicabile e poi lo associ all’ora UTC. Il formato rigoroso evita valori ambigui, mentre l’etichetta della città rende la risposta adatta a programmi, report e pannelli senza suggerire che la posizione sia stata verificata.

Indichi le componenti con segno dell’offset UTC

Inserisca la parte intera delle ore in offset_hours e i minuti rimanenti in offset_minutes. Le componenti positive descrivono un orologio avanti rispetto a UTC; quelle negative un orologio indietro. L’offset +05:45 si rappresenta con 5 ore e 45 minuti, mentre -03:30 usa -3 ore e -30 minuti. Le componenti non nulle devono avere lo stesso segno per rendere esplicita la direzione. Per un offset negativo inferiore a un’ora, usi zero ore e minuti negativi. L’intervallo totale ammesso va da -12:00 a +14:00. I minuti devono essere interi compresi tra -59 e 59; frazioni e valori eccessivi vengono rifiutati anziché arrotondati. Dopo la convalida, il calcolatore converte l’intero offset in minuti con segno e lo somma ai minuti trascorsi dalla mezzanotte UTC. Questo metodo gestisce offset di mezz’ora e di un quarto d’ora senza ricorrere a ore decimali imprecise.

Legga l’ora locale e il cambio di giorno

Il campo local_time contiene l’orario convertito nel formato a 24 ore HH:MM con zeri iniziali. day_offset spiega il rapporto tra il giorno locale e quello della riferimento UTC: -1 indica il giorno precedente, 0 lo stesso giorno e 1 il giorno successivo. Un offset positivo applicato a tarda ora può superare la mezzanotte, mentre uno negativo subito dopo la mezzanotte UTC può tornare alla data precedente. Poiché non riceve una data, il calcolatore non inventa mese, giorno della settimana o data risultante; Lei può applicare day_offset alla data nota tramite uno strumento di calendario adeguato. La risposta conserva città, entrambi gli orari e componenti dell’offset, rendendo verificabile il calcolo. L’algoritmo usa solo interi limitati e non dipende da impostazioni locali, fuso della macchina o ora corrente. Gli input errati generano un errore tipizzato. L’uso dell’API costa $0.002 per richiesta e la stessa logica può funzionare nel browser.

Casi d'uso

Preparare una riunione remota

Converta una riunione concordata in UTC nell’orario della città di un partecipante quando l’offset è già noto.

Creare un itinerario

Mostri l’ora di destinazione e conservi l’indicatore del cambio di giorno in un programma basato su dati UTC.

Uniformare i pannelli operativi

Trasformi orari di eventi UTC in viste cittadine a offset fisso senza dipendere dal fuso del server.

Domande frequenti

Il calcolatore trova l’offset UTC attuale di una città?

No. Lei fornisce l’offset; la città è soltanto un’etichetta descrittiva del risultato.

Tiene conto dell’ora legale?

No. Inserisca l’offset fisso valido per il luogo e la data dopo aver considerato le regole stagionali.

Come si inserisce un offset UTC-03:30?

Usi -3 in offset_hours e -30 in offset_minutes affinché entrambe le componenti indichino un ritardo rispetto a UTC.

Che cosa significa day_offset?

Vale -1 per il giorno precedente, 0 per lo stesso giorno o 1 per il successivo rispetto alla riferimento UTC.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Il calcolo deterministico può anche essere eseguito 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/local-time-from-offset

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/local-time-from-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'

const res = await fetch("https://api.kit.forhosting.com/date/local-time-from-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/local-time-from-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/local-time-from-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/local-time-from-offset", 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

{
  "utc_time": "18:45",
  "city": "Kathmandu",
  "offset_hours": 5
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.local_time_from_offset",
  "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 →