ForHosting KIT · Strumenti per sviluppatori

Aggiungere minuti a data e ora

Aggiunga minuti a una data e ora quando una pianificazione, un registro, una scadenza, un passaggio o un test richiedono un istante spostato esatto.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Fornisca una data e ora ISO completa con Z o un offset numerico di fuso, insieme a un numero intero di minuti positivo, negativo o pari a zero. Il calcolatore convalida calendario e offset, converte in UTC l’istante indicato, esegue un calcolo deterministico e restituisce una data e ora UTC canonica. Non consulta mai l’ora corrente, non presume un fuso e non dipende dal computer sul quale viene eseguito.

Fornisca un istante iniziale completo e inequivocabile

Inserisca il valore iniziale come data e ora ISO contenente una data di calendario, il separatore T, ore, minuti, secondi e un indicatore esplicito del fuso. Un valore che termina con Z descrive già UTC. Un valore che termina con un offset come +02:00 o -05:30 descrive i campi dell’ora locale insieme alla loro differenza esatta rispetto a UTC. L’obbligo di questo suffisso evita una causa comune di errori di pianificazione: un’ora locale priva di fuso, il cui significato cambia in base al computer, al browser o al server che la interpreta. La parte di calendario viene verificata secondo le regole gregoriane per anni bisestili e durata dei mesi; le date impossibili vengono quindi rifiutate anziché normalizzate in silenzio. Le ore devono essere comprese tra 00 e 23, mentre minuti e secondi tra 00 e 59. Le frazioni di secondo facoltative possono avere da una a tre cifre. La capacità non accetta nomi come Europe/London, perché richiedono regole storiche e possono introdurre ambiguità legate all’ora legale. Utilizzi invece un offset che identifichi esplicitamente l’istante desiderato.

Comprenda la somma dei minuti e la conversione UTC

L’operazione interpreta innanzitutto la data, l’ora e l’offset numerico forniti come un unico istante assoluto. Converte tale istante in UTC mediante aritmetica di calendario, quindi aggiunge il numero richiesto di minuti interi con segno. I numeri positivi avanzano, quelli negativi arretrano e zero esegue soltanto la normalizzazione UTC. Il riporto supera ogni confine: ora, giorno, mese, giorno bisestile, anno o secolo; la sottrazione attraversa gli stessi confini al contrario. Il risultato termina sempre con Z, rendendo il fuso esplicito e coerente per l’archiviazione o il confronto. I secondi e le relative frazioni non cambiano, perché l’incremento è un multiplo esatto di un minuto. L’implementazione non chiama il costruttore Date di JavaScript e non consulta l’orologio di sistema. Conta invece i giorni gregoriani, applica offset e minuti come interi e ricostruisce i campi UTC. In questo modo lo stesso input produce lo stesso output in un browser, worker, test automatico o server, indipendentemente dalle impostazioni locali e dal fuso dell’host.

Utilizzi il risultato in sicurezza nelle automazioni e nei test

Questa capacità è adatta ai flussi che conoscono già l’istante iniziale e richiedono una marca temporale derivata riproducibile. Può, ad esempio, creare un promemoria trenta minuti dopo un evento, calcolare la scadenza di un periodo di tolleranza fisso, convertire in UTC record importati con il relativo offset dichiarato o preparare test intorno alla mezzanotte e ai giorni bisestili. L’oggetto restituito comprende la data e ora originale ripulita, il numero intero normalizzato di minuti, il risultato spostato e un’etichetta UTC esplicita. Memorizzi o confronti il campo del risultato quando un altro sistema richiede una marca temporale canonica. Si tratta di aritmetica sui minuti trascorsi, non di pianificazione civile per una regione nominata. Aggiungere sessanta minuti significa sempre aggiungere esattamente 3,600 secondi, senza consultare passaggi all’ora legale o calendari lavorativi. Se un appuntamento deve mantenere la stessa ora locale dopo un cambio regionale, determini prima la regione e l’offset desiderato. Un input non valido restituisce un errore tipizzato. L’esecuzione API costa $0.002 per elemento, mentre il browser usa lo stesso calcolo puro.

Impostare una scadenza esatta

Aggiunga un periodo di tolleranza fisso alla marca temporale di un token, una prenotazione o un caricamento e salvi il termine UTC.

Normalizzare marche temporali con offset

Applichi zero minuti a una data e ora dotata di offset per ottenerne la rappresentazione UTC canonica equivalente.

Creare test sui valori limite

Generi casi deterministici che superino mezzanotte, fine mese, giorno bisestile o fine anno senza consultare l’orologio corrente.

Quanto costa una chiamata API?

Ogni elemento costa $0.002. La versione nel browser esegue localmente lo stesso calcolo deterministico.

Vengono usate la data o l’ora attuali?

No. Vengono utilizzati soltanto la data e ora esplicita e il numero di minuti forniti nella richiesta.

Sono accettati valori negativi per i minuti?

Sì. Un intero negativo sottrae minuti trascorsi, mentre zero normalizza soltanto l’istante in UTC.

Perché la data e ora deve includere Z o un offset?

Senza tale indicazione, un’ora locale non identifica un istante univoco e può variare secondo il fuso dell’host.

Viene gestita l’ora legale?

L’offset numerico esplicito viene rispettato, ma dai nomi dei fusi non vengono dedotte regole regionali sull’ora legale.

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.

POSThttps://api.kit.forhosting.com/date/add-minutes

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

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"
  }
}

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

per richiesta$0.002

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

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →