DATETIMEFORMAT ER 函数

DATETIMEFORMAT 函数返回一个字符串值,此值以指定格式和指定的区域性(可选)将给定日期/时间值显示为文本。 有关支持格式的信息,请参阅标准自定义

语法 1

DATETIMEFORMAT (datetime, format)

语法 2

DATETIMEFORMAT (datetime, format, culture)

参数

datetime日期/时间

表示要设定格式的日期和时间的日期/时间值。

format字符串

输出字符串的格式。 有关支持格式的信息,请参阅标准自定义

注释

当您使用标准格式或自定义格式时,格式字符串区分大小写。 例如,标准“d”格式说明符使用短日期模式返回日期,而标准“D”格式说明符使用长日期模式返回日期。 而且,自定义“M”格式说明符返回月份 1 到 12,而自定义“m”格式说明符返回分钟 0 到 59。

culture字符串

用于设定格式的区域性。 有关受支持的区域性的信息,请参阅区域性

返回值

字符串

生成的字符串值。

使用说明

如果区域性未被定义为被调用函数的参数,culture 由调用上下文定义。 例如,如果对于配置为使用德国区域性的 FILE 元素,以电子申报 (ER) 格式使用语法 1 调用 DATETIMEFORMAT 函数,则将使用德国区域性完成转换。 默认 culture 值为 EN-US

DATETIMEFORMAT 函数转换给定的日期/时间值时,它将考虑正在运行 ER 格式(调用该函数的上下文的 ER 格式)的应用程序用户的时区设置。

示例 1

DATETIMEFORMAT (NOW(), "dd-MM-yyyy") 根据指定的自定义格式返回当前应用程序服务器日期/时间值 2015 年 12 月 24 日为 "24-12-2015"

示例 2

DATETIMEFORMAT (SESSIONNOW(), "d", "DE") 根据所选的德国区域性和指定格式,返回当前应用程序会话的日期/时间值 2015 年 12 月 24 日为 "24.12.2015"

示例 3

当此函数在语言和国家/地区首选项部分具有时区值 (GMT-08:00)太平洋时间(美国和加拿大) 的应用程序用户启动的流程中调用时,DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") 返回字符串值 2019-11-12T08:00:00.0000000-08:00

其他资源

日期和时间函数