Convertir un champ temporel (Gestion des données)

Synthèse

Transfère les valeurs de date et d’heure stockées dans un champ dans un autre champ. L’outil permet la conversion entre différents types de champs (texte, nombre ou date) ou la conversion de valeurs de différents formats tels que jj/MM/aa HH:mm:ss en aaaa-MM-jj.

Utilisation

Attention :

Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

• Si le champ d’heure en entrée est de type numérique ou texte, sélectionnez le format approprié à partir du paramètre Input Time Format (Format date/heure en entrée).

  En savoir plus sur les formats de champ temporel pris en charge

• Si la valeur du paramètre Input Time Field (Champ temporel en entrée) est un champ de texte, les formats personnalisés peuvent être ajoutés au paramètre Input Time Format (Format date/heure en entrée).

  En savoir plus sur la conversion de valeurs temporelles de type chaîne en format de date

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Couche ou table qui contient le champ portant les valeurs temporelles à convertir.	Table View
Champ temporel en entrée	Champ contenant les valeurs temporelles. Le champ peut être de type court, long, réel simple, réel double, texte ou date.	Field
Format date/heure en entrée (Facultatif)	Format des valeurs temporelles dans la valeur du paramètre Input Time Field (Champ temporel en entrée). Vous pouvez choisir un format temporel standard dans la liste déroulante ou spécifier un format personnalisé. Le paramètre n’est pas pris en charge lorsque le champ temporel en entrée est de type date. Remarque : Les chaînes de format respectent la casse. Si le type de données du champ temporel est date, aucun format horaire n'est requis. Si le type de données du champ temporel est numérique (court, long, réel simple ou réel double), une liste de formats temporels numériques standard est fournie dans la liste déroulante. Si le type de données du champ temporel est une chaîne, une liste de formats temporels de type chaîne standard est fournie dans la liste déroulante. Pour les champs de type chaîne, vous pouvez également spécifier un format temporel personnalisé. Par exemple, les valeurs temporelles ont pu être stockées dans un champ de type chaîne dans l'un des formats standard tels que aaaa/MM/dd HH:mm:ss ou dans un format personnalisé tel que dd/MM/aaaa HH:mm:ss. Pour le format personnalisé, vous pouvez également spécifier l’indicateur a.m., p.m. Certains formats répandus sont répertoriés ci-dessous : aaaa : année représentée par quatre chiffres MM : mois sous forme de chiffres avec zéro de début pour les mois à un seul chiffre MMM : mois sous forme d’abréviation en trois lettres jj : jour du mois sous forme de chiffres avec zéro de début pour les jours à un seul chiffre jjj : jour de la semaine sous forme d’abréviation en trois lettres hh : heures avec zéro de début pour les heures à un seul chiffre ; horloge de 12 heures HH : heures avec zéro de début pour les heures à un seul chiffre ; horloge de 24 heures mm : minutes avec zéro de début pour les minutes à un seul chiffre ss : secondes avec zéro de début pour les secondes à un seul chiffre t : chaîne de repère horaire d’un caractère, telle que A ou P tt : chaîne de repère horaire de plusieurs caractères, telle que AM ou PM unix_us : heure Unix en microsecondes unix_ms : heure Unix en millisecondes unix_s : heure Unix en secondes unix_hex : heure Unix au format hexadécimal	String
Nom du champ en sortie	Nom du champ à ajouter, dans lequel les valeurs temporelles converties seront stockées.	String
Type de champ temporel en sortie (Facultatif)	Indique le type du champ temporel en sortie. Date—Le champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure. Texte—Le champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères. Long (Entier 32 bits)—Le champ est de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647. Court (Entier 16 bits)—Le champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767. Double (Virgule flottante 64 bits)—Le champ est de type réel double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308. Flottant (Virgule flottante 32 bits)—Le champ est de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38.	String
Format temporel en sortie (Facultatif)	Format des valeurs temporelles en sortie. Les formats temporels en sortie pris en charge dépendent de la valeur du paramètre Output Time Field Type (Type de champ temporel en sortie). Un format personnalisé peut également permettre la conversion de la valeur dans un autre format ou l’extraction d’une portion de la valeur (une année, par exemple). Pour une liste des formats personnalisés, consultez l'aide du paramètre Format date/heure en entrée. Ce paramètre n'est pas utilisé si la valeur du paramètre Type du champ temporel en sortie est Date. Remarque : Si le type de données du champ temporel en sortie n'est pas assez long pour stocker la valeur temporelle en sortie, cette dernière est tronquée.	String

Sortie obtenue

Étiquette	Explication	Type de données
Table en entrée mise à jour	Table en entrée mise à jour.	Table View

Python

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})

Nom	Explication	Type de données
in_table	Couche ou table qui contient le champ portant les valeurs temporelles à convertir.	Table View
input_time_field	Champ contenant les valeurs temporelles. Le champ peut être de type court, long, réel simple, réel double, texte ou date.	Field
input_time_format (Facultatif)	Format des valeurs temporelles dans la valeur du paramètre input_time_field. Le paramètre n’est pas pris en charge lorsque le champ temporel en entrée est de type date. Remarque : Les chaînes de format respectent la casse. Si le type de données du champ temporel est date, aucun format horaire n'est requis. Si le type de données du champ temporel est numérique (court, long, réel simple ou réel double), une liste de formats temporels numériques standard est fournie dans la liste déroulante. Si le type de données du champ temporel est une chaîne, une liste de formats temporels de type chaîne standard est fournie dans la liste déroulante. Pour les champs de type chaîne, vous pouvez également spécifier un format temporel personnalisé. Par exemple, les valeurs temporelles ont pu être stockées dans un champ de type chaîne dans l'un des formats standard tels que aaaa/MM/dd HH:mm:ss ou dans un format personnalisé tel que dd/MM/aaaa HH:mm:ss. Pour le format personnalisé, vous pouvez également spécifier l’indicateur a.m., p.m. Certains formats répandus sont répertoriés ci-dessous : aaaa : année représentée par quatre chiffres MM : mois sous forme de chiffres avec zéro de début pour les mois à un seul chiffre MMM : mois sous forme d’abréviation en trois lettres jj : jour du mois sous forme de chiffres avec zéro de début pour les jours à un seul chiffre jjj : jour de la semaine sous forme d’abréviation en trois lettres hh : heures avec zéro de début pour les heures à un seul chiffre ; horloge de 12 heures HH : heures avec zéro de début pour les heures à un seul chiffre ; horloge de 24 heures mm : minutes avec zéro de début pour les minutes à un seul chiffre ss : secondes avec zéro de début pour les secondes à un seul chiffre t : chaîne de repère horaire d’un caractère, telle que A ou P tt : chaîne de repère horaire de plusieurs caractères, telle que AM ou PM unix_us : heure Unix en microsecondes unix_ms : heure Unix en millisecondes unix_s : heure Unix en secondes unix_hex : heure Unix au format hexadécimal	String
output_time_field	Nom du champ à ajouter, dans lequel les valeurs temporelles converties seront stockées.	String
output_time_type (Facultatif)	Indique le type du champ temporel en sortie. DATE—Le champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure. TEXT—Le champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères. LONG—Le champ est de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647. SHORT—Le champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767. DOUBLE—Le champ est de type réel double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308. FLOAT—Le champ est de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38.	String
output_time_format (Facultatif)	Format des valeurs temporelles en sortie. Les formats temporels en sortie pris en charge dépendent de la valeur du paramètre output_time_type. Un format personnalisé peut également permettre la conversion de la valeur dans un autre format ou l’extraction d’une portion de la valeur (une année, par exemple). Pour une liste des formats personnalisés, consultez l'aide du paramètre input_time_format. Ce paramètre n'est pas utilisé si la valeur du paramètre output_time_type est DATE. Remarque : Si le type de données du champ temporel en sortie n'est pas assez long pour stocker la valeur temporelle en sortie, cette dernière est tronquée.	String

Sortie obtenue

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

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ConvertTimeField en mode immédiat.

import arcpy
arcpy.ConvertTimeField_management("C:/Data/TemporalData.gdb/Input_Table","Input_Time","1033;MMMM dd, yyyy HH:mm:ss;AM;PM","Output_Time")

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

Le script autonome ci-dessous illustre l’utilisation de la fonction ConvertTimeField.

# Name: ConvertTimeField_Ex02.py
# Description: Convert a time field to date field
# Requirements: None

# Import system modules
import arcpy

# Set local variables
inTable = "C:\Data\TemporalData.gdb\Input_Table"
inputTimeField = "Input_Time"
inputTimeFormat = "1033;MMMM dd, yyyy HH:mm:ss;AM;PM"
outputDateField = "Output_Time"

# Execute CalculateEndDate
arcpy.ConvertTimeField_management(inTable, inputTimeField, inputTimeFormat, outputDateField)

Environnements

Espace de travail courant

Informations de licence

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