ForHosting KIT · Entwickler-Tools

Datum als Dezimaljahr

Der Dezimaljahr-Rechner wandelt einen eindeutigen ISO-8601-Zeitpunkt in eine Jahreszahl wie 2024.5 um.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Zuerst wird der angegebene Zeitzonenversatz auf UTC normiert. Danach werden die seit Beginn dieses UTC-Jahres vergangenen Millisekunden durch dessen vollständige Länge geteilt. Der ganzzahlige Teil bezeichnet das UTC-Jahr, der Dezimalteil die Lage des Zeitpunkts darin. Weder Systemuhr noch Standort, Netzwerk oder versteckte Vorgaben fließen ein; dieselbe Eingabe liefert daher stets dieselbe Ausgabe.

Was ein gebrochenes Dezimaljahr ausdrückt

Ein gebrochenes Jahr verbindet die Bezeichnung eines Kalenderjahres und eine kontinuierliche Position innerhalb dieses Jahres in einer Zahl. Der ganzzahlige Teil ist das UTC-Kalenderjahr, in dem der angegebene Zeitpunkt liegt. Der Dezimalteil entspricht der exakten Dauer seit dem 1. Januar um 00:00:00.000 UTC, geteilt durch die Dauer des gesamten Jahres. Deshalb ist der erste Zeitpunkt des Jahres 2024 genau 2024, während die Mitte dieses Schaltjahres 2024.5 ergibt. Gegen Ende von 2024 nähert sich das Ergebnis 2025, erreicht diesen Wert aber nicht; der erste Zeitpunkt von 2025 gehört bereits zum neuen Jahr und ist genau 2025. Diese Definition beruht auf Dauer und zählt weder Kalenderblätter noch abgeschlossene Daten, Monate, Quartale oder Arbeitstage. Stunden, Minuten, Sekunden und Millisekunden gehen anteilig ein. Die Antwort enthält den normierten UTC-Zeitpunkt, das gewählte UTC-Jahr, die vergangenen Millisekunden und die gesamten Jahresmillisekunden. So können Sie jeden Bestandteil prüfen oder die Rechnung unabhängig nachvollziehen, wenn eine kompakte Jahreskoordinate praktischer als ein Zeitstempel ist, die Identität des Kalenderjahres aber erhalten bleiben soll.

Einfluss von UTC-Normierung und Schaltjahren

Die Eingabe muss mit Z oder einem numerischen Versatz wie +05:30 oder -04:00 einen eindeutigen Zeitpunkt bezeichnen. Der Rechner wendet diesen Versatz an, bevor er das Jahr auswählt und die vergangene Dauer misst. Diese Reihenfolge ist an Jahresgrenzen entscheidend: Eine Ortszeit kurz nach Mitternacht am 1. Januar kann in UTC noch auf den 31. Dezember fallen, während eine späte Dezemberzeit örtlich bereits dem 1. Januar UTC entsprechen kann. Anschließend gelten für das ermittelte UTC-Jahr die gregorianischen Schaltjahrregeln. Durch vier teilbare Jahre haben 366 Tage, außer Jahrhundertjahre, die nicht durch vierhundert teilbar sind; alle anderen haben 365 Tage. Der Nenner richtet sich deshalb nach dem gewählten Jahr und verhindert die Abweichung einer starren Dauer von 365 Tagen. Jeder bürgerliche Tag wird mit exakt 86,400 Sekunden angesetzt; Schaltsekunden werden nicht eingefügt. Der Parser weist fehlende oder ungültige Versätze, unmögliche Daten, Schalttage in Gemeinjahren, Stunden über 23, Minuten oder Sekunden über 59 sowie mehr als drei Millisekundenstellen zurück. Eine Ablehnung ist verlässlicher als das Erraten einer Zeitzone, denn eine Vermutung würde die Reproduzierbarkeit zwischen Systemen und Browsern beeinträchtigen.

Einsatz in Daten- und Wissenschaftsabläufen

Gebrochene Jahre dienen als kompakte Koordinaten für Beobachtungen über viele Kalenderjahre hinweg. Eine Zeitreihen-Pipeline kann Zeitstempel mit Versatz vor Regression, Interpolation, Diagrammerstellung oder Export umrechnen. Jeder Datensatz erhält dadurch einen sortierbaren Zahlenwert, während der ursprüngliche Zeitstempel separat erhalten bleibt. Wissenschaftliche Berichte verwenden Dezimaljahre häufig zur Einordnung von Messungen auf einer Jahresachse; Migrationen müssen mitunter Werte älterer Analysesysteme reproduzieren. Die deterministische Antwort eignet sich zudem für Tests: Neujahr, Schalttag, Jahresmitte, Versatzwechsel und letzte Millisekunde lassen sich fest vorgeben, ohne die Systemuhr nachzuahmen. Bewahren Sie die Definition mit den Daten auf, da andere Programme Tageszählungen, mittagsbasierte Konventionen, feste Jahre mit 365.25 Tagen oder abweichende Rundungen nutzen können. Diese Fähigkeit teilt exakt vergangene UTC-Millisekunden durch die genaue Länge des betreffenden proleptisch-gregorianischen UTC-Jahres. Runden Sie nicht in Zwischenschritten, sondern erst für ein Diagramm oder einen Bericht. Ersetzen Sie keinen absoluten Zeitstempel durch diesen Wert, wenn Umkehrbarkeit oder die Reihenfolge extrem naher Zeitpunkte erforderlich ist. Ein erfolgreicher API-Aufruf kostet $0.002; dieselbe reine Berechnung kann auch im Browser erfolgen.

Zeitreihenbeobachtungen normieren

Wandeln Sie Zeitstempel mit Versatz in kontinuierliche Jahreskoordinaten für Diagramme, Regression und Interpolation um.

Achsen wissenschaftlicher Berichte nachbilden

Erzeugen Sie prüfbare Dezimaljahre nach einer dokumentierten gregorianischen UTC-Dauerkonvention.

Deterministische Datumstests erstellen

Prüfen Sie Schaltjahre und Zeitzonenübergänge, ohne die aktuelle Systemzeit zu lesen oder nachzuahmen.

Welche Formel wird verwendet?

Das Ergebnis ist das UTC-Jahr plus die seit Jahresbeginn vergangenen Millisekunden geteilt durch sämtliche Millisekunden dieses UTC-Jahres.

Warum muss der Zeitpunkt eine Zeitzone enthalten?

Ohne Z oder numerischen Versatz bezeichnet der Text keinen eindeutigen Zeitpunkt und kann je nach Umgebung andere Antworten liefern.

Wie werden Schaltjahre berücksichtigt?

Das betreffende UTC-Jahr umfasst nach gregorianischen Regeln 366 Tage, andernfalls 365 Tage.

Werden Schaltsekunden einbezogen?

Nein. Jeder bürgerliche Tag wird für ein portables, deterministisches Ergebnis mit exakt 86,400 Sekunden berechnet.

Was kostet eine Berechnung per API?

Jeder erfolgreiche API-Aufruf kostet $0.002. Die reine Berechnung kann auch lokal im Browser ausgeführt werden.

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.

POSThttps://api.kit.forhosting.com/date/fractional-year

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/date/fractional-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-07-02T00:00:00Z"}'
{
  "datetime": "2024-07-02T00:00:00Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.fractional_year",
  "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.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →