Créer date heure
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,MinuteetSecond. 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 |
|---|---|
| Input dataset (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. |
| Fields (Champs) | Liste d’un ou de plusieurs champs et format des valeurs de date/heure contenues dans le champ spécifié. |
| Time field (Champ temporel) | Champ contenant les valeurs de date ou d’heure. |
| Time format (Format de date/heure) | Format des valeurs figurant dans le champ de date/heure. |
| Keep source fields (Conserver les champs sources) | Indique si les champs utilisés pour créer un champ de date/heure sont conservés dans la sortie. |
| Time zone (Fuseau horaire) | Fuseau horaire des valeurs en entrée |
| Output time field name (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 disposez d’un champ de type chaîne nommé
MY_DATE_TIMEdéfini sur la valeur2022-12-30 17:30:00. SpécifiezMYDATETIMEpour le champ de date/heure et une valeuryyyy-MM-dd HH:mm:sspour le format de date/heure.Vous disposez de deux champs :
MY_DATEdéfini sur la valeur07/25/2000etMY_TIMEdéfini sur la valeur5:30:00 PM. Spécifiez deux paires de champ/format. Spécifiez le premier champ de date/heure en tant queMY_DATEavec une valeur de formatMM/dd/yyyy, et le second champ de date/heure en tant queMY_TIMEavec une valeur de formathh:mm:ss a.
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, par exemple 12/30.
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 sont calculées à l’aide de la valeur de date/heure indiquée, mais le champ de date/heure en sortie est 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/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 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, comme12/23/2022, ou les valeurs d’heure uniquement, comme12:30:00, ne sont pas prises en charge pour les champs de type date.Le format doit correspondre exactement aux valeurs figurant dans le champ spécifié. Ainsi, il est impossible d’utiliser un format
MM/dd/yyyysi le champ contient un sous-ensemble de ces valeurs, par exemple12/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 Configuration requise.
De plus, Data Pipelines n’est disponible que si vous disposez d’une instance ArcGIS Data Pipelines Server configurée avec ArcGIS Enterprise.