# 日期函数

如果您的数据未被检测为日期，您需要先将转换为日期函数应用于包含日期的列，然后再应用任何其他日期相关函数。您需要填写的格式信息仅用于配置日期的显示文本格式，而不是用于解析未被检测为日期的文本。

## 添加持续时间

以指定的时间单位为日期、时间或时间戳添加持续时间。

### 属性

| 属性 | 配置 |
| --- | --- |
| 要处理的列 | 选择要应用该函数的列。<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 |
| 2019/03/07 14:00:00 | <ul> <li> <p>时间单位: 秒</p> </li> <li> <p>搭配使用: 值</p> </li> <li> <p>值: 30</p> </li> </ul> | 3/7/2019 2:00:30<br>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>年年年年-月月-日日</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>如果要将其应用于多个列，请使用下拉列表选择要应用的列，然后点击应用。 |
| 日期格式 | 选择列的预期时间格式。<br><br><ul> <li> <p>自动，以自动检测当前格式。</p> </li> <li> <p>自定义，用于输入您的特定时间格式，在<span>日期模式</span>字段中设置。</p> </li> <li> <p>时时:分分</p> </li> <li> <p>时时:分分:秒秒</p> </li> <li> <p>时时:分分 AM/PM</p> </li> <li> <p>时时:分分:秒秒 AM/PM</p> </li> </ul> |
| 创建新列 | 如果您想在新列中输出此函数的结果并保持原始数据不变，请选中此复选框。 |

## 转换为时间戳

转换列中包含的数据类型，以便在系统中将其解释为时间戳。

### 属性

| 属性 | 配置 |
| --- | --- |
| 要处理的列 | 选择要应用该函数的列。<br><br>如果要将其应用于多个列，请使用下拉列表选择要应用的列，然后点击应用。 |
| 日期格式 | 选择列的预期时间戳格式。<br><br><ul> <li> <p>自动，以自动检测当前格式。</p> </li> <li> <p>自定义，用于输入您的特定时间戳格式，在<span>日期模式</span>字段中设置。</p> </li> <li> <p>年年年年月月日日 时时:分分</p> </li> <li> <p>年年年年月月日日 时时:分分:秒秒</p> </li> <li> <p>年年年年月月日日时间时时:分分</p> </li> <li> <p>年年年年月月日日时 时时:分分:秒秒</p> </li> <li> <p>月/日/年年年年 时时:分分 AM/PM</p> </li> <li> <p>月/日/年年 时时:分分 AM/PM</p> </li> <li> <p>月月/日日/年年 时时:分分 AM/PM</p> </li> <li> <p>月/日/年年年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>月/日/年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>月月/日日/年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>月月月 日, 年年年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>星期, 月月月月 日, 年年年年 时时:分分:秒秒 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>`。 |
| 日期部分前缀 | 输入一个自定义前缀，该前缀将添加到每个创建的列的名称中。如果您未指定前缀，则将使用包含日期的源列的名称作为前缀。 |

### 示例

| 输入 | 配置 | 输出 |
| --- | --- | --- |
| 2021/12/10 9:56:30 上午 | <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>已提取_日标签：周四</p> </li> <li> <p>提取的星期几: 4</p> </li> <li> <p>extracted_monthLabel: 十月</p> </li> <li> <p>extracted_quarterLabel: 第四季度</p> </li> <li> <p>提取的年份周数: 43</p> </li> </ul> |

## 格式化日期

更改日期列中使用的日期格式。

### 属性

| 属性 | 配置 |
| --- | --- |
| 要处理的列 | 选择要应用该函数的列。<br><br>如果要将其应用于多个列，请使用下拉列表选择要应用的列，然后点击应用。 |
| 日期格式 | 从下拉列表中选择一种预定义格式，或输入自定义格式以应用于日期：<br><br><ul> <li> <p>自定义，用于输入您的特定日期格式，在<span>日期模式</span>字段中设置。</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> <li> <p>年年年年月月日日 时时:分分:秒秒</p> </li> <li> <p>年年年年月月日日时间时时:分分</p> </li> <li> <p>年年年年月月日日时 时时:分分:秒秒</p> </li> <li> <p>月/日/年年年年 时时:分分 AM/PM</p> </li> <li> <p>月/日/年年 时时:分分 AM/PM</p> </li> <li> <p>月月/日日/年年 时时:分分 AM/PM</p> </li> <li> <p>月/日/年年年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>月/日/年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>月月/日日/年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>月月月 日, 年年年年 时时:分分:秒秒 AM/PM</p> </li> <li> <p>星期, 月月月月 日, 年年年年 时时:分分:秒秒&nbsp;AM/PM</p> </li> <li> <p>时时:分分</p> </li> <li> <p>时时:分分:秒秒</p> </li> <li> <p>时时:分分 AM/PM</p> </li> <li> <p>时时:分分:秒秒 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 | 日期格式：星期, 月月月月 日, 年年年年 时时:分分:秒秒 AM/PM | 2017年5月4日星期四 12: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> |
| 创建新列 | 如果您想将此函数的结果输出到一个新列中并保持原始列不变，请选中此复选框。 |

### 示例

| 输入 | 配置 | 输出 |
| --- | --- | --- |
| 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 |