TIME(2)

이름
time - 초 단위로 시간을 얻는다.

사용법
#include <time.h>

time_t time(time_t *t);

설명
time 는 시간을 초 단위로 계산하여 Epoch (00:00:00 UTC, January 1, 1970) 이후의 시간을 리턴한다. t가 NULL이 아니라면, 반환값은 항상 t가 가리키는 메모리에 저장된다.

반환값
성공하면, Epoch 이후의 시간이 초 딘위로 리턴된다. 에러이면, ((time_t)-1)이 리턴되며, errno는 적당한 값으로 설정된다.

에러

EFAULT
    t 가 가리키는 곳은 접근할 수 있는 메모리 영역을 넘어선다.

주의
POSIX.1은 secondssincetheEpoch를 지정된 시간과 Epoch사이의 초 단위 값으로써 정의한다. 이것은 윤초(leap seconds)는 무시되며 모든 년수를 4로 나누어 윤년인지를 보는 기본 변환 공식에 따라 UTC를 바꾼 것이다. 이 값은 그 시간과 Epoch 사이의 실제 초 시간과는 같지 않다. 왜냐하면, 윤초(leap seconds) 때문에, clock 시간이 표준과 동기화되어 있지 않기 때문이다. 이것은 Epoch 이후의 시간값을 일관되게 다루기 위한 의도이다: 좀더 이론적 근거를 원한다면 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)

역자
정강훈 <skyeyes@soback.kornet.net>, 2000년 5월 1일