FTIME

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 23 juin 2008
Index Menu principal

NOM

ftime - Obtenir la date et l'heure

SYNOPSIS

#include <sys/timeb.h>

int ftime(struct timeb *tp);

DESCRIPTION

Cette fonction renvoie la date et l'heure actuelle, en secondes et millisecondes, depuis l'Époque ((00:00:00 UTC, 1er janvier 1970) dans une structure tp, déclarée ainsi :

struct timeb {
    time_t         time;
    unsigned short millitm;
    short          timezone;
    short          dstflag;
};

Ici, time est le temps écoulé en secondes depuis le 1er janvier 1970 à 0h00 et millitm est le nombre de millisecondes depuis time. Le champ timezone est le fuseau horaire local mesuré en minutes de temps à l'Ouest de Greenwich (avec une valeur négative indiquant les minutes à l'Est de Greenwich). dstflag est un drapeau indiquant, s'il est non nul que le décalage horaire s'applique (Ndt : « Daylight Saving Time », ou heure d'été en France).

POSIX.1-2001 indique que le contenu des champs timezone et dstflag est indéfini, vous ne devez donc pas compter sur eux.

VALEUR RENVOYÉE

Cette fonction renvoie toujours 0. (POSIX.1-2001 indique, et certains systèmes documentent une valeur de retour en erreur de -1.)

CONFORMITÉ

BSD 4.2, POSIX.1-2001.

BOGUES

Cette fonction est obsolète. Ne l'utilisez pas. Si la précision de la seconde vous suffit, utilisez time(2). Sinon gettimeofday(2) fournit des microsecondes, et clock_gettime(3) des nanosecondes, mais n'est pas disponible partout.

Sous libc 4 et libc 5, le champ millitm est sans signification. Les premières publications de la glibc 2 étaient boguées, et renvoyaient toujours 0 dans ce champ. La glibc 2.1.1 est correcte.

VOIR AUSSI

gettimeofday(2), time(2)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 26 octobre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 ftime ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008