DataWorks:スケジューリングパラメーターのフォーマット

使用法

スケジューリングパラメーターの代入ロジックは、スケジューリング設定 > Scheduling Parameterにパラメーター名とパラメーター値を指定して定義します。パラメーターを定義した後、 ${parameter name} 構文を使用してコード内で参照できます。 詳細については、「スケジューリングパラメーターの設定と使用」をご参照ください。

• 業務日付と予定時刻を表すには、システム組み込みパラメーター の $bizdate と $cyctime を使用します。これらのパラメーターは、次の値に解決されます：

  • $bizdate=${yyyymmdd}

  • $cyctime=$[yyyymmddhh24miss]

    The preceding examples show the parameter definitions for $bizdate (resolving to ${yyyymmdd}) and $cyctime (resolving to $[yyyymmddhh24miss]), and their preview results when the business date is 2025-10-16.

• デフォルトの 基準時間 の値がニーズに合わない場合は、${...} と $[...] 構文を使用して、2 つの基準時間をカスタム時間パラメーターに変換します。

${...} と $[...] の主な違い

${...} フォーマットと $[...] フォーマットは、時間ベースラインと計算機能が異なります。これらを混在させると、データエラーが発生する可能性があります。

時間フォーマット

${...} または $[...] のフォーマットを使用して、時間パラメーターを生成します。yyyy、yy、mm、dd などのフォーマットコードを組み合わせて、業務日付の前後 N 年、N か月、または N 日の日付を生成します。

オフセット計算

オフセット計算では、業務日付またはスケジューリング時刻に対して時間を加算または減算できます。時間ベースラインに対して、N 年、N か月、N 日、N 時間、または N 分のオフセットを適用できます。時間と分のオフセットは、スケジューリング時刻に対してのみサポートされます。${...} と $[...] はサポートする時間精度が異なるため、オフセット機能も異なります。

1. ${...} オフセット計算

   • コア機能： 年、月、週、日について整数オフセットをサポートします。

     重要

     時間と分のオフセットはサポートされません。たとえば、${yyyy-mm-dd-1/24} は無効な構文です。

   • 構文： ${<time_format><±N>}。ここで、N の単位はフォーマット内の最小単位です (例: yyyymm、yyyymmdd)。

     要件	オフセット単位	構文	例
     N 年前／N 年後	年	${yyyy±N} または ${yy±N}	前年を取得： ${yyyy-1}
     N か月前／N か月後	月	${yyyymm±N}	前月を取得： ${yyyymm-1}
     N 週間前／N 週間後	週	${yyyymmdd±7*N}	前週を取得： ${yyyymmdd-7*1}
     N 日前／N 日後	日	${yyyymmdd±N}	前日を取得： ${yyyymmdd-1}

2. $[...] オフセット計算

   • コア機能： 日、時間、分について分数オフセットをサポートします。

     重要

     $[...] フォーマットでは、$[yyyy-N] や $[mm-N] などの式で、N 年前または N か月前の日付を取得することはできません。年または月のオフセットを実行するには、add_months 関数を使用する必要があります。

   • 構文： $[<time_format><±N>] 。ここで、N は 1 日の分数を表します。N 時間のオフセットには N/24、N 分のオフセットには N/24/60 を使用します。

     要件	オフセット単位	構文	例
     N 年前／N 年後	年	N 年後： $[add_months(yyyymmdd,12*N)] N 年前： $[add_months(yyyymmdd,-12*N)]	前年を取得： $[add_months(yyyymmdd,-12)]
     N か月前／N か月後	月	N か月後： $[add_months(yyyymmdd,N)] N か月前： $[add_months(yyyymmdd,-N)]	前月を取得： $[add_months(yyyymmdd,-1)]
     N 週間前／N 週間後	週	$[yyyymmdd±7*N]	前週を取得： $[yyyymmdd-7*1]
     N 日前／N 日後	日	$[yyyymmdd±N]	前日 (昨日) を取得： $[yyyymmdd-1]
     N 時間前／N 時間後	時間	使用可能なフォーマット： $[hh24miss±N/24]、$[hh24±N/24] $[<custom_time_format>±N/24]	異なるフォーマットで前の時間を取得： 月： $[mm-1/24] 年： $[yyyy-1/24] 年と月： $[yyyymm-1/24] 年、月、日： $[yyyymmdd-1/24] 前日と前の時間： $[yyyymmdd-1-1/24]
     N 分前／N 分後	分	使用可能なフォーマット： $[hh24miss±N/24/60] $[yyyymmddhh24miss±N/24/60] $[mi±N/24/60] $[<custom_time_format>±N/24/60]	異なるフォーマットで、スケジューリング時刻の 15 分前を取得： $[yyyy-15/24/60] $[yyyymm-15/24/60] $[yyyymmdd-15/24/60] $[hh24-15/24/60] $[mi-15/24/60]
     複合オフセット	日 + 時間	$[yyyymmdd±N±M/24]。ここで、N は日のオフセット、M は時間のオフセットです。	例： $[yyyymmdd-1-1/24]

     説明

     • 日またぎの処理： 時間と分のオフセットにより、日付が日またぎになる可能性があります。処理方法の詳細については、「1 時間のオフセット時における日またぎパラメーター置換の処理方法」をご参照ください。

     • 月末日の調整： 月末日に月オフセットを適用した場合、対象月の日数が少ないときは、結果がその月の最終日に自動的に調整されます。たとえば、2025-03-31 から 1 か月減算すると、2 月には 31 日がないため 2025-02-28 が返されます。

エンジン関数を使用した二次変換

組み込みのフォーマットとオフセット機能で必要な値 (例：前月の最終日) を正確に生成できない場合は、ノードのエンジン関数または代入ノードを使用して二次変換を適用します。

参照： スケジューリングパラメーターの戻り値を二次処理する代表的なシナリオ。

文字列連結

文字列連結を使用して、組み込み構文ではサポートされない構造化された日付文字列を作成します。この方法では、スケジューリングパラメーターで生成した日付部分を定数文字列と組み合わせます。

シナリオ 1：通常スケジューリング

通常スケジューリングでは、パラメーター置換は、業務日付とスケジュール時刻という 2 つの時間ベースラインに基づいています。

• ${...} (業務日付)：値はインスタンスの業務日付を基にします。

• $[...] (スケジュール時刻)：値はインスタンスのスケジュール時刻を基にします。

たとえば、A という名前の日次タスクが 00:00 に実行されるようにスケジュールされていて、次のパラメーターがあるとします：

• yesterday=${yyyymmdd}

• today=$[yyyymmddhh24miss]

次の表は、特定のインスタンスでこれらのパラメーターがどのように置換されるかを示しています：

シナリオ 2：データバックフィル

データバックフィル中、パラメーター置換ロジックは、選択された業務日付に基づいて変更されます。これは特に、スケジュール時刻に依存するパラメーターに影響します。

• ${...} (業務日付)：ベースラインは手動で選択された業務日付です。

• $[...] (スケジュール時刻)：ベースラインは手動で選択された業務日付 + 1 日です。

たとえば、業務日付を 2025-03-15 としてタスク A をバックフィルする場合：