日期获取

使用说明

日期获取用于提取当前系统时间或当前系统对应的 UTC 时间。

日期获取适用于结果数据命名、批次标识、流程执行时间记录、数据处理日志追踪等场景。通过设置获取策略，可控制时间戳是按每条记录实时获取，还是在工作流或转换器执行期间复用同一个时间值。

功能原理

日期获取根据参数设置读取本地系统时间或 UTC 时间，再按照日期类型、输出格式、分隔符和时区偏移规则生成字符串，最后将结果写入输出数据的指定字段。

本地时间：使用当前系统所在时区的日期和时间。
UTC 时间：使用协调世界时对应的日期和时间。
自定义格式：按用户设置的类型和分隔符组织输出内容。
ISO 标准：按 ISO 日期时间格式输出结果。

SuperMap TransformX 2026 版本开始提供。

输入数据

参数名	参数释义	参数类型
输入	输入待追加日期时间结果字段的数据，可以由数据读入转换器的输出或数据处理转换器的输出来指定。	IFeatureCollection

参数说明

参数名	参数释义	参数类型
类型	指定获取的日期时间内容。日期：仅输出当前日期，即年月日。自定义格式且分隔符为空时，示例为 20260428。时间：仅输出当前时间，即时分秒。自定义格式且分隔符为空时，示例为 114655。日期时间：输出当前日期和时间，即年月日时分秒。自定义格式且分隔符为空时，示例为 20260428114655。	DateTimeOutputType
时区	指定日期时间的获取时区。本地：使用当前系统所在时区。 UTC：使用协调世界时。	DateTimeZoneType
包含时区偏移	当类型中包含时间时可用，用于指定输出结果是否包含时区偏移，默认值为否。否：输出结果不包含时区偏移。例如，20260428114655。是：输出结果包含时区偏移。例如，20260428114655+08:00。	SelectedType
获取策略	指定日期时间结果的获取方式。每条记录：每处理一条输入记录时重新获取一次系统时间。执行工作流：整个工作流启动时获取一次系统时间，所有记录共用该时间戳。执行转换器：该转换器首次被调用时获取一次系统时间，所有记录共用该时间戳。	DateTimeAcquisitionStrategy
输出格式	指定日期时间字符串的输出格式，默认值为自定义。自定义：按照类型和分隔符组合输出内容。 ISO 标准：按照 ISO 标准输出结果。本地时区包含偏移时，示例为 2026-04-28T17:21:44+08:00；UTC 时区包含偏移时，示例为 2026-04-28T09:21:44Z。	DateTimeOutputFormat
分隔符	当输出格式为自定义时可用，用于分隔年月日时分秒。默认值为空。另提供空格、英文逗号、/、\、- 五种分隔符。例如，分隔符设置为 - 且类型为日期时间时，输出结果为 2026-04-28-11-46-55。	DateTimeSeparator
结果字段	指定存放日期时间结果的字段名称，默认值为 time。若输出数据中已存在同名字段，系统会在字段名后追加 _n 生成新字段名。	String
预览	根据当前参数设置显示日期时间输出结果的示例，便于确认格式是否符合预期。	String

输出结果

参数名	参数释义	参数类型
输出	包含原始数据和日期时间结果字段的数据。原始字段、属性值和几何对象保持不变。	DatasetFeatureCollection
无效数据	当前转换器无法处理的记录。	IFeatureCollection

应用示例

案例说明

在批量生成成果数据时，为每条输出记录追加工作流启动时间，作为结果数据的批次标识，便于后续追踪数据生产时间。

主要操作步骤

读入待处理数据，并将读入转换器的输出端口连接到日期获取转换器的输入端口。
双击日期获取转换器，打开参数设置对话框。
类型选择日期时间，时区选择本地，包含时区偏移选择是。
获取策略选择执行工作流，输出格式选择 ISO 标准。
结果字段设置为 time，点击确定按钮，运行工作流并查看输出数据。

结果说明

输出数据中新增 time 字段，字段值为工作流启动时获取的本地日期时间。所有记录共用同一个时间戳，结果可用于成果命名、批次记录或后续字段拼接。