Verwendung der TZ-Zeitzonenangabe in Docker: Anleitung und Verfügbare Zeitzonen

Was ist die TZ-Umgebungsvariable?

Die TZ-Umgebungsvariable ermöglicht es dir, die Zeitzone für einen Docker-Container festzulegen. Standardmäßig übernehmen Docker-Container die Zeitzone des Host-Systems. Wenn du jedoch sicherstellen möchtest, dass dein Container eine bestimmte Zeitzone verwendet, kannst du dies über die TZ-Variable steuern.

Warum ist die Zeitzonenkonfiguration wichtig?

Die korrekte Zeitzone ist entscheidend für:

Zeitstempel: Anwendungen, die Zeitstempel generieren (z.B. in Logs oder Datenbankeinträgen), müssen diese in der richtigen Zeitzone erzeugen.
Geplante Aufgaben: Cron-Jobs oder andere zeitbasierte Aufgaben müssen zur richtigen lokalen Zeit ausgeführt werden.
Globale Anwendungen: Wenn deine Anwendung von Nutzern in verschiedenen Zeitzonen genutzt wird, ist es wichtig, dass die Zeit korrekt lokalisiert wird.

So verwendest du die TZ-Umgebungsvariable in Docker

Um die Zeitzone eines Docker-Containers festzulegen, setzt du die TZ-Umgebungsvariable beim Start des Containers. Dies geschieht mit dem -e (oder --env) Schalter, gefolgt von der gewünschten Zeitzonenangabe.

Beispiel: Container mit festgelegter Zeitzone starten

Angenommen, du möchtest einen Container starten und die Zeitzone auf “Europe/Berlin” festlegen, dann verwendest du den folgenden Befehl:

docker run -e TZ=Europe/Berlin your-docker-image

Dieser Befehl startet den Container und stellt sicher, dass die Zeitzone auf Berlin gesetzt ist, unabhängig davon, welche Zeitzone das Host-System verwendet

Auswirkungen der TZ-Zeitzonenangabe

Wenn du die TZ-Variable setzt, beeinflusst dies:

Systemzeit innerhalb des Containers: Alle zeitabhängigen Operationen im Container basieren auf der festgelegten Zeitzone.
Logs und Zeitstempel: Jede generierte Zeitangabe (z.B. in Logs) wird in der festgelegten Zeitzone ausgegeben.
Geplante Aufgaben: Cron-Jobs und andere zeitbasierte Aufgaben laufen zur richtigen Zeit in der angegebenen Zeitzone.

Liste der Verfügbaren Zeitzonen

Docker unterstützt alle Zeitzonen, die von der IANA (Internet Assigned Numbers Authority) gepflegt werden. Diese Zeitzonen sind im Format “Region/Stadt” angegeben. Hier ist eine Auswahl der häufig verwendeten Zeitzonen: