getdate(3) - wariua/manpages-ko GitHub Wiki

getdate, getdate_r - 날짜-시간 문자열을 분할 시간으로 변환하기

#include <time.h>

struct tm *getdate(const char *string);

extern int getdate_err;

#include <time.h>

int getdate_r(const char *string, struct tm *res);

glibc 기능 확인 매크로 요건 (feature_test_macros(7) 참고):

getdate():

_XOPEN_SOURCE >= 500

getdate_r():

_GNU_SOURCE

getdate() 함수는 string이 가리키는 버퍼에 담긴 날짜 및 시간 문자열 표현을 분할 시간으로 변환한다. 분할 시간을 tm 구조체에 저장해서 그 구조체에 대한 포인터를 함수 결과로 반환한다. 그 tm 구조체는 정적 저장 공간에 할당돼 있으므로 이어서 getdate()를 또 호출하면 덮어 써지게 된다.

(format 인자가 있는) strptime(3)과 달리 getdate()에서는 파일에서 얻은 형식들을 사용한다. 그 파일의 전체 경로명을 환경 변수 DATEMSK로 받는다. 주어진 입력 문자열에 맞는 파일 내의 첫 행을 변환에 쓴다.

맞는지 확인할 때 대소문자를 무시한다. 패턴이나 변환할 문자열 내의 잉여 공백은 무시한다.

strptime(3)의 변환 지정 항목들이 패턴에 포함될 수 있다. POSIX.1-2001에는 변환 지정 항목 한 가지가 추가로 명세돼 있다.

%Z가 있으면 분할 시간을 담는 구조체를 주어진 시간대의 현재 시간에 해당하는 값들로 초기화 한다. 아니면 구조체를 (localtime(3)을 호출한 것처럼) 현재 지역 시간에 해당하는 분할 시간으로 초기화 한다.

주 중 날 번호만 있는 경우에는 그 날을 오늘이나 이후의 첫 해당 날로 받는다.

월만 있는 (년은 없는) 경우에는 그 달을 금월이나 이후의 첫 해당 달로 받는다.

시분초가 없는 경우에는 현재 시분초를 쓴다.

날짜가 없지만 시간은 아는 경우에는 그 시간을 현재 시간이나 이후의 첫 해당 시간으로 받는다.

getdate_r()은 getdate()의 재진입 가능 버전을 제공하는 GNU 확장이다. 전역 변수로 오류를 보고하고 정적 버퍼로 분할 시간을 반환하는 대신 함수 반환 값을 통해 오류를 반환하고 res 인자가 가리키는 호출자 할당 버퍼로 결과 분할 시간을 반환한다.

성공 시 getdate()는 struct tm에 대한 포인터를 반환한다. 아니면 NULL을 반환하며 전역 변수 getdate_err를 아래 있는 오류 번호들 중 하나로 설정한다. errno 변화에 대해선 명세돼 있지 않다.

성공 시 getdate_r()은 0을 반환한다. 오류 시 아래 있는 오류 번호들 중 하나를 반환한다.

getdate_err를 통해서 (getdate()), 또는 함수 결과를 통해서 (getdate_r()) 다음 오류를 반환한다.

DATEMSK

서식 패턴을 담은 파일.

TZ, LC_TIME

strptime(3)에서 쓰는 변수들.

이 절에서 사용하는 용어들에 대한 설명은 attributes(7)를 보라.

POSIX.1-2001, POSIX.1-2008.

POSIX.1의 strptime(3) 명세에는 %E 및 %O 수식자를 이용한 변환 지정 항목이 있지만 getdate()에는 그런 지정 항목이 없다. glibc에서는 getptime(3)으로 getdate()를 구현하고 있으며, 그래서 양쪽에서 정확히 같은 변환들을 지원한다.

아래 프로그램에서는 명령행 인자 각각에 대해 getdate()를 호출하고 각 호출마다 반환된 tm 구조체의 필드 값들을 표시한다. 다음 셸 세션은 프로그램 사용 방식을 보여 준다.

$ TFILE=$PWD/tfile
$ echo '%A' > $TFILE       # 주 중 날짜 이름
$ echo '%T' >> $TFILE      # ISO 날짜 (YYYY-MM-DD)
$ echo '%F' >> $TFILE      # 시간 (HH:MM:SS)
$ date
$ export DATEMSK=$TFILE
$ ./a.out Tuesday '2009-12-28' '12:22:33'
Sun Sep  7 06:03:36 CEST 2008
Call 1 ("Tuesday") succeeded:
    tm_sec   = 36
    tm_min   = 3
    tm_hour  = 6
    tm_mday  = 9
    tm_mon   = 8
    tm_year  = 108
    tm_wday  = 2
    tm_yday  = 252
    tm_isdst = 1
Call 2 ("2009-12-28") succeeded:
    tm_sec   = 36
    tm_min   = 3
    tm_hour  = 6
    tm_mday  = 28
    tm_mon   = 11
    tm_year  = 109
    tm_wday  = 1
    tm_yday  = 361
    tm_isdst = 0
Call 3 ("12:22:33") succeeded:
    tm_sec   = 33
    tm_min   = 22
    tm_hour  = 12
    tm_mday  = 7
    tm_mon   = 8
    tm_year  = 108
    tm_wday  = 0
    tm_yday  = 250
    tm_isdst = 1

#define _GNU_SOURCE
#include <time.h>
#include <stdio.h>
#include <stdlib.h>

int
main(int argc, char *argv[])
{
    struct tm *tmp;
    int j;

    for (j = 1; j < argc; j++) {
        tmp = getdate(argv[j]);

        if (tmp == NULL) {
            printf("Call %d failed; getdate_err = %d\n",
                   j, getdate_err);
            continue;
        }

        printf("Call %d (\"%s\") succeeded:\n", j, argv[j]);
        printf("    tm_sec   = %d\n", tmp->tm_sec);
        printf("    tm_min   = %d\n", tmp->tm_min);
        printf("    tm_hour  = %d\n", tmp->tm_hour);
        printf("    tm_mday  = %d\n", tmp->tm_mday);
        printf("    tm_mon   = %d\n", tmp->tm_mon);
        printf("    tm_year  = %d\n", tmp->tm_year);
        printf("    tm_wday  = %d\n", tmp->tm_wday);
        printf("    tm_yday  = %d\n", tmp->tm_yday);
        printf("    tm_isdst = %d\n", tmp->tm_isdst);
    }

    exit(EXIT_SUCCESS);
}

time(2), localtime(3), setlocale(3), strftime(3), strptime(3)

2019-03-06