# 日付関数

データが日付として検出されない場合は、他の日付関連関数を適用する前に、まず日付を含む列に [日付に変換] 関数を適用する必要があります。入力する必要がある形式情報は、日付として認識されなかったテキストを解析するためのものではなく、日付の表示テキスト形式を構成するためのものです。

## 期間を追加

指定した時間単位で期間を日付、時刻、タイムスタンプに追加します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| 時間単位 | 日付、時刻、またはタイムスタンプのどの部分に時間を追加するかを選択します。<br><br><ul> <li> <p>年</p> </li> <li> <p>月</p> </li> <li> <p>週</p> </li> <li> <p>日</p> </li> <li> <p>時</p> </li> <li> <p>分</p> </li> <li> <p>秒</p> </li> <li> <p>ミリ秒</p> </li> <li> <p>マイクロ秒</p> </li> </ul> |
| [Use with] (次を使用) | <ul> <li> <p><span>値</span>: [<span>値</span>] 項目に設定される固定値を追加するには、このオプションを選択します。</p> </li> <li> <p><span>他の列</span>: [<span>列</span>] ドロップダウン リストで設定された他の列から値を追加するには、このオプションを選択します。</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| 03/03/2023 | <ul> <li> <p>時間単位: 年</p> </li> <li> <p>Use with (次を使用): 値</p> </li> <li> <p>値: 10</p> </li> </ul> | 03/03/2033 |
| 3/7/2019 2:00:00 PM | <ul> <li> <p>時間単位: 秒</p> </li> <li> <p>Use with (次を使用): 値</p> </li> <li> <p>値: 30</p> </li> </ul> | 3/7/2019 2:00:30 PM |

## 日付の差を計算

指定した時間単位で、列の日付と指定した日付の間の時間を計算します。

計算は、まず日付を指定した日付または時刻の部分まで切り捨て、それらの差を整数として返します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| 時間単位 | 計算に使用する時間部分を選択します。<br><br><ul> <li> <p>年</p> </li> <li> <p>月</p> </li> <li> <p>日</p> </li> <li> <p>時</p> </li> <li> <p>分</p> </li> <li> <p>秒</p> </li> <li> <p>ミリ秒</p> </li> <li> <p>マイクロ秒</p> </li> </ul> |
| 終了 | ターゲットとなる日付の設定方法を選択します。<br><br><ul> <li> <p>[<span>Now</span>] (今) では、現在の日時までの差を計算します。</p> </li> <li> <p>[<span>具体的な日付</span>] では、 [<span>この日</span>] 項目に日付ピッカーを使用して選択した日付を入力して設定します。</p> </li> <li> <p>[<span>他の列</span>] では、 [<span>列</span>] ドロップダウン リストで設定した別の列の日付が使用されます。</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| 06/12/1989 | <ul> <li> <p>時間単位: 日</p> </li> <li> <p>終了: 具体的な日付</p> </li> <li> <p>この日: 31/12/2000</p> </li> </ul> | 4044 |
| <ul> <li> <p>列 A: 8/4/2016</p> </li> <li> <p>列 B: 8/4/2025</p> </li> </ul> | <ul> <li> <p>終了時間: 週</p> </li> <li> <p>終了: 他の列</p> </li> <li> <p>列: B</p> </li> </ul> | 468 |

## 日付を比較

列の日付を、特定の値または別の列の値と比較します。関数は、演算子によって設定された条件が満たされた場合に TRUE を返し、そうでない場合は FALSE を返します。

時刻は時刻としか比較できませんが、タイムスタンプと日付は比較できます。この場合、日付は時刻が 00:00 に設定されたタイムスタンプとして解釈されます。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| 比較モード | 日付を比較するために使用する演算子を選択します。<br><br><ul> <li> <p>等しい</p> </li> <li> <p>Not equals (等しくない)</p> </li> <li> <p>この日の後</p> </li> <li> <p>After or equals (後または等しい)</p> </li> <li> <p>この日の前</p> </li> <li> <p>Before or equals (前または等しい)</p> </li> </ul> |
| [Use with] (次を使用) | <ul> <li> <p><span>値</span>: [<span>値</span>] の日付ピッカーで設定された固定値に対して列をチェックするには、このオプションを選択します。日付を mm/dd/yyyy 形式で選択します。</p> <div><span>情報メモ</span>以前にこの関数を別の形式の固定日付で構成していた場合、入力を解析して新しい日付入力に正しく表示しようとします。ただし、空の入力が表示される場合は、 [<span>値</span>] を再設定する必要がある場合があります。</div> </li> <li> <p><span>他の列</span>: [<span>列</span>] ドロップダウン リストで設定された別の列の値に対して列をチェックするには、このオプションを選択します。</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| <ul> <li> <p>1969-02-27</p> </li> <li> <p>1989-11-09</p> </li> </ul> | <ul> <li> <p>比較モード: この日の後</p> </li> <li> <p>Use with (次を使用): 値</p> </li> <li> <p>値: 01/01/1989</p> </li> </ul> | <ul> <li> <p>FALSE</p> </li> <li> <p>TRUE</p> </li> </ul> |

## 日付に変換

列に含まれているデータ タイプを、システムで日付として解釈されるように変換します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| [Date format] (日付形式) | 列の予想される日付形式を選択します。<br><br><ul> <li> <p>自動: 現在の形式を自動的に検出します。</p> </li> <li> <p>カスタム: 特定の日付形式を入力するには、 [<span>日付パターン</span>] 項目で設定します。</p> </li> <li> <p>YYYY-MM-DD</p> </li> <li> <p>YYYYMMDD</p> </li> <li> <p>M/D/YYYY</p> </li> <li> <p>M/D/YY</p> </li> <li> <p>MM/DD/YY</p> </li> <li> <p>MMM D、YYYY</p> </li> <li> <p>MMMM D,&nbsp;YYYY</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

## 時間に変換

列に含まれているデータ タイプを、システムで時間として解釈されるように変換します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| [Date format] (日付形式) | 列の予想される時間形式を選択します。<br><br><ul> <li> <p>自動: 現在の形式を自動的に検出します。</p> </li> <li> <p>カスタム: 特定の時間形式を入力するには、 [<span>日付パターン</span>] 項目で設定します。</p> </li> <li> <p>hh:mm</p> </li> <li> <p>hh:mm:ss</p> </li> <li> <p>hh:mm AM/PM</p> </li> <li> <p>hh:mm:ss AM/PM</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

## タイムスタンプに変換

列に含まれているデータ タイプを、システムでタイムスタンプとして解釈されるように変換します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| [Date format] (日付形式) | 列の予想されるタイムスタンプ形式を選択します。<br><br><ul> <li> <p>自動: 現在の形式を自動的に検出します。</p> </li> <li> <p>カスタム: 特定のタイムスタンプ形式を入力するには、 [<span>日付パターン</span>] 項目で設定します。</p> </li> <li> <p>YYYYMMDD hh:mm</p> </li> <li> <p>YYYYMMDD hh:mm:ss</p> </li> <li> <p>YYYYMMDDThh:mm</p> </li> <li> <p>YYYYMMDDThh:mm:ss</p> </li> <li> <p>M/D/YYYY hh:mm AM/PM</p> </li> <li> <p>M/D/YY hh:mm&nbsp;AM/PM</p> </li> <li> <p>MM/DD/YY hh:mm AM/PM</p> </li> <li> <p>M/D/YYYY hh:mm:ss&nbsp;AM/PM</p> </li> <li> <p>M/D/YY hh:mm:ss AM/PM</p> </li> <li> <p>MM/DD/YY HH:mm:ss&nbsp;AM/PM</p> </li> <li> <p>MMM D、YYYY hh:mm:ss AM/PM</p> </li> <li> <p>Weekday, MMMM D, YYYY hh:mm:ss&nbsp;AM/PM</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

## 部分から日付を作成

他の列の数値部分を連結させて、新しい日付列を作成します。

### [Properties] (プロパティ)

| プロパティ | 設定 |
| --- | --- |
| 年 | 作成する日付の年の情報が含まれる列を選択します。 |
| 月 | 作成する日付の月の情報が含まれる列を選択します。 |
| 日 | 作成する日付の日の情報が含まれる列を選択します。 |
| 新しい列名 | 連結用に作成される列の名前を入力します。新しい名前を入力しない場合、既定の列名は `new_date` になります。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| <ul> <li> <p>列 A: 10</p> </li> <li> <p>列 B:&nbsp;2021</p> </li> <li> <p>列 C: 12</p> </li> </ul> | <ul> <li> <p>年: 列 B</p> </li> <li> <p>月: 列 A</p> </li> <li> <p>日: 列 C</p> </li> </ul> | 列 D: 10/21/2021 |

## 部分から時間を作成

他の列の数値部分を連結させて、新しい時間列を作成します。

### [Properties] (プロパティ)

| プロパティ | 設定 |
| --- | --- |
| 時 | 作成する時間の時の情報が含まれる列を選択します。 |
| 分 | 作成する時間の分の情報が含まれる列を選択します。 |
| 秒 | 作成する時間の秒の情報が含まれる列を選択します。 |
| ミリ秒 | 作成する時間のミリ秒の情報が含まれる列を選択します。 |
| 新しい列名 | 連結用に作成される列の名前を入力します。新しい名前を入力しない場合、既定の列名は `new_time` になります。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| <ul> <li> <p>列 A: 9</p> </li> <li> <p>列 B: 1</p> </li> <li> <p>列 C:&nbsp;30</p> </li> <li> <p>列 D: 56</p> </li> </ul> | <ul> <li> <p>時: 列 A</p> </li> <li> <p>分: 列 D</p> </li> <li> <p>秒: 列 C</p> </li> <li> <p>ミリ秒: 列 B</p> </li> </ul> | 列 E: 09:56:30.100 |

## 部分からタイムスタンプを作成

他の列の数値部分を連結させて、新しいタイムスタンプ列を作成します。

### [Properties] (プロパティ)

| プロパティ | 設定 |
| --- | --- |
| 年 | 作成するタイムスタンプの年の情報が含まれる列を選択します。 |
| 月 | 作成するタイムスタンプの月の情報が含まれる列を選択します。 |
| 日 | 作成するタイムスタンプの日の情報が含まれる列を選択します。 |
| 時 | 作成するタイムスタンプの時の情報が含まれる列を選択します。 |
| 分 | 作成するタイムスタンプの分の情報が含まれる列を選択します。 |
| 秒 | 作成するタイムスタンプの秒の情報が含まれる列を選択します。 |
| ミリ秒 | 作成するタイムスタンプのミリ秒の情報が含まれる列を選択します。 |
| 新しい列名 | 連結用に作成される列の名前を入力します。新しい名前を入力しない場合、既定の列名は `new_timestamp` になります。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| <ul> <li> <p>列 A: 10</p> </li> <li> <p>列 B: 2021</p> </li> <li> <p>列 C: 12</p> </li> <li> <p>列 D: 9</p> </li> <li> <p>列 E: 1</p> </li> <li> <p>列 F: 30</p> </li> <li> <p>列 G: 56</p> </li> </ul> | <ul> <li> <p>年: 列 B</p> </li> <li> <p>月: 列 A</p> </li> <li> <p>日: 列 C</p> </li> <li> <p>時: 列 D</p> </li> <li> <p>分: 列 G</p> </li> <li> <p>秒: 列 F</p> </li> <li> <p>ミリ秒: 列 E</p> <p>&nbsp;</p> </li> </ul> | 列 H: 10/12/2021 9:56:30 AM |

## 日付部分を抽出

日付の一部を抽出し、選択された日付部分を使って個別の列を作成します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| <ul> <li> <p><span>AM/PM</span> </p> </li> <li> <p><span>日</span> </p> </li> <li> <p><span>曜日名</span> </p> </li> <li> <p><span>曜日番号</span> </p> </li> <li> <p><span>年の日</span> </p> </li> <li> <p><span>時 (12 時間時計)</span> </p> </li> <li> <p><span>時 (24 時間時計)</span> </p> </li> <li> <p><span>分</span> </p> </li> <li> <p><span>月</span> </p> </li> <li> <p><span>月名</span> </p> </li> <li> <p><span>四半期</span> </p> </li> <li> <p><span>四半期番号</span> </p> </li> <li> <p><span>秒</span> </p> </li> <li> <p><span>毎週</span> </p> </li> <li> <p><span>年</span> </p> </li> <li> <p><span>年-月</span> </p> </li> <li> <p><span>年-四半期</span> </p> </li> <li> <p><span>年-週</span> </p> </li> </ul> | トグルを使用して、作成する列を選択します。選択した各部分は異なる列に抽出されます。既定の列名は `<prefix_or_source_column_name>_<date_part>` になります。 |
| 日付部分のプレフィックス | 作成された各列の名前に追加されるカスタム プレフィックスを入力します。プレフィックスを指定しない場合は、日付を含むソース列の名前がプレフィックスとして使用されます。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| 10/12/2021 9:56:30 AM | <ul> <li> <p>曜日名</p> </li> <li> <p>曜日番号</p> </li> <li> <p>月名</p> </li> <li> <p>四半期</p> </li> <li> <p>週</p> </li> <li> <p>日付部分のプレフィックス: 抽出</p> </li> </ul> | <ul> <li> <p>extracted_dayLabel: Thu</p> </li> <li> <p>extracted_dayOfWeek: 4</p> </li> <li> <p>extracted_monthLabel: Oct</p> </li> <li> <p>extracted_quarterLabel: Q4</p> </li> <li> <p>extracted_weekOfYear: 43</p> </li> </ul> |

## 日付の書式設定

日付列で使用する日付書式を変更します。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| [Date format] (日付形式) | ドロップダウン リストから定義済みの形式のいずれかを選択するか、日付に適用するカスタム形式を入力します。<br><br><ul> <li> <p>カスタム: 特定の日付形式を入力するには、 [<span>日付パターン</span>] 項目で設定します。</p> </li> <li> <p>YYYY-MM-DD</p> </li> <li> <p>YYYYMMDD</p> </li> <li> <p>M/D/YYYY</p> </li> <li> <p>M/D/YY</p> </li> <li> <p>MM/DD/YY</p> </li> <li> <p>MMM D、YYYY</p> </li> <li> <p>MMMM D、YYYY</p> </li> <li> <p>YYYYMMDD hh:mm</p> </li> <li> <p>YYYYMMDD hh:mm:ss</p> </li> <li> <p>YYYYMMDDThh:mm</p> </li> <li> <p>YYYYMMDDThh:mm:ss</p> </li> <li> <p>M/D/YYYY hh:mm AM/PM</p> </li> <li> <p>M/D/YY hh:mm&nbsp;AM/PM</p> </li> <li> <p>MM/DD/YY hh:mm AM/PM</p> </li> <li> <p>M/D/YYYY hh:mm:ss AM/PM</p> </li> <li> <p>M/D/YY hh:mm:ss AM/PM</p> </li> <li> <p>MM/DD/YY HH:mm:ss AM/PM</p> </li> <li> <p>MMM D、YYYY hh:mm:ss AM/PM</p> </li> <li> <p>Weekday, MMMM D, YYYY hh:mm:ss&nbsp;AM/PM</p> </li> <li> <p>hh:mm</p> </li> <li> <p>hh:mm:ss</p> </li> <li> <p>hh:mm AM/PM</p> </li> <li> <p>hh:mm:ss AM/PM</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| 12-31-2000 | <ul> <li> <p>日付形式: カスタム</p> </li> <li> <p>日付パターン: DD/MM/YYYY</p> </li> </ul> | 31/12/2000 |
| 05/04/2017 | 日付形式: 曜日、MMMM D、YYYY hh:mm:ss AM/PM | Thursday, May 4, 2017 12:00:00 am |

## 日付を切り捨て

日付の一部を削除します。日付またはタイムスタンプは、切り捨てる単位の最初のポイントに設定されます。

### [Properties] (プロパティ)

| プロパティ | 構成 |
| --- | --- |
| 処理する列 | 関数を適用する列 (複数可) を選択します。<br><br>複数の列を削除する場合は、ドロップダウン リストを使用して削除する列を選択し、 [適用] をクリックします。 |
| 時間単位 | 日付のどの部分より後の値が切り捨てられるかを選択します。日以上に切り捨てた場合、返される値は日付になり、それ以外の場合はタイムスタンプになります。<br><br><ul> <li> <p>年</p> </li> <li> <p>月</p> </li> <li> <p>日</p> </li> <li> <p>時</p> </li> <li> <p>分</p> </li> <li> <p>秒</p> </li> </ul> |
| [Create new column] (新しいカラムを作成) | この関数の結果を新しい列に出力し、元の列をそのまま残す場合は、このチェックボックスをオンにします。 |

### 例

| 入力 | 構成 | 出力 |
| --- | --- | --- |
| 2024-06-22 | 時間単位: 年 | 2024-01-01 |
| 2024-06-22 11:05 | 時間単位: 月 | 2024-06-01 |
| 2024-06-22 11:05:35 | 時間単位: 秒 | 2024-06-22 11:05:01 |