DATETIME( ) 函数

将日期时间转换为字符串。还可以返回当前操作系统日期时间。

语法

DATETIME(<日期时间> <,格式>)

参数

名称	类型	描述
日期时间 可选	日期时间	要转换的域、表达式或字面量值。如果省略该参数，则返回当前操作系统日期。
格式 可选	字符	要应用于输出字符串的格式，例如 "DD/MM/YYYY"。如果省略该参数，则使用当前 Analytics 日期显示格式。如果已省略日期/日期时间，则无法指定格式。

输出

字符。

示例

基本示例

字面量日期时间输入

按当前 Analytics 日期和时间显示格式返回 "20141231 235959"：

DATETIME(`20141231 235959`)

返回 "31-Dec-2014 11:59 P"：

DATETIME(`20141231 235959`, "DD-MMM-YYYY hh:mm A")

使用当前 Analytics 日期和时间显示格式，以字符串的形式返回当前操作系统日期和时间：

DATETIME()

域输入

使用当前 Analytics 日期和时间显示格式，以字符串的形式返回收款时间戳域中的每个值：

DATETIME(回执时间戳)

使用指定的日期和时间显示格式，以字符串的形式返回收款时间戳域中的每个值：

DATETIME(回执时间戳, "DD/MM/YYYY hh:mm:ss")

备注

输出字符串长度

输出字符串的长度始终为 27 个字符。如果指定的输出格式或 Analytics 日期和时间显示格式小于 27 个字符，则使用尾随空格填充输出字符串。

参数详细信息

为日期时间指定的域可以使用任何日期时间格式，前提是域定义正确定义了该格式。

如果您使用格式来控制如何显示输出字符串，则必须使用下表中的格式。

• 您可以使用日期、时间和 AM/PM 格式的任意组合。
• 日期必须位于时间的前面。不必在两者之间放置一个分隔符，原因是 Analytics 自动使用单个空格作为输出字符串中的分隔符。
• AM/PM 格式是可选的，并且被放置在最后。
• 必须使用单引号或双引号指定格式。

  例如："DD-MMM-YYYY hh:mm:ss AM"

日期格式	时间格式	AM/PM 格式	示例
所有受支持的 Analytics 日期显示格式	hh:mm:ss	无 24 小时时钟	"DD/MM/YYYY hh:mm:ss"
	hhmmss	AM 或 PM 12 小时时钟	"MMDDYY hhmmss PM"
	hh:mm	A 或 P 12 小时时钟	"DD-MMM-YYYY hh:mm A"
	hhmm
	hh

指定日期时间字面值

在为日期时间指定字面量日期时间值时，您必须使用下表中的格式，并且必须将值放在反引号中 — 例如，`20141231 235959`。

在日期或时间的各个部分之间，不要使用任何分隔符，如斜杠 (/) 或冒号 (:)。

• 日期时间值 - 您可以使用日期、分隔符和下表列出的时间格式的任意组合。日期必须位于时间前面，并且您必须在两者之间使用分隔符。有效分隔符是单个空格、字母 't' 或字母 'T'。

• 时间值 – 您必须使用 24 小时时钟指定时间。协调世界时 (UTC) 偏移量前面必须带有加号 (+) 或减号 (-)。

  格式示例	字面值示例
  YYYYMMDD hhmmss	`20141231 235959`
  YYMMDDthhmm	`141231t2359`
  YYYYMMDDThh	`20141231T23`
  YYYYMMDD hhmmss+/-hhmm （UTC 偏移量）	`20141231 235959-0500`
  YYMMDD hhmm+/-hh （UTC 偏移量）	`141231 2359+01`
  说明 请勿在包含 UTC 偏移量数据的主时间格式中单独使用 hh。例如，请避免：hh+hhmm。结果可能不可靠。

其他日期时间转换函数

日期时间到字符转换

函数	描述
DATE( )	从指定的日期或日期时间中提取日期并将其以字符串形式返回。还可以返回当前操作系统日期。
TIME( )	从指定的时间或日期时间中提取时间并将其以字符串形式返回。还可以返回当前操作系统时间。

字符或数值到日期时间转换

函数	描述
CTOD( )	将字符或数值日期值转换为日期。还可以从字符或数值日期时间值中提取日期并将其作为日期返回。英文“Character to Date”的缩写。
CTODT( )	将字符或数值日期时间值转换为日期时间。英文“Character to Datetime”的缩写。
CTOT( )	将字符或数值时间值转换为时间。还可以从字符或数值日期时间值中提取时间并将其作为时间返回。英文“Character to Time”的缩写。

序列到日期时间转换

函数	描述
STOD( )	将序列日期，即以整数形式表示的日期转换为日期值。英文“Serial to Date”的缩写。
STODT( )	将序列日期时间，即以整数形式表示的日期时间和 24 小时的小数部分转换为日期时间值。英文“Serial to Datetime”的缩写。
STOT( )	将序列时间，即以 24 小时的小数部分形式表示的时间（其中，24 小时等于 1）转换为时间值。英文“Serial to Time”的缩写。