DateTime auf Einheit kürzen
Kürzen Sie Datum und Uhrzeit auf den Beginn von Jahr, Monat, Tag, Stunde oder Minute in UTC: 2024-06-15T14:37:52Z auf den Tag gekürzt ergibt 2024-06-15T00:00:00Z. Nützlich für Tagesberichte, Stundendiagramme und das Gruppieren von Einträgen. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Datum und Uhrzeit
- 2024-06-15T14:37:52Z day
- Ergebnis
- 2024-06-15T00:00:00Z day
- Jahr
- 2.024
- Monat
- 6
- Tag
- 15
Einen Zeitstempel auf eine gröbere Einheit zu kürzen ist die Grundlage täglicher Buckets, monatlicher Berichte, stündlicher Diagramme und Cache-Schlüssel, die über Sprachen und Hosts übereinstimmen müssen. Host-Zeitzonen und Sommerzeit-Tabellen lassen einen naiven Floor zwischen Browsern, Servern und Edge-Workern auseinanderlaufen. Dieses Werkzeug zum Kürzen von DateTime auf eine Einheit akzeptiert ein explizites ISO-8601-DateTime — volle Uhrzeit mit Z oder numerischem Offset, oder nur ein Datum als Mitternacht UTC — plus eine Einheit Jahr, Monat, Tag, Stunde oder Minute. Es normalisiert die Eingabe mit reiner gregorianischer Kalenderarithmetik auf koordinierte Weltzeit und setzt danach jedes feinere Feld auf null, sodass das Ergebnis ein stabiler UTC-Floor-Augenblick als Jahr-Monat-Tag T Stunde-Minute-Sekunde Z ist. Unmögliche Kalendertage und unbekannte Einheiten scheitern mit klarer Validierung statt mit erfundenem Überlauf.
So funktioniert die UTC-Kürzung ohne Systemuhr
Beginnen Sie mit einem expliziten Basis-DateTime in internationaler ISO-Form, damit jeder Client dasselbe Jahr, denselben Monat, denselben Tag und optionale Uhrfelder teilt. Wird nur ein Kalenderdatum geliefert, behandeln Sie es als Mitternacht in koordinierter Weltzeit. Ist eine Uhrzeit vorhanden, akzeptieren Sie optionale Bruchteile von Sekunden, die auf ganze Sekunden gekürzt werden, sowie entweder ein abschließendes Z für UTC oder einen numerischen Plus-Minus-Stunden-Minuten-Offset, der bei der Umrechnung in absolute Zeit abgezogen wird.
Prüfen Sie, dass der bürgerliche Tag unter gregorianischen Schaltregeln existiert — der 29. Februar ist nur legal, wenn das Jahr durch vier teilbar ist, wobei Jahrhundertjahre zusätzlich durch vierhundert teilbar sein müssen — und dass Stunde, Minute und Sekunde in den üblichen Bereichen liegen. Wandeln Sie das bürgerliche Tripel mit dem Howard-Hinnant-Algorithmus days-from-civil in eine Tagesseriennummer um, multiplizieren Sie mit vierundachtzigtausendsechshundert Sekunden, addieren Sie die lokale Tageszeit und ziehen Sie Offset-Minuten mal sechzig ab, um UTC-Epochensekunden zu erhalten.
Rekonstruieren Sie UTC-Jahr, -Monat, -Tag, -Stunde, -Minute und -Sekunde mit civil-from-days. Wenden Sie dann einen reinen Floor je Einheit an: year setzt Monat und Tag auf eins und die Uhr auf null; month behält Jahr und Monat, setzt den Tag auf eins und die Uhr auf null; day behält das Kalenderdatum und setzt die Uhr auf null; hour setzt Minute und Sekunde auf null; minute setzt nur die Sekunde auf null. Formatieren Sie die gekürzten bürgerlichen Felder als Vier-zwei-zwei T zwei-zwei-zwei Z-Zeichenkette.
Wo Rechner zum Kürzen von DateTime auf eine Einheit Nutzen stiften
Analytics-Pipelines materialisieren tägliche und stündliche Ereignisschlüssel, indem sie Ingestionszeitstempel floorn, sodass jede Sprache und Region denselben UTC-Bucket teilt, ohne eine Kalenderbibliothek zu erfinden. Finanz- und Betriebsteams gruppieren Buchungszeilen oder Support-Tickets in Monats- oder Tagesperioden für deterministische Zusammenfassungen, die Offline-Audits entsprechen. Produkt- und Wachstums-Dashboards zeichnen Aktivität nach Stunde oder Tag mit stabilem Floor, damit Browser-Vorschauen und Backend-Aggregationen bei Sommerzeitwechseln nie um eine Stunde abweichen.
Wenn Sie später Stunden oder Tage zu einem Zeitstempel addieren, Tage zwischen zwei Daten zählen, Monatsanfang und -ende berechnen oder reine Zeiteinheiten zwischen Stunden und Minuten umrechnen müssen, behandeln Sie das als getrennte Suchabsichten und Landingpages statt diese Seite zum Kürzen von DateTime auf eine Einheit zu überladen — jene Probleme lösen andere Anfragen, auch wenn Teile der Arithmetik unter der Haube ähnlich wirken.
Anwendungsfälle
Tägliche und stündliche Analytics-Buckets
Flooren Sie ISO-Ereigniszeitstempel auf Tag oder Stunde in UTC, damit jede Pipeline-Sprache denselben Aggregationsschlüssel für Diagramme und Rollups materialisiert.
Monats- und Jahresberichtsperioden
Kürzen Sie Buchungs- oder Ticket-DateTimes auf Monat oder Jahr, um deterministische Periodenstarts für Exporte, Audits und Finanzübersichten zu bauen.
Häufige Fragen
Welche Einheiten werden unterstützt?
Genau fünf groß-/kleinschreibungsunabhängige Token: year, month, day, hour und minute.
Nutzt die Kürzung meine lokale Zeitzone?
Nein. Der Floor wird stets in UTC aus der expliziten Eingabezeichenkette berechnet. Offsets in der Zeichenkette werden zuerst nach UTC umgerechnet; die Host-Uhr wird nie gelesen.
Was passiert bei einem ungültigen Kalendertag?
Die Aufgabe rollt nicht in den März und erfindet keinen Schalttag.
Was erhalte ich beim Kürzen auf Monat oder Jahr?
Beim Kürzen auf den Monat erhalten Sie dessen ersten Tag um Mitternacht UTC. Beim Kürzen auf das Jahr erhalten Sie den 1. Januar dieses Jahres um Mitternacht UTC, alle kleineren Teile auf null.
Was geschieht mit einer Uhrzeit mit Zeitzonenversatz?
Sie wird zuerst in UTC umgerechnet und erst dann gekürzt. Eine Uhrzeit mit positivem Versatz kann deshalb in einer anderen Stunde oder sogar an einem anderen Tag landen als im ursprünglichen Text.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"datetime": "2024-06-15T14:37:52Z",
"unit": "day"
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.truncate_to_unit",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Was Sie senden und was Sie zurückerhalten
Klassische Prüfungen: vierzehn siebenunddreißig auf den Tag um Mitternacht UTC flooren, einen Morgenstempel mit Plus-zwei-Offset auf die Stunde in reinem Z flooren, auf den Monat am ersten Tag flooren, auf das Jahr am ersten Januar flooren und eine Basis wie den 29. Februar in einem Gemeinjahr ablehnen. Senden Sie zwei Pflichtfelder: datetime als ISO-8601-Zeichenkette, zum Beispiel zweitausendvierundzwanzig Bindestrich null sechs Bindestrich fünfzehn T vierzehn Doppelpunkt siebenunddreißig Doppelpunkt zweiundfünfzig Z, und unit als eines von year, month, day, hour oder minute (groß-/kleinschreibungsunabhängig). Alias date, dt, timestamp und ts gelten für die Basiszeichenkette; Alias to, truncate_to und granularity für die Einheit. Fehlende Felder, nicht-string-datetime, Zeichenketten außerhalb der ISO-Form, unmögliche Kalendertage, ungültige Zeitkomponenten und Einheiten außerhalb der fünf erlaubten Token scheitern mit invalid_input und werden nicht berechnet. Bei Erfolg spiegelt die Antwort das getrimmte Basis-datetime, die normalisierte unit in Kleinbuchstaben, die resultierende UTC-ISO-Zeichenkette nach der Kürzung, die numerischen year, month, day, hour, minute und second des Floor-Augenblicks, die epoch_seconds des Ergebnisses und eine kurze Formel zur UTC-Floor-Regel. Der Preis erfolgreicher API-Aufrufe ist die veröffentlichte Basis von $0.002 pro Element; Validierungsfehler werden nicht berechnet.
Wo Rechner zum Kürzen von DateTime auf eine Einheit Nutzen stiften
Weil die Fähigkeit eine reine Parse-Engine ist, beträgt der API-Preis die veröffentlichte Basis von $0.002 pro erfolgreichem Element und fehlgeschlagene Validierung wird nicht berechnet.
Integrationsbeispiele
QA-Fixtures an Bucket-Grenzen
Erzeugen Sie erwartete Floor-Augenblicke um Mitternacht, Monatsanfänge und Offset-zu-UTC-Umwandlung für Regressionstests ohne Host-Uhr.
Technische Fragen
Wie kürze ich ein DateTime auf den Tag in UTC?
Senden Sie datetime als ISO-8601-Zeichenkette und unit als day. Die API liefert dasselbe Kalenderdatum um 00:00:00Z, nachdem numerische Offsets nach UTC normalisiert wurden.
Was kostet das Werkzeug zum Kürzen von DateTime auf eine Einheit?
Das Browser-Werkzeug ist kostenlos. API-Anfragen nutzen Prepaid-KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht berechnet.