Changer de fuseau horaire

Résumé

Convertit des valeurs temporelles enregistrées dans un champ date d'un fuseau horaire vers un autre fuseau horaire.

La conversion de valeurs temporelles d'un fuseau horaire vers un autre permet de normaliser les données temporelles de fuseaux horaires différents. Cela améliore l'affichage et les performances des requêtes pour la visualisation de données temporelles de différents fuseaux horaires à l'aide du Curseur temporel.

Pour en savoir plus sur la définition d'une référence temporelle sur les données temporelles

Pour en savoir plus sur la visualisation de données temporelles à l'aide du curseur temporel

Illustration

Convertit des valeurs temporelles enregistrées dans un champ date d'un fuseau horaire vers un autre fuseau horaire.

Utilisation

• Les valeurs temporelles en entrée à convertir doivent être stockées dans un champ de type date.

• Le champ temporel en sortie créé sera un champ de type date.

• Si vos données ont été collectées dans un fuseau horaire qui observe le passage à l'heure d'été, vous devez choisir les paramètres pour respecter l'heure d'été dans les champs en entrée et en sortie. Pour en savoir plus sur le passage à l'heure d'été.

Syntaxe

arcpy.management.ConvertTimeZone(in_table, input_time_field, input_time_zone, output_time_field, output_time_zone, {input_dst}, {output_dst})

Paramètre	Explication	Type de données
in_table	La classe d'entités ou table en entrée qui contient les heures qui seront converties dans un fuseau horaire différent.	Table View
input_time_field	Le champ en entrée qui contient les heures qui seront converties dans un fuseau horaire différent.	Field
input_time_zone	Fuseau horaire en entrée dans lequel les heures ont été collectées.	String
output_time_field	Le champ en sortie dans lequel les heures converties dans fuseau horaire en sortie souhaité seront stockées.	String
output_time_zone	Fuseau horaire dans lequel les heures seront converties. Par défaut, le fuseau horaire en sortie est le même que le fuseau horaire en entrée.	String
input_dst (Facultatif)	Indique si les heures ont été collectées en observant les règles de passage à l'heure d'été dans le fuseau horaire en entrée. Lors de la lecture des valeurs temporelles pour convertir le fuseau horaire, les valeurs temporelles sont ajustées pour tenir compte du décalage horaire pendant l'heure d'été. Par défaut, les valeurs temporelles en entrée sont ajustées pour prendre en compte le décalage horaire dû aux règles de passage à l’heure d’été dans le fuseau horaire en entrée. INPUT_ADJUSTED_FOR_DST —Les valeurs temporelles en entrée sont ajustées pour l'heure d'été. INPUT_NOT_ADJUSTED_FOR_DST —Les valeurs temporelles en entrée ne sont pas ajustées pour l'heure d'été.	Boolean
output_dst (Facultatif)	Indique si les valeurs temporelles en sortie prennent en compte le décalage horaire dû aux règles de passage à l’heure d’été observées dans le fuseau horaire en sortie. Par défaut, les valeurs temporelles en sortie sont ajustées pour prendre en compte le décalage horaire dû aux règles de passage à l’heure d’été observées dans le fuseau horaire en sortie. OUTPUT_ADJUSTED_FOR_DST —Les valeurs temporelles en sortie sont ajustées pour l'heure d'été dans le fuseau horaire en sortie. OUTPUT_NOT_ADJUSTED_FOR_DST —Les valeurs temporelles en sortie ne sont pas ajustées pour l'heure d'été dans le fuseau horaire en sortie.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_table	Table en entrée mise à jour.	Vue tabulaire

Exemple de code

Exemple d'utilisation de l'outil ConvertTimeZone (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil ConvertTimeZone en mode immédiat.

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")

Exemple 2 d'utilisation de l'outil ConvertTimeZone (script autonome)

Le script autonome suivant illustre l'utilisation de l'outil 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)

Environnements

• Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui