format_datetime ()
根据提供的格式对日期时间进行格式化。
语法
format_datetime(
日期 ,
格式)
参数
名称 | 类型 | 必需 | 描述 |
---|---|---|---|
日期 | 日期时间 | ✓ | 要格式化的值。 |
格式 | 字符串 | ✓ | 由一个或多个 受支持的格式元素组成的输出格式。 |
受支持的格式元素
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 |
一个日期和时间值中的 1 万分之一秒。 | 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 |
如果非零,那么在一个日期和时间值中的 1 万分之一秒。 | 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 |
小时,使用从 1 到 12 的 12 小时时钟。 | 2009-06-15T01:45:30 -> 1 , 2009-06-15T13:45:30 -> 1 |
hh |
小时,使用从 01 到 12 的 12 小时时钟。 | 2009-06-15T01:45:30 -> 01 , 2009-06-15T13:45:30 -> 01 |
H |
小时,使用从 0 到 23 的 24 小时制时钟。 | 2009-06-15T01:45:30 -> 1 , 2009-06-15T13:45:30 -> 13 |
HH |
小时,使用从 00 到 23 的 24 小时时钟。 | 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 |
月,从 01 到 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 |
AM/PM 小时 | 2009-06-15T13:45:09 -> PM |
受支持的定界符
格式说明符可以包含以下定界符:
定界符 | 注释 |
---|---|
' ' |
太空 |
'/' |
|
'-' |
破折号 |
':' |
|
',' |
|
'.' |
|
'_' |
|
'[' |
|
']' |
退货
具有由 format指定的 date 格式的字符串。
示例
events
| project original_time
//--- Search for the last 5 minutes of data
| where original_time > ago(5d)
//--- USER Criteria Here
| extend v1=format_datetime(original_time,'yy-MM-dd [HH:mm:ss]')
| extend v2=format_datetime(original_time, 'yyyy-M-dd [H:mm:ss]')
| extend v3=format_datetime(original_time, 'yy-MM-dd [hh:mm:ss tt]')
结果
原始时间 | v1 | v2 | v3 |
---|---|---|---|
2023-08-25T00:01:21.503Z | 23-08-25 [00:01:21] | 2023-08-25 [00:01:21] | 23-08-25 [12:01:21 AM] |