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.