Linux Certif

Toute la documentation sur la certification Linux LPI

ftime

NOM

ftime - Obtenir la date et l'heure

SYNOPSIS

#include <sys/timeb.h>

int ftime (struct timeb *tp);

DESCRIPTION

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.

VALEUR RENVOYÉE

Cette fonction renvoie toujours 0.

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 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 22 novembre 2007.

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.