Date

Date 是文本函数，可返回联机报表中填充数据的日期和时间，或者保存快照报表的日期和时间。日期和时间从报表服务器中检索并与报表服务器所在的国家/地区相符。可以在文本框、文本单元格或行/列标题中使用 Date。

注：

日期和时间格式因区域设置而异。本主题中的示例针对美国。

语法：

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

参数说明

参数	说明
format	默认为日期/时间的用户首选项。有效值是 Java `SimpleDateFormat` 接受的那些值，或 "user" 或空 ("user")。日期和时间 format 字符区分大小写。
TimeZoneId	有效值是 Java `TimeZone.getTimeZone()` 接受的那些值，或服务器时区。例如，对于 `TimeZone.getTimeZone()`，要指定东海岸，请输入："America/New_York"。使用 TimeZoneID 时，请将 `format` 参数置于引号内。仅当指定了 TimeZoneId 时才适用。您无需在 TimeZoneId 改进之前更新报表。

format

默认为日期/时间的用户首选项。有效值是 Java SimpleDateFormat 接受的那些值，或 "user" 或空 ("user")。

日期和时间 format 字符区分大小写。

TimeZoneId

有效值是 Java TimeZone.getTimeZone() 接受的那些值，或服务器时区。例如，对于 TimeZone.getTimeZone()，要指定东海岸，请输入："America/New_York"。

使用 TimeZoneID 时，请将 format 参数置于引号内。仅当指定了 TimeZoneId 时才适用。您无需在 TimeZoneId 改进之前更新报表。

表 -14 日期和时间格式字符

格式字符	含义	数据类型	示例
G	纪元标志符	文本	AD
M	年中的月	文本或数字	如果月为 July：则 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:37PM：3
z	时区	文本	太平洋标准时间
y	年份	数字	2002,02
'	文字文本	文本	<<Date(" D’the day of ’yyyy")>> displays:105th day of 2002
' '	用于生成一个单引号的两个单引号	文本	<<Date("k:mm ‘O’’Clock’ a")>> displays: 6:15 O’Clock PM 注：使用 2 个单引号生成一个单引号，或如同 O'Clock (O''Clock) 中的撇号。

使用 format 字符时的注意事项：

format 字符的数目或计数决定了格式：
- 对于文本，模式字母小于四个则表示使用简短或缩写格式（如果存在此格式）。
- 模式字母达到或超过四个则表示使用完整的格式。
- M 或 MM 表示将月份用作数字。
- MMM 表示使用月份的三字母缩写形式。
- MMMM 表示使用月份的完整名称。
例如，如果日期为 4 月 24 日：

<<Date("dd-M-yy")>> 将显示 24-4-02

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

<<Date("dd-MMM-yy")>> 将显示 24-Apr-02

<<Date("dd-MMMM-yy")>> 将显示 24-April-02
对于数字，模式字母的数目为最小位数。偏短的数字以零填补。年份是一个特例。如果使用 "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")>>`	Tuesday, March 23, 2002
`<<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, 2002 AD time: 12:52:05 PM Eastern Standard Time
`<<Date("hh 'o’’clock' a, zzzz")>>`	12:00 PM, Eastern Standard Time 注：必须使用两个单引号才能在设置格式的结果文本中生成一个单引号。