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。