[DATE_FORMAT函數]指定日期與時間的顯示格式後顯示
在計算公式中設定DATE_FORMAT函數,可以將日期、時間、日期與時間的值轉換成指定的日期與時間格式的字串。
要將日期或時間與其他字串結合時,也可以使用DATE_FORMAT函數。
DATE_FORMAT函數的語法
DATE_FORMAT(日期與時間, "日期與時間格式", "時區")
在DATE_FORMAT函數中指定第1參數(日期與時間)、第2參數(日期與時間格式)、第3參數(時區)。
第1參數:日期與時間
第1參數指定要指定顯示格式的日期與時間。
以欄位代碼、UNIX時間或計算公式來指定參數。
指定欄位代碼
可指定以下欄位的欄位代碼:
- 日期與時間
- 日期
- 時間
- 建立時間
- 更新時間
- 數值
- 計算
指定數值欄位或計算欄位時,該欄位的值將視為UNIX時間。
指定UNIX時間
可直接指定UNIX時間。
UNIX時間的指定範圍為-30610224000以上、253402300799以下。
指定計算公式
可指定計算公式,對日期與時間進行時間加減,用來指定計算結果的日期與時間。
可使用以下運算符號及函數:
- +
- -
- *
- /
- ^
- SUM函數
要在計算公式中輸入時間時,以秒為單位指定。
例如,1小時指定為「3600」或「60*60*1」。
以下範例為顯示後一天的日期的計算公式。
DATE_FORMAT(日期+24*60*60*1, "YYYY/MM/dd", "Etc/GMT")
第2參數:日期與時間格式
第2參數指定日期與時間的格式。
以下列方法指定日期與時間格式:
- 直接指定日期與時間格式
- 指定欄位代碼
日期與時間格式的指定方法,請參閱「可指定的日期與時間格式」。
以欄位代碼指定時,可指定以下欄位:
- 單行文字方塊
- 多行文字方塊欄位
若想在計算結果中顯示日期與時間格式記載的字串
若想在計算結果中顯示日期與時間格式記載的字串,請用單引號(')括住想顯示的字串。
例如若想將計算結果顯示為「Date: 日期」格式,指定方式如下:
DATE_FORMAT(欄位代碼, "'DATE:' d", "Asia/Tokyo")
想讓單引號(')在計算結果中顯示為文字時,請連續記載兩個單引號「''」。
例如若想將計算結果顯示為「'Date: 日期'」格式,指定方式如下:
DATE_FORMAT(欄位代碼, "'''DATE:' d''", "Asia/Tokyo")
第3參數:時區
第3參數指定時區。
若在第1參數指定時間欄位或日期欄位,時區請指定為「Etc/GMT」(世界協調時間的時區ID)。指定「Etc/GMT」以外的時區可能會使時間或日期產生誤差。
DATE_FORMAT(時間, "hh:mm", "Etc/GMT")
若指定其他欄位或UNIX時間,請指定想顯示的時區。
DATE_FORMAT(日期與時間, "YYYY年M月d日", "Asia/Tokyo")
時區指定為「system」時,將套用在cybozu.com共通管理中設定的時區(系統時區)。
夏令時間的處理方式
指定有夏令時間的時區時,計算結果會反映夏令時間。
以下範例為指定有夏令時間的時區的計算公式。
DATE_FORMAT(日期與時間, "YYYY/MM/dd HH:mm ZZ", "America/Los_Angeles")
此範例的計算結果如下:
- 世界協調時間的「2019-01-01 00:00」將轉換為「2018/12/31 16:00 -08:00」。
- 世界協調時間的「2018-08-01 00:00」將轉換為「2018/07/31 17:00 -07:00」。
可使用DATE_FORMAT函數的欄位
若要顯示DATE_FORMAT函數的計算結果,請在單行文字方塊欄位中使用函數。
在單行文字方塊欄位的「設定」畫面中勾選「自動計算」,輸入計算公式。
在計算欄位中直接顯示DATE_FORMAT函數的計算結果會發生錯誤。
但可以使用在函數中,例如作為IF函數的條件公式使用。
可指定的日期與時間格式
可指定為DATE_FORMAT函數第2參數的日期與時間格式如下:
顯示年份的格式
格式 | 轉換結果範例 | 說明 |
---|---|---|
YYYY | 2020 | 轉換為西元年。也可以使用小寫的「yyyy」。 |
顯示月份的格式
格式 | 轉換結果範例 | 說明 |
---|---|---|
MMMM | April 4月 |
轉換為編輯記錄使用者設定的顯示語言的月份。 |
MMM | Apr 4月 |
轉換為編輯記錄使用者設定的顯示語言的月份。若為英文將顯示縮寫。 |
MM | 04 | 轉換為月份,自動補零。 |
M | 4 | 轉換為月份,不補零。 |
顯示日期的格式
格式 | 轉換結果範例 | 說明 |
---|---|---|
dd | 01 | 轉換為日期,自動補零。 |
d | 1 | 轉換為日期,不補零。 |
顯示小時的格式
格式 | 轉換結果範例 | 說明 |
---|---|---|
a | PM 午後 下午 |
轉換為編輯記錄使用者設定的顯示語言的「上午」或「下午」。 |
KK | 00 | 轉換為小時,以0點至11點為上午的12小時制。自動補零。 正午將轉換為「00」。 |
K | 0 | 轉換為小時,以0點至11點為上午的12小時制。不補零。 正午將轉換為「0」。 |
hh | 12 | 轉換為小時,以1點至12點為上午的12小時制。自動補零。 正午將轉換為「12」。 |
h | 12 | 轉換為小時,以1點至12點為上午的12小時制。不補零。 正午將轉換為「12」。 |
HH | 00 | 轉換為小時,以0點至23點為1天的24小時制。自動補零。 午夜將轉換為「00」。 |
H | 0 | 轉換為小時,以0點至23點為1天的24小時制。不補零。 午夜將轉換為「0」。 |
kk | 24 | 轉換為小時,以1點至24點為1天的24小時制。自動補零。 午夜將轉換為「24」。 |
k | 24 | 轉換為小時,以1點至24點為1天的24小時制。不補零。 午夜將轉換為「24」。 |
顯示分鐘的格式
格式 | 轉換結果範例 | 說明 |
---|---|---|
mm | 05 | 轉換為分鐘,自動補零。 |
m | 5 | 轉換為分鐘,不補零。 |
顯示秒數的格式
kintone處理日期與時間或時間的欄位中,不會儲存秒數。
在第1參數指定欄位代碼後,秒數將視為0秒。
格式 | 轉換結果範例 | 說明 |
---|---|---|
ss | 01 | 轉換為秒數,自動補零。 UNIX時間「1695179101」(2023年9月20日12點5分1秒)將轉換為「01」。 |
s | 1 | 轉換為秒數,不補零。 UNIX時間「1695179101」(2023年9月20日12點5分1秒)將轉換為「1」。 |
顯示時區的格式
格式 | 轉換結果範例 | 說明 |
---|---|---|
Z | +0900 | 轉換為第3參數指定的時區與UTC(世界協調時間)的時差。以hhmm的格式顯示。 |
ZZ | +09:00 | 轉換為第3參數指定的時區與UTC(世界協調時間)的時差。以hh:mm的格式顯示。 |
ZZZ | Asia/Tokyo | 轉換為第3參數指定的時區ID。 |
計算公式範例
在計算公式中,請指定欄位代碼作為參數,而非欄位名稱。
以下範例中,欄位代碼與欄位名稱完全相同。
將日期欄位的格式變更為「****年**月**日」
以下範例的計算公式為將日期欄位的格式變更為「****年**月**日」。
DATE_FORMAT(日期, "YYYY年M月d日", "Etc/GMT")
在「日期」欄位中輸入「2020-04-01」時,將顯示「2020年4月1日」。
變更日期與時間欄位的格式及時區
以下範例的計算公式為將日期與時間欄位的格式變更為「YYYY-MM-dd HH:mm」,並將時區設為太平洋標準時間。
DATE_FORMAT(日期與時間, "YYYY-MM-dd HH:mm", "America/Los_Angeles")
在「日期與時間」欄位中輸入日本時間「2020-04-01 13:00」時,計算結果為2020-03-31 21:00。
結合顯示姓名與記錄建立時間
以下範例的計算公式為將姓名與記錄建立時間以「姓名-記錄建立日期」的格式顯示。
使用「&」結合姓名、連字號(-)、記錄建立時間。
姓名 & "-" & DATE_FORMAT(建立時間, "YYYYMMdd", "system")
在「姓名」欄位中輸入「Maria Jackson」,且記錄建立時間為「2022-10-31 16:42」時,計算結果為「Maria Jackson-20221031」。
從出生日期顯示出生月份
以下範例的計算公式為從出生日期顯示出生月份。
DATE_FORMAT(出生日期, "MM", "Etc/GMT")
在「出生日期」欄位中輸入「1969-12-31」時,將顯示「12」。
從申請日期計算30天後的試用結束日期
以下範例的計算公式為顯示申請日期起30天後的試用結束日期。
DATE_FORMAT(申請日期 + (60*60*24*30), "YYYY-MM-dd", "Etc/GMT")
在「申請日期」欄位中輸入「2021-07-01」時,將顯示30天後的日期「2021-07-31」。