你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

format_datetime()

  • 项目

按提供的格式设置日期/时间格式。

语法

format_datetime(date,format)

详细了解语法约定。

参数

名称 类型 必需 描述
date datetime ✔️ 要格式化的值。
format string ✔️ 由一个或多个受支持的格式元素组成的输出格式。

支持的格式元素

format 参数应包含以下一个或多个元素：

格式说明符 说明 示例
d 一个月中的某一天（1 到 31）。 2009-06-01T13:45:30 -> 1、2009-06-15T13:45:30 -> 15
dd 一个月中的某一天（01 到 31）。 2009-06-01T13:45:30 -> 01、2009-06-15T13:45:30 -> 15
f 日期和时间值的十分之几秒。 2009-06-15T13:45:30.6170000 -> 6、2009-06-15T13:45:30.05 -> 0
ff 日期和时间值的百分之几秒。 2009-06-15T13:45:30.6170000 -> 61、2009-06-15T13:45:30.0050000 -> 00
fff 日期和时间值的千分之几秒。 6/15/2009 13:45:30.617 -> 617、6/15/2009 13:45:30.0005 -> 000
ffff 日期和时间值的万分之几秒。 2009-06-15T13:45:30.6175000 -> 6175、2009-06-15T13:45:30.0000500 -> 0000
fffff 日期和时间值的十万分之几秒。 2009-06-15T13:45:30.6175400 -> 61754、2009-06-15T13:45:30.000005 -> 00000
ffffff 日期和时间值的百万分之几秒。 2009-06-15T13:45:30.6175420 -> 617542、2009-06-15T13:45:30.0000005 -> 000000
fffffff 日期和时间值的千万分之几秒。 2009-06-15T13:45:30.6175425 -> 6175425、2009-06-15T13:45:30.0001150 -> 0001150
F 如果非零，则为日期和时间值的十分之几秒。 2009-06-15T13:45:30.6170000 -> 6、2009-06-15T13:45:30.0500000 ->（无输出）
FF 如果非零，则为日期和时间值的百分之几秒。 2009-06-15T13:45:30.6170000 -> 61、2009-06-15T13:45:30.0050000 ->（无输出）
FFF 如果非零，则为日期和时间值的千分之几秒。 2009-06-15T13:45:30.6170000 -> 617、2009-06-15T13:45:30.0005000 ->（无输出）
FFFF 如果非零，则为日期和时间值的万分之几秒。 2009-06-15T13:45:30.5275000 -> 5275、2009-06-15T13:45:30.0000500 ->（无输出）
FFFFF 如果非零，则为日期和时间值的十万分之几秒。 2009-06-15T13:45:30.6175400 -> 61754、2009-06-15T13:45:30.0000050 ->（无输出）
FFFFFF 如果非零，则为日期和时间值的百万分之几秒。 2009-06-15T13:45:30.6175420 -> 617542、2009-06-15T13:45:30.0000005 ->（无输出）
FFFFFFF 如果非零，则为日期和时间值的千万分之几秒。 2009-06-15T13:45:30.6175425 -> 6175425、2009-06-15T13:45:30.0001150 -> 000115
h 采用 12 小时制的小时（从 1 到 12）。 2009-06-15T01:45:30 -> 1、2009-06-15T13:45:30 -> 1
hh 采用 12 小时制的小时（从 01 到 12）。 2009-06-15T01:45:30 -> 01、2009-06-15T13:45:30 -> 01
H 采用 24 小时制的小时（从 0 到 23）。 2009-06-15T01:45:30 -> 1、2009-06-15T13:45:30 -> 13
HH 采用 24 小时制的小时（从 00 到 23）。 2009-06-15T01:45:30 -> 01、2009-06-15T13:45:30 -> 13
m 分钟（0 到 59）。 2009-06-15T01:09:30 -> 9、2009-06-15T13:29:30 -> 29
mm 分钟（00 到 59）。 2009-06-15T01:09:30 -> 09、2009-06-15T01:45:30 -> 45
M 月份（1 到 12）。 2009-06-15T13:45:30 -> 6
MM 月份（1 到 12）。 2009-06-15T13:45:30 -> 06
s 秒（0 到 59）。 2009-06-15T13:45:09 -> 9
ss 秒（00 到 59）。 2009-06-15T13:45:09 -> 09
y 年份（0 到 99）。 0001-01-01T00:00:00 -> 1、0900-01-01T00:00:00 -> 0、1900-01-01T00:00:00 -> 0、2009-06-15T13:45:30 -> 9、2019-06-15T13:45:30 -> 19
yy 年份（00 到 99）。 0001-01-01T00:00:00 -> 01、0900-01-01T00:00:00 -> 00、1900-01-01T00:00:00 -> 00、2019-06-15T13:45:30 -> 19
yyyy 由四位数字表示的年份。 0001-01-01T00:00:00 -> 0001、0900-01-01T00:00:00 -> 0900、1900-01-01T00:00:00 -> 1900、2009-06-15T13:45:30 -> 2009
tt 上午/下午时间 2009-06-15T13:45:09 -> PM

支持的分隔符

格式说明符可以包含以下分隔符：

分隔符 评论
' ' Space
'/'
'-' 短划线
':'
','
'.'
'_'
'['
']'

返回

包含 format 格式的 date 的字符串。

示例

以下三个示例返回格式不同的日期/时间。

运行查询

let dt = datetime(2017-01-29 09:00:05);
print 
v1=format_datetime(dt,'yy-MM-dd [HH:mm:ss]')

输出

v1
17-01-29 [09:00:05]

运行查询

let dt = datetime(2017-01-29 09:00:05);
print 
v2=format_datetime(dt, 'yyyy-M-dd [H:mm:ss]')

输出

v2
2017-1-29 [9:00:05]

运行查询

let dt = datetime(2017-01-29 09:00:05);
print 
v3=format_datetime(dt, 'yy-MM-dd [hh:mm:ss tt]')

输出

v3
17-01-29 [09:00:05 AM]

相关内容