dateAdd()
向给定日期添加指定的时间间隔。
| 语法 | dateAdd(<time>, <interval>, <unit>) |
||
| 参数 | 名称 | 类型 | 描述 |
<time> |
时间 | 初始时间 | |
<interval> |
INT |
时间偏移量（正值表示增加，负值表示减去） | |
<unit> |
STRING |
时间偏移量的单位，包括year、month、day、hour、minute和second |
|
| 返回类型 | DATETIME |
||
return dateAdd("1970-1-1", -1, "hour") as newTime
结果：
| newTime |
|---|
| 1969-12-31 23:00:00 |
return dateAdd("1970-1-1", 10, "year")
结果：
| newTime |
|---|
| 1980-01-01 00:00:00 |
dateDiff()
计算两个日期间的时间间隔（time1-time2），并以指定时间单位返回结果。
| 语法 | dateAdd(<time1>, <time2>, <unit>) |
||
| 参数 | 名称 | 类型 | 描述 |
<endTime> |
时间 | 第一个时间 | |
<time2> |
时间 | 第二个时间 | |
<unit> |
STRING |
时间间隔单位，包括day、hour、minute和second |
|
| 返回类型 | DATETIME |
||
return dateDiff("1970-01-01 10:00:00", "1970-01-01 12:00:20", "minute") as diff
结果：
| diff |
|---|
| -120 |
dateFormat()
根据指定格式打印给定日期。
| 语法 | dateFormat(<time>, <formatCode>) |
||
| 参数 | 名称 | 类型 | 描述 |
<time> |
时间 | 输入的时间 | |
<formatCode> |
STRING |
格式代码 | |
| 返回类型 | 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, 01, ..., 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 |
See %g |
%Y |
相当于%G |
See %G |
%z |
UTC偏移量，格式为±HHMM[SS] |
+0000, -0400, +1030, ... |
%Z |
时区名称 | GMT, UTC, IST, CST, ... |
%% |
%字符 | % |
return dateFormat("2010/9/25 6:12:30","%A %e %B, %G") as newFormat
结果：
| newFormat |
|---|
| Saturday 25 September, 2010 |
day()
提取给定日期的日部分，即在当月的第几天。
| 语法 | day(<time>) |
||
| 参数 | 名称 | 类型 | 描述 |
<time> |
时间 | 输入的时间 | |
| 返回类型 | UINT |
||
return day("2022-10-5")
结果：
| day("2022-10-5") |
|---|
| 5 |
dayOfWeek()
返回一个数字（从1到7，其中1为星期日，7为星期六），表示给定日期对应的星期几。
| 语法 | dayOfWeek(<time>) |
||
| 参数 | 名称 | 类型 | 描述 |
<time> |
时间 | 输入的时间 | |
| 返回类型 | UINT |
||
return dayOfWeek("2024-12-5")
结果：
| dayOfWeek("2024-12-5") |
|---|
| 5 |
month()
提取给定日期的月份数。
| 语法 | month(<time>) |
||
| 参数 | 名称 | 类型 | 描述 |
<time> |
时间 | 输入的时间 | |
| 返回类型 | UINT |
||
return month("2022-10-5")
结果：
| month("2022-10-5") |
|---|
| 10 |
now()
返回协调世界时（UTC）下当前日期和时间。
| 语法 | now() |
| 返回类型 | DATETIME |
now()
结果：
| now() |
|---|
| 2024-12-05 06:43:47.402538 |
year()
提取给定日期的年份数。
| 语法 | year(<time>) |
||
| 参数 | 名称 | 类型 | 描述 |
<time> |
时间 | 输入的时间 | |
| 返回类型 | UINT |
||
return year("2022-10-5")
结果：
| year("2022-10-5") |
|---|
| 2022 |