描述
将日期字段中所记录的时间值从一个时区转换到另一个时区。
将时间值从一个时区转换到另一个时区有助于归一化来自不同时区的时态数据。当使用“时间滑块”对来自不同时区的时态数据进行可视化时,这将提高显示和查询性能。
插图
使用方法
要转换的输入时间值必须存储在“日期”字段中。
添加的输出时间字段将是“日期”类型的字段。
如果数据是在实行“夏令时”的时区中采集的,则应该在输入和输出字段中选择实施“夏令时”的参数。
语法
ConvertTimeZone(in_table, input_time_field, input_time_zone, output_time_field, output_time_zone, {input_dst}, {output_dst})
参数 | 说明 | 数据类型 |
in_table | 包含时间戳的输入要素类或表将变换到其他时区。 | Table View |
input_time_field | 包含时间戳的输入字段将变换到其他时区。 | Field |
input_time_zone | 获得时间戳的输入时区。 | String |
output_time_field | 存储变换到所需输出时区的时间戳的输出字段。 | String |
output_time_zone | 时间戳将要变换到的时区。默认情况下,输出时区与输入时区相同。 | String |
input_dst (可选) | 指示是否在输入时区中按照“夏令时”规则收集时间戳。在读取时间值进行时区转换时,将调整时间值以反映“夏令时”期间的时间变更。 默认情况下输入时间值会进行相应调整,以反映输入时区所采用的“夏令时”规则。
| Boolean |
output_dst (可选) | 说明输出时间值是否会反映输出时区中因实行“夏令时”规则而导致的时间变更。 默认情况下输出时间值会进行相应调整,以反映输出时区所采用的“夏令时”规则。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
out_table | 已更新的输入表。 | 表视图 |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 ConvertTimeZone 工具。
import arcpy
arcpy.ConvertTimeZone_management("C:/Data/TemporalData.gdb/InputData","Input_Time","Pacific_Standard_Time","Output_Time","Eastern_Standard_Time","INPUT_ADJUSTED_FOR_DST","OUTPUT_ADJUSTED_FOR_DST")
以下独立脚本演示了如何使用 ConvertTimeZone 工具。
# Name: ConvertTimeZone_Ex02.py
# Description: Convert a time field to another time zone
# Requirements: None
# Import system modules
import arcpy
# Set local variables
inTable = "C:/Data/TemporalData.gdb/InputData"
inputTimeField = "Input_Time"
inputTimeZone = "Pacific_Standard_Time"
outputTimeField = "Output_Time"
onputTimeZone = "Eastern_Standard_Time"
inputUseDaylightSaving = "INPUT_ADJUSTED_FOR_DST"
outputUseDaylightSaving = "OUTPUT_ADJUSTED_FOR_DST"
# Execute CalculateEndDate
arcpy.ConvertTimeZone_management(inTable, inputTimeField, inputTimeZone, outputTimeField, onputTimeZone, inputUseDaylightSaving, outputUseDaylightSaving)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是