_tzset, _wtzset

Nach oben zu time.h - Index

Header-Datei

time.h

Kategorie

Uhrzeit- und Datumsroutinen

Prototyp

void _tzset(void)

void _wtzset(void)

Beschreibung

Setzt die Werte der globalen Variablen _daylight, _timezone und _tzname.

_tzset ist auf XENIX-Systemen verfügbar.

_tzset setzt die globalen Variablen _daylight, _timezone und _tzname entsprechend der Umgebungsvariablen TZ. _wtzset setzt die globalen Variablen _daylight, _timezone und _wtzname. Die Bibliotheksfunktionen ftime und localtime verwenden diese globalen Variablen, um die Greenwich Mean-Zeit (GMT) mit der lokalen Zeitzone abzustimmen. Das Format der Umgebungsvariablen ist:

TZ = zzz[+/-]d[d][lll]

wobei zzz ein drei Zeichen langer String ist, der den Namen der aktuellen Zeitzone angibt. Alle drei Zeichen sind erforderlich. Beispielsweise steht der String “PST” für die Pazifik-Standardzeit.

[+/-]d[d] ist ein erforderliches Feld, das ein optionales Vorzeichen und ein oder mehrere Ziffern angibt. Diese Zahl gibt die Differenz zwischen lokaler Zeitzone und GMT in Stunden an. Eine positive Zahl gibt eine Zeitzone westlich von GMT an. Eine negative Zahl gibt eine Zeitzone östlich von GMT an. Nummer 5 gibt beispielsweise EST an, +8 ist PST und -1 ist Kontinentaleuropa. Diese Zahl wird bei der Berechnung des Werts der globalen Variable _timezone verwendet. _timezone ist die Differenz zwischen GMT und der lokalen Zeit in Sekunden.

lll ist ein optionales, drei Zeichen langes Feld, das die Sommerzeit der lokalen Zeitzone angibt. Beispielsweise steht der String “PDT” für die Sommerzeit der Pazifik-Standardzeit. Ist dieses Feld vorhanden, wird die globale Variable _daylight auf einen Wert ungleich Null gesetzt. Ist es nicht vorhanden, wird _daylight auf Null gesetzt.

Ist die Umgebungsvariable TZ nicht vorhanden oder hat nicht das oben dargestellte Format, wird für die Festlegung der Werte der globalen Variablen _daylight, _timezone und _tzname als Standardwert TZ = “EST5EDT” angenommen. Auf einem Win32-System wird keine dieser globalen Variablen gesetzt, wenn TZ Null ist.

Die globalen Variablen _tzname[0] und _wtzname[0] zeigen auf einen drei Zeichen langen String mit dem aus der Umgebungsvariablen TZ bezogenen Namen der Zeitzone. Die Variablen _tzname[1] und _wtzname[1] zeigen auf einen drei Zeichen langen String mit dem aus der Umgebungsvariablen TZ bezogenen Namen der Sommerzeitzone. Ist kein solcher Name vorhanden, zeigen _tzname[1] und _wtzname[1] auf einen Null-String.

Rückgabewert

Keiner.

Beispiel

 #include <time.h>
 #include <stdlib.h>
 #include <stdio.h>
 int main(void)
 {
    time_t td;
    putenv("TZ=PST8PDT");
    tzset();
    time(&td);
    printf("Current time = %s\n", asctime(localtime(&td)));
    return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
_tzset	+	+
_wtzset		+