共用方式為


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) 太平洋時間 (美國和加拿大) 的應用程式使用者啟動的。

其他資源

日期和時間函數