Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

time — obtenir l’heure calendaire actuelle

La fonction time de <time.h> renvoie une approximation de l’heure calendaire actuelle sous forme de time_t ; vérifiez si le résultat vaut (time_t)(-1).

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <time.h>
time_t time(time_t *timer);

time renvoie la meilleure approximation de l’heure calendaire actuelle que l’implémentation puisse fournir. Lorsque l’heure n’est pas disponible, elle renvoie (time_t)(-1). Vérifiez ce résultat avant d’utiliser la valeur.

L’appel time(NULL) ne fait que renvoyer le résultat. Avec un pointeur non nul, comme dans time(&stored), la fonction stocke également la valeur renvoyée dans l’objet time_t pointé.

L’encodage de l’heure n’est pas spécifié : le code portable ne peut pas supposer qu’il s’agit du nombre de secondes depuis l’époque Unix. L’exemple compare la valeur stockée à celle qui est renvoyée au lieu d’afficher une date qui change.

Exemples

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

int main(void)
{
    time_t stored;
    time_t result = time(&stored);

    if (result == (time_t)(-1)) {
        puts("Time unavailable");
        return 1;
    }

    puts(stored == result ? "Values match" : "Values differ");
    return 0;
}

Résultat

Values match

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources