Namespaces
Variants

tm

From cppreference.net
Défini dans l'en-tête <time.h>
struct tm ;

Structure contenant une date et une heure calendaires décomposées en leurs composants.

Table des matières

Objets membres

int tm_sec
secondes après la minute – [ 0 , 61 ] (avant C99) [ 0 , 60 ] (depuis C99) [note 1]
(membre public)
int tm_min
minutes après l'heure – [ 0 , 59 ]
(membre public)
int tm_hour
heures depuis minuit – [ 0 , 23 ]
(membre public)
int tm_mday
jour du mois – [ 1 , 31 ]
(membre public)
int tm_mon
mois depuis janvier – [ 0 , 11 ]
(membre public)
int tm_year
années depuis 1900
(membre public)
int tm_wday
jours depuis dimanche – [ 0 , 6 ]
(membre public)
int tm_yday
jours depuis le 1er janvier – [ 0 , 365 ]
(membre public)
int tm_isdst
indicateur d'heure d'été. La valeur est positive si l'heure d'été est en vigueur, zéro si elle ne l'est pas et négative si aucune information n'est disponible
(membre public)
Notes

La norme impose uniquement la présence des membres susmentionnés dans un ordre quelconque. Les implémentations ajoutent généralement davantage de membres de données à cette structure.

  1. La plage permet une seconde intercalaire positive. Deux secondes intercalaires dans la même minute ne sont pas autorisées (la plage C89 0..61 était un défaut)

Exemple

#include <stdio.h>
#include <time.h>
int main(void)
{
    struct tm start = {.tm_year = 2022 - 1900, .tm_mday = 1};
    mktime(&start);
    printf("%s", asctime(&start)); // note implicit trailing '\n'
}

Sortie :

Sat Jan  1 00:00:00 2022

Références

  • Norme C23 (ISO/CEI 9899:2024) :
  • 7.27.1/3 Composants du temps (p: À DÉTERMINER)
  • Norme C17 (ISO/CEI 9899:2018):
  • 7.27.1/3 Composantes du temps (p: 284)
  • Norme C11 (ISO/IEC 9899:2011):
  • 7.27.1/3 Composants du temps (p: 388)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.23.1/3 Composants du temps (p: 338)
  • Norme C89/C90 (ISO/IEC 9899:1990) :
  • 4.12.1 Composants du temps

Voir aussi

convertit le temps depuis l'époque en temps calendaire exprimé en heure locale
(fonction)
convertit le temps depuis l'époque en temps calendaire exprimé en temps universel coordonné (UTC)
(fonction)