Назва¶

time - повертає час у секундах

Стислий огляд¶

#include <time.h>

time_t time(time_t *t);

Опис¶

Функція time повертає час у секундах, що пройшла з початку Epoch (00:00:00 UTC, 1 Січня 1970 року).

Якщо t не є нульовим (NULL), то значення, що повертається, буде також збережено в пам'яті на яку вказує покажчик t.

Повернені значення¶

При вдалому завершенні роботи функції повертається час у секундах, що пройшов з початку Epoch. При помилці повертається ((time_t)-1), а змінна errno отримує значення помилки.

Коди помилок¶

EFAULT

t вказує на відрізок пам'яті, що знаходиться поза межами доступного адресного простору.

Примітки¶

POSIX.1 визначає значення виразу секунди з початку Epoch, як кількість секунд між заданим часом і початком Epoch, обчислених як перетворення еквівалентного UTC-часу в кінцевий час згідно з формулою naOve; при цьому ігноруються високосні секунди, а всі роки, номер яких поділяється на 4, вважаються високосними. Це значення вiдповідатиме точній кількості секунд між заданим часом і початком Epoch внаслідок ігнорування високосних секунд і через те, що час у годинниках необов'язково синхронізуються згідно стандартного джерела. Намір був, щоб це значення несуперечливим відображенням кількість секунд з початку Epoch. Дивiться POSIX.1 Annex B 2.2.2, для додаткової аргументації.

Відповідність стандартам¶

SVr4, SVID, POSIX, X/OPEN, BSD 4.3. У BSD 4.3 цей виклик застарів після появи gettimeofday(2). POSIX не описує можливі помилки цієї функції.

Дивіться також¶

ctime(3), date(1), ftime(3), gettimeofday(2)