DateTime

DateTime 是一個文字函數，會傳回報表被植入資料的日期與時間。日期與時間會從報表伺服器中擷取，並對應至報表伺服器所在的國家。您可以在文字方塊、文字儲存格、或資料列或資料欄標題中使用 DateTime。

註：

文字函數中基於報表預覽結果所使用的時區，是以使用者偏好設定中指定的每個使用者時區為依據。

語法：

DateTime("DateFormat","TimeFormat")

註：

若將 DateTime 函數參數留白 (例如 DateTime ())，或者兩個參數中都使用 "none" (例如 DateTime (none, none))，那麼 Narrative Reporting 的日期與時間使用者偏好設定將使用於格式。

註：

請參閱文字函數的參數以取得參數定義。

表格 10-9 日期與時間格式字元

格式化字元	意義	資料型態	範例
G	年代指示符號	文字	AD
M	一年中的月份	文字或數字	如果月份為 7 月：M 會顯示：7，MM 會顯示：07，MMM 會顯示：Jul，MMMM 會顯示：July
d	每月第幾日	數字	10
h	小時，以 am/pm (1-12) 表示	數字	11
H	一天的整點時間 (0-23)	數字	22
m	一小時內的分鐘數	數字	30
s	一分鐘中的秒數	數字	25
S	毫秒	數字	978
E	星期幾	文字	E：Tue，EE：Tuesday
D	每年第幾日	數字	189
F	月份一週天次	數字	Date("dd-MMM-yy ‘is the’ F 'th ' E 'of' ‘MMM") 會顯示： 24-Dec-02 is the 4th Tue of Dec
w	年度週次	數字	27
W	月份週次	數字	2
a	am/pm 標記	文字	PM
k	一天的整點時間 (1-24)	數字	23
K	小時，以 am/pm (0-11) 表示	數字	在美國，如果時間為 3:37 PM: 3
z	時區	文字	太平洋標準時間
y	年度	數字	2017,02
'	文字	文字	Date(" D’the day of ’yyyy") 會顯示：105th day of 2017
' '	兩個單引號可產生一個單引號	文字	Date("k:mm ‘O’’Clock’ a") 會顯示：6:15 O’Clock PM 使用 2 個單引號標記來產生單一引號或撇號，如 O’Clock (O’’Clock) 中所示。

使用格式字元時的考量：

格式字元的數目或計數會決定格式：
- 若為文字，少於四個格式字母表示使用簡短或縮寫形式（若存在的話）。
- 四個或更多格式字母表示使用完整形式。
- M 或 MM 表示使用月份作為數字。
- MMM 表示使用月份的三個字母縮寫。
- MMMM 表示使用月份的完整名稱。
例如，如果日期為 April 24：

Date("dd-M-yy") 會顯示 24-4-17

Date("dd-MM-yy") 會顯示 24-04-17

Date("dd-MMM-yy") 會顯示 24-Apr-17

Date("dd-MMMM-yy") 會顯示 24-April-17
若為數字，格式字母的數目為位數的最小數目。較短的數字會以零填補。年度為特殊案例。如果您使用 "yy"，便會顯示年度的最後兩個位數，但如果您使用 "yyyy"，則會顯示四位數的年度。

例如，如果月份為 2 月：

Date("MM-yyyy") 會顯示 02-2017
所有大寫或小寫的字母字元都會被視為格式，無論它們是否被指定格式字元。
將文字括在單引號中。若要在文字中使用單引號，請在單引號中將文字括住，並使用兩個單引號作為撇號。

例如，要列印 4 點鐘的格式為：

Date("hh 'o''clock' ")

範例：

日期格式	結果
`Date("d/M/yy")`	23/3/17
`Date("d-MMM-yy")`	23-Mar-17
`Date("EEEE, MMMM dd, yyyy")`	Tuesday, March 23, 2017
`Date("h:mm:ss a")`	12:52:05 PM
`Date("h:mm:ss a zzzz")`	12:52:05 PM Eastern Standard Time
`Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")`	Tuesday, March 23, 2017 AD time: 12:52:05 PM Eastern Standard Time
`Date("hh 'o’’clock' a, zzzz")`	12:00 PM, Eastern Standard Time 您必須使用 2 個單引號標記在您格式化結果的文字中產生一個單引號。