Unix-Timestamp: Einheit an der Stellenzahl erkennen

Inhalt
Welchen Zeitpunkt eine Zahl wie 1784298258 in einer API-Antwort oder einem Server-Log genau bezeichnet, lässt sich schon an der Stellenzahl erkennen. Bei Unix-Timestamps liegt der Stellenbereich fest, je nachdem, ob der Wert in Sekunden oder Millisekunden angegeben ist.
Wer diese Regel nicht kennt und die Zahl direkt an den JavaScript-Date-Konstruktor übergibt, erhält absurde Daten: entweder einen Zeitpunkt irgendwo in den 1970er-Jahren oder ein Jahr im fünfstelligen Bereich n. Chr. Dieser Artikel fasst die Rechenregeln zusammen, mit denen Sie allein anhand der Stellenzahl Sekunden, Millisekunden, Mikrosekunden und Nanosekunden unterscheiden.
Kurzfassung ① 1 bis 11 Stellen bedeuten Sekunden, 12 bis 14 Stellen Millisekunden, 15 bis 17 Stellen Mikrosekunden und ab 18 Stellen Nanosekunden. ② Wird ein 10-stelliger Sekundenwert fälschlich als Millisekunden direkt an
Dateübergeben, landet das Ergebnis um 1970. Wird ein 13-stelliger Millisekundenwert fälschlich als Sekunden betrachtet und mit 1000 multipliziert, kommt ein Datum im fünfstelligen Jahresbereich n. Chr. heraus. ③ Derselbe Timestamp erscheint in UTC und in Ortszeit um den jeweiligen Zeitzonen-Offset verschoben, und negative Werte bezeichnen Zeitpunkte vor 1970.
Warum Verwechslungen bei der Stellenzahl im Alltag tatsächlich vorkommen
In Server-Logs und API-Antworten stehen Timestamps oft nur als nackte Zahl, ohne Einheit. Manche Systeme liefern Sekunden, andere Millisekunden. Selbst bei gleichem Feldnamen (created_at, timestamp usw.) kann die Stellenzahl des tatsächlichen Werts daher unterschiedlich sein.
Das Problem: Der JavaScript-Date-Konstruktor arbeitet immer mit Millisekunden. new Date(x) interpretiert x als die Anzahl der Millisekunden, die seit dem 1. Januar 1970, 0:00 Uhr (UTC) vergangen sind.
Übergeben Sie dort direkt eine Sekundenzahl, wird ein Wert gelesen, der nur ein Tausendstel so groß ist wie der richtige, und das berechnete Datum landet um 1970.
Auch der umgekehrte Fehler kommt vor. Wer eine Millisekundenzahl für Sekunden hält, mit 1000 multipliziert und dann an Date übergibt, landet 1000-mal weiter in der Zukunft als der tatsächliche Zeitpunkt. Da der Code in beiden Fällen ohne Fehlermeldung durchläuft, fällt das erst auf, wenn irgendwo ein seltsames Datum angezeigt wird.
So bestimmen Sie die Einheit ohne Tool allein durch Zählen der Stellen
Die Erkennungsregel und warum die Grenze bei 11 Stellen liegt
Die Regel lautet: Zählen Sie die Stellen des ganzzahligen Teils. 1 bis 11 Stellen gelten als Sekunden, 12 bis 14 Stellen als Millisekunden, 15 bis 17 Stellen als Mikrosekunden und ab 18 Stellen als Nanosekunden.
Dass die Grenze bei 11 Stellen liegt, hat einen Grund. Der größte 11-stellige Wert, 99999999999, entspricht in Sekunden umgerechnet dem 16. November 5138.
Ein Sekunden-Timestamp kann also schon mit 11 Stellen Zeitpunkte bis ins Jahr 5138 n. Chr. darstellen. Taucht eine Zahl mit 12 oder mehr Stellen auf, handelt es sich deshalb sehr wahrscheinlich nicht um Sekunden, sondern um eine kleinere Einheit.
Mit echten Zahlen nachprüfen
Prüfen wir das an echten Zahlen. Der Sekunden-Timestamp zum Zeitpunkt dieses Artikels lautet 1784298258 (10 Stellen). Korrekt als Sekunden gelesen ergibt das den 17. Juli 2026, 14:24 Uhr (UTC).
Setzen Sie diese Zahl jedoch versehentlich als new Date(1784298258) direkt an die Millisekunden-Stelle, erhalten Sie den 21. Januar 1970. 1784298258 Millisekunden sind nämlich nur etwa 20 Tage.
Der Millisekundenwert desselben Moments ist 1784298258087 (13 Stellen). Halten Sie diese Zahl dagegen fälschlich für Sekunden und übergeben sie multipliziert mit 1000 als new Date(1784298258087 * 1000), kommt mit dem Jahr 58512 n. Chr. ein unmögliches Datum heraus.
Die Rechenschritte im Überblick
So gehen Sie vor:
- Zählen Sie die Stellen der Zahl.
- Bestimmen Sie die Einheit anhand der Stellenregel (Grenzen bei 11, 14 und 17 Stellen).
- Bei Millisekunden teilen Sie durch 1000, um Sekunden zu erhalten. Wollen Sie umgekehrt Sekunden in ein JavaScript-
Dateeinsetzen, multiplizieren Sie mit 1000 und erhalten Millisekunden. - Prüfen Sie das erzeugte Date-Objekt jeweils mit toISOString() (UTC) und toString() (Ortszeit).
Statt Stellen zu zählen und von Hand zu dividieren und zu multiplizieren, können Sie den Wert mit unserem kostenlosen Tool „Epoch-Konverter für Entwickler: Sekunden bis Nanosekunden, ISO 8601 & relative Zeit“ prüfen.
Erkennt die Einheit anhand der Stellenzahl und berechnet sofort Sekunden, Millisekunden, Mikrosekunden, Nanosekunden sowie UTC- und Ortszeit. Kostenlos, die Verarbeitung erfolgt nur im Browser.

Häufige Stolperstellen
Auch wenn ein Wert denselben Zeitpunkt bezeichnet, hat er je nach Einheit eine andere Stellenzahl. Die folgende Tabelle fasst die eben geprüften Zahlen zusammen.
| Stellenzahl | Einheit | Beispielwert | Bezeichneter Zeitpunkt (UTC) |
|---|---|---|---|
| 1–11 Stellen | Sekunden | 1784298258 | 2026-07-17 14:24:18 |
| 12–14 Stellen | Millisekunden | 1784298258087 | 2026-07-17 14:24:18.087 |
| 15–17 Stellen | Mikrosekunden | 1784298258087000 | 2026-07-17 14:24:18.087 (derselbe Zeitpunkt) |
| ab 18 Stellen | Nanosekunden | 1784298258087000000 | 2026-07-17 14:24:18.087 (derselbe Zeitpunkt) |
Der Unterschied zwischen UTC, Ortszeit und relativer Zeit
UTC und Ortszeit unterscheiden sich, weil ein Timestamp selbst zu keiner Zeitzone gehört. Er ist ein absoluter Wert (die seit dem 1. Januar 1970, 0:00 Uhr UTC vergangene Zeit). Die Ortszeit ist das Ergebnis dieses absoluten Werts plus dem Zeitzonen-Offset, den der Browser eingestellt hat.
Der Wert aus der Tabelle oben ist in UTC der 17. Juli, 14:24 Uhr. In der koreanischen Standardzeit (UTC+9) wird derselbe Moment dagegen als 17. Juli, 23:24 Uhr angezeigt.
Die relative Zeit (eine Anzeige wie „in 3 Stunden“) wird berechnet, indem die Differenz zwischen Zielzeit und aktueller Zeit in Sekunden bestimmt und dann in eine für Menschen gut lesbare Einheit aus Minuten, Stunden oder Tagen umgerechnet wird. Liegt das Ziel in der Zukunft, steht davor „in …“, liegt es in der Vergangenheit, „vor …“.
Negative Timestamps und berechnete kleinere Einheiten
Negative Timestamps sind ebenfalls gültige Werte. Ein negativer Wert bezeichnet einen Zeitpunkt vor dem 1. Januar 1970, 0:00 Uhr (UTC). So liegt -3600 genau 3600 Sekunden (1 Stunde) vor diesem Bezugszeitpunkt, also am 31. Dezember 1969 um 23:00 Uhr (UTC).
Zu beachten ist schließlich, dass Mikrosekunden- und Nanosekundenwerte berechnete Werte sind, die durch Multiplikation des Millisekundenwerts mit 1000 bzw. 1.000.000 entstehen. Hat das Ursprungssystem tatsächlich unabhängig bis auf die Mikrosekunde genau gemessen, können sich die unteren Stellen dieses Originalwerts von dem berechneten Wert unterscheiden.
Zusammenfassung
- 1 bis 11 Stellen bedeuten Sekunden, 12 bis 14 Stellen Millisekunden, 15 bis 17 Stellen Mikrosekunden und ab 18 Stellen Nanosekunden.
- Selbst der größte 11-stellige Sekundenwert liegt erst im Jahr 5138 n. Chr.; bei 12 oder mehr Stellen handelt es sich daher wahrscheinlich nicht um Sekunden.
- Ein 10-stelliger Sekundenwert, direkt an der Millisekunden-Stelle eingesetzt, landet um die 1970er-Jahre. Ein 13-stelliger Millisekundenwert, der fälschlich als Sekunden betrachtet und mit 1000 multipliziert wird, ergibt eine absurde Zukunft.
- Auch bei demselben Timestamp werden UTC und Ortszeit um den Zeitzonen-Offset verschoben angezeigt, und negative Werte bezeichnen Zeitpunkte vor 1970.
- Mikrosekunden- und Nanosekundenwerte sind berechnete Werte, die durch Multiplikation des Millisekundenwerts entstehen.
Erkennt die Einheit anhand der Stellenzahl und berechnet sofort Sekunden, Millisekunden, Mikrosekunden, Nanosekunden sowie UTC- und Ortszeit. Kostenlos, die Verarbeitung erfolgt nur im Browser.
Häufig gestellte Fragen
Kann ich mich bei der Einheit immer allein auf die Stellenregel verlassen?
Für Timestamps aus der Praxis, die Jahre nahe der Gegenwart betreffen, reicht diese Regel zur Unterscheidung völlig aus. Es handelt sich allerdings um eine Konvention, die auf der Rechnung beruht, dass Sekundenwerte bis zum Jahr 5138 n. Chr. mit 11 Stellen darstellbar sind. Bei Sekundenwerten, die noch viel weiter in der Zukunft liegen, können es 12 oder mehr Stellen werden, und die Regel stimmt dann nicht mehr.
Kann ich auch negative Timestamps eingeben?
Ja, auch negative Werte für Datumsangaben vor dem 1. Januar 1970 werden korrekt berechnet. Beispielsweise bedeutet -3600 den 31. Dezember 1969, 23:00 Uhr (UTC).
Wird die eingegebene Zahl an einen Server übertragen?
Nein. Die gesamte Einheitenerkennung und Datumsberechnung läuft sofort per JavaScript im Browser, und die eingegebene Zahl wird nicht an einen Server gesendet.
Sind Mikrosekunden- und Nanosekundenwerte so genau, als wären sie gemessen?
Nein. Die angezeigten Mikrosekunden- und Nanosekundenwerte sind berechnete Werte, die durch Multiplikation des Millisekundenwerts mit 1000 bzw. 1.000.000 entstehen. Hat das Ursprungssystem tatsächlich unabhängig bis auf die Mikrosekunde genau gemessen, können sich die unteren Stellen dieses Werts davon unterscheiden.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen