概述
函数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为星期一,2为星期二,……,7为星期日(在Sun Solaris系统中1为星期日) | 1, 2, ..., 7 |
%U | 一年中的第几周(补零),从一年中的第一个星期日开始记作第01周,此前的日子记作第00周 | 00, 01, ..., 53 |
%V | 一年中的第几周(补零),如果一年中的第一天到第一个星期日如果大于等于4天,第一个星期日之前的日子记作第01周,否则那些日子记作前一年的最后一周 | 01, 02, ..., 53 |
%W | 一年中的第几周(补零),从一年中的第一个星期一开始记作第01周,此前的日子记作第00周 | 00, 01, ..., 53 |
%w | 工作日索引,0为星期日,1为星期一,……,6为星期六 | 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类型)
一般用法
本例使用异源别名计算:
uncollect ["2023-04-30 22:30:35", "2020-01-15 09:03:16"] as a
uncollect ["%y-%m-%d %R", "%Y/%m/%d %r"] as b
return table(a, b, dateFormat(a, b))
| a | b | dateFormat(a, b) |
|---------------------|-------------|------------------------|
| 2023-04-30 22:30:35 | %y-%m-%d %R | 23-04-30 22:30 |
| 2020-01-15 09:03:16 | %Y/%m/%d %r | 2020/01/15 09:03:16 AM |
本例将异源别名做笛卡尔积组合后计算:
uncollect ["2023-04-30 22:30:35", "2020-01-15 09:03:16"] as a
uncollect ["%y-%m-%d %R", "%Y/%m/%d %r"] as b
with dateFormat(a, b) as c
return table(a, b, c)
| a | b | c |
|---------------------|-------------|------------------------|
| 2023-04-30 22:30:35 | %y-%m-%d %R | 23-04-30 22:30 |
| 2023-04-30 22:30:35 | %Y/%m/%d %r | 2023/04/30 10:30:35 PM |
| 2020-01-15 09:03:16 | %y-%m-%d %R | 20-01-15 09:03 |
| 2020-01-15 09:03:16 | %Y/%m/%d %r | 2020/01/15 09:03:16 AM |