NAZWA

       ftime - zwraca datę i czas

SKŁADNIA

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

OPIS

       Funkcja  zwraca  bieżący  czas  jako  sekundy  i milisekundy od początku epoki, 1970-01-01
       00:00:00 +0000 (UTC). Czas jest zwracany w strukturze tp, zadeklarowanej następująco:

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

       time jest tu liczbą sekund od początku epoki, millitm jest  liczbą  milisekund  od  chwili
       time  sekund  od  początku  epoki,  timezone  jest przesunięciem czasu dla lokalnej strefy
       czasowej, mierzonym w minutach w kierunku na zachód od Greenwich (z  ujemnymi  wartościami
       oznaczającymi  wschód  od  Greenwich),  a  dstflag  jest znacznikiem, który jeśli jeśli ma
       wartość niezerową, wskazuje, że w danej części roku obowiązuje lokalnie czas letni.

       POSIX.1-2001 mówi, że zawartość pól timezone i dstflag nie jest określona, prosimy  unikać
       zależenia od tych pól.

WARTOŚĆ ZWRACANA

       Funkcja  zawsze zwraca 0. (POSIX.1-2001 określa, a niektóre systemy dokumentują, zwracanie
       -1 w przypadku błędu).

ATRYBUTY

   Wielowątkowość (patrz pthreads(7))
       Funkcja ftime() jest bezpieczna dla wątków.

ZGODNE Z

       4.2BSD, POSIX.1-2001. POSIX.1-2008 usuwa opis ftime().

       Funkcja ta jest przestarzała. Nie należy jej używać. Jeśli  wystarczy  czas  w  sekundach,
       można  używać  time(2);  gettimeofday(2)  zwraca  czas  w mikrosekundach; clock_gettime(2)
       zwraca nanosekundy, lecz nie jest tak powszechnie dostępna.

BŁĘDY IMPLEMENTACJI

       Wczesne wersje glibc2 miały błąd i zwracały 0 w polu millitm; glibc  2.1.1  zachowuje  się
       znowu poprawnie.

ZOBACZ TAKŻE

       gettimeofday(2), time(2)

O STRONIE

       Angielska  wersja  tej  strony  pochodzi  z  wydania  3.71  projektu Linux man-pages. Opis
       projektu, informacje dotyczące zgłaszania błędów, oraz najnowszą  wersję  oryginału  można
       znaleźć pod adresem http://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej   strony   podręcznika   man  są:  Andrzej
       Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl>, Robert Luberda  <robert@debian.org>  i  Michał
       Kułach <michal.kulach@gmail.com>.

       Polskie  tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na
       stronie  http://sourceforge.net/projects/manpages-pl/.  Jest   zgodne   z   wersją    3.71
       oryginału.