DateTime

DateTime 是一个文本函数,返回在报表中填充数据的日期和时间。日期和时间从报表服务器进行检索并且与报表服务器所位于的国家/地区对应。您可以在文本框、文本单元格或者行或列标题中使用 DateTime

注:

进行报表预览时的文本函数结果中使用的时区基于每位用户在 User Preferences(用户首选项)中指定的时区。

语法:

DateTime("DateFormat","TimeFormat")

注:

如果 DateTime 函数参数保留为空,例如 DateTime (),或者两个参数均使用 "none",例如 DateTime (none, none),则 Narrative Reporting "User Preferences"(用户首选项)中设置的 Date(日期)Time(时间)将用于格式。

注:

有关参数定义,请参阅“文本函数的参数”。

或者,您也可以为短格式、中等格式、长格式和完整格式指定与区域设置无关的值:DateTime (short|medium|long|full|none, short|medium|long|full|none)。(输入这些值时,请勿使用引号。)示例(给出的示例针对美国):

  • DateTime(short, short)01/03/2017 1:54 PM

  • DateTime(medium, medium)Jan 03, 2017 1:54:32 PM

  • DateTime(long, long)January 03, 2017 1:54:32 PM PDT

  • DateTime(full, none)Tuesday, January 03, 2017 (注意:未显示时间。)

  • DateTime(none, short)1:54 PM(注意:未显示日期。)

表 10-9 日期和时间格式字符

格式字符 含义 数据类型 示例

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 is the 4th Tue of Dec

w

年中的周

数字

27

W

月中的周

数字

2

a

上午/下午标记

文本

PM

k

某日几时 (1-24)

数字

23

K

上午/下午几时 (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

使用两个单引号生成一个单引号或撇号,如 O’Clock (O’’Clock) 中所示。

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

  • format 字符的个数或计数决定了格式:

    • 对于文本,少于四个模式字母表示使用简短或缩写形式(如果存在)。

    • 四个或更多模式字母表示使用完整形式。

    • M 或 MM 表示将月份用作数字。

    • MMM 表示使用月份的三个字母缩写。

    • MMMM 表示使用月份的完整名称。

    例如,如果日期是 4 月 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",将显示四位数年份。

    例如,如果月份是二月:

    Date("MM-yyyy") 显示 02-2017

  • 所有大写和小写字母字符均视为模式,而不管是否将其指定为 format 字符。

  • 用单引号将文字文本引起来。要在文字文本中使用单引号,请用单引号将文本引起来,并使用两个单引号生成撇号。

    例如,输出 4 o’clock 的格式如下:

     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

您必须使用两个单引号才能在设置了格式的结果文本中生成一个单引号。