Time.h

Time.h

time.h


Dans les langages C et C++, time.h est le fichier d'en-tête de la bibliothèque standard C qui déclare des fonctions fournissant de manière standardisée des primitives de manipulation des dates et leur formatage.

Sommaire

Fonctions

char *asctime(const struct tm* tmptr)
Convertir tmptr en une chaîne de caractères au format Www Mmm dd hh:mm:ss yyyy, où Www est le jour de la semaine, Mmm est le mois en lettres, dd le jour du mois, hh:mm:ss est l'heure, et yyyy est l'année. La chaîne est suivi d'un retour à la ligne et d'un caractère de fin de chaîne, pour un total de 26 caractères. La chaîne donnée en résultat est allouée statiquement et partagée par les fonctions ctime et asctime. A chaque fois, qu'une des deux fonctions et appelée, le contenu cette chaîne est écrasé.
clock_t clock(void)
Retourne une approximation du temps processeur utilisé par le processus.
char* ctime(const time_t* timer)
Convertit la valeur timer en uin chaîne au même format que asctime. La chaîne retournée est allouée statiquement dans une zone partagée avec asctime

ctime also uses internally the buffer used by gmtime and localtime as return value, so a call to this function will overwrite this.

double difftime(time_t timer2, time_t timer1)
Retourne la différence, exprimée en secondes entre deux instants.
struct tm* gmtime(const time_t* timer)
Convertit une valeur de type time_t en une structure tm en temps UTC. Cette structure est allouée statiquement et partagée par les fonctions gmtime, localtime et ctime. A chaque fois qu'une de ces fonctions est appelée, le contenu de la structure est écrasé.
struct tm* gmtime_r(const time_t* timer, struct tm* result)
Convertit une valeur de type time_t en une structure tm en temps UTC. La date est stockée dans le structure tm pointée par result. Ceci est une version compatible avec les threads de gmtime.
struct tm* localtime(const time_t* timer)
Convertit une valeur de type time_t en une structure tm à l'heure locale. Cette structure est allouée statiquement et partagée par les fonctions gmtime, localtime et ctime. A chaque fois qu'une de ces fonctions est appelée, le contenu de la structure est écrasé.
time_t mktime(struct tm* ptm)
Convertit une structure tm en une valeur de type time_t. mktime vérifie la structure tm, en corrigeant les valeurs de ses attributs si elles sont mal renseignées, et traduit cette structure en une valeur time_t qui est retournée. Les valeurs d'origine des champs tm_wday et tm_yday (jour de la semaine et de l'année) de ptm sont ignorées, mais les champs sont remplis avec les valeurs qui correspondent à la date calculée. La valeur de tm_day n'est pas vérifiée jusqu'à ce que tm_wday et tm_yday soient déterminés. En cas d'erreur, la fonction retourne la valeur -1.
time_t time(time_t* timer)
Donne la date courante en heure UNIX (nombre de secondes depuis le 1er janvier 1970). La valeur est stockée dans la zone mémoire pointée par timer. Dans le cas où timer vaut NULL, la valeur est seulement passée en résultat de la fonction.
size_t strftime(char* s, size_t n, const char* format, const struct tm* tptr)
Formate la structure tm en une chaîne de caractères, écrite dans s, qui contient au plus n caractères.

Constantes

CLK_PER_SEC
Constante qui défini le nombre de coups d'horloge par secondes. Elle est utilisée par la fonction clock().
CLOCKS_PER_SEC
Une autre nom de CLK_PER_SEC utilisé par quelques bibliothèques. ;CLK_TCK
Une macro obsolète de CLK_PER_SEC.

Types de données

clock_t
Type de données retourné par clock().
Généralement défini par les types int ou long int.
time_t
Type de données retourné par time().
Généralement défini par les types int ou long int.
struct tm
Représentation humaine et calendaire des dates.

Temps calendaire

La représentation humaine des dates ("broken-down time" en anglais) est représentées dans la bibliothèque standard C par la structure struct tm structure, dont voici les membres:

Membre Description
int tm_hour heure (0 - 23)
int tm_isdst Indicateur sur le décalage entre heure d'hiver et heure d'été: vaut 1 si le décalage est actif, 0 s'il ne l'est pas et une valeur négative si l'information n'est pas disponible.
int tm_mday jour du mois (1 - 31)
int tm_min minutes (0 - 59)
int tm_mon mois (0 - 11, 0 correspond à janvier)
int tm_sec secondes (0 - 60)
int tm_wday jour de la semaine (0-6, 0 correspond à dimanche)
int tm_yday jour de l'année (0 - 365)
int tm_year nombres d'années écoulées depuis 1900

Références

Manual], « Calendar Time » 

Specifications], « gmtime » 

Ce document provient de « Time.h ».

Wikimedia Foundation. 2010.

Contenu soumis à la licence CC-BY-SA. Source : Article Time.h de Wikipédia en français (auteurs)

Игры ⚽ Нужен реферат?

Regardez d'autres dictionnaires:

  • Time — Time, n.; pl. {Times}. [OE. time, AS. t[=i]ma, akin to t[=i]d time, and to Icel. t[=i]mi, Dan. time an hour, Sw. timme. [root]58. See {Tide}, n.] 1. Duration, considered independently of any system of measurement or any employment of terms which… …   The Collaborative International Dictionary of English

  • time — [tīm] n. [ME < OE tima, prob. < IE * dī men < base * dā(i) , to part, divide up > TIDE1] I duration; continuance 1. indefinite, unlimited duration in which things are considered as happening in the past, present, or future; every… …   English World dictionary

  • Time — • Article explores two questions, What are the notes, or elements, contained in the subjective representation of time? and To what external reality does this representation correspond? Catholic Encyclopedia. Kevin Knight. 2006. Time     Time …   Catholic encyclopedia

  • Time's Up! — is a grassroots environmental group that seeks to promote a more sustainable, less toxic New York City. For 20 years, it has been committed to improving the environment by empowering individuals to become active in their community. In New York… …   Wikipedia

  • TIME — (magazine) Pour les articles homonymes, voir Time.  Time Magazine {{{nomorigine}}} …   Wikipédia en Français

  • time — ► NOUN 1) the indefinite continued progress of existence and events in the past, present, and future, regarded as a whole. 2) a point of time as measured in hours and minutes past midnight or noon. 3) the favourable or appropriate moment to do… …   English terms dictionary

  • TIME — Erstausgabe 1923 Beschreibung Nachrichtenmagazi …   Deutsch Wikipedia

  • Time — Time …   Deutsch Wikipedia

  • Time.h — Saltar a navegación, búsqueda time.h es un archivo de cabecera de la biblioteca estándar del lenguaje de programación C que contiene funciones para manipular y formatear la fecha y hora del sistema. Contenido 1 Funciones 2 Constantes 3 Tipo …   Wikipedia Español

  • Time UK — is a computer retailer set up by the people behind the failed Time Computer Systems.The company is based within the main factory offices at Time Technology Park in Simonstone, near Burnley in Lancashire. The company specializes in providing… …   Wikipedia

  • TIME — Premier élément d’un gigantesque empire de presse dont l’histoire est intimement liée à l’action d’une des plus fortes personnalités du journalisme américain, Henry R. Luce (1903 1967), et à son ami Britton Hadden. La création du Time Weekly News …   Encyclopédie Universelle

Share the article and excerpts

Direct link
Do a right-click on the link above
and select “Copy Link”