调度参数支持的格式_大数据开发治理平台 DataWorks-阿里云帮助中心

调度参数是DataWorks任务调度时使用的参数，可根据您配置的调度参数取值规则，在每次任务运行时自动替换为真实的取值，实现任务调度时间内参数的动态替换。本文为您介绍调度参数支持的格式及相关使用。

背景信息

您可在代码中通过


        ${变量名}

的方式定义变量，并在调度配置 > 参数界面，通过调度参数表达式为代码中的变量赋值，实现调度场景下的代码动态入参。部分节点的调度参数配置存在差异（例如，通用Shell节点中的变量只能以$1、$2、$3...命名），详情请参见各类型节点的调度参数配置示例。

概念	描述
业务日期	指昨天，在离线计算场景下，交易日期为业务发生的日期。DataWorks默认取调度时间内，任务预期调度运行时间的前一天（即昨天）的日期为业务日期，精确到天。例如，今天统计前一天的营业额，此处的前一天，指交易发生的日期，也就是业务日期。
定时时间	指今天，即某业务数据加工任务的预期执行时间。DataWorks默认取调度时间内，任务预期调度运行的时间点（即今天）为定时时间，精确到秒。任务预期执行时间，与实际开始执行时间并非完全一致。任务实际开始执行时间受多方因素影响。

取值方式	参数格式	参数示例	相关参考
基于业务日期获取时间数据。	通常，使用大括号 `${...}` ，结合 `yyyy` 、 `yy` 、 `mm` 及 `dd` 自定义组合生成时间参数，获取业务日期前后多少天、周、月、年。	可通过 `${yyyymmdd}` 、 `${yyyy-mm-dd}` 等${...}自定义时间格式获取，例如： `${yyyymmdd±N}` `${yyyymmdd±7*N}` `${yy±N}` `${mm}` `${yyyy-mm-dd±N}`	更多赋值示例，请参见自定义参数${...} 。
基于定时时间获取时间数据。	通常，使用中括号 `$[...]` ，结合 `yyyy` 、 `yy` 、 `mm` 、 `dd` 、 `hh24` 、 `mi` 及 `ss` 自定义组合生成时间参数，获取定时时间前后多少天、周、月、年、小时、分钟。	可通过 `$[yyyymmddhh24miss]` 等 `$[...]` 自定义时间格式获取。例如，取前一天的前一小时，参数表达式为 `$[yyyymmdd-1-1/24]` 。	更多赋值示例，请参见自定义参数$[...] 。取多少小时、分钟，可能存在跨天问题，跨天时间的参数处理，详情请参见调度参数往前取一个小时，如何处理跨天参数替换的问题。

场景示例	操作说明	相关参考
通过引擎函数将时间格式的内容加工为时间戳。	在代码中使用引擎函数获取目标时间。	调度参数返回值二次处理的典型场景
${mm}01：获取每月1号。	通过纯字符串拼接，获取目标时间。	无

时间加减周期	获取方式
后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小时	获取该时间数据包含如下方式： `$[hh24miss±N/24]` 、 `$[hh24±N/24]` `$[自定义时间格式±N/24]` 。例如，取前一个小时的不同时间格式：取月： `$[mm-1/24]` 。取年： `$[yyyy-1/24]` 。取年月： `$[yyyymm-1/24]` 。取年月日： `$[yyyymmdd-1/24]` 。取前一天且前一小时： `$[yyyymmdd-1-1/24]`
前/后N分钟	获取该时间数据包含如下方式： `$[hh24miss±N/24/60]` `$[yyyymmddhh24miss±N/24/60]` `$[mi±N/24/60]` `$[自定义时间格式±N/24/60]` 。例如，取定时时间15分钟前的不同时间格式： `$[yyyy-15/24/60]` `$[yyyymm-15/24/60]` `$[yyyymmdd-15/24/60]` `$[hh24-15/24/60]` `$[mi-15/24/60]`

内置参数	定义
$bizdate	业务日期，格式为 `yyyymmdd` ，与自定义参数 `${yyyymmdd}` 取值一致。该参数的应用较为广泛，日常调度中默认任务预期运行时间的前一天为业务日期。
$cyctime	任务的定时时间，格式为 `yyyymmddhh24miss` ，与自定义参数 `$[yyyymmddhh24miss]` 取值一致。
$gmtdate	当前日期，格式为 `yyyymmdd` 。该参数默认取当天日期，执行补数据操作时输入的日期为 `业务日期+1` 。
$bizmonth	业务月份，格式为 `yyyymm` 。如果业务日期的月份与当前月份一致，则 `$bizmonth=业务日期月份-1` 。如果业务日期的月份与当前月份不一致，则 `$bizmonth=业务日期月份` 。
$jobid	任务所属的业务流程ID。
$nodeid	节点ID。
$taskid	节点产生的实例ID。


关系类别	说明及示例
调度参数与实际运行时间的关系	调度参数替换值在实例生成时已确定，因此，调度参数的替换值不会随着实例实际运行时间的改变而产生变化。
调度参数与任务定时时间的关系	当调度参数取小时、分钟时，参数替换值由实例的定时时间决定，即由节点调度配置的定时调度时间决定。例如，当前节点为小时调度节点，并且设置定时调度时间为 `00：00` ~ `23：59` ，每小时调度一次，则：第一个小时实例定时时间为 `0` 点，小时的参数取值为 `00` 。第二个小时实例定时时间为 `1` 点，小时的参数取值为 `01` 。
调度参数与业务日期、定时时间的关系