Resumen
Convierte valores de tiempo registrados en un campo de fecha de una zona horaria a otra zona horaria.
Convertir valores de tiempo de una zona horaria a otra ayuda a normalizar los datos temporales de diferentes zonas horarias. Esto mejora el rendimiento de visualización y consulta para visualizar los datos temporales de diferentes zonas horarias con el Control deslizante de tiempo.
Ilustración
Uso
Los valores de tiempo de entrada que se convertirán se deben almacenar en un campo de fecha.
El campo de tiempo de salida agregado será un campo de tipo de fecha.
Si los datos se capturaron en una zona horaria que sigue el horario de verano, entonces deberá elegir los parámetros para respetar ese horario en los campos de entrada y salida.
Sintaxis
arcpy.management.ConvertTimeZone(in_table, input_time_field, input_time_zone, output_time_field, output_time_zone, {input_dst}, {output_dst})
Parámetro | Explicación | Tipo de datos |
in_table | Tabla o clase de entidad de entrada que contiene las marcas de hora que se transformarán a una zona horaria diferente. | Table View |
input_time_field | Campo de entrada que contiene las marcas de hora que se transformarán a una zona horaria diferente. | Field |
input_time_zone | Zona horaria de entrada de la que se adquirieron las marcas de hora. | String |
output_time_field | Campo de salida en el que se almacenarán las marcas de hora transformadas a la zona horaria de salida deseada. | String |
output_time_zone | Zona horaria a la que se transformarán las marcas de tiempo. Por defecto, la zona horaria de salida es la misma que la zona horaria de entrada. | String |
input_dst (Opcional) | Indica si las marcas de tiempo se adquirieron al observar las reglas del Horario de verano en la zona de tiempo de entrada. Al leer los valores de tiempo para convertir la zona horaria, los valores de tiempo se ajustarán para dar cuenta del cambio en el tiempo durante el Horario de verano. Por defecto, los valores de tiempo de entrada se ajustan para acomodarse al cambio horario, debido a las reglas de horario de verano en la zona horaria de entrada.
| Boolean |
output_dst (Opcional) | Indica si los valores de tiempo de salida darán cuenta del cambio en el tiempo debido a las reglas del Horario de verano observadas en la zona de tiempo de salida. Por defecto, los valores de tiempo de salida se ajustan para acomodarse al cambio horario, debido a las reglas de horario de verano que rigen la zona horaria de salida.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_table | La tabla de entrada actualizada. | Vista de tabla |
Muestra de código
El script de la ventana de Python muestra cómo utilizar la herramienta ConvertTimeZone en el modo inmediato.
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")
El siguiente script independiente muestra cómo utilizar la herramienta 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)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí