概述
dateFormat()函数将一个时间对象转换为指定格式的字符串。
语法
dateFormat(time, format)
参数 |
类型 |
描述 |
|---|---|---|
time |
Datetime、timestamp或string | 时间对象 |
format |
String | 指定的格式 |
日期/时间格式指令：
格式指令 |
描述 | 示例/范围 |
|---|---|---|
%a |
星期名称简写（系统语言环境） | (en_US) Sun, Mon |
%A |
星期名称全称（系统语言环境） | (en_US) Sunday, Monday |
%b |
月份名称简写（系统语言环境） | (en_US) Jan, Feb |
%B |
月份名称全称（系统语言环境） | (en_US) January, February |
%c |
系统默认的日期和时间表示法 | Wed Jan 11 10:59:28 2023 |
%C |
两位数世纪（年份除以100） | 00, 01, ..., 99 |
%d |
某月的第几天（补零） | 01, 02, ..., 31 |
%D |
相当于%m/%d/%y |
01/11/23 |
%e |
某月的第几天（不补零） | 1, 2, ..., 31 |
%Ez |
时区 | +08:00 |
%g |
年份后两位 | 00, 01, ..., 99 |
%G |
四位数年份 | 0000, 0001, ..., 9999 |
%h |
相当于%b |
同%b |
%H |
24小时制的小时（补零） | 00, 02, ..., 23 |
%I |
12小时制的小时（补零） | 01, 02, ..., 12 |
%j |
一年中的第几天（补零） | 001, 002, ..., 366 |
%m |
月份数字（补零） | 01, 02, ..., 12 |
%M |
分钟数（补零） | 00, 01, ..., 59 |
%n |
换行符 | |
%p |
AM或PM | (en_US) AM, PM |
%P |
am或pm | (en_US) am, pm |
%r |
相当于%I/%M/%S %p |
01:49:23 AM |
%R |
相当于%H:%M |
13:49 |
%S |
秒数（补零） | 00, 01, ..., 59 |
%t |
制表符 | |
%T |
相当于%H:%M:%S |
23:02:05 |
%u |
一周的第几天，1为星期一（在Sun Solaris系统中1为星期日） | 1, 2, ..., 7 |
%U |
一年中的第几周（补零），一年中的第一个星期日记作第01周的第一天，此前的日子记作第00周 | 00, 01, ..., 53 |
%V |
一年中的第几周（补零），星期一记为每周的第一天，第01周需在当年至少有4天 | 01, 02, ..., 53 |
%W |
一年中的第几周（补零），从一年中的第一个星期一开始记作第01周，此前的日子记作第00周 | 00, 01, ..., 53 |
%w |
一周的第几天，0为星期日 | 0, 1, ..., 6 |
%x |
系统默认的日期表示法 | 01/11/23 |
%X |
系统默认的时间表示法 | 06:38:45 |
%y |
相当于%g |
同%g |
%Y |
相当于%G |
同%G |
%z |
UTC偏移量，格式为±HHMM [SS] |
+0000, -0400, +1030, ... |
%Z |
时区名称 | GMT, UTC, IST, CST, ... |
%% |
%字符 | % |
返回值类型：String
结果示例
return dateFormat("2010/9/25 6:12:30","%A %e %B, %G")
结果：Saturday 25 September, 2010
使用示例
以指定格式展示评论发布时间。
find().nodes({@review}) as n
return dateFormat(n.time,"%e %b, %G")