调度参数支持的格式

概念

描述

业务日期

指昨天，在离线计算场景下，业务日期为业务发生的日期。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年

${yyyy±N}

前/后N月

${yyyymm±N}

前/后N周

${yyyymmdd±7*N}

前/后N天

${yyyymmdd±N}

年月日加/减N天

${yyyymmdd±N}

加/减N年（yyyy格式）

${yyyy±N}年

加/减N年（yy格式）

${yy±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小时

获取该时间数据包含如下方式：

• $[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。