Timestamp in Datum umrechnen: Sekunden, Millisekunden, UTC

Inhalt
Dieser Beitrag richtet sich an alle, die einen Zeitpunkt, der in einer API-Antwort oder Datenbank als Zahl wie 1700000000 gespeichert ist, in ein lesbares Datum umwandeln wollen. Ein Unix-Timestamp ist nichts weiter als die Anzahl der Sekunden oder Millisekunden seit dem 1. Januar 1970, 0 Uhr (UTC). Wer die Regeln kennt, kann daher jede Zahl exakt als Uhrzeit lesen. Verwechselt man dagegen die Einheit, erscheint dieselbe Zahl mal als Datum im Jahr 1970, mal als Datum in Tausenden Jahren.
Kurzfassung ① Ein Timestamp zählt die Sekunden oder Millisekunden seit 1970-01-01 00:00:00 UTC (Epoche). ② Mit bis zu 11 Stellen handelt es sich um Sekunden, ab 12 Stellen um Millisekunden. Wer die Einheit verwechselt, landet bei einem Datum, das um etwa den Faktor 1000 danebenliegt. ③ Derselbe Timestamp wird in den drei Formaten Ortszeit, UTC und ISO um den jeweiligen Zeitzonen-Offset unterschiedlich angezeigt.
Im Log steht nur eine Zahl, ohne Einheit
In Server-Logs oder API-Antworten steht der Zeitpunkt oft nur als einzelne Zahl, etwa created_at: 1700000000. Gespeichert wird nämlich nicht „November 2023“, sondern direkt die seit der Epoche vergangene Zeit.
Das Problem: Bei dieser Zahl steht nicht dabei, ob es „Sekunden“ oder „Millisekunden“ sind. Manche Systeme speichern in Sekunden, andere in Millisekunden. Selbst bei gleichem Feldnamen kann die Stellenzahl des Werts deshalb unterschiedlich sein.
Sehen Sie im Log 1700000000 und 1700000000000 nebeneinander, lässt sich daher kaum auf einen Blick sagen, ob beide denselben Moment meinen oder völlig verschiedene Zeitpunkte. Dieser Beitrag fasst zusammen, nach welchen Regeln Sie eine solche Zahl korrekt als Datum lesen.
So rechnen Sie ohne Tool selbst um
Schritt 1: Zuerst die Epoche
Der Bezugspunkt (die Epoche) des Unix-Timestamps ist der 1. Januar 1970, 00:00:00 UTC. Ein Timestamp ist eine einzelne Zahl, die angibt, wie viele Sekunden (oder Millisekunden) seit diesem Moment vergangen sind.
Wichtig ist dabei, dass der Bezug UTC ist. Der Timestamp selbst enthält keine Zeitzoneninformation und bezeichnet überall auf der Welt denselben absoluten Zeitpunkt.
Schritt 2: Einheit anhand der Stellenzahl erkennen
Zählen Sie die Stellen des ganzzahligen Teils. Bis zu 11 Stellen gelten als Sekunden, ab 12 Stellen als Millisekunden. Aktuelle Werte haben in Sekunden 10 Stellen und in Millisekunden 13 Stellen, die Unterscheidung ist in der Praxis meist eindeutig.
Um einen Sekundenwert in ein Datum umzurechnen, muss er in Millisekunden vorliegen. JavaScripts Date arbeitet immer mit Millisekunden, deshalb müssen Sie Sekundenwerte mit 1000 multiplizieren.
Schritt 3: Die Umrechnung durchführen
Am zuverlässigsten geht es in der Entwicklerkonsole des Browsers. Bei einem Sekundenwert multiplizieren Sie vor der Eingabe mit 1000.
new Date(1700000000 * 1000).toString() // Ortszeit
new Date(1700000000 * 1000).toUTCString() // UTC
new Date(1700000000 * 1000).toISOString() // ISO 8601
Wenn Sie lieber die Kommandozeile nutzen, zeigen Sie die UTC-Zeit am Mac mit date -r 1700000000 -u und unter Linux mit date -d @1700000000 -u an.
In einer Tabellenkalkulation wandelt die Formel =A1/86400 + DATE(1970,1,1) einen Sekundenwert in ein UTC-Datum um. Für die koreanische Zeit addieren Sie dazu 9/24 (UTC+9).
Schritt 4: Von UTC in die Ortszeit
Liegt der UTC-Wert vor, addieren Sie den Offset Ihrer Region. Die koreanische Standardzeit (KST) ist UTC+9, die Ortszeit ergibt sich also, indem Sie 9 Stunden zur UTC-Zeit addieren.
Zum Nachprüfen mit unserem Tool „Timestamp jetzt: Unix-Zeit in Sekunden und Millisekunden“:
Geben Sie eine Zahl ein: Das Tool erkennt automatisch Sekunden oder Millisekunden und zeigt Lokalzeit, UTC und ISO. Wählen Sie ein Datum, erhalten Sie den Wert in Sekunden und Millisekunden. Alles läuft ohne Installation im Browser.

Warum derselbe Wert als Ortszeit, UTC und ISO unterschiedlich aussieht
Geben Sie 1700000000 in das Tool ein, erscheinen drei Zeilen. Es ist dieselbe Zahl, aber die Uhrzeiten wirken unterschiedlich, was verwirren kann.
| Format | Anzeige | Bedeutung |
|---|---|---|
| Ortszeit (lokal) | 2023-11-15 07:13:20 | Bezogen auf die Browser-Zeitzone (KST=UTC+9) |
| UTC | 2023-11-14 22:13:20 UTC | Bezogen auf den Zeitzonen-Offset 0 |
| ISO 8601 | 2023-11-14T22:13:20.000Z | UTC als internationaler Standard-String |
Alle drei Werte bezeichnen denselben Moment. Ein Timestamp ist ein absoluter Wert ohne Zeitzone, je nach Format ändert sich nur die Darstellung.
Die Ortszeit liegt 9 Stunden vor UTC, weil KST gleich UTC+9 ist. In diesem Beispiel springt durch die 9 Stunden auch das Datum um einen Tag weiter, vom 14. auf den 15. November.
Das Z am Ende des ISO-8601-Strings bedeutet: „Diese Zeit ist UTC.“ Die ISO- und die UTC-Zeile unterscheiden sich daher nur im Format, der gemeinte Zeitpunkt ist derselbe.
Häufiger Fehler: Wer die Einheit verwechselt, liegt um den Faktor 1000 daneben
Der häufigste Fehler ist die falsche Einheit. Hält man einen Sekundenwert für Millisekunden oder umgekehrt, liegt das Ergebnis um etwa den Faktor 1000 daneben.
| Eingegebene Zahl | Angenommene Einheit | Berechneter Zeitpunkt (UTC) |
|---|---|---|
| 1700000000 (10 Stellen) | Sekunden (korrekt) | 2023-11-14 22:13:20 |
| 1700000000000 (13 Stellen) | Millisekunden (korrekt) | 2023-11-14 22:13:20 |
| 1700000000 | fälschlich als Millisekunden | 1970-01-20 16:13:20 |
1700000000 ist eigentlich ein Sekundenwert, erst mit dem Faktor 1000 ergibt sich das Jahr 2023. Setzen Sie die Zahl unverändert als Millisekunden ein, sind das nur etwa 1,7 Milliarden Millisekunden, also gut 20 Tage, und Sie landen im Januar 1970.
Multiplizieren Sie dagegen einen 13-stelligen Millisekundenwert versehentlich noch einmal mit 1000, ergibt sich ein unmögliches Datum in den zehntausenden Jahren n. Chr. Das Tool erkennt die Einheit zuerst an der Stellenzahl und verringert so das Risiko solcher Multiplikationsfehler.
Gut zu wissen ist allerdings, dass die Erkennung über die Stellenzahl nur eine Konvention ist. Weil ab 12 Stellen von Millisekunden ausgegangen wird, kann die Regel bei Sekundenwerten, die auf einen sehr fernen Zeitpunkt in der Zukunft zeigen, danebenliegen.
Zusammenfassung
- Ein Unix-Timestamp zählt die Sekunden oder Millisekunden seit 1970-01-01 00:00:00 UTC (Epoche).
- Bis zu 11 Stellen sind Sekunden, ab 12 Stellen Millisekunden. Aktuelle Sekundenwerte haben 10 Stellen, Millisekundenwerte 13.
- Wer die Einheit verwechselt, liegt um etwa den Faktor 1000 daneben und landet in der Nähe von 1970 oder in einer absurden Zukunft.
- Derselbe Timestamp wird in Ortszeit, UTC und ISO nur um den Zeitzonen-Offset verschieden angezeigt, es ist stets derselbe Moment.
- Das
Zam Ende von ISO 8601 zeigt an, dass die Zeit in UTC angegeben ist.
Geben Sie eine Zahl ein: Das Tool erkennt automatisch Sekunden oder Millisekunden und zeigt Lokalzeit, UTC und ISO. Wählen Sie ein Datum, erhalten Sie den Wert in Sekunden und Millisekunden. Alles läuft ohne Installation im Browser.
Häufig gestellte Fragen
Wie unterscheide ich 10-stellige und 13-stellige Zahlen?
Anhand der Stellenzahl. Das Tool wertet bis zu 11 Stellen als Sekunden und ab 12 Stellen als Millisekunden. Aktuell haben Sekundenwerte 10 Stellen und Millisekundenwerte 13 Stellen, die Unterscheidung ist daher meist eindeutig. Sekundenwerte werden für die Umrechnung in ein Datum intern mit 1000 multipliziert.
Warum weichen Ortszeit und UTC voneinander ab?
Ein Timestamp ist ein absoluter Wert ohne Zeitzone, und die Ortszeit ergibt sich, indem der Offset der Browser-Zeitzone hinzugerechnet wird. Die koreanische Standardzeit ist UTC+9, deshalb liegt die Ortszeit 9 Stunden vor UTC, und je nach Uhrzeit springt auch das Datum um einen Tag weiter. Die beiden Zeilen unterscheiden sich nur in der Anzeige und bezeichnen denselben Moment.
Kann ich auch ein Datum in einen Timestamp umrechnen?
Ja. Wählen Sie im zweiten Feld des Tools Datum und Uhrzeit aus, dann zeigt es den Sekundenwert und den Millisekundenwert dieses Moments an, die Sie jeweils kopieren können. Der Sekundenwert ist die Millisekundenzahl geteilt durch 1000, ohne Nachkommastellen.
Wird die eingegebene Zahl an einen Server übertragen?
Nein. Die Erkennung der Einheit und die Datumsberechnung laufen komplett im Browser. Es gibt weder eine Übertragung noch eine Installation, das Ergebnis ändert sich sofort bei jeder Eingabe.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen