CURRENT_DATE函數用於擷取指定時區time_zone的當前日期,並以DATE類型返回。
命令格式
DATE CURRENT_DATE([STRING <time_zone>])
-- 標準樣本。
-- 返回2025-09-24。
SELECT CURRENT_DATE('Asia/Shanghai');參數說明
time_zone:可選。指定時區,STRING類型。例如Asia/Shanghai或UTC+08:00或+8。若未指定時區,則預設為當前Session/Project的時區。
說明
若未修改過專案時區,則預設為東八區(UTC+08:00)。
傳回值說明
返回DATE類型。若輸入參數為NULL,則返回NULL。
使用樣本
下述樣本中,當前專案時區設定為Asia/Shanghai,時間為2025-09-24 17:08:32.274。
樣本1:預設time_zone,擷取當前Session/Project時區的時間值。
-- 返回當前Session/Project時區的日期。 -- 返回2025-09-24。 SELECT CURRENT_DATE();樣本2:擷取夏威夷時區(UTC-10:00)的當前日期。
-- 返回2025-09-23。 SELECT CURRENT_DATE('Pacific/Honolulu'); -- 等價於上面寫法,返回2025-09-23。 SELECT CURRENT_DATE('UTC-10:00'); -- 等價於上面寫法,返回2025-09-23。 SELECT CURRENT_DATE('-10');樣本3:若輸入參數為NULL,則返回NULL。
-- 返回NULL。 SELECT CURRENT_DATE(NULL);
相關函數
CURRENT_DATE函數屬於日期函數,更多日期計算、日期轉換的相關函數請參見日期函數。