本文对任务编排功能涉及的4种变量进行介绍,并介绍如何配置时间变量。

变量介绍

  • 节点变量:节点变量为时间变量,在当前节点中使用。节点变量不会显示在下游节点的输入变量中,对下游节点不可见且不可引用。
  • 任务流变量:任务流变量为时间变量,在所有节点中都可使用。任务流变量显示在下游节点的输入变量中,对下游可见且可引用。
  • 输入变量:输入变量是来自任务流变量和上游节点的输出变量。输入变量可使用 ${变量名} 的形式在当前节点(例如单实例SQL节点)的SQL语句中引用,或者作为判断变量(例如用于条件分支节点)。
  • 输出变量:输出变量由本节点定义并赋值,可被下游访问和引用。在下游节点的输入变量中,可以查看本节点的输出变量。

    例如,使用SQL赋值语句读取数据库表中的内容,并通过定义输出变量,将变量值供下游节点使用。

说明 关于上述变量在节点中的应用,请参见任务类型介绍

配置时间变量

配置项 说明
变量名 输入自定义时间变量的名称。
说明 如需删除已配置的变量,您可以单击右侧的删除-变量
变量规则 配置时间变量的规则。
  • 时间格式:输入您需要的时间格式。关于时间格式,请参见时间格式
  • 时间偏移量:时间变量以业务时间bizdate(当前日期的前一天)的时间点为基准进行偏移,即自定义的时间变量是基于bizdate做加减运算的。

    例如,变量名为6_month_ago,时间格式为yyyy-MM-dd,偏移量设置为-6月。如果当前日期为2021-8-12,则变量${6_month_ago}的值为2021-02-11。

    时间变量
    说明 配置时间变量后,您可以在右侧的SQL语句中引用该变量,格式为${变量名},同时您可以单击SQL预览来查看时间变量的值。

时间格式

变量支持的时间格式如下:

时间变量 说明 输入示例 返回示例
公元 G表示公元。 Gyyyy 公元2021年
  • y或yyyy表示当天所在的年份。
  • yy表示年份的后两位数字。
  • Y表示当前周结束时(周日为最后一天)的年份。
yyyy 2021
M当前年份的第N个月,M的返回值为[1,12],MM的返回值为[01,12],MMM将返回一月至十二月 MM 08
  • w表示当前年份的第N周,w的返回值为[1,52],ww返回值为[01,52]。
  • W表示当前月份的第N周,返回值为[1,5]。
ww 13
  • D表示当前年份的第N天,D的返回值为[1,365],DD的返回值为[01,365],DDD的返回值为[001,365]。
  • d表示当前月份的第N天,d的返回值为[1,31],dd的返回值为[01,31]。
D 360
周几
  • E表示周几,将返回星期一至星期日。
  • e表示周几的数字表达,返回值为[1-7](默认1表示周一)。
    说明 您可以在变量偏移中配置+1日,实现西方日历(即1为表示周日)。
e 1
上午、下午 a表示上午或下午。返回值为:上午(00:00-11:59)、下午(12:00-23:59)。 a 上午
小时
  • H表示当天的第N个小时,0表示0点。H的返回值为[0, 23],HH的返回值为[00, 23]。
  • h表示上午、下午的第N个小时,1表示0点,h的返回值为[1, 12],hh的返回值为[01, 12]。
  • K表示上午、下午的第N个小时,0表示0点,K的返回值为[0, 11],KK的返回值为[00, 11]。
  • k表示当天的第N个小时,1表示0点,k的返回值[1, 24],kk的返回值[01, 24]。
HH 10
分钟 m表示分钟数,m的返回值[0, 59],mm的返回值[00, 59]。 m 27
  • s表示秒数。
  • S表示毫秒数。
ss 08
时区 z表示时区。 z UTC+08:00

时间格式的组合示例:

输入示例 返回示例
yyyy-MM-dd 2021-08-12
yyyyMM01 20210801
HH:mm:ss 11:05:21
yyyyMMdd HH:mm:ss 20210812 11:05:21