C-Standardbibliothek -<time.h>

Einführung

time.hDie Header-Datei definiert vier Variablentypen, zwei Makros und verschiedene Funktionen zur Bearbeitung von Datums- und Zeitangaben.

<time.h>Es ist eine Header-Datei in der C-Standardbibliothek, die Funktionen und Typen für die Verarbeitung und Bearbeitung von Datums- und Zeitangaben bereitstellt. Die Funktionen in dieser Header-Datei werden verwendet, um die aktuelle Zeit abzurufen, die Zeit festzulegen, Zeit zu formatieren, Zeitdifferenzen zu berechnen und so weiter.

Konstanten und Makros

Konstanten/MakrosBeschreibung
CLOCKS_PER_SECAnzahl der Taktzyklen pro Sekunde.
NULLNullzeigerkonstante.
TIME_UTCStellt UTC-Zeit dar (C11).

Bibliotheksvariablen

Nachfolgend sind die in der Header-Datei time.h definierten Variablentypen aufgeführt:

Laufende NummerVariable & Beschreibung
1size_t
Ist ein vorzeichenloser Ganzzahltyp, der das Ergebnis dessizeof-Schlüsselworts ist.
2clock_t
Dies ist ein Typ, der zum Speichern der Prozessorzeit geeignet ist.
3time_t ist
Dies ist ein Typ, der zum Speichern der Kalenderzeit geeignet ist.
4struct tm
Dies ist eine Struktur, die zum Speichern von Zeit und Datum verwendet wird.

Die tm-Struktur ist wie folgt definiert:

struct tm {
   int tm_sec;         /* 秒,范围从 0 到 59        */
   int tm_min;         /* 分,范围从 0 到 59        */
   int tm_hour;        /* 小时,范围从 0 到 23        */
   int tm_mday;        /* 一月中的第几天,范围从 1 到 31    */
   int tm_mon;         /* 月,范围从 0 到 11        */
   int tm_year;        /* 自 1900 年起的年数        */
   int tm_wday;        /* 一周中的第几天,范围从 0 到 6    */
   int tm_yday;        /* 一年中的第几天,范围从 0 到 365    */
   int tm_isdst;       /* 夏令时                */
};

Bibliotheksmakros

Nachfolgend sind die Makros aufgeführt, die in der Header-Datei time.h definiert sind:

Laufende NummerMakro & Beschreibung
1NULL
Dieses Makro ist der Wert einer Nullzeigerkonstante.
2CLOCKS_PER_SEC
Dieses Makro repräsentiert die Anzahl der Prozessortakte pro Sekunde.

Bibliotheksfunktionen

Nachfolgend sind die Funktionen aufgeführt, die in der Header-Datei time.h definiert sind:

Laufende NummerFunktion & Beschreibung
1char *asctime(const struct tm *timeptr)
Gibt einen Zeiger auf eine Zeichenkette zurück, die Datum und Uhrzeit der Struktur timeptr darstellt.
2clock_t clock(void)
Gibt die Menge an Prozessorzeit zurück, die seit Beginn der Programmausführung verwendet wurde (im Allgemeinen der Programmstart).
3char *ctime(const time_t *timer)
Gibt eine Zeichenkette zurück, die die lokale Zeit basierend auf dem Parameter timer darstellt.
4double difftime(time_t time1, time_t time2)
Gibt die Differenz in Sekunden zwischen time1 und time2 zurück (time1-time2).
5struct tm *gmtime(const time_t *timer)
Der Wert von timer wird in eine tm-Struktur zerlegt und in Coordinated Universal Time (UTC) ausgedrückt, auch bekannt als Greenwich Mean Time (GMT).
6struct tm *localtime(const time_t *timer)
Der Wert von timer wird in eine tm-Struktur zerlegt und in der lokalen Zeitzone ausgedrückt.
7time_t mktime(struct tm *timeptr)
Konvertiert die Struktur, auf die timeptr zeigt, in einen time_t-Wert basierend auf der lokalen Zeitzone.
8size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)
Formatiert die durch die Struktur timeptr dargestellte Zeit gemäß den in format definierten Formatierungsregeln und speichert sie in str.
9time_t time(time_t *timer)
Berechnet die aktuelle Kalenderzeit und kodiert sie in das time_t-Format.
10int timespec_get(struct timespec *ts, int base);
Ruft die aktuelle Zeit ab (C11).

Beispiel

Das Folgende verwendet<time.h>Beispiele für einige Funktionen in

Aktuelle Zeit abrufen:

Beispiel

#include <stdio.h>
#include <time.h>

int main() {
    time_t current_time;
    time(&current_time);
    printf("Aktuelle Zeit: %s", ctime(&current_time));

    return 0;
}

Zeit formatieren:

Beispiel

#include <stdio.h>
#include <time.h>

int main() {
    time_t current_time;
    struct tm *time_info;
    char buffer[80];

    time(&current_time);
    time_info = localtime(&current_time);

    strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", time_info);
    printf("Formatierte Zeit: %s\n", buffer);

    return 0;
}

Zeitdifferenz berechnen:

Beispiel

#include <stdio.h>
#include <time.h>

int main() {
    time_t start_time, end_time;
    double time_diff;

    time(&start_time);
    // Simuliere eine zeitaufwändige Operation
    for (int i = 0; i < 100000000; i++);

    time(&end_time);
    time_diff = difftime(end_time, start_time);
    printf("Zeitdifferenz: %.2f Sekunden\n", time_diff);

    return 0;
}

Verwendungstruct tm:

Beispiel

#include <stdio.h>
#include <time.h>

int main() {
    struct tm time_info;
    char buffer[80];

    time_info.tm_year = 2024 - 1900;  // Das Jahr wird ab 1900 berechnet
    time_info.tm_mon = 5;             // Juni, Bereich von 0 bis 11
    time_info.tm_mday = 12;
    time_info.tm_hour = 12;
    time_info.tm_min = 0;
    time_info.tm_sec = 0;
    time_info.tm_isdst = -1;          // Automatisch bestimmen, ob Sommerzeit gilt

    mktime(&time_info);

    strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", &time_info);
    printf("Benutzerdefinierte Zeit: %s\n", buffer);

    return 0;
}

Hinweise

  • NutzunglocaltimeundgmtimeWenn, der zurückgegebene Zeiger zeigt aufstruct tmDie Struktur wird statisch gespeichert, und jeder Aufruf überschreibt den vorherigen Inhalt.
  • NutzungmktimeBei Verwendung der Funktion muss sichergestellt werdenstruct tmDie verschiedenen Felder darin sind gültig.
  • NutzungstrftimeStellen Sie bei der Zeitformatierung sicher, dass der Zielpuffer groß genug ist, um einen Pufferüberlauf zu vermeiden.

Durch das Verstehen und Verwenden<time.h>Die bereitgestellten Funktionen erleichtern die Manipulation von Datum und Uhrzeit und ermöglichen das Schreiben funktionsreicherer und effizienterer C-Programme.

Weitere Erweiterungen