# 日期函數

如果您的資料未被偵測為日期，您需要先將轉換為日期函數套用於包含日期的欄位，然後才能套用任何其他與日期相關的函數。您需要填寫的格式資訊只是為了設定日期的顯示文字格式，而不是剖析未偵測為日期的文字。

## 新增持續時間

以指定的時間單位，將持續時間新增至日期、時間或時間戳記

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<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> |
| 使用搭配 | <ul> <li> <p><span>值</span>：選取此選項，可以加上在<span>值</span>欄位中設定的固定值。</p> </li> <li> <p><span>其他欄</span>：選取此選項，可以加上在<span>欄</span>下拉式清單中設定的另一欄的值。</p> </li> </ul> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| 03/03/2023 | <ul> <li> <p>時間單位：年</p> </li> <li> <p>搭配使用: 值</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>搭配使用: 值</p> </li> <li> <p>值：30</p> </li> </ul> | 3/7/2019 2:00:30 PM |

## 計算日期差異

對於給定的時間部分單位，計算欄中日期與所選日期之間的時間。

計算的方法是先將日期截斷為指定的日期或時間部分，然後以整數形式傳回兩個時間部分之間的差距。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<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>現在</span>，用來計算與目前日期和時間之間的差異。</p> </li> <li> <p><span>特定日期</span>，用來輸入您選擇的日期，使用<span>此日期</span>欄位中的日期選擇器來設定。</p> </li> <li> <p><span>其他欄</span>用來使用來自另一欄的日期，在<span>欄</span>下拉式清單中設定。</p> </li> </ul> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| 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 的時間戳記。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<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> |
| 使用搭配 | <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> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| <ul> <li> <p>1969-02-27</p> </li> <li> <p>1989-11-09</p> </li> </ul> | <ul> <li> <p>比較模式：之後</p> </li> <li> <p>搭配使用: 值</p> </li> <li> <p>值：01/01/1989</p> </li> </ul> | <ul> <li> <p>False</p> </li> <li> <p>True</p> </li> </ul> |

## 轉換為日期

轉換欄中包含的資料類型，以便解譯為系統中的日期。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<br><br>如果要將其套用於多個欄，請使用下拉式清單選取是哪些欄，然後按一下套用。 |
| 日期格式 | 選取欄的預期日期格式。<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, YYYY</p> </li> </ul> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

## 轉換為時間

轉換欄中包含的資料類型，以便解譯為系統中的時間。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<br><br>如果要將其套用於多個欄，請使用下拉式清單選取是哪些欄，然後按一下套用。 |
| 日期格式 | 選取欄的預期時間格式。<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> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

## 轉換為時間戳記

轉換欄中包含的資料類型，以便解譯為系統中的時間戳記。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<br><br>如果要將其套用於多個欄，請使用下拉式清單選取是哪些欄，然後按一下套用。 |
| 日期格式 | 選取欄的預期時間戳記格式。<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> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

## 建立起始日期部分

串連來自其他欄的數字部分，以建立新的日期欄。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 年 | 選取包含您要建立之日期年份資訊的欄。 |
| 月 | 選取包含您要建立之日期月份資訊的欄。 |
| 日 | 選取包含您要建立之日期日子資訊的欄。 |
| 新的欄名稱 | 輸入將為串連建立的欄名稱。如果不輸入新的名稱，預設欄名稱將是 `new_date`。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| <ul> <li> <p>欄 A：10</p> </li> <li> <p>欄 B：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 |

## 建立起始時間部分

串連來自其他欄的數字部分，以建立新的時間欄。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 小時 | 選取包含您要建立之時間小時資訊的欄。 |
| 分鐘 | 選取包含您要建立之時間分鐘資訊的欄。 |
| 秒 | 選取包含您要建立之時間秒鐘資訊的欄。 |
| 毫秒 | 選取包含您要建立之時間毫秒資訊的欄。 |
| 新的欄名稱 | 輸入將為串連建立的欄名稱。如果不輸入新的名稱，預設欄名稱將是 `new_time`。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| <ul> <li> <p>欄 A：9</p> </li> <li> <p>欄 B：1</p> </li> <li> <p>欄 C：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 |

## 建立起始時間戳記部分

串連來自其他欄的數字部分，以建立新的時間戳記欄。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 年 | 選取包含您要建立之時間戳記年份資訊的欄。 |
| 月 | 選取包含您要建立之時間戳記月份資訊的欄。 |
| 日 | 選取包含您要建立之時間戳記日子資訊的欄。 |
| 小時 | 選取包含您要建立之時間戳記小時資訊的欄。 |
| 分鐘 | 選取包含您要建立之時間戳記分鐘資訊的欄。 |
| 秒 | 選取包含您要建立之時間戳記秒鐘資訊的欄。 |
| 毫秒 | 選取包含您要建立之時間戳記毫秒資訊的欄。 |
| 新的欄名稱 | 輸入將為串連建立的欄名稱。如果不輸入新的名稱，預設欄名稱將是 `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 |

## 擷取日期部分

擷取日期部分並以所選日期部分建立獨立的欄。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<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> |

## 格式日期

變更要用於日期欄的日期格式。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<br><br>如果要將其套用於多個欄，請使用下拉式清單選取是哪些欄，然後按一下套用。 |
| 日期格式 | 從下拉式清單中選取其中一個預先定義的格式，或輸入自訂格式以套用至日期：<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> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| 12-31-2000 | <ul> <li> <p>日期格式：自訂</p> </li> <li> <p>日期模式：DD/MM/YYYY</p> </li> </ul> | 31/12/2000 |
| 05/04/2017 | 日期格式：Weekday, MMMM D, YYYY hh:mm:ss AM/PM | Thursday, May 4, 2017 12:00:00 am |

## 截斷日期

移除日期部分。日期或時間戳記將會設定為您正在截斷之單位的第一個點。

### 屬性

| 屬性 | 設定 |
| --- | --- |
| 要處理的欄 | 選取一個或多個您要套用函數的欄。<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> |
| 建立新欄 | 如果您希望將此函數的結果輸出到新欄並保持原始結果不變，請選取此核取方塊。 |

### 範例

| 輸入 | 設定 | 輸出 |
| --- | --- | --- |
| 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 |