NOM
ftime - Obtenir la date et l’heure
SYNOPSIS
#include <sys/timeb.h>
int ftime(struct timeb *tp);
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 (EPOCH) 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 d’été s’applique pendant la partie appropriée
de l’année.
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 cas d’erreur de -1).
CONFORMITÉ
BSD 4.2, POSIX.1-2001. POSIX.1-2008 supprime la spécification de
ftime().
Cette fonction est obsolète. Ne l’utilisez pas. Si la précision en
seconde vous suffit, utilisez time(2). Sinon gettimeofday(2) fournit
des microsecondes, et clock_gettime(2) des nanosecondes, mais elle
n’est pas disponible sur tous les systèmes.
BOGUES
Sous libc4 et libc5, le champ millitm est sans signification. Les
premières versions de la glibc2 étaient boguées, et renvoyaient
toujours 0 dans ce champ. La glibc 2.1.1 est correcte.
VOIR AUSSI
gettimeofday(2), time(2)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».