Date

Date 為一文字函數，可傳回線上報表植入資料的日期與時間，或儲存快照報表的日期與時間。日期與時間擷取自報表伺服器，並對應於報表伺服器所在國家/地區。您可以在文字方塊、文字儲存格或列或欄標題中使用 Date。

註：

日期與時間格式因地區設定而異。本主題中的範例是以美國為例。

語法：

<<Date("format,TimeZoneId")>>

引數描述

引數	描述
format	預設為使用者的日期/時間偏好設定。有效值為 Java `SimpleDateFormat` 可接受的值、"user" 或 empty ("user")。日期與時間 format 字元為區分大小寫。
TimeZoneId	有效值為 Java `TimeZone.getTimeZone()` 可接受的值，或者伺服器時區。例如，對於 `TimeZone.getTimeZone()`，若要指定東岸，您可以輸入："America/New_York"。使用 TimeZoneID 時，請以引號括住`format` 參數。這只有在已指定 TimeZoneId 時才適用。您不需要在 TimeZoneId 增強之前更新報表。

format

預設為使用者的日期/時間偏好設定。有效值為 Java SimpleDateFormat 可接受的值、"user" 或 empty ("user")。

日期與時間 format 字元為區分大小寫。

TimeZoneId

有效值為 Java TimeZone.getTimeZone() 可接受的值，或者伺服器時區。例如，對於 TimeZone.getTimeZone()，若要指定東岸，您可以輸入："America/New_York"。

使用 TimeZoneID 時，請以引號括住format 參數。這只有在已指定 TimeZoneId 時才適用。您不需要在 TimeZoneId 增強之前更新報表。

表格 -14 日期與時間格式字元

格式字元	意義	資料類型	範例
G	年代指示項	文字	AD
M	年中的月	文字或數字	如果月份是七月：M 顯示：7 MM 顯示：07 MMM 顯示：Jul MMMM 顯示：July
d	月中的日	數字	10
h	上午/下午中的時 (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 是十二月第四個星期二
w	年中的週	數字	27
W	月中的週	數字	2
a	上午/下午標記	文字	PM
k	日中的時 (1-24)	數字	23
K	上午/下午中的時 (0-11)	數字	如果時間為 3:37PM: 3
z	時區	文字	太平洋標準時間
y	年	數字	2002,02
'	引述文字	文字	<<Date(" D’the day of ’yyyy")>> 顯示：105th day of 2002
' '	使用兩個單引號以構成一個引號	文字	<<Date("k:mm ‘O’’Clock’ a")>> 顯示：6:15 O’Clock PM 註：使用 2 個單引號以構成一個引號，或使用縮寫符號，如 O’Clock (O’’Clock) 中所示。

使用 format 字元時的考量事項：

format 字元的數目或計數會決定格式：
- 若為文字，少於四個圖樣代號表示使用簡短或縮寫的格式 (如果存在的話)。
- 四個或四個以上的圖樣代號，則表示使用完整格式。
- M 或 MM 表示以數字格式使用月份。
- MMM 表示使用三個字母的月份縮寫。
- MMMM 表示使用月份的完整名稱。
例如，如果日期為四月 24 日：

<<Date("dd-M-yy")>> 會顯示 24-4-02

<<Date("dd-MM-yy)>> 顯示 24-04-02

<<Date("dd-MMM-yy")>> 會顯示 24-Apr-02

<<Date("dd-MMMM-yy")>> 會顯示 24-April-02
若為數字，圖樣代號的數目即為最小位數。位數不足的數字會以 0 填補。年份為特殊案例。如果您使用 "yy"，則會顯示年份的最後兩位數，但如果您使用 "yyyy"，則會顯示四位數的年份。

例如，如果月份為二月：

<<Date("MM-yyyy")>> 會顯示 02-2002
不論是否為指定的 format 字元，所有的大寫與小寫字母字元都會被視為圖樣。
請以單引號括住引述文字。若要在引述文字中使用單引號，請以單引號括住文字，並使用兩個單引號作為縮寫符號。

例如，列印 4 o’clock 的格式為：

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

範例：

日期格式	結果
`<<Date("d/M/yy")>>`	23/3/02
`<<Date("d-MMM-yy")>>`	23-Mar-02
`<<Date("EEEE, MMMM dd, yyyy")>>`	星期二，三月 23 日，2002 年
`<<Date("h:mm:ss a")>>`	12:52:05 PM
`<<Date("h:mm:ss a zzzz")>>`	12:52:05 PM 東部標準時間
`<<Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")>>`	星期二，3 月 23 日，2002 年 AD 時間：12:52:05 PM 東部標準時間
`<<Date("hh 'o’’clock' a, zzzz")>>`	12:00 PM 東部標準時間註：在您格式化結果的文字中，您必須使用兩個單引號才能構成一個引號。