localtime_r(3) - 지역시간 struct tm 타입으로 변환(thread-safe)

localtime_r(3)

#include <time.h>

struct tm *localtime_r(const time_t *timep, struct tm *result);

localtime_r(3)함수는 time_t type의 초단위의 시간을 지역 시간(locale정보)의 struct tm type으로 변환하는 함수입니다.

time_t type은 주로 time(2)함수를 이용하여 얻습니다. localtime(3)이 변환된 결과를 local static 변수에 저장하는 것과 달리 localtime_r(3)함수는 data를 변환한 결과 값을 result에 저장하기 때문에 multi-thread에서도 안전한 thread-safte함수입니다.

 

struct tm 구조체는 아래와 같은 구조입니다.

struct tm {
    int tm_sec;    /* 초: 0 ~ 59,(60,61윤초)*/
    int tm_min;    /* 분: 0 ~ 59*/
    int tm_hour;   /* 시: 0 ~ 23 */
    int tm_mday;   /* 일: 1 ~ 31 */
    int tm_mon;    /* 월: 0 ~ 11 (따라서 +1해야 함*/
    int tm_year;   /* 년: + 1900을 해야 함*/
    int tm_wday;   /* 요일: 0 ~ 6 */
    int tm_yday;   /* 1월1일부터 경과된 날수: 0 ~ 365 */
    int tm_isdst;  /* daylight적용여부: 0:적용안됨, -값:유효하지 않음 +값:적용시간*/
};

 

파라미터

timep
    - 주로 time(2)함수의 return값이나 gettimeofday(2)의 struct timeval의 tv_sec 등으로 
      초 단위의 시간을 저장한 변수

result
    - 변환된 데이터를 저장할 buffer.

 

RETURN

NULL 아님
    - 정상적으로 변환이 되었으며 result pointer를 return합니다.
    
NULL
    - 오류가 발생하였습니다.

 

---

활용 예제

 

Sample

#include <time.h>
#include <stdio.h>

int main(int argc, char **argv)
{
    time_t t;
    struct tm lt;
    
    if((t = time(NULL)) == -1) {
        perror("time() call error");
        return -1;
    }

    if(localtime_r(&t, &lt) == NULL) {
        perror("localtime_r() call error");
        return -1;
    }

    printf("지금시간: %04d-%02d-%02d %02d:%02d:%02d\n", 
        lt.tm_year + 1900, lt.tm_mon + 1, lt.tm_mday, 
        lt.tm_hour, lt.tm_min, lt.tm_sec);

    return 0;
}

 

---

 

see also : 시간 관련 함수