Traitements et affichages des dates
GenericsData & 
HandleData
|
Afin de simplifier la lecture, les objets de type TimeStamp sont décrits dans DataChain et la documentation comme étant des Dates (avec une majuscule). Les valeurs représentant des dates qui ne sont pas de type Date (Chaîne de caractère ou Numérique) sont désignées comme des dates (avec une minuscules). |
Affichage dans DataChain
Afin de simplifier la lecture et la manipulation des Dates sur toute la chaîne de valeurs, les Dates sont affichées par défaut avec un masque d’affichage du format ISO 8601 simplifié.
Le fuseau horaire dépend des paramètres de votre instance DataChain (UTC par défaut), contactez un administrateur DataChain en cas de doute.
Au survol, les Dates s’affichent toujours au format ISO 8601 complet et en UTC, peu importe le masque d’affichage appliqué.
-
ISO simplifié en UTC : 2023-09-01 13:42:24
-
ISO complet en UTC : 2032-09-01T13:42:24:000Z
Manipuler les dates avec les masques
Différents traitements peuvent être effectués sur les dates à partir de masques d’affichage, de lecture et d’écriture.
Masque de lecture
Lors d’une intégration rapide, du mapping d’une Entité Métier, ou pour convertir une colonne de DataBlock en sortie d’étape, le masque de lecture permet de préciser de quelle manière transformer les valeurs manipulées.
Vous devez préciser le masque de lecture à utiliser pour créer l’Entité Métier lors d’une intégration rapide.
Vous devez préciser le masque de lecture, ainsi que le fuseau et la langue, à utiliser lors du Mapping d’une Entité Métier.
Vous devez préciser le masque de lecture à utiliser, ainsi que le fuseau et la langue, lorsque vous modifiez le type d’une colonne en sortie d’étape de DataBlock.
Masque d’affichage
Lors de la configuration d’une sortie d’étape d’un DataBlock ou d’une source HandleData vous pouvez modifier le masque d’affichage à appliquer.
Le masque d’affichage utilisé par défaut est au format ISO simplifié.
Vous pouvez aussi, si besoin, modifier le fuseau et la langue.
Masque d’écriture
2 formules permettent de transformer les dates au format chaîne de caractères et les Dates.
-
date.to_strz transforme une Date en Chaîne de caractères à partir d’un masque d’écriture, d’un fuseau et d’une langue
-
str.to_datez transforme une Chaîne de caractères en Date à partir d’un masque de lecture, d’un fuseau et d’une langue
Définir le fuseau horaire et la langue
Il est possible de modifier le fuseau horaire à utiliser dans les masques d’affichage et d’écriture afin de préciser le décalage horaire à appliquer par rapport à l’horaire UTC.
Le choix de la langue permet de préciser la langue à utiliser pour les masques contenant des valeurs de type chaînes de caractères (lundi, mardi, Janvier…).
Personnaliser les masques
Il est possible de personnaliser le masque à partir des valeurs acceptées.
Les valeurs les plus couramment utilisées sont décrites dans le tableau ci-dessous, pour connaître l’ensemble des valeurs acceptées, référez-vous à la documentation Oracle disponible en ligne.
| Valeur | Rendu | Exemple |
|---|---|---|
D |
Jour dans l’année |
156 |
d |
Jour dans le mois |
29 |
EEEE |
Jour de la semaine |
Vendredi |
MM |
Mois de l’année sur deux chiffres |
09 |
MMM |
Abréviation du nom du mois de l’année |
sept. |
MMMM |
Mois de l’année complet |
Septembre |
yy |
Année sur deux chiffres |
23 |
yyyy |
Année sur quatres chiffres |
2023 |
hh |
Heure sur 24h |
22 |
HH |
Heure au format AM/PM (sur 12h) |
10 |
ss |
Secondes |
42 |
Z |
Décalage de l’horaire avec l’heure UTC |
+02 |
Utiliser des modèles de masque pré-configurés
DataChain propose un certain nombre de modèles de masques pré-configurés disponibles pour la lecture, l’affichage ou l’écriture.
Modèle |
Exemple |
yyyyMMdd |
20231002 |
ddMMyyyy |
02102023 |
dd/MM/yyyy |
02/10/2023 |
dd-MM-yyyy |
02-10-2023 |
yyyy/MM/dd |
2023/10/02 |
yyyy-MM-dd |
2023-10-02 |
dd/MM/yyyy HH:mm |
02/10/2023 10:42 |
dd-MM-yyyy HH:mm |
02-10-2023 10:42 |
yyyy/MM/dd HH:mm |
2023/10/02 10:42 |
yyyy-MM-dd HH:mm |
2023-02-10 10:42 |
dd/MM/yyyy HH:mm:ss |
02/10/2023 10:42:55 |
dd/MM/yyyy HH:mm:ss.SSS |
02/10/2023 10:42:55.915 |
dd-MM-yyyy HH:mm:ss |
02-10-2023 10:42:55 |
dd-MM-yyyy HH:mm:ss.SSS |
02-10-2023 10:42:55.915 |
yyyy/MM/dd HH:mm:ss |
2023/10/02 10:42:55 |
yyyy/MM/dd HH:mm:ss.SSS |
2023/10/02 10:42:55.915 |
yyyy-MM-dd HH:mm:ss |
2023-10-02 10:42:55 |
yyyy-MM-dd HH:mm:ss.SSS |
2023-10-02 10:42:55.915 |
HH |
10 |
HH:mm |
10:42 |
HH:mm:ss |
10:42:55 |
HH:mm:ss.SSS |
10:42:55.915 |
EEEE dd MM yyyy |
lundi 02 10 2023 |
EEEE dd MMM yyyy |
lundi 02 oct. 2023 |
EEEE dd M yyyy HH’h’mm |
lundi 02 10 2023 10h42 |
yyyy |
2023 |
EEEE |
lundi |
MMMM |
octobre |
MMMM - yyyy |
oct.-23 |
w - YYYY |
40 - 2023 |
W - MMMM - yyyy |
01-oct.-23 |
EEEE - yyyy |
lundi - 2023 |
EEEE-HH |
lundi-10 |
dd-MM-yyyy HH:mm:ssX |
02-10-2023 10:42:55+02 |
dd-MM-yyyy HH:mm:ssXX |
02-10-2023 10:42:55+0200 |
dd-MM-yyyy HH:mm:ssXXX |
02-10-2023 10:42:55+02:00 |
dd-MM-yyyy HH:mm:ssXXXX |
02-10-2023 10:42:55+0200 |
dd-MM-yyyy HH:mm:ssXXXXX |
02-10-2023 10:42:55+02:00 |
dd-MM-yyyy HH:mm:ss.SSSX |
02-10-2023 10:42:55.955+02 |
dd-MM-yyyy HH:mm:ss.SSSXX |
02-10-2023 10:42:55.955+0200 |
dd-MM-yyyy HH:mm:ss.SSSXXX |
02-10-2023 10:42:55.955+02:00 |
dd-MM-yyyy HH:mm:ss.SSSXXXX |
02-10-2023 10:42:55.955+0200 |
dd-MM-yyyy HH:mm:ss.SSSXXXXX |
02-10-2023 10:42:55.955+02:00 |
yyyy-MM-dd HH:mm:ssX |
2023-10-02 10:42:55+02 |
yyyy-MM-dd HH:mm:ssXX |
2023-10-02 10:42:55+0200 |
yyyy-MM-dd HH:mm:ssXXX |
2023-10-02 10:42:55+02:00 |
yyyy-MM-dd HH:mm:ssXXXX |
2023-10-02 10:42:55+0200 |
yyyy-MM-dd HH:mm:ssXXXXX |
2023-10-02 10:42:55+02:00 |
yyyy-MM-dd HH:mm:ss.SSSX |
2023-10-02 10:42:55.955+02 |
yyyy-MM-dd HH:mm:ss.SSSXX |
2023-10-02 10:42:55.955+0200 |
yyyy-MM-dd HH:mm:ss.SSSXXX |
2023-10-02 10:42:55.955+02:00 |
yyyy-MM-dd HH:mm:ss.SSSXXXX |
2023-10-02 10:42:55.955+0200 |
yyyy-MM-dd HH:mm:ss.SSSXXXXX |
2023-10-02 10:42:55.955+02:00 |
yyyy-MM-dd HH:mm:ss.SSSSSS |
2023-10-02 10:42:55.955441 |
yyyy-MM-dd HH:mm:ss.SSSSSSX |
2023-10-02 10:42:55.955441+02 |
yyyy-MM-dd HH:mm:ss.SSSSSSXX |
2023-10-02 10:42:55.955441+0200 |
yyyy-MM-dd HH:mm:ss.SSSSSSXXX |
2023-10-02 10:42:55.955441+02:00 |
yyyy-MM-dd HH:mm:ss.SSSSSSXXXX |
2023-10-02 10:42:55.955441+0200 |
yyyy-MM-dd HH:mm:ss.SSSSSSXXXXX |
2023-10-02 10:42:55.955441+02:00 |
yyyy-MM-dd HH:mm:ss.SSSSSSSSS |
2023-10-02 10:42:55.955441000 |
yyyy-MM-dd HH:mm:ss.SSSSSSSSSX |
2023-10-02 10:42:55.955441000+02 |
yyyy-MM-dd HH:mm:ss.SSSSSSSSSXX |
2023-10-02 10:42:55.955441000+0200 |
yyyy-MM-dd HH:mm:ss.SSSSSSSSSXXX |
2023-10-02 10:42:55.955441000+02:00 |
yyyy-MM-dd HH:mm:ss.SSSSSSSSSXXXX |
2023-10-02 10:42:55.955441000+0200 |
yyyy-MM-dd HH:mm:ss.SSSSSSSSSXXXXX |
2023-10-02 10:42:55.955441000+02:00 |
yyyy-MM-dd’T’HH:mm:ssX |
2023-10-02T10:42:55+02 |
yyyy-MM-dd’T’HH:mm:ssXX |
2023-10-02T10:42:55+0200 |
yyyy-MM-dd’T’HH:mm:ssXXX |
2023-10-02T10:42:55+02:00 |
yyyy-MM-dd’T’HH:mm:ssXXXX |
2023-10-02T10:42:55+0200 |
yyyy-MM-dd’T’HH:mm:ssXXXXX |
2023-10-02T10:42:55+02:00 |
yyyy-MM-dd’T’HH:mm:ss.SSSX |
2023-10-02T10:42:55.955+02 |
yyyy-MM-dd’T’HH:mm:ss.SSSXX |
2023-10-02T10:42:55.955+0200 |
yyyy-MM-dd’T’HH:mm:ss.SSSXXX |
2023-10-02T10:42:55.955+02:00 |
yyyy-MM-dd’T’HH:mm:ss.SSSXXXX |
2023-10-02T10:42:55.955+0200 |
yyyy-MM-dd’T’HH:mm:ss.SSSXXXXX |
2023-10-02T10:42:55.955+02:00 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSX |
2023-10-02T10:42:55.955441+02 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSXX |
2023-10-02T10:42:55.955441+0200 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSXXX |
2023-10-02T10:42:55.955441+02:00 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSXXXX |
2023-10-02T10:42:55.955441+0200 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSXXXXX |
2023-10-02T10:42:55.955441+02:00 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSSSSX |
2023-10-02T10:42:55.955441000+02 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSSSSXX |
2023-10-02T10:42:55.955441000+0200 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSSSSXXX |
2023-10-02T10:42:55.955441000+02:00 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSSSSXXXX |
2023-10-02T10:42:55.955441000+0200 |
yyyy-MM-dd’T’HH:mm:ss.SSSSSSSSSXXXXX |
2023-10-02T10:42:55.955441000+02:00 |