Convertir un champ temporel (Outils de gestion des données)
Résumé
Transfère les valeurs temporelles stockées dans un champ dans un autre champ. L’outil permet la conversion entre des types de champ (texte, numérique ou date/heure) ou la conversion de valeurs dans un autre format, par exemple jj/MM/aa HH:mm:ss en aaaa-MM-jj.
Utilisation
Attention :
Cet outil modifie les données en entrée. Reportez-vous à la section Outils qui modifient ou mettent à jour les données en entrée pour obtenir plus d’informations et découvrir des stratégies permettant d’éviter toute modification indésirable des données.
Si le champ temporel en entrée est de type texte ou numérique, choisissez ou spécifiez le format approprié dans le paramètre Input Format (Format en entrée).
En savoir plus sur les formats de champ temporel pris en charge
Si la valeur du paramètre Input Field (Champ en entrée) est un champ de texte, les formats personnalisés peuvent être ajoutés au paramètre Input Format (Format en entrée).
Pour les champs de texte respectant les règles d’écritures de la norme ISO-8601, utilisez aaaa-MM-jjTHH:mm:ss.s comme format d’entrée. Ce format permet de traiter les entrées comportant une désignation de fuseau horaire UTC (Z) ou de décalage par rapport au temps UTC (±hh:mm).
En savoir plus sur la conversion de valeurs temporelles de type chaîne en format de date
Les sorties dans un champ de texte au format aaaa-MM-jjTHH:mm:ss.s ne prennent pas en charge l’ajout d’une désignation de fuseau horaire UTC (Z) ou de décalage par rapport au temps UTC (±hh:mm).
Si l’environnement Time Zone (Fuseau horaire) est spécifié, la valeur de l’environnement indiquée dans le paramètre Time Zone Offset (Décalage de fuseau horaire) est utilisée par défaut, sauf si une valeur est également spécifiée pour ce paramètre.
Si la valeur du paramètre Input Field (Champ en entrée) est un champ de date et que la valeur du paramètre Output Field Type (Type de champ en sortie) est Timestamp offset (Décalage de l’horodatage), vous pouvez indiquer le type String (Chaîne) pour le paramètre Time Zone Offset (Décalage de fuseau horaire) et choisir un fuseau horaire à appliquer uniformément à toutes les lignes de la sortie. Par exemple, si vous sélectionnez Pacific Standard Time (Heure normale du Pacifique) comme décalage pour un champ de date en entrée avec une valeur de 2002-08-20 12:00:00 PM, la valeur générée en sortie est 2002-08-20 12:00:00 PM -08:00. Le décalage de -08:00 est également appliqué à toutes les autres lignes du champ Date en entrée.
Vous pouvez aussi spécifier le type de champ et sélectionner un champ contenant les données de décalage de fuseau horaire. Les valeurs de champ peuvent être de type numérique, comme -5, ou chaîne, comme Eastern Standard Time (Heure normale de l’Est). Pour connaître la liste de tous les fuseaux horaires pris en charge pour les valeurs de type chaîne, reportez-vous au paramètre Time Zone Offset (Décalage de fuseau horaire). Lorsqu’un champ est spécifié, l’outil utilise la valeur de la ligne comme valeur de décalage. Le fait d’utiliser un champ pour le décalage peut s’avérer utile lorsque les valeurs de date des lignes en entrée proviennent de fuseaux horaires différents. Par exemple, si le champ Date en entrée contient les valeurs 2001-01-01 7:00:00 AM, 2001-01-02, 9:00:00 AM et 2001-01-02 12:00:00 PM et que le champ de décalage contient les valeurs -8, -5 et 0 pour les lignes correspondantes, l’outil génère en sortie les valeurs 2001-01-01 7:00:00 AM -08:00, 2001-01-02 9:00:00 AM -05:00 et 2001-01-02 12:00:00 PM +00:00.
Remarque :
L’outil ne convertit pas les dates et les heures si la valeur du paramètre Input Field (Champ en entrée) est un champ Date et si la valeur du paramètre Output Field Type (Type de champ en sortie) est Timestamp offset (Décalage de fuseau horaire). S’il est nécessaire d’effectuer une conversion de la date ou de l’heure, utilisez l’outil Convert Time Zone (Changer de fuseau horaire) pour convertir le champ de date vers la date et l’heure appropriées avant d’utiliser cet outil pour appliquer la valeur de décalage de l’horodatage correspondante.
Si la valeur du paramètre Input Field (Champ en entrée) est un champ Timestamp Offset (Décalage de l’horodatage) et que la valeur du paramètre Output Field Type (Type de champ en sortie) est un champ Date, Date Only (Date uniquement) ou Time Only (Heure uniquement), l’outil effectue la conversion appropriée de la date et de l’heure vers la valeur spécifiée du paramètre Time Zone Offset (Décalage de fuseau horaire). Par exemple, la valeur 2011-06-02 4:30:00.000 PM -08:00 du champ Timestamp Offset (Décalage de l’horodatage) convertie en type Date, avec le paramètre Time Zone Offset (Décalage de fuseau horaire) défini sur le type String (Chaîne) avec une valeur UTC, a pour valeur en sortie 2011-06-03 12:30:00 AM.
Le paramètre Output Format (Format en sortie) peut avoir la valeur Time only (Heure uniquement), mais cette valeur n’est pas acceptée pour le paramètre Input Format (Format en entrée). En effet, le format en sortie Time only (Heure uniquement) n’est pas assez détaillé pour être converti dans d’autres formats tels que Timestamp Offset (Décalage de l’horodatage), Date ou Date Only (Date uniquement).
Paramètres
| Etiqueter | Explication | Type de données |
|---|---|---|
|
Input Table (Table en entrée) |
Couche ou table qui contient le champ portant les valeurs temporelles à convertir. |
Table View |
|
Champ en entrée |
Champ contenant les valeurs temporelles. Il peut être de type court, long, réel simple, réel double, texte, date, décalage de l’horodatage ou date uniquement. |
Field |
|
Input Format (Format d’entrée) (Facultatif) |
Format des valeurs temporelles dans la valeur du paramètre Input Field (Champ 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.
|
String |
|
Output Field Name (Nom du champ en sortie) |
Nom du champ à ajouter, dans lequel les valeurs temporelles converties seront stockées. |
String |
|
Output Field Type (Type de champ en sortie) (Facultatif) |
Indique le type du champ temporel en sortie.
|
String |
|
Format de 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 Field Type (Type de champ 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 obtenir une liste des formats personnalisés, consultez la description du paramètre Input Format (Format en entrée). Ce paramètre n’est pas utilisé lorsque la valeur du paramètre Output Field Type (Type de champ 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 |
|
Time Zone Offset (Décalage de fuseau horaire) (Facultatif) |
Fuseau horaire ou champ contenant un décalage numérique par rapport à la table en entrée et qui sera utilisé en tant que fuseau horaire en sortie. Si un fuseau horaire est spécifié, cette valeur est utilisée par défaut dans l’outil comme valeur d’environnement.
|
String; Field |
Sortie dérivée
| Etiqueter | Explication | Type de données |
|---|---|---|
|
Table en entrée mise à jour |
Table en entrée mise à jour. |
Table View |
Environnements
Espace de travail courant, Fuseau horaire
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui