L’outil Créer un champ de date/heure crée un champ de date/heure avec des valeurs de champ existantes.
Exemples
L’outil Créer un champ de date/heure peut être utilisé dans les scénarios suivants :
- Un jeu de données de suivi des ouragans contient une représentation sous forme de chaîne de la date/l’heure de l’observation. Utilisez l’outil Créer un champ de date/heure pour mettre en forme le champ de chaîne et le convertir en sortie sous forme d’un champ de date.
- Un jeu de données stocke les informations temporelles dans les champs Hour, Minute et Second. Utilisez l’outil Créer un champ de date/heure pour spécifier ces champs ainsi que les formats des valeurs de champ afin de produire un nouveau champ de date/heure.
Paramètres
Le tableau suivant explique les paramètres utilisés dans l’outil Créer un champ de date/heure :
| Paramètre | Description |
|---|---|
Jeu de données en entrée | Jeu de données contenant les valeurs de champ qui seront utilisées pour créer le champ de date/heure. |
Champs | Liste d’un ou de plusieurs champs et format des valeurs de date/heure contenues dans le champ spécifié. |
Champ temporel | Champ contenant les valeurs de date ou d’heure. |
Format d'heure | Format des valeurs figurant dans le champ de date/heure. |
Conserver les champs sources | Indique si les champs utilisés pour créer un champ de date/heure sont conservés dans la sortie. |
Fuseau horaire | Fuseau horaire des valeurs en entrée |
Nom du champ de date/heure en sortie | Nom du champ de date/heure en sortie. Ce paramètre est facultatif. La valeur par défaut est TIMESTAMP. |
Remarques sur l’utilisation
Utilisez le paramètre Input dataset (Jeu de données en entrée) pour identifier le jeu de données contenant les valeurs de champ utilisées pour créer le champ de date/heure. Le jeu de données est renvoyé dans la sortie avec une nouvelle colonne de date/heure ajoutée.
Utilisez le paramètre Fields (Champs) pour spécifier un ou plusieurs champs afin de calculer les valeurs de date en sortie. La sortie correspond à un seul champ de date/heure. Voici quelques exemples de champs en entrée et formats :
- Vous possédez un champ sous forme de chaîne nommé MY_DATE_TIME avec une valeur égale à 2022-12-30 17:30:00. Spécifiez MYDATETIME pour le champ de date/heure et une valeur de yyyy-MM-dd HH:mm:ss pour le format de date/heure.
- Vous avez deux champs : MY_DATE avec une valeur de 07/25/2000 et MY_TIME avec une valeur de 5:30:00 PM. Spécifiez deux paires de champ/format. Spécifiez le premier champ de date/heure comme MY_DATE avec une valeur de format MM/dd/yyyy et le deuxième champ de date/heure comme MY_TIME avec une valeur de format de hh:mm:ss a.
Par défaut, les champs utilisés pour créer le champ de date/heure sont supprimés du jeu de données en sortie. Pour conserver les champs en entrée, activez le paramètre Keep source fields (Conserver les champs sources).
Le paramètre Time zone (Fuseau horaire) indique le fuseau horaire dans lequel les valeurs de date/heure en entrée sont conservées. Le temps universel coordonné (UTC) est la valeur par défaut. Si vous spécifiez une valeur différente, les valeurs en entrée seront calculées à l’aide de la valeur de date/heure indiquée, mais le champ de date/heure en sortie sera converti au format UTC.
Les fuseaux horaires sont basés sur l’heure de Joda. Pour en savoir plus sur les formats d’heure de Joda, consultez la rubrique Fuseaux horaires disponibles à l’heure de Joda.
Formats de date et d’heure dans Data Pipelines
| Valeur | Description | Exemple |
|---|---|---|
aa | L'année, représentée par deux chiffres. | 16 |
aaaa | L'année, représentée par quatre chiffres. | 2016 |
MM | Le mois, représenté numériquement. | 01 ou 1 |
MMM | Le mois, représenté avec trois lettres. | Jan |
MMMM | Le mois, représenté avec l'orthographe complète. | January |
jj | Le jour. | 02 ou 2 |
HH | L’heure, avec un jour de 24 heures et des valeurs comprises entre 0 et 23. | 21 |
hh | L’heure, avec un jour de 12 heures et des valeurs comprises entre 1 et 12. | 9 |
mm | La minute, avec des valeurs comprises entre 0 et 59. | 45 |
ss | La seconde, avec des valeurs comprises entre 0 et 59. | 02 |
SSS | La milliseconde, avec des valeurs comprises entre 0 et 999. | 50 |
a | Symbole ponctuel AM/PM. | PM |
epoch_millis | Le temps en millisecondes, d’epoch. | 1509581781000 |
epoch_seconds | Le temps en secondes, d’epoch. | 1509747601 |
Z | Le décalage du fuseau horaire exprimé en heures. | -0100 ou -01:00 |
ZZZ | Le décalage du fuseau horaire exprimé à l’aide d’ID. | America/Los_Angeles |
'' | Les guillemets simples ajoutent du texte ne représentant pas une valeur décrite dans ce tableau. | 'T' |
Sorties
L’outil crée un seul champ de date/heure. Toutes les paires de champ de date/heure et de format que vous spécifiez permettent de créer une seule valeur de date/heure. Pour créer plusieurs champs de date/heure, exécutez l’outil à plusieurs reprises.
La sortie de l’outil inclut un jeu de données avec tous les champs du jeu de données en entrée en plus d’un nouveau champ de date/heure. Si vous n’avez pas spécifié de nom pour le champ en sortie, le champ de date/heure se nomme TIMESTAMP par défaut. Le champ en sortie est de type date et contient les informations de date et d’heure de chaque enregistrement.
Lorsque vous prévisualisez des champs de date/heure, les valeurs sont affichées dans le fuseau horaire du navigateur. Lorsque vous écrivez des valeurs dans une couche d’entités, elles sont stockées en temps universel coordonné (UTC).
Limitations
Les limitations connues suivantes s’appliquent à l’outil Créer un champ de date/heure :
- L’outil renvoie un seul champ de date/heure. Pour calculer plusieurs champs de date/heure, configurez des outils Créer un champ de date/heure supplémentaires.
- Les paires de champ de date/heure et de format spécifiées doivent calculer une valeur de date/heure complète, par exemple 12/23/2022 12:30:00. Les valeurs de date uniquement, telles que 12/23/2022, ou les valeurs d’heure uniquement, telles que 12:30:00, ne sont pas prises en charge pour les champs de type date/heure.
- Le format doit correspondre exactement aux valeurs figurant dans le champ spécifié. Ainsi, il est impossible d’utiliser un format MM/dd/yyyy si le champ contient un sous-ensemble de ces valeurs, comme 12/30.
Licences requises
Les licences et configurations suivantes sont requises :
- Type d’utilisateur Creator ou Professional
- Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent
Afin d’en savoir plus sur la configuration requise pour Data Pipelines, reportez-vous à la rubrique Conditions requises.
Vous avez un commentaire à formuler concernant cette rubrique ?