NANOSECONDS_ADD

설명

나노초 정밀도를 유지하면서 TIMESTAMP_NS 값에 지정한 나노초 수를 더합니다.

구문

NANOSECONDS_ADD(<timestamp_ns>, <delta>)

매개변수

매개변수	설명
<timestamp_ns>	기준값으로, 타입은 TIMESTAMP_NS입니다.
<delta>	더할 나노초 수로, 타입은 BIGINT입니다. 음수이면 나노초를 뺍니다.

반환값

TIMESTAMP_NS를 반환합니다. 인수 중 하나라도 NULL이면 NULL을 반환합니다. 결과가 TIMESTAMP_NS 범위를 벗어나면 오류가 발생합니다.

예제

SELECT NANOSECONDS_ADD(
    CAST('1969-12-31 23:59:59.999999999' AS TIMESTAMP_NS), 1
) AS result;

+-------------------------------+
| result                        |
+-------------------------------+
| 1970-01-01 00:00:00.000000000 |
+-------------------------------+

delta가 음수이면 나노초를 뺍니다:

SELECT NANOSECONDS_ADD(
    CAST('1970-01-01 00:00:00.000000001' AS TIMESTAMP_NS), -2
) AS result;

+-------------------------------+
| result                        |
+-------------------------------+
| 1969-12-31 23:59:59.999999999 |
+-------------------------------+

SELECT NANOSECONDS_ADD(CAST(NULL AS TIMESTAMP_NS), 1) AS result;

+--------+
| result |
+--------+
| NULL   |
+--------+