Назва
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 не описує можливі помилки цієї функції.