Amazon QLDB 中的 DATE_DIFF 函数 - Amazon Quantum Ledger Database (Amazon QLDB)
语法Arguments返回类型示例相关函数

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon QLDB 中的 DATE_DIFF 函数

在 Amazon QLDB 中，使用 DATE_DIFF 函数返回两个给定时间戳中指定日期部分之间的差值。

语法

DATE_DIFF( datetimepart, timestamp1, timestamp2 )

Arguments

datetimepart

对其执行函数的日期或时间段。该参数可以是下列项之一：

  • year

  • month

  • day

  • hour

  • minute

  • second

timestamp1、timestamp2

函数比较的数据类型 timestamp 的两个字段名称或表达式。如果 timestamp2 晚于timestamp1，则结果为正。如果 timestamp2 早于 timestamp1，则结果为负。

Ion 时间戳文本值可以用反引号 (`...`) 表示。有关时间戳值的格式详细信息和示例，请参阅 Amazon Ion 规格文档中的时间戳。

返回类型

int

示例

DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010-12T`, `2011-01T`)                  -- 0 (must be at least 12 months apart to evaluate as a 1 year difference)
DATE_DIFF(month, `2010T`, `2010-05T`)                    -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(month, `2010-12-31T`, `2011-01-01T`)           -- 0 (must be at least a full month apart to evaluate as a 1 month difference)
DATE_DIFF(day, `2010-01-01T23:00Z`, `2010-01-02T01:00Z`) -- 0 (must be at least 24 hours apart to evaluate as a 1 day difference)

-- Runnable statements
SELECT DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`) FROM << 0 >> -- 1
SELECT DATE_DIFF(month, `2010T`, `2010-05T`) FROM << 0 >>         -- 4

相关函数