[DATE_FORMAT函數]以計算公式顯示日期或時間

於計算公式使用DATE_FORMAT函數,可更改日期與時間格式或是時區。要將日期或時間與其他字串合併時,也可使用DATE_FORMAT函數。

DATE_FORMAT(計算公式, "日期與時間格式", "時區")

DATE_FORMAT函數的項目可以使用下列任一格式。

函數的格式項目

項目 說明
計算公式

計算公式中可以使用下列欄位。

  • 日期與時間
    日期與時間僅可使用從世界協調時間1970年1月1日 上午0點(日本時間上午9點)至世界協調時間2050年1月1日 上午0點(日本時間上午9點)為止。
  • 日期
    日期僅可使用從1970年1月1日至2286年11月20日為止。
  • 時間
  • 建立時間
  • 更新時間
  • 數值
  • 計算

透過欄位代碼指定欄位。於日期進行時間的加減計算時,需在計算公式中指定以秒為單位的時間。例如,1小時指定為「3600」或是「60*60*1」。若為1天,則指定為「24*60*60*1」。
例:日期 + (60 * 60 * 1)

計算公式結果為數值時,其數值會是UNIX時間。UNIX時間是指自1970年1月1日上午0點(世界協調時間)起至現在的總秒數。也稱作UNIX時間戳。日期與時間是2016年4月1日上午0點(世界協調時間)的話,UNIX時間就是「1459468800」。

UNIX時間 指定不超過10,000,000,000的UNIX時間。
日期與時間格式 指定更改後的日期與時間格式。
關於格式請參閱下列項目。
日期與時間格式的表示方法
時區

指定更改後的時區ID,或是「system」。指定「system」,即為管理員設定的標準時區。
日期欄位或時間欄位的時區,是固定為世界協調時間。若計算公式中使用了這些欄位,就要指定世界協調時間的時區ID「Etc/GMT」。若指定為其他時區,計算結果會不符預期。

各時區的ID請參閱下列頁面。
時區清單(cybozu.com共通管理的說明)

指定含夏令時間的時區時,計算結果會以夏令時間計算。
例如)指定DATE_FORMAT(日期與時間, "YYYY/MM/dd HH:mm ZZ", "America/Los_Angeles")時:
  • 會將2019-01-01 00:00轉換成世界協調時間2018/12/31 07:00 - 08:00。
  • 會將2018-08-01 00:00轉換成世界協調時間2018/07/31 08:00 - 07:00。

日期與時間格式的撰寫格式

指定日期與時間格式時,要使用下表的格式指定元。各個格式指定元將轉換為對應的字串。

格式指定元 說明 2020年4月1日正午轉換後的字串
YYYY或yyyy 轉換為西元年。 2020
MMMM 轉換為編輯記錄使用者所設定的系統語言的月份。 英文:April
日文:4月
中文:四月
MMM 轉換為編輯記錄使用者所設定的系統語言的月份縮寫。 英文:Apr
日文:4
中文:四月
MM 轉換為月份,自動補零。 04
M 轉換為月份,不補零。 4
dd 轉換為日期,自動補零。 01
d 轉換為日期,不補零。 1
a 轉換為編輯記錄使用者所設定的系統語言的「上午」或「下午」。 英文:PM
日文:午後
中文:下午
KK 轉換為以0點至11點表示上午的12小時制時間格式。自動補零。 00
K 轉換為以0點至11點表示上午的12小時制時間格式。不補零。 0
hh 轉換為以1點至12點表示上午的12小時制時間格式。自動補零。 12
h 轉換為以1點至12點表示上午的12小時制時間格式。不補零。 12
HH 轉換為以0點至23點表示1天的24小時制時間格式。自動補零。 12
H 轉換為以0點至23點表示1天的24小時制時間格式。不補零。 12
kk 轉換為以1點至24點表示1天的24小時制時間格式。自動補零。 12
k 轉換為以1點至24點表示1天的24小時制時間格式。不補零。 12
mm 轉換為分鐘顯示,自動補零。 00
m 轉換為分鐘顯示,不補零。 0
ss 轉換為秒數顯示,自動補零。 00
s 轉換為秒數顯示,不補零。 0
Z 轉換為與UTC(世界協調時間)之時差。格式為hhmm。 +0900
ZZ 轉換為與UTC(世界協調時間)之時差。格式為hh:mm。 +09:00
ZZZ 轉換為時區ID。 Asia/Tokyo

計算公式範例

說明如何使用DATE_FORMAT函數的計算公式範例。

計算公式:DATE_FORMAT(欄位A, "YYYY年M月d日", "Etc/GMT")

將欄位A的格式改為○○年○○月○○日。
若欄位A的值為「2020-04-01」,計算結果將為2020年4月1日。
計算公式:DATE_FORMAT(欄位A, "YYYY-MM-dd HH:mm", "America/Los_Angeles")

將欄位A的時區改為太平洋標準時間。
若欄位A的值為「2020-04-01 13:00」,計算結果將為2020-03-31 21:00。
計算公式:欄位A & "-" & DATE_FORMAT(建立時間, "YYYYMMdd", "system")

將欄位A的字串與記錄建立時間相合併。
若欄位A的值為「田中 愛美」,記錄建立時間為「2020-04-01 13:00」,計算結果將為「田中 愛美-20200401」。