Zerlegung von Datum & Zeit
|
|
In <time.h> ist ein Struktur-Typ definiert,
der die Bestandteile eines Datum-und-Zeit Objekts verwaltet:
|
Struktur vom Typ tm
struct tm {
int tm_sec; // Sekunden (0..59)
int tm_min; // Minuten (0..59)
int tm_hour; // Stunden (0..23)
int tm_mday; // Tag des Monats (1..31)
int tm_mon; // Monat (0..11)
int tm_year; // Jahr (Kalenderjahr - 1900)
int tm_wday; // US-Wochentag (0..6, So=0)
int tm_yday; // Tag des Jahres (0..365)
int tm_isdst; // US-Sommerzeit (0..1)
};
Ausgabe des Beispiels (rechts):
Datum: 0, 0, 0
Weltzeit UTC: 0, 0, 0
Lokalzeit: 0, 0, 0
TimeZone Offset = 0h
|
Beispiel:
#include <stdio.h>
#include <time.h>
int main() {
int yy,mo,dd,h0,h1,mi,ss;
time_t uts;
struct tm ts, *pts;
time(&uts);
ts = *(gmtime(&uts));
yy = ts.tm_year+1900;
mo = ts.tm_mon+1;
dd = ts.tm_mday;
h0 = ts.tm_hour;
mi = ts.tm_min;
ss = ts.tm_sec;
printf("Datum: %d, %d, %d\n",yy,mo,dd);
printf("Weltzeit UTC: %d, %d, %d\n",h0,mi,ss);
pts = localtime(&uts);
h1 = pts->tm_hour;
printf("Lokalzeit: %d, %d, %d\n",h1,mi,ss);
printf("TimeZone Offset = %dh\n",h1-h0);
}
|
Funktion gmtime()
Diese Funktion zerlegt ein Datum-Zeit Objekt in die (ganzzahligen) Bestandteile der
→
Weltzeit UTC (früher GMT):
Argument: Die Funktion erwartet einen Pointer auf
ein time_t Objekt, welches meistens unmittelbar davor mit der
↑ Funktion time()
auf die aktuellen Daten gesetzt wurde.
Rückgabe: Die Funktion gibt einen Pointer auf
eine tm Struktur zurück. Die Elemente der Struktur enthalten
die gewünschten Daten.
Funktion localtime()
Diese Funktion arbeitet genauso wie gmtime(), liefert jedoch
die Bestandteile der lokalen Zeitzone.
|
Das Beispiel oben zeigt 2 Varianten der Anwendung:
•
Das Ergebnis der Funktion gmtime() wird de-referenziert und
an die Variable ts zugewiesen. Danach werden die Elemente
von ts an weitere Variable (yy...ss)
zugewiesen und ausgegeben.
•
Das Ergebnis der Funktion localtime() wird direkt an
die Pointer-Variable pts zugewiesen.
Danach wird lediglich das Element tm_hours der damit
angegebenen Struktur an die Variable h1 zugewiesen.
•
Aus der Differenz der Stunden von Lokalzeit und UTC (h1-h0)
wird die Zeit-Differenz der Zeitzone (TimeZone Offset) berechnet und ausgegeben.
|
LokalZeit
Ein Programm wird leichter durchschaubar, wenn man Teil-Arbeiten in Funktionen
oder Klassen auslagert. Hier wird vorgestellt, wie man die Berechnung der Zeit-Bestandteile
übersichtlich auslagern kann.
Die Funktion current_hms() sollte Stunden, Minuten und
Sekunden als ganze Zahlen zurückgeben. Da eine C-Funktion nur einen einzigen Wert
zurückgeben kann, verwendet man (so wie in allen ähnlichen Fällen)
Pointer, und zwar aus Sicht des Programms main() die
Pointer &hh,&mi,&ss, aus Sicht der Funktion die
(zur Unterscheidung anders benannten) Argumente ph,pmi,ps
Die Funktion arbeitet so wie oben beschrieben und schreibt die Ergebnisse in jene
Adressen, welche durch die 3 Pointer angegeben werden, z.B. die Stunden Lokalzeit
an die mit dem Pointer ph angegebene Adresse, usw.
Nach der einfachen Ausgabe als ganze Zahlen (Platzhalter %d )
wird gezeigt, wie man die gleichen Daten im Standard-Format
→ ISO-8601 mit optional führenden Nullen
(Platzhalter %02d) formatieren kann.
♦ Details zur
Funktion printf()
|
Beispiel: Die C/C++ Funktion current_hms()
liefert die Bestandteile der aktuellen LokalZeit:
#include <stdio.h>
#include <time.h>
void current_hms(int*,int*,int*);
int main(void) {
int hh,mi,ss;
current_hms(&hh,&mi,&ss);
printf("Zeit: %d,%d,%d\n",hh,mi,ss);
printf("ISO: %02d:%02d:%02d\n",hh,mi,ss);
}
void current_hms(int *ph,int *pmi,int *ps) {
time_t uts;
struct tm ts,*pts;
time(&uts);
ts = *(gmtime(&uts));
pts=localtime(&uts);
*ph=pts->tm_hour;
*pmi = ts.tm_min;
*ps = ts.tm_sec;
}
Ausgabe:
Zeit: 0,0,0
ISO: 00:00:00
|
Wochentag:
Den Tag der Woche nach Standard
→ ISO-8601 muss man selbst berechnen, z.B. so:
int iso_dow(int us_dow) {
if(us_dow) {return us_dow;}
else{return 7;}
}
|
Zeitzone und Sommerzeit
Die Angabe der US-Sommerzeit ist in Europa wertlos.
Auch die Zeitdifferenz der lokalen Zeitzone wird (je nach Betriebssystem und Compiler)
nicht immer richtig angegeben.
In diesen Fällen muss man sich selbst helfen: Man erhält die Daten entweder
vom Betriebssystem (Konsolen-Programme, Umgebungs-Variable, Windows-Registry) oder
man muss (Normalzeit oder Sommerzeit) selbst berechnen.
|
C/C++