Unix-Zeitstempel erklärt: Sekunden, Millisekunden und Zeitzonen
Was ein Unix-Zeitstempel ist, wie du Sekunden von Millisekunden unterscheidest, warum Zeitzonen ihn nicht ändern, das 2038-Problem und Umrechnung im Code.
Aktualisiert
Ein Unix-Zeitstempel zählt die Sekunden seit der Unix-Epoche, dem 1. Januar 1970 um 00:00:00 UTC. 1696118400 bedeutet 1.696.118.400 Sekunden nach diesem Moment, also Mitternacht UTC am 1. Oktober 2023. Die Zahl ist in jedem Land dieselbe, denn die Zeitzone kommt erst ins Spiel, wenn du die Zählung in ein Kalenderdatum umwandelst, das ein Mensch lesen soll.
Warum Computer Sekunden zählen
Datumsangaben sind umständlich zu speichern und zu vergleichen. Monate sind unterschiedlich lang, Jahre haben manchmal 366 Tage, und jede Region schreibt die Bestandteile in einer anderen Reihenfolge. Eine einzelne Ganzzahl umgeht das alles. Zwei Zeitstempel lassen sich mit einem Kleiner-als-Zeichen vergleichen, voneinander abziehen, um eine Dauer zu erhalten, als einfache Zahlen sortieren und in einer festen Anzahl von Bytes speichern.
Deshalb tauschen Datenbanken, Logdateien, JWT-Tokens, Cache-Header und die meisten APIs Zeit als Epoch-Wert aus. Ein paar Orientierungspunkte helfen dir, einen zu erkennen, wenn du ihn siehst:
0ist 1970-01-01T00:00:00Z, die Epoche selbst.1000000000ist 2001-09-09T01:46:40Z, die milliardste Sekunde.1696118400ist 2023-10-01T00:00:00Z.1791676800ist 2026-10-11T00:00:00Z.2147483647ist 2038-01-19T03:14:07Z, die 32-Bit-Grenze.
Negative Werte sind erlaubt und bedeuten Daten vor 1970, allerdings kommt nicht jedes System damit zurecht.
Sekunden und Millisekunden im Vergleich
Die ursprüngliche Definition zählt Sekunden, und genau das liefern Unix-Tools, time.time() in Python und die meisten Datenbanken. JavaScript hat mit der Konvention gebrochen. Date.now() liefert Millisekunden, derselbe Zeitpunkt erscheint also als 1696118400000. System.currentTimeMillis() in Java und viele Logging-Frameworks folgen JavaScript.
Die beiden zu verwechseln ist der häufigste Zeitstempel-Fehler. Übergibst du einen Millisekundenwert, wo Sekunden erwartet werden, landet das Datum etwa im Jahr 55.000. Übergibst du Sekunden, wo Millisekunden erwartet werden, wird jedes Datum zum 20. Januar 1970. Die schnelle Prüfung ist die Stellenzahl: Heutige Werte haben 10 Stellen in Sekunden und 13 in Millisekunden. Manche Systeme gehen weiter, mit 16 Stellen für Mikrosekunden und 19 für Nanosekunden.
Die Umrechnung ist eine Multiplikation oder Division mit 1000. In JavaScript erhältst du Sekunden mit Math.floor(Date.now() / 1000), und ein Sekundenwert wird mit new Date(ts * 1000) zum Datum. Der Unix-Timestamp-Konverter erkennt die Einheit automatisch an der Länge und zeigt das dekodierte Datum zusammen mit seiner ISO-8601-Form, was dir das Raten erspart.
Zeitzonen ändern die Zahl nicht
Ein Zeitstempel benennt einen Zeitpunkt, keine Uhrzeit an der Wand. 1696118400 ist Mitternacht am 1. Oktober in London, aber 20:00 Uhr am 30. September in New York, 05:30 Uhr am 1. Oktober in Mumbai und 09:00 Uhr am 1. Oktober in Tokio. Alle vier sind derselbe Zeitpunkt und dieselbe Zahl. Nur die Anzeige unterscheidet sich.
Deshalb lautet die vernünftige Regel für jedes System: Zeitstempel in UTC speichern und übertragen und erst im letztmöglichen Moment, in der Benutzeroberfläche, in Ortszeit umwandeln. Speicherst du stattdessen eine Ortszeit, verlierst du den Zeitpunkt. „2:30 Uhr am 5. November“ gibt es in New York zweimal, wenn die Uhren zurückgestellt werden, und am Frühjahrstermin, wenn sie vorspringen, gar nicht.
Die Sommerzeit ist der Hauptgrund, Rechnungen in Ortszeit zu vermeiden. 86400 Sekunden zu einem Zeitstempel zu addieren rückt immer genau einen Tag realer Zeit vor, aber dieser Tag kann auf der lokalen Uhr 23 oder 25 Stunden haben. Wenn du „morgen zur selben Zeit“ in der Zone eines Nutzers brauchst, rechne in Kalenderbegriffen mit einer zeitzonenfähigen Bibliothek, nicht durch Addieren von Sekunden.
Wenn du sehen musst, wie ein bestimmter Zeitpunkt in verschiedenen Büros aussieht, nimmt der Zeitzonen-Konverter ein Datum mit Uhrzeit und listet die Entsprechung in über 30 Zonen auf, was schneller geht, als von Hand über Offsets nachzudenken.
Schaltsekunden und die 2038-Grenze
Die Unix-Zeit tut so, als hätte jeder Tag genau 86400 Sekunden. Echte Tage enthalten gelegentlich eine Schaltsekunde, und wenn das passiert, wiederholt oder streckt die Systemuhr eine Sekunde, statt bis 60 zu zählen. Für fast alle Anwendungen ist das unsichtbar, aber es ist der Grund, warum die Unix-Zeit nicht ganz der Zahl der seit 1970 real vergangenen Sekunden entspricht.
Das 2038-Problem ist praktischer. Eine vorzeichenbehaftete 32-Bit-Ganzzahl endet bei 2147483647. Eine Sekunde später, am 19. Januar 2038 um 03:14:08 UTC, springt sie auf eine große negative Zahl um, die als Dezember 1901 dekodiert wird. Moderne Betriebssysteme, Sprachen und Datenbanken verwenden 64-Bit-Werte und sind für die nächsten 292 Milliarden Jahre sicher. Das Risiko steckt in alten Embedded-Geräten, alten Dateiformaten und jedem Schema, das für eine Epoch-Spalte INT statt BIGINT gewählt hat.
Mit Zeitstempeln im Code arbeiten
Die Umrechnungen sind in jeder Sprache eingebaut, sehen aber unterschiedlich aus:
- Shell:
date +%sgibt den aktuellen Zeitstempel aus, unddate -u -d @1696118400dekodiert einen unter Linux. - Python:
datetime.fromtimestamp(1696118400, tz=timezone.utc)undint(dt.timestamp()). - JavaScript:
new Date(1696118400 * 1000).toISOString()undMath.floor(date.getTime() / 1000). - SQL:
to_timestamp(1696118400)in PostgreSQL,FROM_UNIXTIME(1696118400)in MySQL. - Excel:
=A1/86400 + DATE(1970,1,1)macht aus einem Sekundenwert eine fortlaufende Datumszahl.
Zeitspannen sind einfach Subtraktion. Die beiden Zeitstempel 1696118400 und 1696204800 unterscheiden sich um 86400, also einen Tag. Teile durch 3600 für Stunden oder durch 604800 für Wochen. Wenn das Ergebnis in Kalendereinheiten wie „2 Jahre, 3 Monate und 14 Tage“ ausgedrückt werden soll, reicht einfache Subtraktion nicht mehr, weil Monate unterschiedlich lang sind. Der Zeitdauer-Rechner übernimmt diese Aufschlüsselung aus zwei Datumsangaben und zeigt zusätzlich die Summen in Tagen, Stunden und Sekunden.
Weitere Konverter für Datumsangaben, Cron-Ausdrücke und Zeitpläne findest du in der Kategorie Datum und Zeit.
Probier es aus
Füge 1696118400 in den Unix-Timestamp-Konverter ein, um den 1. Oktober 2023 in UTC zu sehen, füge dann 1696118400000 ein und überzeuge dich, dass er Millisekunden erkennt und denselben Zeitpunkt ermittelt.