DATETIMEFORMAT ER 函數
DATETIMEFORMAT
函數回傳一個 字串 值,它將給定的日期/時間值顯示為指定格式和可選指定文化的文字。 如需支援格式的相關信息,請參閱標準和自訂。
語法 1
DATETIMEFORMAT (datetime, format)
語法 2
DATETIMEFORMAT (datetime, format, culture)
引數
datetime
:日期時間
表示要格式化的日期和時間的日期/時間值。
format
:字串
輸出字串的格式。 如需支援格式的相關信息,請參閱標準和自訂。
注意
當您使用標準格式或自訂格式時,格式字串區分大小寫。 例如,標準「d」格式說明符使用短日期模式回傳日期,而標準「D」格式說明符使用長日期模式回傳日期。 此外,自訂「M」格式指定元回傳從 1 到 12 的月份,而自訂「m」格式指定元回傳從 0 到 59 的分鐘。
culture
:字串
用於格式化的文化。 如需支援的文化的相關信息,請參閱文化。
回傳值
字串
產生的字串值。
使用方式說明
如果文化沒有被定義為被調用函數的參數,那麼 culture
的值由調用內容定義。 例如,如果為設定為使用德國文化的 FILE 元素使用電子報表 (ER) 格式中的語法 1 調用 DATETIMEFORMAT
函數,則將使用德國文化完成轉換。 預設的 culture
值為 EN-US。
當 DATETIMEFORMAT
函數轉換給定的日期/時間值時,它會考慮執行在內容中調用該函數的 ER 格式的應用程式使用者的時區設定。
範例 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy")
根據指定的自訂格式,將現行應用程式服務器的日期/時間值 (2015 年 12 月 24 日) 回傳為 「24-12-2015」。
範例 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE")
根據所選的德國文化和指定的格式,將現行應用程式工作階段日期/時間值 (2015 年 12 月 24 日) 回傳為 「24.12.2015」。
範例 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O")
回傳字串值 2019-11-12T08:00:00.0000000-08:00,當該函數被調用時,是由一個在 語言和國家/地區偏好 部分具有時區值 (GMT-08:00) 太平洋時間 (美國和加拿大) 的應用程式使用者啟動的。