Vergangener Jahresanteil

Er wandelt eine Zeit mit Z oder numerischem Versatz in UTC um, misst die exakten Millisekunden seit dem 1. Januar um 00:00:00 UTC und teilt diese Dauer durch die Gesamtlänge des ermittelten UTC-Jahres. Schaltjahre haben 366 Tage, gewöhnliche Jahre 365. Weder aktuelles Datum noch lokale Zeitzone, Netzwerk, Zufall oder verborgene Standardwerte beeinflussen das Ergebnis.

Was der vergangene Jahresanteil bedeutet

Der ausgegebene Bruchteil ist ein kontinuierliches Maß für den Fortschritt innerhalb eines UTC-Kalenderjahres. Sein Zähler entspricht den Millisekunden vom 1. Januar um 00:00:00.000 UTC bis zum angegebenen Zeitpunkt; sein Nenner entspricht den Millisekunden des gesamten UTC-Jahres. Im ersten Moment des 1. Januar ist das Ergebnis exakt null. Danach steigt es im Jahresverlauf, bleibt aber bei jedem gültigen Zeitpunkt dieses Jahres kleiner als eins. Eins gehört zum ersten Moment des Folgejahres, in dem eine neue Berechnung wieder bei null beginnt. Das unterscheidet sich von einem Prozentsatz nach Kalendertag, der ganze Datumswerte zählt oder den laufenden Tag als vollständig vergangen behandelt. Mittags ist die Hälfte dieses Datums verstrichen, Sekunden tragen ihren genauen Anteil bei und bis zu drei Nachkommastellen einer Sekunde bleiben als Millisekunden erhalten. Der Nenner umfasst 365 Tage in einem gewöhnlichen und 366 Tage in einem gregorianischen Schaltjahr. Da der Versatz vor der Wahl des UTC-Jahres normalisiert wird, kann ein spät am 31. Dezember in einer anderen Zeitzone notierter Zeitpunkt korrekt zum 1. Januar des folgenden UTC-Jahres gehören.

Einen eindeutigen ISO-Zeitpunkt eingeben

Senden Sie datetime im Format YYYY-MM-DDTHH:mm:ssZ. Optional können Sie eine bis drei Nachkommastellen für Sekunden ergänzen oder Z durch einen vorzeichenbehafteten Versatz wie +05:30 oder -04:00 ersetzen. Die Zeitzonenangabe ist Pflicht, weil eine lokale Datums- und Zeitangabe keinen eindeutigen Zeitpunkt bezeichnet. Reine Datumswerte, lokale Formate, Monatsnamen, Leerzeichen statt T und Versätze ohne Doppelpunkt werden abgelehnt und nicht geraten. Der Parser prüft außerdem gregorianische Monatslängen, Schalttage, Stunden, Minuten, Sekunden und Versatzfelder. Schaltsekunden werden nicht akzeptiert: Sekunden reichen von 00 bis 59 und entsprechen damit dem verwendeten deterministischen Modell einer bürgerlichen Minute. Nach dem Parsen wird der Versatz mit ganzzahliger Arithmetik angewendet und der resultierende Zeitpunkt als utc_datetime ausgegeben. Zusätzlich enthält die Antwort utc_year, elapsed_milliseconds und year_milliseconds, sodass Sie den Bruchteil ohne erneute Kalenderberechnung prüfen können. Zwei Zeichenfolgen für denselben Zeitpunkt mit unterschiedlichen Versätzen liefern dieselbe normalisierte Zeit und denselben Bruchteil. Ein erfolgreicher automatisierter Aufruf kostet $0.002; die Berechnung ist auch lokal im Browser möglich.

Einsatz eines deterministischen Jahresverhältnisses

Nutzen Sie diese Funktion, wenn ein Modell, eine Visualisierung, ein Bericht oder ein Test eine stabile Position im Kalenderjahr benötigt und nicht vom Ausführungszeitpunkt eines Rechners abhängen darf. Dashboards können den Bruchteil in einen Prozentsatz oder Fortschrittsbalken umwandeln und zugleich den exakten Zähler und Nenner für Beschriftungen und Prüfungen aufbewahren. Datenpipelines können Zeitstempel um eine normalisierte Jahreskoordinate für Saisonanalysen, Interpolation oder zyklische Merkmale ergänzen; Eingaben mit Versatz werden dabei auf derselben UTC-Zeitachse verglichen. Tests können Grenzfälle zu Neujahr, am Schalttag oder in der letzten Millisekunde des Dezembers festschreiben, ohne eine Uhr zu simulieren. Das Ergebnis basiert auf verstrichener Dauer und eignet sich daher nicht zum Zählen abgeschlossener Kalendertage, Arbeitstage, Geschäftsjahre oder gleich langer Monate. UTC-Tage werden bewusst mit 86.400 Sekunden modelliert und Schaltsekunden nicht eingefügt, wodurch die Berechnung portabel und reproduzierbar bleibt. Für einen Prozentsatz multiplizieren Sie fraction mit hundert und runden erst bei der Anzeige. Für Geschäftsjahre verwenden Sie stattdessen die Grenzen des jeweiligen Geschäftskalenders.