お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

日付と時刻の形式のリファレンス  

日付と時刻のステートは、Java 8 DateTime形式に準拠しています。

ナノ秒は、入力に含まれている場合のみ返されます。含まれていない場合、値はゼロになります。

期間形式パターン  

期間の値はISO-8601パターンに従います。

P(n)DT(n)H(n)M(n)S

• P：期間の開始を示します

• D：日数

• T：日付と時刻の構成要素を区切ります

• H：時間数

• M：分の数

• S：秒数

例。

P2DT3H15M10S - 2日3時間15分10秒を表します。

共通設定 

以下の共通設定に加えて、各状態には、それぞれのセクションで説明する固有の項目が含まれる場合があります。

1. サーキットの右ペインに移動します。

2. ［データ変換］を選択し、［日付／時刻］を選択します。

3. ［日付／時刻］カテゴリーで必要な状態を選択します。

4. 選択した状態をサーキットにドラッグ＆ドロップします。

5. ［設定］で：

1. ［種類］はデフォルトでタスクに設定されています。

2. ［タスクID］と［次の状態］は、選択した状態に基づいて事前に選択されており、ドロップダウンから変更できます。

6. 以下の各状態の設定セクションの説明に従って、状態固有の項目を設定します。

7. 必要に応じて、エラー処理を設定します。

8. ［入力パス］、［出力パス］、［結果パス］、［結果セレクター］を設定するには、［設定］タブの横にある［入力／出力］をクリックします。詳細については、入出力処理を参照してください。

      

日付／時刻で使用できる状態は次のとおりです。

追加 

指定した期間を、指定した日付または時刻の値に追加します。

ビルダー表示でのペイロード設定

• ［日時］：日付または日時の値（静的または動的）。

• ［入力］：入力形式、タイムゾーン、ロケールを指定します。

• ［期間］：入力日時に追加する期間。

• ［出力］：出力形式、タイムゾーン、ロケールを定義します。

コード表示  

{
'Add Duration': {
'タブ': 'datetime',
'task_id': 'add',
'payload': {
'datetime': '2025-08-25',
'input': {
'format': 'yyyy-MM-dd',
'zone': 'Asia/Kolkata'
},
'output': {
'format': 'dd-MMMM-yyyy',
'zone': 'UTC',
'locale': 'fr-FR'
},
'duration': 'P2D'
},
'next': 'End'
}
}

減算  

指定した期間を、指定した日付または時刻の値から差し引きます。

［ビルダー表示］ ［ペイロード設定］

• ［日時］：日時の値（静的または動的、たとえば $.time）を指定します。

• ［入力］：入力形式、タイムゾーン、ロケールを指定します。

• ［期間］：入力日時から差し引く期間です。

• ［出力］：出力形式、タイムゾーン、ロケールを定義します。

［コード表示］  

{
'Add Duration': {
'タブ': 'datetime',
'task_id': 'subtract',
'payload': {
'datetime': '2025-08-25',
'input': {
'format': 'yyyy-MM-dd',
'zone': 'Asia/Kolkata'
},
'output': {
'format': 'dd-MMMM-yyyy',
'zone': 'UTC',
'locale': 'fr-FR'
},
'duration': 'P2D'
},
'next': 'End'
}
}

書式設定

日付または時刻の値を、指定した文字列形式に変換します。

ビルダー表示ペイロード設定

次のペイロードを設定します。

• 日時：日時の値（静的または動的、たとえば $.time）を指定します。

• 入力：入力形式、タイムゾーン、ロケールを指定します。

• 出力：出力形式、タイムゾーン、ロケールを定義します。

コード表示

{
'Format Date': {
      'タブ': 'datetime',
      'task_id': 'format',
      'payload': {
          'datetime': '2025-08-25',
          'input': {
            'format': 'yyyy-MM-dd',
            'zone': 'Asia/Kolkata'
          },
          'output': {
            'format': 'dd-MMMM-yyyy',
            'zone': 'UTC',
            'locale': 'fr-FR'
          }
      },
      'next': 'End'
}
}

差分の算出

2つの日付または時刻の値の時間差を計算します。

ビルダー表示ペイロード設定

次のペイロードを設定します。

• 開始日時：開始日時の値を指定します。

• 終了日時：終了日時の値を指定します。

• 入力：入力形式、タイムゾーン、ロケールを指定します。

• 単位：結果を返す単位（たとえば、日、時間、分）を指定します。

コード表示

{
'Date Difference': {
'タブ': 'datetime',
'task_id': 'difference',
'payload': {
'start_datetime': '2025-08-25',
'end_datetime': '2025-10-25',
'input': {
'format': 'yyyy-MM-dd',
'zone': 'Asia/Kolkata'
},
'units': ['days', 'hours', 'minutes']
},
'next': 'End'
}
}

現在日時  

サーキットの実行中に現在の日付と時刻を取得します。

使用例  

この状態は、実行時にデータやログにタイムスタンプを付けるために使用できます。

ビルダー表示設定

次のペイロードを設定します。

1. 出力：入力形式、タイムゾーン、ロケールを指定します

2. 時刻を含める。 
   

1. 有効→現在の日付と時刻を返します
   

2. 無効→その日の開始時刻を返します
   

コード表示  

{
'Current Datetime': {
'タブ': 'datetime',
'task_id': 'current_datetime',
'payload': {
'output': {
'format': 'dd-MMMM-yyyy',
'zone': 'UTC',
'locale': 'fr-FR'
},
'include_time': true
},
'next': 'End'
}
}

期間の抽出  

期間値からの特定の単位の抽出

ビルダー表示のペイロード設定

次のペイロードを設定します。

• 期間：期間を入力します

• 単位：結果が返される単位（たとえば、日、時間、分）を指定します。

単位が選択されていない場合、結果は期間として返されます。

コードビュー  

{
'Extract Duration': {
'タブ': 'datetime',
'task_id': 'extract_duration',
'payload': {
'duration': 'P2DT5H7M',
'units': ['hours', 'minutes', 'seconds']
},
'next': 'End'
}
}

日時の抽出  

日時値から特定の日付または時刻の要素を取得します。  

ビルダービューのペイロード設定

次のペイロードを設定します。

• 日時：このキーでは、日時のみが動的に渡されます（例：$.time）。

• 入力：入力形式、タイムゾーン、ロケールを指定します。

• 単位：ドロップダウンから単位を選択します。取得された日時は、選択した単位で返されます。

コードビュー  

{
'Extract Datetime': {
'タブ': 'datetime',
'task_id': 'extract_datetime',
'payload': {
'datetime': '2025-10-25',
'input': {
'format': 'yyyy-MM-dd',
'zone': 'Asia/Kolkata'
},
'units': ['days', 'hours', 'minutes']
},
'next': 'End'
}
}