创建日期时间

“创建日期时间”工具将使用现有字段值创建日期字段。

示例

“创建日期时间”工具可用于以下场景：

下表概述了在“创建日期时间”工具中使用的参数：

参数	描述
输入数据集	包含将用于创建日期字段的字段值的数据集。
字段	一个或多个字段的列表以及指定字段中包含的日期或时间值的格式。
时间字段	包含日期或时间值的字段。
时间格式	时间字段中值的格式。
保留源字段	指定用于创建日期的字段是否将保留在输出中。
时区	输入值的时区。
输出时间字段名称	输出时间字段的名称。这是可选参数。默认值为 `TIMESTAMP`。

使用输入数据集参数来识别包含将用于创建日期字段的字段值的数据集。将在输出中返回该数据集，并添加一个新的日期列。

使用字段参数指定一个或多个字段来计算输出日期值。将输出单一日期字段。以下是输入字段和格式的示例：

您有一个名为 MY_DATE_TIME 的字符串字段，其值为 2022-12-30 17:30:00。为时间字段指定 MYDATETIME，为时间格式指定值 yyyy-MM-dd HH:mm:ss。
您有两个字段：值为 07/25/2000 的 MY_DATE 和值为 5:30:00 PM 的 MY_TIME。指定两个字段和格式对。指定第一个时间字段为 MY_DATE，格式值为 MM/dd/yyyy；第二个时间字段为 MY_TIME，格式值为 hh:mm:ss a。

格式必须与指定字段中的值完全匹配。例如，如果字段包含这些值的子集（如 12/30），则不能使用 MM/dd/yyyy 格式。

默认情况下，将从输出数据集中移除用于创建日期的字段。要保留输入字段，请启用保留源字段参数。

时区参数用于指示存储输入时间值的时区。默认值为协调世界时 (UTC)。如果指定 UTC 以外的值，将使用指定的时间值计算输入值，但输出时间字段将转换为 UTC。

时区基于 Joda-Time。有关 Joda-Time 格式的详细信息，请参阅 Joda-Time 可用时区。

该工具将创建单一日期字段。您指定的所有时间字段和格式对都将用于构建单一日期值。要创建多个日期字段，请多次运行该工具。

工具输出包括一个数据集，其中包含输入数据集中的所有字段以及一个新的日期字段。如果未指定输出字段名称，则该时态字段将默认命名为 TIMESTAMP。输出字段类型为 date，且包含每条记录的日期和时间信息。

在预览日期字段时，值将显示为浏览器的时区。在将值写入要素图层时，它们将以 UTC 时间存储。

以下是“创建日期时间”工具的已知局限性：

工具将返回单一日期字段。要计算多个日期字段，请配置其他创建日期时间工具。
指定的字段和格式对必须可以计算出完整的日期值，例如 12/23/2022 12:30:00。日期类型字段不支持仅日期值（如 12/23/2022）或仅时间值（如 12:30:00）。
格式必须与指定字段中的值完全匹配。例如，如果字段包含这些值的子集（如 12/30），则不能使用 MM/dd/yyyy 格式。

需要以下许可和配置：

有关 Data Pipelines 要求的详细信息，请参阅要求。