시간 관련 예제

시간 관련 예제

📌
실습을 위해 아래 쿼리를 먼저 실행해 테이블과 데이터를 준비해 두십시오.
CREATE TAG TABLE IF NOT EXISTS EXAMPLE (
    NAME VARCHAR(20) PRIMARY KEY,
    TIME DATETIME BASETIME,
    VALUE DOUBLE SUMMARIZED
);
INSERT INTO EXAMPLE VALUES('TAG0', TO_DATE('2021-08-12 12:00:00 123:456:789'), 10);
INSERT INTO EXAMPLE VALUES('TAG0', TO_DATE('2021-08-13 12:00:00 123:456:789'), 11);

TQL은 다양한 Time 관련 함수를 제공합니다.

시간 함수

Now

time("now")는 현재 시각을 반환합니다.

SQL(`select to_char(time), value from example where time < ?`, time('now'))
CSV()

결과

2021-08-12 12:00:00 123:456:789,10
2021-08-13 12:00:00 123:456:789,11

Timestamp

time(epoch)는 나노초 단위 Unix epoch 값을 time으로 변환합니다.

SQL(`select to_char(time), value from example where time = ?`, time(1628737200123456789))
CSV()

시간 변환

TQL을 이용해 Timestamp시간 문자열을 손쉽게 변환할 수 있습니다.

Timestamp → 시간 문자열

아래 코드를 time_to_format.tql로 저장합니다.

STRING(param("format_time") ?? "808210800", separator('\n'))
SCRIPT({
    epoch = parseInt($.values[0])
    time = new Date(epoch*1000)
    $.yield(epoch, time.toISOString())
})
CSV()

http://127.0.0.1:5654/db/tql/time_to_format.tql?format_time=808210800000000001

시간 문자열 → Timestamp

아래 코드를 format_to_time.tql로 저장합니다.

STRING(param("timestamp") ?? "1995-08-12T00:00:00.000Z", separator('\n'))
SCRIPT({
    ts = new Date(Date.parse($.values[0]));
    epoch = ts.getTime() / 1000;
    $.yield(epoch, ts.toISOString())
})
CSV()

http://127.0.0.1:5654/db/tql/format_to_time.tql?timestamp=1995-08-12T00:00:00.000Z

출력 포맷

출력 시 시간 값을 어떤 형식으로 표현할지 지정할 수 있습니다.

None (기본)

SQL(`select to_char(time), time from example`)
CSV()

결과

2021-08-12 12:00:00 123:456:789,1628737200123456789
2021-08-13 12:00:00 123:456:789,1628823600123456789

Default

SQL(`select to_char(time), time from example`)
CSV(timeformat('DEFAULT'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-12 03:00:00.123
2021-08-13 12:00:00 123:456:789,2021-08-13 03:00:00.123

Additional Default Types

TypeDescription
DEFAULT_MS2006-01-02 15:04:05.999
DEFAULT_US2006-01-02 15:04:05.999999
DEFAULT_NS2006-01-02 15:04:05.999999999
DEFAULT.MS2006-01-02 15:04:05.000
DEFAULT.US2006-01-02 15:04:05.000000
DEFAULT.NS2006-01-02 15:04:05.000000000

Numeric 포맷

SQL(`select to_char(time), time from example`)
CSV(timeformat('NUMERIC'))

결과

2021-08-12 12:00:00 123:456:789,08/12 03:00:00AM '21 +0000
2021-08-13 12:00:00 123:456:789,08/13 03:00:00AM '21 +0000

Ansic 포맷

SQL(`select to_char(time), time from example`)
CSV(timeformat('ANSIC'))

결과

2021-08-12 12:00:00 123:456:789,Thu Aug 12 03:00:00 2021
2021-08-13 12:00:00 123:456:789,Fri Aug 13 03:00:00 2021

Unix 포맷

SQL(`select to_char(time), time from example`)
CSV(timeformat('NUMERIC'))

결과

2021-08-12 12:00:00 123:456:789,Thu Aug 12 03:00:00 UTC 2021
2021-08-13 12:00:00 123:456:789,Fri Aug 13 03:00:00 UTC 2021

RFC822 포맷

SQL(`select to_char(time), time from example`)
CSV(timeformat('RFC822'))

결과

2021-08-12 12:00:00 123:456:789,12 Aug 21 03:00 UTC
2021-08-13 12:00:00 123:456:789,13 Aug 21 03:00 UTC

RFC3339 포맷

SQL(`select to_char(time), time from example`)
CSV(timeformat('RFC3339'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-12T03:00:00Z
2021-08-13 12:00:00 123:456:789,2021-08-13T03:00:00Z

시간대

tz() 함수를 사용해 시간대를 지정할 수 있습니다.

Local

SQL(`select to_char(time), time from example`)
CSV(timeformat('DEFAULT'), tz('local'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-12 12:00:00.123
2021-08-13 12:00:00 123:456:789,2021-08-13 12:00:00.123

UTC

SQL(`select to_char(time), time from example`)
CSV(timeformat('DEFAULT'), tz('UTC'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-12 03:00:00.123
2021-08-13 12:00:00 123:456:789,2021-08-13 03:00:00.123

Seoul

SQL(`select to_char(time), time from example`)
CSV(timeformat('DEFAULT'), tz('Asia/Seoul'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-12 12:00:00.123
2021-08-13 12:00:00 123:456:789,2021-08-13 12:00:00.123

EST

SQL(`select to_char(time), time from example`)
CSV(timeformat('DEFAULT'), tz('EST'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-11 22:00:00.123
2021-08-13 12:00:00 123:456:789,2021-08-12 22:00:00.123

Paris

SQL(`select to_char(time), time from example`)
CSV(timeformat('DEFAULT'), tz('Europe/Paris'))

결과

2021-08-12 12:00:00 123:456:789,2021-08-12 05:00:00.123
2021-08-13 12:00:00 123:456:789,2021-08-13 05:00:00.123
최근 업데이트