ForHosting KIT · Date e tempo

Tronca datetime a unità

Riporti data e ora all'inizio del suo anno, mese, giorno, ora o minuto in UTC: 2024-06-15T14:37:52Z troncata al giorno diventa 2024-06-15T00:00:00Z. Utile per resoconti giornalieri, grafici orari e raggruppamenti di dati. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Esempio risolto

Se inserisce

Data e ora: 2024-06-15T14:37:52Z day

Ottiene

Risultato: 2024-06-15T00:00:00Z day
Anno: 2024
Mese: 6
Giorno: 15

Normalizza l'ingresso al Tempo universale coordinato con aritmetica gregoriana pura, poi azzera ogni campo più fine dell'unità scelta così che il risultato sia un istante di pavimento UTC stabile scritto come anno-mese-giorno T ora-minuto-secondo Z. Giorni di calendario impossibili e unità sconosciute falliscono con un errore di validazione chiaro invece di inventare un riporto.

Come funziona il troncamento UTC senza orologio di sistema

Parta da una data-ora di base esplicita scritta nella forma internazionale ISO affinché ogni client concordi sullo stesso anno, mese, giorno e campi orologio opzionali. Quando viene fornita solo una data di calendario, la tratti come mezzanotte in Tempo universale coordinato. Quando è presente l'ora, accetti secondi frazionari opzionali troncati a secondi interi e una Z finale per UTC oppure uno scostamento numerico di ore e minuti con segno più o meno, sottratto nella conversione a tempo assoluto.

Validare che il giorno civile esista secondo le regole gregoriane del bisestile —il 29 febbraio è legale solo se l'anno è divisibile per quattro, salvo che gli anni secolari debbano esserlo anche per quattrocento— e che ora, minuto e secondo restino nei range consueti. Converta la tripla civile in un seriale di giorno con l'algoritmo days-from-civil di Howard Hinnant, moltiplichi per ottantaquattromilaseicento secondi, aggiunga l'ora locale del giorno e sottragga i minuti di scostamento per sessanta per ottenere i secondi d'epoca UTC.

Ricostruisca anno, mese, giorno, ora, minuto e secondo UTC con civil-from-days. Applichi quindi un pavimento puro per unità: year reimposta mese a uno e giorno a uno con orologio a zero; month conserva anno e mese ma fissa il giorno a uno e l'orologio a zero; day conserva la data di calendario e azzera l'orologio; hour azzera minuto e secondo; minute azzera solo il secondo. Formatti i campi civili troncati come stringa quattro-due-due T due-due-due Z.

Dove i calcolatori di troncamento data-ora a unità creano valore

Le pipeline di analytics materializzano chiavi di eventi giornaliere e orarie abbassando i timestamp di ingestione al pavimento, così ogni lingua e regione condivide lo stesso bucket UTC senza inventare una libreria di calendario. I team finance e operations raggruppano righe di libro mastro o ticket di supporto in periodi di mese o giorno per sintesi deterministiche allineate alle audit offline.

Le dashboard di prodotto e crescita tracciano l'attività per ora o giorno con un pavimento stabile affinché anteprime browser e aggregazioni backend non discordino di un'ora ai passaggi dell'ora legale.

Casi d'uso

Bucket di analytics giornalieri e orari

Abbassi timestamp ISO di eventi a giorno o ora in UTC affinché ogni linguaggio della pipeline materializzi la stessa chiave di aggregazione per grafici e rollup.

Periodi di report mensili e annuali

Tronchi date-ore di libro mastro o ticket a mese o anno per costruire inizi di periodo deterministici per export, audit e sintesi finanziarie.

Domande frequenti

Quali unità sono supportate?

Esattamente cinque token senza distinzione di maiuscole: year, month, day, hour e minute.

Il troncamento usa il mio fuso orario locale?

No. Il pavimento è sempre calcolato in UTC dalla stringa di ingresso esplicita. Gli scostamenti nella stringa sono convertiti prima in UTC; l'orologio host non viene mai letto.

Cosa succede con un giorno di calendario non valido?

L'attività non scorre a marzo e non inventa un giorno bisestile.

Che cosa ottengo troncando al mese o all'anno?

Troncando al mese ottiene il primo giorno di quel mese a mezzanotte UTC. Troncando all'anno ottiene il 1° gennaio di quell'anno a mezzanotte UTC, con tutte le parti più piccole azzerate.

Cosa succede a un orario scritto con uno scostamento di fuso?

Viene prima convertito in UTC e poi troncato. Per questo un orario con scostamento positivo può finire in un'altra ora, o perfino in un altro giorno, rispetto a quello del testo originale.

Strumenti correlati

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/truncate-to-unit

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/truncate-to-unit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}'

const res = await fetch("https://api.kit.forhosting.com/date/truncate-to-unit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/truncate-to-unit",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/truncate-to-unit", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-06-15T14:37:52Z","unit":"day"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/truncate-to-unit", 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

{
  "datetime": "2024-06-15T14:37:52Z",
  "unit": "day"
}

Esempio di risposta

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

Note tecniche

Troncare un timestamp a un'unità più grossolana è la base di bucket giornalieri, report mensili, grafici orari e chiavi di cache che devono coincidere tra lingue e host. I fusi dell'host e le tabelle dell'ora legale fanno divergere un pavimento ingenuo tra browser, server e Workers al bordo. Questo strumento di troncamento data-ora a unità accetta una data-ora ISO-8601 esplicita —orario completo con Z o uno scostamento numerico, oppure una stringa solo data trattata come mezzanotte UTC— più un'unità anno, mese, giorno, ora o minuto.

Cosa invia Lei e cosa riceve in risposta

Controlli classici: abbassare le quattordici trentasette al giorno a mezzanotte UTC, abbassare un timestamp mattutino con scostamento più-due all'ora in Z puro, abbassare al mese il primo giorno, abbassare all'anno il primo gennaio, e respingere una base come il 29 febbraio in un anno comune. Invii due campi obbligatori: datetime come stringa ISO-8601, ad esempio duemilaventiquattro trattino zero sei trattino quindici T quattordici due-punti trentasette due-punti cinquantadue Z, e unit tra year, month, day, hour o minute (senza distinzione di maiuscole). Sono accettati gli alias date, dt, timestamp e ts per la stringa base; gli alias to, truncate_to e granularity per l'unità. Campi assenti, datetime non stringa, stringhe fuori forma ISO, giorni di calendario impossibili, componenti orarie non valide e unità fuori dai cinque token ammessi falliscono con invalid_input e non vengono addebitati. In caso di successo la risposta ecoa il datetime base trimmato, l'unit in minuscolo normalizzata, la stringa ISO UTC risultante dopo il troncamento, l'anno, mese, giorno, ora, minuto e secondo numerici dell'istante di pavimento, il epoch_seconds del risultato e una breve formula che documenta la regola di pavimento UTC. Il prezzo delle chiamate API riuscite è la base pubblicata di $0.002 per elemento; i fallimenti di validazione non consumano il saldo prepagato.

Dove i calcolatori di troncamento data-ora a unità creano valore

Poiché la capacità è un motore parse puro, il prezzo API è la base pubblicata di $0.002 per elemento riuscito e la validazione fallita non consuma saldo. Se in seguito deve aggiungere ore o giorni a un timestamp, contare i giorni tra due date, calcolare inizio e fine mese, o convertire unità di tempo pure tra ore e minuti, le tratti come intenti di ricerca e landing separate invece di sovraccaricare questa pagina di troncamento data-ora a unità: risolvono query diverse anche quando parte dell'aritmetica si assomiglia sotto il cofano.

Casi di integrazione

Fixture QA ai confini di bucket

Generi istanti di pavimento attesi a mezzanotte, inizi di mese e conversione scostamento verso UTC per test di regressione senza orologio host.

Domande tecniche

Come si tronca una data-ora al giorno in UTC?

Invii datetime come stringa ISO-8601 e unit come day. L'API restituisce la stessa data di calendario alle 00:00:00Z dopo aver normalizzato qualsiasi scostamento numerico in UTC.

Quanto costa lo strumento di troncamento data-ora a unità?

Lo strumento nel browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l'ingresso non valido non viene fatturato.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Come funziona il troncamento UTC senza orologio di sistema

Dove i calcolatori di troncamento data-ora a unità creano valore

Casi d'uso

Bucket di analytics giornalieri e orari

Periodi di report mensili e annuali

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Errori

Note tecniche

Cosa invia Lei e cosa riceve in risposta

Dove i calcolatori di troncamento data-ora a unità creano valore

Casi di integrazione

Fixture QA ai confini di bucket

Domande tecniche

grazie