日付/時刻変換ノード

日付/時刻ノードは、1 つ前のノードから渡された timestamp データを、次のノードに渡す前に変更するために使用します。日付/時刻変換は、時間に敏感なプロセスの自動化や、時間ベースのデータ分析、クラウド環境における日付/時刻表現の一貫性を確保する場合に有用です。例えば、前回のバックアップから 7 日後にバックアップを実行するようにスケジュールしたい場合や、開始時間を終了時間から差し引いて特定の時間範囲内のログエントリのみをフィルタリングしたい場合、または異なる API の要件に合わせて日付/時刻フォーマットを変換したい場合などです。

次の点に注意してください：

• 日付/時刻ノードは、フロー内の前のノードからの入力として、timestamp データタイプのフィールドのみを受け付けます。

• 日付/時刻ノードは、フロー内の直前のトリガーノードまたは他のアクティビティノードの両方からの入力をサポートします。

• 日付/時刻ノードは連結して使用できます。

• 変換したいフィールドを選択: 変換対象のフィールドを指定します。フィールドは timestamp データタイプである必要があります。各変換ごとに入力を選択します。入力には、フロー内の前のノードの timestamp フィールド、またはこのノード内の直前の変換結果のどちらかを使用できます。+ ボタンを使用して前のノードのフィールドを参照してください。詳細は Parameter types を参照してください。

• 変換アクションを定義: 変換で実行するアクションを定義し、その出力を新しいフィールドに保存します。以下はサポートされている変換オペレーションです。変換アクションごとに設定方法が異なる点に注意してください。

  • Add: 参照した timestamp フィールドに時間を加算します。
  • Subtract: 参照した timestamp フィールドから時間を減算します。
  • Format: 参照した timestamp フィールドを新しいフォーマットに変更します。例えば、日付を YYYY-MM-DD から MM/DD/YYYY に変更できます。ISO 8601 フォーマットは、その標準を要求する API（例：DataHub への取り込み）向けに利用できます。
  • Truncate: タイムスタンプを選択した期間の開始時点に切り捨てます。1 秒・1 分・1 時間・1 日・1 か月の開始時点に切り捨てることができます。例えば、2008-12-25 を月単位で切り捨てると、2008-12-01 になります。

• + 別のトランスフォームを追加: 複数の日付/時刻フィールドを同時に変換し、それぞれに同じまたは異なる変換を適用します。各ステップは、前のステップの出力を入力として使用できるため、1 つのノード内でオペレーションを連結できます（例：月単位に切り捨て、その後 1 日を減算し、その後フォーマットを変更）。これは、開始日と終了日などの日時フィールドを、厳密なフォーマット要件を持つ API 呼び出しや後続の処理に使用する前に、一貫したフォーマットにそろえる場合に有用です。

• Test: このノードをテストできます。