简易变量集参考
简易变量集提供了一系列自定义的变量,自定义参数会根据任务调度的业务日期、计划时间及参数的取值格式自动替换为具体的值,实现在任务调度时间内参数的动态替换。
当前系统支持业务日期、计划时间、业务id三类参数的自定义。
- 业务日期是指在调度时间内,任务预期调度运行时间的前一天(即昨天),精确到天。业务日期可通过${yyyymmdd}获取。通常,业务日期为计划时间所在日期-1。
- 计划时间是指在调度时间内,任务预期调度运行的时间点(即当天),精确到秒。计划时间可通过$[yyyymmddhh24miss]获取。
- 业务ID参数包括作业ID和作业生成的实例ID两种,通过$job_id和$instance_id获取。
使用简易变量集时,需要打开简易变量集的开关,功能才能生效。开关打开的方法请参见配置默认项 > 是否使用简易变量集。
业务日期参数
业务日期是指在调度时间内,任务预期调度运行时间的前一天(即昨天)。例如,调度日期为2023年1月1日,那么业务日期就是2022年12月31日。该参数是通过yyyy、yy、mm和dd自定义组合而生成的时间参数,其格式可自定义。例如,${yyyy}、${yyyymm}、${yyyymmdd}和${yyyy-mm-dd}等。
- yyyy:表示4位的年份,取值为业务日期的年份。
- yy:表示2位的年份,取值为业务日期的年份后两位。
- mm:表示月份,取值为业务日期的月份。
- dd:表示天,取值为业务日期的天。
取N年前、N月前、N天前的时间数据请参考表1,参数只能精确到年月日,不支持小时、分钟、秒的写法。
计划时间参数
计划时间是指在调度时间内,任务预期调度运行的时间点(即当天)。该参数是通过yyyy、yy、mm、dd、hh24、mi和ss自定义组合而生成的时间参数,其格式可自定义。例如,$[yyyymmdd]、$[yyyy-mm-dd]、$[hh24miss]、$[hh24:mi:ss]和$[yyyymmddhh24miss]等。
- yyyy:表示4位的年份,取值为计划时间的年份。
- yy:表示2位的年份,取值为计划时间的年份后两位。
- mm:表示月份,取值为计划时间的月份。
- dd:表示天,取值为计划时间的天。
- hh:表示12小时制,取值为计划时间的小时。
- hh24:表示24小时制,取值为计划时间的小时。
- mi:表示分钟,取值为计划时间的分钟。
- ss:表示秒,取值为计划时间的秒。
取N小时前、N分钟前的时间数据请参考表2,该参数不支持通过$[yyyy-N]、$[mm-N]等直接获取多少年前、多少月前的时间数据。
计划时间场景 |
获取方法 |
---|---|
后N年 |
$[add_months(yyyymmdd,12*N)] |
前N年 |
$[add_months(yyyymmdd,-12*N)] |
后N月 |
$[add_months(yyyymmdd,N)] |
前N月 |
$[add_months(yyyymmdd,-N)] |
前/后N周 |
$[yyyymmdd±7*N] |
前/后N天 |
$[yyyymmdd±N] |
前/后N小时 |
获取该时间数据包含如下两种方式: |
前/后N分钟 |
获取该时间数据包含如下四种方式: |
- 调度参数替换值在实例生成时已经确定,所以调度参数的替换值不会随着实例实际运行时间的改变而改变。
- 当调度参数取小时、分钟时,参数替换值由实例的计划时间决定,即由节点调度配置的计划调度时间决定。举例如下:
- 如果当前节点为日调度节点,并且设置计划调度时间为01:00,则小时的参数取值为01。
- 如果当前节点为小时调度节点,并且设置计划调度时间为00:00~23:59,每小时调度一次,则:第一个小时实例计划时间为0点,小时的参数取值为00,第二个小时实例计划时间为1点,小时的参数取值为01,以此类推。