日期

• date
• datetime
• time
• hour
• minute
• second
• dateAdd
• date2Chinese
• dayOfMonth
• dayOfYear
• nextDate
• preDate
• year
• month
• monthBegin
• monthEnd
• weekDay
• weekOfYear
• quarter
• quarterBegin
• quarterEnd
• timestemp
• GMTDate
• UTCDate
• isoDateFormat
• timestamp2date
• date2Timestamp
• isLeapYear
• dateDiff
• hours
• days

date

语法

@date

• 当前日期，格式为yyyy-MM-dd
• 取自当前AWS服务器节点的时钟时间

参数

• 无

例子

@date

结果

2014-07-18

datetime

语法

@datetime

• 当前日期时间，格式为yyyy-MM-dd HH:mm:ss
• 取自当前AWS服务器节点的时钟时间

参数

• 无

例子

@datetime

结果

2014-07-18 18:08:08

time

语法

@time(datetime)

• 当前时间，格式为HH:mm:ss
• 取自当前AWS服务器节点的时钟时间

参数

• datetime （可选）从指定日期提取时间，格式为yyyy-MM-dd HH:mm:ss

例子

@time 至 @time(2014-09-18 19:38:56)

结果

18:08:08 至 19:38:56

hour

语法

@hour(datetime)

• 当前小时，范围是0到23
• 默认取自当前AWS服务器节点的时钟时间

参数

• datetime（可选）从指定日期提取小时，格式为yyyy-MM-dd HH:mm:ss

例子

@hour 至 @hour(2014-09-18 19:38:56)

结果

18 至 19

minute

语法

@minute(datetime)

• 当前分钟，范围是0到59
• 默认取自当前AWS服务器节点的时钟时间

参数

• datetime （可选）从指定日期提取分钟，格式为yyyy-MM-dd HH:mm:ss

例子

@minute 至 @minute(2014-09-18 19:38:56)

结果

15 至 38

second

语法

@second(datetime)

• 当前秒钟，范围是0到59
• 默认取自当前AWS服务器节点的时钟时间

参数

• datetime （可选）从指定日期提取秒钟，格式为yyyy-MM-dd HH:mm:ss

例子

@second 至 @second(2014-09-18 19:38:56)

结果

22 至 56

dateAdd

语法

@dateAdd(*datepart, *number, *date)

• 日期计算
• number参数支持负号（表示时间往前算起）

参数

• datepart （必选）可以是year、month、week、day
• number （必选）间隔，一个有符号整数
• date （必选）从该日期开始算起，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14在100天前的日期是@dateAdd(day,-100,2014-07-14)

结果

2014-07-14在100天前的日期是2014-04-05

date2Chinese

语法

@date2Chinese(*date)

• 将指定日期转换成中国大写名称

参数

• date （必选）指定该日期，格式为yyyy-MM-dd

例子

2014-08-18的大写是@date2Chinese(2014-08-18)

结果

2014-07-14的大写是二零一四年八月十八日

dayOfMonth

语法

@dayOfMonth(date)

• 当前月份中天数，在1到31范围内
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取天数，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14是7月的第@dayOfMonth(2014-07-14)天

结果

2014-07-14是7月的第14天

dayOfYear

语法

@dayOfYear(date)

• 当前年份中天数，在1到366范围内
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取天数，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14是2014年的第@dayOfYear(2014-07-14)天

结果

2014-07-14是2014年的第195天

nextDate

语法

@nextDate(date)

• 明日。当前日期的下一天日期
• 取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期计算下一天，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

@date 至 @nextDate 。2015-12-31日的下一日是@nextDate(2015-12-31)

结果

2014-07-18 至 2014-07-19 。 2015-12-31日的下一日是2016-01-01

preDate

语法

@preDate(date)

• 昨日。当前日期的前一天日期
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期计算前一天，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2015-12-31日的前一日是@preDate(2015-12-31)

结果

2015-12-31日的前一日是2015-12-30

year

语法

@year(date)

• 当前年份
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取年份，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

今年是@year年

结果

今年是2015年

month

语法

@month(date)

• 当前月份
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取月份，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

今年是@year年@month月

结果

今年是2015年10月

monthBegin

语法

@monthBegin(date)

• 当前月份第一天日期
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取月份第一天的日期，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2015-10-12日的月份第1日是@monthBegin(2015-10-12)

结果

2015-10-12日的月份第1日是2015-10-01

monthEnd

语法

@monthEnd(date)

• 当前月份最后一天日期
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取月份最后一天的日期，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2015-10-12日的月份最后一日是@monthEnd(2015-10-12)

结果

2015-10-12日的月份最后一日是2015-10-30

weekDay

语法

@weekDay(date)

• 当前星期数(1=星期天，2=星期一, ……7=星期六)
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取星期数，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14的星期数是@weekDay(2014-07-14)

结果

2014-07-14的星期数是2

weekOfYear

语法

@weekOfYear(date)

• 当年第几周，将1月1日所在的周视为一年中的第一周
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取周数，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14是这一年的第@weekOfYear(2014-07-14)周

结果

2014-07-14是这一年的第29周

quarter

语法

@quarter(date)

• 当前季度，在1到4范围内
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取季度，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14是2014年的第@quarter(2014-07-14)季度

结果

2014-07-14是2014年的第3季

quarterBegin

语法

@quarterBegin(date)

• 当前季度第一天日期
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取季度第一天日期，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14的季度第1天是@quarterBegin(2014-07-14)

结果

2014-07-14的季度第1天是2014-07-01

quarterEnd

语法

@quarterEnd(date)

• 当前季度最后一天日期
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期中提取季度最后一天日期，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd

例子

2014-07-14的季度区间是@quarterBegin(2014-07-14)至@quarterEnd(2014-07-14）

结果

2014-07-14的季度区间是2014-07-01至2014-09-30

timestemp

语法

@timestemp

• 从世界时1970年1月1日0时0分0秒起至现在的毫秒数
• 默认取自当前AWS服务器节点的时钟时间

参数

无

例子

从1970年1月1日到现在，消费了@timestemp秒

结果

从1970年1月1日到现在，消费了1405322673793秒

isLeapYear

语法

@isLeapYear(date)

• 当前日期是否为闰年
• 默认取自当前AWS服务器节点的时钟时间

参数

• date （可选）从指定日期计算是否为闰年，格式为yyyy-MM-dd或yyyy-MM-dd HH:mm:ss

例子

2014-08-18这一年@if(@isLeapYear(2014-08-18),是闰年,不是闰年)

结果

2014-07-14这一年不是闰年

GMTDate

语法

@GMTDate

• 获取en-US地区的GMT格式的时间，格式：Fri, 10 Dec 2021 06:17:34 GMT

参数

无

UTCDate

语法

@UTCDate

• 获取en-US地区的UTC格式的时间，格式：YYYYMMDD T HHMMSS Z

参数

无

isoDateFormat

语法

@isoDateFormat(*isoDate,format)

• 将ISO-8601格式日期（yyyy-MM-dd'T'HH:mm:ss.SSS'Z'）按照目标格式进行转换

参数

• isoDate (必选) ISO-8601格式日期（如2017-07-10T10:13:47.861Z）
• format (必选) 日期表达式：如yyyy-MM-dd 或yyyy-MM-dd HH:mm:ss，支持"timestamp"转换为时间戳 -

例子

@isoDateFormat(2022-03-03T18:11:00.211Z,yyyy-MM-dd HH:mm:ss)，@isoDateFormat(2022-03-03T18:11:00.211Z,timestamp)

timestamp2date

语法

@timestamp2date(*timestamp)

• 将时间戳转换成日期

参数

• timestamp （必填），格式为时间戳

例子

@timestamp2date(1659846856)

结果

2022-8-7 12:34:16

timestamp2date

语法

@date2Timestamp(*datetime)

• 将日期时间转时间戳

参数

• datetime （必填），格式为yyyy-MM-dd HH:mm:ss

例子

@date2timestamp(2022-8-7 12:34:16)

结果

1659846856

dateDiff

语法

@dateDiff(beginDate,endDate,*units)

• 计算两个日期/时间值的差值

参数

• beginDate （必填）开始日期或日期时间，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd
• endDate （必填）结束日期或日期时间，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd
• units （必填）差值单位，包括：year、month、week、day、hour、minute、second

例子

@dateDiff(2022-08-01,2022-08-02,day)

结果

1

hours

语法

@hours(beginDate,endDate,holidays)

• 计算开始日期到结束日期的小时数,精确到2位小数

参数

• beginDate （必填）开始日期或日期时间，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd
• endDate （必填）结束日期或日期时间，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd
• holidays （可选）节假日规则，不提供该参数时不排除节假日。格式为常量def或字符串数组：- def 固定常量， 使用平台公共节假日日历 ； - 字符串数组，格式为YYYY-MM-DD的节假日日期，多个空格分开

例子

@hours(2022-08-01 8:30,2022-08-02 9:30,@sqlSet(xxx))//客户自定义在一个假期表里

结果

9.5 //如果8月1日是节假日，有效小时数据是8月2日的0-9:30

days

语法

@days(beginDate,endDate,holidays)

• 计算开始日期到结束日期的天数

参数

• beginDate （必填）开始日期或日期时间，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd
• endDate （必填）结束日期或日期时间，格式为yyyy-MM-dd HH:mm:ss或yyyy-MM-dd
• holidays （可选）节假日规则，不提供该参数时不排除节假日。格式为常量def或字符串数组：- def 固定常量， 使用平台公共节假日日历 ； - 字符串数组，格式为YYYY-MM-DD的节假日日期，多个空格分开

例子

@days(2022-08-01,2022-08-18,@sqlSet(xxx)) //客户自定义在一个假期表里

结果

7