ftime − Obtenir la date et l’heure.

#include <sys/timeb.h>

int ftime (struct timeb *tp);

La fonction ftime() mémorise la date et l’heure 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, millitm contient jusqu’à 1000 millisecondes depuis time, timezone est le fuseau horaire local (mesuré en minutes de temps à l’Ouest de Greenwich) et dstflag est un drapeau indiquant, s’il est non-nul que le décalage horaire d’été s’applique.

De nos jours, le contenu de timezone et dstflag est indéfini.

Cette fonction renvoie toujours 0.

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 glibc 2 étaient boguées, et renvoyaient toujours 0 dans ce champ. La glibc 2.1.1 est correcte.

La fonction ftime() est apparue dans BSD 4.2.

BSD 4.2, POSIX.1-2001.

gettimeofday(2), time(2)

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 14 août 2006.

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.