转换时区 (数据管理)

摘要

将日期字段中所记录的时间值从一个时区转换到另一个时区。

将时间值从一个时区转换到另一个时区有助于归一化来自不同时区的时态数据。 当使用“时间滑块”对来自不同时区的时态数据进行可视化时,这将提高显示和查询性能。

插图

转换时区图示
将日期字段中所记录的时间值从一个时区转换到另一个时区。

使用情况

    警告:

    此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具

  • 要转换的输入时间值必须存储在“日期”字段中。

  • 添加的输出时间字段将是“日期”类型的字段。

  • 如果数据是在实行“夏令时”的时区中采集的,则应该在输入和输出字段中选择实施“夏令时”的参数。

参数

标注说明数据类型
输入表

包含时间戳的输入要素类或表将变换到其他时区。

Table View
输入时间字段

包含时间戳的输入字段将变换到其他时区。

Field
输入时区

获得时间戳的输入时区。

String
输出时间字段

存储变换到所需输出时区的时间戳的输出字段。

String
输出时区

时间戳将要变换到的时区。 默认情况下,输出时区与输入时区相同。

String
按“夏令时”调整输入的时间字段值
(可选)

指定是否在输入时区中按照“夏令时”规则收集时间戳。 在读取时间值进行时区转换时,将调整时间值以反映“夏令时”期间的时间变更。

默认情况下此选项处于选中状态,输入时间值会进行相应调整,以反映输入时区所采用的“夏令时”规则。

  • 选中 - 按“夏令时”调整输入时间值。
  • 未选中 - 不按“夏令时”调整输入时间值。
Boolean
按“夏令时”调整输出时间字段值
(可选)

说明输出时间值是否会反映输出时区中因实行“夏令时”规则而导致的时间变更。

默认情况下此选项处于选中状态,输出时间值会进行相应调整,以反映输出时区所采用的“夏令时”规则。

  • 选中 - 按输出时区中的“夏令时”调整输出时间值。
  • 未选中 - 不按输出时区中的“夏令时”调整输出时间值。
Boolean

派生输出

标注说明数据类型
更新的输入表

已更新的输入表。

Table View

arcpy.management.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
(可选)

指定是否在输入时区中按照“夏令时”规则收集时间戳。 在读取时间值进行时区转换时,将调整时间值以反映“夏令时”期间的时间变更。

默认情况下输入时间值会进行相应调整,以反映输入时区所采用的“夏令时”规则。

  • INPUT_ADJUSTED_FOR_DST按“夏令时”调整输入时间值。
  • INPUT_NOT_ADJUSTED_FOR_DST不按“夏令时”调整输入时间值。
Boolean
output_dst
(可选)

说明输出时间值是否会反映输出时区中因实行“夏令时”规则而导致的时间变更。

默认情况下输出时间值会进行相应调整,以反映输出时区所采用的“夏令时”规则。

  • OUTPUT_ADJUSTED_FOR_DST按输出时区中的“夏令时”调整输出时间值。
  • OUTPUT_NOT_ADJUSTED_FOR_DST不按输出时区中的“夏令时”调整输出时间值。
Boolean

派生输出

名称说明数据类型
out_table

已更新的输入表。

Table View

代码示例

ConvertTimeZone 示例(Python 窗口)

以下 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 示例 2(独立脚本)

以下独立脚本演示了如何使用 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)