Convertir un champ temporel (Gestion des données)

Résumé

Convertit des valeurs temporelles stockées dans une chaîne ou un champ numérique en un champ date. L'outil permet également de convertir dans des formats personnalisés les valeurs de temps stockées dans des champs de type chaîne, numérique ou date, tels que le jour de la semaine et le mois de l'année.

Utilisation

  • Si le champ temporel en entrée sélectionné est une chaîne ou un champ de texte, le format d'heure en entrée peut être sélectionné dans une liste de formats de champs temporels pris en charge ou vous pouvez définir un format de champ temporel personnalisé pour interpréter des valeurs de date ou d'heure personnalisées dans le champ de type chaîne. Pour plus d'informations sur les formats personnalisés pour les champs de type chaîne, reportez-vous à la rubrique conversion des valeurs de chaînes d'heures en format de date.

  • Si le champ d'heure en entrée sélectionné est numérique (court, long, réel simple ou réel double), le format d'heure en entrée peut être sélectionné dans une liste de formats de champs d'heure standard pris en charge. Les formats d'heure personnalisés ne sont pas pris en charge avec les champs numériques.

Syntaxe

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})
ParamètreExplicationType de données
in_table

Couche ou table qui contient le champ portant les valeurs temporelles qui doivent être converties.

Table View
input_time_field

Champ contenant les valeurs temporelles. Peut être de type court, long, réel simple, réel double, texte ou date.

Field
input_time_format
(Facultatif)

Format dans lequel les valeurs temporelles étaient stockées dans le champ temporel en entrée. Vous pouvez choisir un format temporel standard dans la liste déroulante ou entrer un format personnalisé.

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 choisir de 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 un 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 : temps Unix en microsecondes.
    • unix_ms : temps Unix en millisecondes.
    • unix_s : temps Unix en secondes.
    • unix_hex : temps Unix au format hexadécimal.

Pour en savoir plus sur les formats de date et d'heure personnalisés

String
output_time_field

Nom de champ en sortie dans lequel les valeurs temporelles converties seront stockées.

String
output_time_type
(Facultatif)

Type de données du champ temporel en sortie.

  • DATEDate et/ou heure
  • TEXTToute chaîne de caractères.
  • LONGNombres entiers compris entre -2 147 483 648 et 2 147 483 647
  • SHORTNombres entiers compris entre -32 768 et 32 767
  • DOUBLENombres fractionnels compris entre-2,2E308 et 1,8E308
  • FLOATNombres fractionnels compris entre -3,4E38 et 1,2E38
String
output_time_format
(Facultatif)

Format dans lequel les valeurs temporelles en sortie sont enregistrées. La liste de formats horaires en sortie dépend du type de données en sortie spécifié pour le champ temporel en sortie. Format personnalisé qui peut également servir lorsque le type de données du champ temporel en sortie n'est pas Date. Pour une liste de formats personnalisés, consultez l'explication Format date/heure en entrée.

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 dérivée

NomExplicationType de données
out_table

Table en entrée mise à jour.

Vue tabulaire

Exemple de code

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

Le script de fenêtre Python suivant montre comment utiliser l'outil 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 suivant illustre l'utilisation de l'outil 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)

Informations de licence

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

Rubriques connexes