카테고리:

날짜 및 시간 함수

DATEDIFF

요청된 날짜 또는 시간 부분을 기반으로 두 날짜, 시간 또는 타임스탬프 식 간의 차이를 계산합니다. 함수는 세 번째 인자에서 두 번째 인자를 뺀 결과를 반환합니다.

빼기 기호(-)를 사용하여 날짜를 뺄 수도 있습니다.

참고 항목:

TIMEDIFF , TIMESTAMPDIFF

구문

DATEDIFF의 경우

DATEDIFF( <date_or_time_part>, <date_or_time_expr1>, <date_or_time_expr2> )

빼기 기호의 경우

<date_expr2> - <date_expr1>

인자

DATEDIFF의 경우:

date_or_time_part

The unit of time. Must be one of the values listed in 지원되는 날짜 및 시간 부분 (e.g. month). The value can be a string literal or can be unquoted (e.g. 'month' or month).

date_or_time_expr1, date_or_time_expr2

The values to compare. Must be a date, a time, a timestamp, or an expression that can be evaluated to a date, a time, or a timestamp. The value date_or_time_expr1 is subtracted from date_or_time_expr2.

빼기 기호의 경우:

date_expr1, date_expr2

The values to compare. Must be a date, or an expression that can be evaluated to a date. The value date_expr1 is subtracted from date_expr2.

반환

DATEDIFF의 경우:

date_or_time_expr2date_or_time_expr1 간의 단위(초, 일 등) 차이를 나타내는 정수를 반환합니다.

빼기 기호의 경우:

date_expr2date_expr1 간의 일수 차이를 나타내는 정수를 반환합니다. (단위는 항상 일입니다.)

사용법 노트

DATEDIFF 및 빼기 기호 둘 다의 경우:

  • 출력 값은 음수일 수 있습니다(예: -12일).

DATEDIFF의 경우:

  • date_or_time_expr1date_or_time_expr2 는 날짜, 시간 또는 타임스탬프일 수 있습니다.

  • The function supports units of years, quarters, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, and nanoseconds.

  • date_or_time_part지원되는 날짜 및 시간 부분 에 나열된 값 중 하나여야 합니다.

    date_or_time_partweek (또는 그 변형)인 경우, 출력은 WEEK_START 세션 매개 변수에 의해 제어됩니다. 예를 포함한 자세한 내용은 달력상의 주 및 요일 섹션을 참조하십시오.

  • 차이를 계산하는 데 사용되는 단위(예: month)는 결과를 결정하는 데 사용되는 DATE, TIME 또는 TIMESTAMP 필드의 부분을 결정하므로 결과의 정밀도를 결정합니다.

    더 작은 단위는 사용되지 않으므로 값은 반올림되지 않습니다. 예를 들어, 2021년 1월 1일과 2021년 2월 28일의 차이가 한 달보다 두 달에 더 가깝더라도 다음은 한 달을 반환합니다.

    DATEDIFF(month, '2021-01-01'::DATE, '2021-02-28'::DATE)
    

    DATE 값의 경우:

    • year 는 연도만 사용하고 다른 모든 부분은 무시합니다.

    • month 는 월과 연도를 사용합니다.

    • day 는 전체 날짜를 사용합니다.

    TIME 값의 경우:

    • hour 는 시간만 사용하고 다른 모든 부분은 무시합니다.

    • minute 는 시 및 분을 사용합니다.

    • second 는 시, 분, 초를 사용하지만 소수 자리 초는 사용하지 않습니다.

    • millisecond 는 시, 분, 초, 그리고 소수 자리 초의 처음 세 자리를 사용합니다. 소수 자리 초는 반올림되지 않습니다. 예를 들어, DATEDIFF(milliseconds, '00:00:00', '00:00:01.1239') 는 1.124초가 아니라 1.123초를 반환합니다.

    • microsecond 는 시, 분, 초, 그리고 소수 자리 초의 처음 여섯 자리를 사용합니다. 소수 자리 초는 반올림되지 않습니다.

    • nanosecond 는 시, 분, 초, 그리고 소수 자리 초의 아홉 자리 모두를 사용합니다.

    TIMESTAMP 값의 경우:

    규칙은 위의 DATE 및 TIME 데이터 타입에 대한 규칙과 일치합니다. 지정된 단위와 더 큰 단위만 사용됩니다.

빼기 기호의 경우:

  • date_expr1date_expr2 는 둘 다 날짜여야 합니다. 시간과 타임스탬프는 허용되지 않습니다.

두 타임스탬프 간의 연도 차이를 계산합니다.

SELECT DATEDIFF(year, '2010-04-09 14:39:20'::TIMESTAMP, 
                      '2013-05-08 23:39:20'::TIMESTAMP) 
               AS diff_years;
+------------+
| DIFF_YEARS |
|------------|
|          3 |
+------------+

두 타임스탬프 간의 시간 차이를 계산합니다.

SELECT DATEDIFF(hour, '2013-05-08T23:39:20.123-07:00'::TIMESTAMP, 
    DATEADD(year, 2, ('2013-05-08T23:39:20.123-07:00')::TIMESTAMP)) 
               AS diff_hours;
+------------+
| DIFF_HOURS |
|------------|
|      17520 |
+------------+

날짜 부분이 DATEDIFF 계산에 어떤 영향을 미치는지 보여줍니다. 또한, 날짜 빼기에 빼기 기호를 사용하는 방법을 보여줍니다.

SELECT column1 date_1, column2 date_2,
      DATEDIFF(year, column1, column2) diff_years,
      DATEDIFF(month, column1, column2) diff_months,
      DATEDIFF(day, column1, column2) diff_days,
      column2::DATE - column1::DATE AS diff_days_via_minus
    FROM VALUES
      ('2015-12-30', '2015-12-31'),
      ('2015-12-31', '2016-01-01'),
      ('2016-01-01', '2017-12-31'),
      ('2016-08-23', '2016-09-07');
+------------+------------+------------+-------------+-----------+---------------------+
| DATE_1     | DATE_2     | DIFF_YEARS | DIFF_MONTHS | DIFF_DAYS | DIFF_DAYS_VIA_MINUS |
|------------+------------+------------+-------------+-----------+---------------------|
| 2015-12-30 | 2015-12-31 |          0 |           0 |         1 |                   1 |
| 2015-12-31 | 2016-01-01 |          1 |           1 |         1 |                   1 |
| 2016-01-01 | 2017-12-31 |          1 |          23 |       730 |                 730 |
| 2016-08-23 | 2016-09-07 |          0 |           1 |        15 |                  15 |
+------------+------------+------------+-------------+-----------+---------------------+

시간 부분이 DATEDIFF 계산에 어떤 영향을 미치는지 보여줍니다.

ALTER SESSION SET TIMESTAMP_NTZ_OUTPUT_FORMAT = 'DY, DD MON YYYY HH24:MI:SS';
SELECT column1 timestamp_1, column2 timestamp_2,
      DATEDIFF(hour, column1, column2) diff_hours,
      DATEDIFF(minute, column1, column2) diff_minutes,
      DATEDIFF(second, column1, column2) diff_seconds
    FROM VALUES
      ('2016-01-01 01:59:59'::TIMESTAMP, '2016-01-01 02:00:00'::TIMESTAMP),
      ('2016-01-01 01:00:00'::TIMESTAMP, '2016-01-01 01:59:00'::TIMESTAMP),
      ('2016-01-01 01:00:59'::TIMESTAMP, '2016-01-01 02:00:00'::TIMESTAMP);
+---------------------------+---------------------------+------------+--------------+--------------+
| TIMESTAMP_1               | TIMESTAMP_2               | DIFF_HOURS | DIFF_MINUTES | DIFF_SECONDS |
|---------------------------+---------------------------+------------+--------------+--------------|
| Fri, 01 Jan 2016 01:59:59 | Fri, 01 Jan 2016 02:00:00 |          1 |            1 |            1 |
| Fri, 01 Jan 2016 01:00:00 | Fri, 01 Jan 2016 01:59:00 |          0 |           59 |         3540 |
| Fri, 01 Jan 2016 01:00:59 | Fri, 01 Jan 2016 02:00:00 |          1 |           60 |         3541 |
+---------------------------+---------------------------+------------+--------------+--------------+
맨 위로 이동