ftime

ИМЯ

ftime - возвращает дату и время

LIBRARY

Standard C library ( libc, -lc)

СИНТАКСИС

#include <sys/timeb.h>

int ftime(struct timeb *tp);

ОПИСАНИЕ

NOTE: This function is no longer provided by the GNU C library. Use clock_gettime(2) instead. Данная функция возвращает текущее время в секундах и миллисекундах, прошедших начиная с эпохи (Epoch), 1970-01-01 00:00:00 +0000 (UTC). Время возвращается в tp, определённой следующим образом:

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

В данной структуре time — это количество секунд с начала эпохи; millitm — количество миллисекунд, прошедших после time секунд с начала эпохи. Поле timezone — локальный часовой пояс, измеряемый в минутах западнее Гринвича (отрицательные значения означают минуты восточнее Гринвича). Поле dstflag — флаг, ненулевое значение которого указывает, что в соответствующее время года используется летнее время. В POSIX.1-2001 сказано, что содержимое полей timezone и dstflag не определено; не используйте их.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

Эта функция всегда возвращает 0 (в POSIX.1-2001, а также в некоторых системах возвращается -1 при ошибке).

ВЕРСИИ

Starting with glibc 2.33, the ftime() function and the <sys/timeb.h> header have been removed. To support old binaries, glibc continues to provide a compatibility symbol for applications linked against glibc 2.32 and earlier.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
ftime()	Безвредность в нитях	MT-Safe

СТАНДАРТЫ

4.2BSD, POSIX.1-2001. В POSIX.1-2008 спецификация ftime() удалена. Эта функция устарела. Не используйте её. В случаях, когда достаточно секунд, можно использовать time(2); gettimeofday(2) позволяет работать с микросекундами; функция clock_gettime(3) позволяет работать с наносекундами, однако она пока ещё не очень широко распространена.

ДЕФЕКТЫ

Ранние версии glibc2 работают некорректно и возвращают 0 в поле millitm; начиная с glibc 2.1.1 эта ошибка исправлена.

СМ. ТАКЖЕ

gettimeofday(2), time(2)

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Azamat Hackimov <[email protected]>, Dmitry Bolkhovskikh <[email protected]>, Yuri Kozlov <[email protected]> и Иван Павлов <[email protected]> Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на [email protected]