Changer de fuseau horaire (Gestion des données)

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.

Illustration

Illustration de l'outil Convertir le fuseau horaire
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.

Syntaxe

arcpy.management.ConvertTimeZone(in_table, input_time_field, input_time_zone, output_time_field, output_time_zone, {input_dst}, {output_dst})
ParamètreExplicationType 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_DSTLes valeurs temporelles en entrée sont ajustées pour l'heure d'été.
  • INPUT_NOT_ADJUSTED_FOR_DSTLes 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_DSTLes valeurs temporelles en sortie sont ajustées pour l'heure d'été dans le fuseau horaire en sortie.
  • OUTPUT_NOT_ADJUSTED_FOR_DSTLes 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

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

Informations de licence

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

Rubriques connexes