描述
将存储在字符串或数值字段中的时间值转换为日期字段。此工具也可用于将以字符串、数值或日期字段形式存储的时间值转换为如一周中周几或一年中第几个月等自定义格式。
使用方法
如果所选择的输入时间字段为字符串或文本字段,可以从支持的时间字段格式列表中选择输入时间格式,或定义自定义的时间字段格式来解释字符串字段中的自定义日期或时间值。有关字符串字段的自定义格式的详细信息,请参阅将字符串时间值转换为日期格式。
如果所选择的输入时间字段是数值字段(短整型、长整型、浮点型或双精度),可以从支持的标准时间字段格式列表中选择输入时间格式。数值字段不支持自定义时间格式。
语法
ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})
参数 | 说明 | 数据类型 |
in_table | 包含着含有要转换的时间值的字段的图层或表。 | Table View |
input_time_field | 含有时间值的字段。可能的类型有短整型、长整型、浮点型、双精度、文本或日期。 | Field |
input_time_format (可选) | 输入时间字段中的时间值所使用的存储格式。可以从下拉列表中选择标准时间格式,也可以输入自定义格式。 注:格式字符串区分大小写。
| String |
output_time_field | 用于要存储转换的时间值的输出字段的名称。 | String |
output_time_type (可选) | 输出时间字段的数据类型。
| String |
output_time_format (可选) | 保存输出时间值时使用的格式。输出时间格式列表取决于为输出时间字段指定的输出数据类型。如果输出时间字段的数据类型不是日期,也可以使用自定义格式。有关自定义格式的列表,请参阅“输入时间格式”的说明。 注:如果输出时间字段的数据类型长度不足以存储转换的时间值,将会截断输出值。 | String |
派生输出
名称 | 说明 | 数据类型 |
out_table | 已更新的输入表。 | 表视图 |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 ConvertTimeField 工具。
import arcpy
arcpy.ConvertTimeField_management("C:/Data/TemporalData.gdb/Input_Table","Input_Time","1033;MMMM dd, yyyy HH:mm:ss;AM;PM","Output_Time")
以下独立脚本演示了如何使用 ConvertTimeField 工具。
# Name: ConvertTimeField_Ex02.py
# Description: Convert a time field to date field
# Requirements: None
# Import system modules
import arcpy
# Set local variables
inTable = "C:\Data\TemporalData.gdb\Input_Table"
inputTimeField = "Input_Time"
inputTimeFormat = "1033;MMMM dd, yyyy HH:mm:ss;AM;PM"
outputDateField = "Output_Time"
# Execute CalculateEndDate
arcpy.ConvertTimeField_management(inTable, inputTimeField, inputTimeFormat, outputDateField)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是