对于周期性运行的离线任务而言,系统支持通过使用时间参数自动获取周期任务实例的数据时间。
时间参数使用 ${…} 进行自定义,支持例如 ${yyyyMMdd}、${yyyy-MM-dd}、${HH:mm:ss} 和 ${yyyyMMddHHmmss} 等。其中,yyyy 表示4位的年份,yy 表示2位的年份,MM 表示月,dd 表示天,HH 表示小时,mm 表示分钟,ss 表示秒。各部分之间支持灵活组合。
系统的内置参数 ${timestamp} 作为调度时间对应的10位时间戳,精度到秒级。
示例如下:
以20210710080000时间为基准
时间 | 时间参数格式 | 备注 |
后 N 年 | ${yyyyMMdd+Ny} | 若引用 dt=${yyyyMMdd-1M},将执行替换:dt=20210610 若引用 dt=${yyyyMMdd-1d} ,将执行替换:dt=20210709 若引用 time=${yyyyMMddHHmmss-3h},将执行替换:time=20210710050000 若引用 ti=${yyyyMMddHHmmss-25m},将执行替换:ti=20210710073500 |
前 N 年 | ${yyyyMMdd-Ny} | |
后 N 月 | ${yyyyMMdd+NM} | |
前 N 月 | ${yyyyMMdd-NM} | |
后 N 周 | ${yyyyMMdd+Nw} | |
前 N 周 | ${yyyyMMdd-Nw} | |
后 N 天 | ${yyyyMMdd+Nd} | |
前 N 天 | ${yyyyMMdd-Nd} | |
后 N 小时 | ${yyyyMMddHHmmss+NH} | |
前 N 小时 | ${yyyyMMddHHmmss-NH} | |
后 N 分钟 | ${yyyyMMddHHmmss+Nm} | |
前 N 分钟 | ${yyyyMMddHHmmss-Nm} | |
调度时间戳 | ${timestamp} | ${timestamp}=1625875200
支持使用 “+”、“-” 等运算符处理 |
调度时间戳(13位) | ${timestamp_ms} | ${timestamp_ms}=1698508800000
支持使用 “+”、“-” 等运算符处理。 |
对于常见的日期提供了快捷的转换表达式,如下:
序号 | 时间参数格式 | 说明 |
1 | ${yyyyMMdd+TE} | TENDAY END 数据日期对应旬末 |
2 | ${yyyyMMdd+ME} | MONTH END 数据日期对应月末 |
3 | ${yyyyMMdd+QE} | QUARTER END 数据日期对应季末 |
4 | ${yyyyMMdd+HYE} | HALF YEAR END 数据日期对应半年末 |
5 | ${yyyyMMdd+YE} | YEAR END 数据日期对应年末 |
6 | ${yyyyMMdd+TS} | TENDAY START 数据日期对应旬初 |
7 | ${yyyyMMdd+MS} | MONTH START 数据日期对应月初 |
8 | ${yyyyMMdd+HYS} | HALFYEAR START 数据日期对应半年初 |
9 | ${yyyyMMdd+YS} | YEAR START 数据日期对应年初 |
10 | ${yyyyMMdd+PME} | PRI MONTH END 数据日期对应上月月末 |
11 | ${yyyyMMdd+PYE} | PRI YEAR END 数据日期上年年末 |
说明:
wedata 这里时间参数是自动获取周期任务“实例数据时间”,注意不要和“计划调度时间”混淆:
“计划调度时间”是周期实例期望调度运行时间,可在开发页面 > 调度设置中配置。而“实例数据时间”与周期实例调度周期对应,确定调度周期后“实例数据时间”也就固定了,如配置天周期任务,在20240815的实例数据时间为:2024 - 08 - 15 00:00:00,计划调度时间可以配置为2024 - 08- 15 00:00:00 -- 2024 - 08 - 15 23:59:00的任意时间(可精确到分钟)。可参考下图。
使用占位符来替换时间参数
使用占位符`$dt`来替换时间参数,例如
dt=${yyyyMMdd-1d}
表示时间参数。