ForHosting KIT · Strumenti per sviluppatori

Punto medio tra due date

Trovare il punto medio tra due date risponde a una domanda diversa dal contare giorni interi, costruire un conto alla rovescia o calcolare l’età: chiede l’unico istante equidistante tra due punti noti della linea temporale.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore del punto medio tra due date accetta due datetime ISO-8601 espliciti—timestamp completi con Z o offset numerico, oppure sola data trattata come mezzanotte UTC—, converte entrambi in millisecondi di epoca con aritmetica gregoriana pura, media quegli istanti con il floor deterministico della somma e restituisce il datetime a metà strada formattato in UTC con precisione al millisecondo. Controlli classici: da mezzanotte a mezzanotte su giorni consecutivi cade a mezzogiorno; un intervallo di un secondo cade al mezzo secondo; estremi identici restituiscono lo stesso istante. Il motore non consulta l’orologio dell’host, non chiama la rete e non usa l’oggetto Date della piattaforma, così gli stessi input producono sempre lo stesso punto medio nel widget gratuito del browser e nell’API a $0.002 per richiesta riuscita. Lo usi per traguardi a metà progetto, centri di finestre di fatturazione e fixture riproducibili in CI.

Cosa significa un punto medio di istanti e cosa contiene la risposta

Mediando due istanti assoluti si ottiene l’analogo temporale del punto medio di un segmento sulla retta numerica: se Lei conosce l’inizio e la fine di una riunione, uno studio, una campagna o una finestra contrattuale, il punto medio è l’unico istante UTC equidistante in millisecondi da entrambe le estremità. Non è la data civile «a metà marzo» su più giorni, né un punto medio di giorni lavorativi che salta i fine settimana, né una media dell’orologio a muro che finge che ogni giorno civile abbia esattamente ventiquattro ore ignorando gli offset. Lei fornisce start e end come stringhe ISO-8601; ciascuna può essere un datetime completo con secondi frazionari opzionali e offset Z o ore-minuti, oppure un valore sola data YYYY-MM-DD trattato come mezzanotte UTC affinché le coppie di calendario semplici funzionino ancora. Il calcolatore valida che entrambi i giorni esistano sul calendario gregoriano—incluso il 29 febbraio solo negli anni bisestili—, converte ogni input in un conteggio di millisecondi di epoca UTC con aritmetica civile prolettica e imposta midpoint_epoch_ms al floor della somma delle due epoche divisa per due, così un totale dispari di millisecondi produce comunque un’unica scelta deterministica. La risposta ripete le stringhe originali start e end per l’audit, restituisce midpoint come stringa ISO UTC con tre cifre frazionarie e Z finale, riporta start_epoch_ms, end_epoch_ms e midpoint_epoch_ms per pipeline numeriche, e include span_ms come distanza assoluta più signed_span_ms come end meno start per vedere la direzione quando il secondo istante è anteriore al primo. Un breve campo formula riafferma la media per documentare il contratto accanto alla risposta. I casi rifiutati includono start o end mancante, stringhe non ISO-8601, mesi o giorni impossibili come 2023-02-29, componenti di orologio non validi e anni fuori da uno a 9999. Se Le servono conteggi di giorni di calendario, parti di conto alla rovescia o età in anni e mesi, usi quegli strumenti dedicati; questa pagina risponde solo all’istante esatto a metà strada tra due timestamp validati.

Come vengono letti start e end e come il punto medio resta riproducibile

Il primo campo preferito è start, ma sono accettati gli alias from, date1, a e begin così fogli di calcolo, query string e moduli riutilizzano lo stesso contratto senza rinominare le colonne. Il secondo preferito è end, con alias to, date2, b e finish per lo stesso motivo. Ogni stringa viene tagliata degli spazi; i valori sola data diventano mezzanotte UTC; i datetime possono usare T o uno spazio tra data e ora; i secondi frazionari sono accettati e troncati a millisecondi interi prima della media così il rumore sotto il millisecondo non inventa un secondo punto medio. Gli offset come più zero due due punti zero zero o meno zero cinque due punti zero zero sono convertiti in UTC sottraendo i minuti di offset dall’epoca civile locale, così una serata a New York e una mattina a Parigi che si riferiscono allo stesso intervallo assoluto si mediano correttamente in UTC. Internamente il motore mappa ogni tripla civile a un conteggio seriale di giorni con la mappatura nota days_from_civil, moltiplica per ottantasei milioni e quattrocentomila millisecondi al giorno, aggiunge i millisecondi dell’ora del giorno e regola l’offset—aritmetica intera pura senza Date, Math.random né rete. Il punto medio viene riformattato con la mappatura inversa civil_from_days affinché la stringa UTC stampata coincida esattamente con midpoint_epoch_ms. Input identici producono lo stesso istante come punto medio; invertire la coppia lascia invariati il punto medio e l’ampiezza assoluta e inverte solo il segno di signed_span_ms. Poiché ogni passo è deterministico, l’esecuzione gratuita nel browser e il percorso API a pagamento concordano byte per byte sullo stesso modulo, ideale per fixture CI che fissano 2024-01-01T12:00:00.000Z come punto medio di mezzanotti consecutive senza reimplementare a mano le tabelle bisestili.

Dove l’aritmetica del punto medio si inserisce in pianificazione, scienza e software

I project manager segnano checkpoint a metà percorso quando una finestra di lancio o uno sprint è definito da due timestamp espliciti e gli stakeholder vogliono un’unica ora di revisione a metà finestra anziché un’etichetta vaga di metà settimana. Ricercatori e sistemi di laboratorio registrano il punto medio di un intervallo di osservazione così le tabelle di sintesi mostrano un istante rappresentativo per grafici e join senza scegliere arbitrariamente l’inizio o la fine. I team finance e operations centrano finestre di fatturazione o di preavviso quando una policy si riferisce al mezzo di un periodo già memorizzato come coppia di istanti ISO in un libro mastro. Gli sviluppatori chiamano il contratto da script per generare punti medi deterministici per gli scheduler, affermare campi a metà percorso nei report o soddisfare requisiti di prodotto che esigono media UTC pura senza deriva di fuso dall’oggetto Date dell’host. Educatori e redattori di standard usano lo strumento per dimostrare che il punto medio di un intervallo di un secondo è il mezzo secondo, e che input con offset collassano comunque in un’unica risposta normalizzata con Z. In questa pagina il lavoro gira interamente nel Suo browser; tramite API ogni ricerca riuscita costa $0.002, la validazione fallita non viene addebitata e nulla viene memorizzato dopo la risposta. Questa suddivisione—esplorazione interattiva gratuita e API a pagamento identica—corrisponde al resto del catalogo KIT di livello A e Le consente di passare da un controllo occasionale a una pipeline senza cambiare il risultato matematico. Lo abbini a days-between, countdown-between o helper di epoca quando Le servono passi temporali correlati, e tenga questa pagina per l’intento di ricerca del punto medio tra due date come datetime esatto.

Traguardi a metà progetto e campagna

Calcoli l’ora esatta di revisione a metà finestra per uno sprint, un lancio o una campagna di marketing definita da due timestamp ISO.

Punti medi di osservazione ed esperimento

Registri un unico istante UTC rappresentativo di un intervallo di osservazione così grafici e join non scelgono arbitrariamente l’inizio o la fine.

Fixture deterministiche di CI e fatturazione

Generi valori di punto medio riproducibili per test unitari, centri di libro mastro e pipeline senza dipendere da Date o dall’orologio dell’host.

Quanto costa il calcolatore del punto medio tra due date?

È gratuito nel Suo browser in questa pagina. Tramite API una richiesta riuscita costa $0.002; gli input non validi non vengono addebitati.

Come è definito il punto medio?

Entrambi gli input sono convertiti in millisecondi di epoca UTC. midpoint_epoch_ms è floor((start_ms + end_ms) / 2), poi formattato come stringa ISO-8601 UTC con precisione al millisecondo.

Fusi orari e offset influenzano il risultato?

Sì, correttamente: gli offset di ciascun input sono convertiti in UTC prima della media. Il punto medio è sempre restituito con Z finale in UTC.

Cosa succede se i due datetime sono uguali, o end è prima di start?

Input identici restituiscono lo stesso istante come punto medio. Se end è anteriore a start, il punto medio non cambia e solo signed_span_ms diventa negativo.

Sono accettati valori di sola data?

Sì. Una stringa YYYY-MM-DD è trattata come mezzanotte UTC di quel giorno civile, poi mediata come qualsiasi altro istante.

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/midpoint-between-dates

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/midpoint-between-dates \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-01T00:00:00Z","end":"2024-01-02T00:00:00Z"}'
{
  "start": "2024-01-01T00:00:00Z",
  "end": "2024-01-02T00:00:00Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.midpoint_between_dates",
  "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 →