DB2 日期時間函數完整參考：抽取、運算、格式化、時區轉換與自訂函數範例

前言

DB2 提供豐富的內建日期時間函數，支援抽取元件、日期運算、格式化輸出、時區調整與差異計算。本文整理完整函數清單、常用語法範例、時區處理技巧、自訂精確秒差函數與閏年判斷函數。

一、元件抽取函數

二、日期時間運算 (自然語言語法)

DB2 支援直觀的英文關鍵字運算：

CURRENT DATE + 1 YEAR
CURRENT DATE + 3 YEARS + 2 MONTHS + 15 DAYS
CURRENT TIME + 5 HOURS - 3 MINUTES + 10 SECONDS
CURRENT TIMESTAMP - 2 DAYS

• 關鍵字不分大小寫，複數單數皆可 (YEAR/YEARS)。
• 運算結果保持原資料型別 (DATE/TIME/TIMESTAMP)。

三、型別轉換與擷取

DATE(CURRENT TIMESTAMP)      -- 擷取日期部分 → DATE
TIME(CURRENT TIMESTAMP)      -- 擷取時間部分 → TIME
TIMESTAMP(CURRENT DATE)      -- 日期轉 TIMESTAMP (時間歸零)
TIMESTAMP('2024-10-15 14:30:00')  -- 字串轉 TIMESTAMP
DATE('2024-10-15')           -- 字串轉 DATE (支援 ISO, USA, EUR, JIS 格式)
TIME('14:30:00')             -- 字串轉 TIME

四、格式化輸出

常用格式元素：YYYY, MM, DD, HH24, MI, SS, MS (毫秒), US (微秒), AM/PM, MON (月份縮寫), DY (星期縮寫)。

五、字串轉 TIMESTAMP (解析)

TIMESTAMP_FORMAT('2024-10-15 14:30:45', 'YYYY-MM-DD HH24:MI:SS')
TO_DATE('2024-10-15', 'YYYY-MM-DD')          -- 同義詞
TO_TIMESTAMP('2024-10-15 14:30:45', 'YYYY-MM-DD HH24:MI:SS')

六、時區調整

-- 目前 Session 時區位移 (例如 +08:00 → 8*3600 = 28800 秒)
CURRENT TIMEZONE

-- 將本地時間轉為 UTC
CURRENT TIMESTAMP - CURRENT TIMEZONE
CURRENT TIME - CURRENT TIMEZONE

資料庫層面時區由註冊表 DB2_TIMEZONE 或 OS 環境變數 TZ 決定。

七、日期時間差異計算

7.1 TIMESTAMPDIFF (估算值，假設每月 30 天)

TIMESTAMPDIFF(16, CHAR(TIMESTAMP('2024-11-30') - TIMESTAMP('2024-11-08')))  -- 16=天數 → 22

7.2 精確秒差 (自訂函數)

CREATE FUNCTION secondsdiff(t1 TIMESTAMP, t2 TIMESTAMP)
RETURNS BIGINT
LANGUAGE SQL
DETERMINISTIC
NO EXTERNAL ACTION
READS SQL DATA
RETURN (DAYS(t1) - DAYS(t2)) * 86400 + (MIDNIGHT_SECONDS(t1) - MIDNIGHT_SECONDS(t2));

• DAYS(dt)：從 0001-01-01 起的天數整數。
• MIDNIGHT_SECONDS(t)：午夜至該時間的秒數 (0-86399)。
• 此函數精確至秒，考慮閏年、實際月長。

八、閏年判斷與年間天數函數

CREATE FUNCTION days_in_year(yr INT)
RETURNS INT
LANGUAGE SQL
DETERMINISTIC
NO EXTERNAL ACTION
READS SQL DATA
RETURN CASE
    WHEN MOD(yr, 400) = 0 THEN 366
    WHEN MOD(yr, 100) = 0 THEN 365
    WHEN MOD(yr, 4) = 0 THEN 366
    ELSE 365
END;

九、其他實用函數

結語

熟練掌握 DB2 日期時間函數體系，能優雅解決「本月第一天」、「上季末日」、「精確齡數計算」、「跨時區報表」等常見需求。建議將自訂 secondsdiff、days_in_year 納入專案共用函數庫。