DataWorks：調度參數支援的格式

概念

描述

業務日期

指昨天，在離線計算情境下，業務日期為業務發生的日期。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。