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] |
相关内容
- 若要从 UTC 转换为本地时间，请参阅 datetime_utc_to_local()
- 若要将日期/时间从“本地”转换为“UTC”，请参阅 datetime_local_to_utc()