メインコンテンツへスキップ

日付/時刻変換ノード

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

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

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

  • 日付/時刻ノードは、フロー内の直前のトリガーノードまたは他のアクティビティノードのどちらからの入力にも対応します。

  • 日付/時刻ノードは連結してチェーンすることができます。

日付/時刻トランスフォーマーの設定

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

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

    • Add: 参照している timestamp フィールドに時間を加算します。
    • Subtract: 参照している timestamp フィールドから時間を減算します。
    • Format: 参照している timestamp フィールドを新しいフォーマットに変更します。たとえば、日付を YYYY-MM-DD から MM/DD/YYYY に変更することができます。ISO 8601 フォーマットは、その標準を要求する API(例: DataHub の取り込み)向けに利用できます。
    • Truncate: タイムスタンプを指定した期間の開始時点に切り捨てます。秒・分・時・日・月の開始に切り捨てることができます。たとえば、2008-12-25 を月単位で切り捨てると、2008-12-01 になります。
  • + 別のトランスフォームを追加: 複数の日付/時刻フィールドを同時に変換し、それぞれに同じ、または異なる変換を適用します。各ステップは前のステップの出力を入力として使用できるため、1 つのノード内でオペレーションをチェーンできます(例: 月単位で切り捨て、その後 1 日減算し、最後にフォーマットを変更)。これは、開始日や終了日などの日付フィールドを、厳密なフォーマット要件を持つ API 呼び出しやその後のプロセスで使用する前に、一貫したフォーマットに揃えるのに有用です。

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