Skip to main content

Dates

La brick Dates (catégorie Transform) applique une liste ordonnée d'opérations sur les colonnes de dates : convertir un texte en date, formater une date en texte, extraire une composante (année, mois…), calculer une durée entre deux colonnes. Elle prend un flux en entrée (in) et produit un flux en sortie (out).

note

Les opérations s'appliquent dans l'ordre déclaré. Les valeurs qui ne peuvent pas être interprétées comme des dates deviennent null (l'exécution ne s'arrête pas) ; pensez à contrôler les null en aval.

Opérations disponibles​

parse : convertir un texte en date​

ParamètreTypeDescription
columntexteColonne à convertir (requis), remplacée par sa version datetime
formattexteFormat strptime explicite (optionnel : auto-détection sinon)

Exemples de format : %d/%m/%Y pour 31/12/2025, %Y-%m-%d %H:%M pour 2025-12-31 08:30.

commande (avant, texte)commande (après, datetime)
31/12/2025→2025-12-31
pas une date→null
tip

Renseignez toujours format quand vous le connaissez : l'auto-détection peut confondre jour et mois (03/04/2025) et elle est plus lente.

format : convertir une date en texte​

ParamètreTypeDescription
columntexteColonne source (requis)
format_strtexteFormat strftime de sortie (défaut %Y-%m-%d)
output_columntexteColonne de sortie (défaut : écrase la colonne source)

Avant → après (format_str: %d/%m/%Y, output_column: commande_fr) :

commande (avant)commande_fr (après)
2025-12-31→31/12/2025
2026-01-15→15/01/2026

extract : extraire des composantes​

ParamètreTypeDescription
columntexteColonne source (requis)
partsliste de textesComposantes à extraire : year, month, day, weekday, hour, minute

Chaque composante crée une colonne numérique nommée <colonne>_<composante> (par exemple commande_year), null si la date source est null. weekday va de 0 (lundi) à 6 (dimanche).

Avant → après (parts: [year, month]) :

commandecommandecommande_yearcommande_month
2025-12-31→2025-12-31202512
2026-01-15→2026-01-1520261

diff : durée entre deux colonnes​

ParamètreTypeDescription
col_atexteColonne A (requis)
col_btexteColonne B (requis)
unittexteUnité du résultat : days (défaut), hours ou minutes
output_columntexteColonne de sortie (défaut diff)

Le résultat est A − B, en entier : négatif si A précède B.

Avant → après (col_a: livraison, col_b: commande, unit: days, output_column: delai) :

commandelivraisondelai
2025-12-012025-12-04→3
2025-12-102025-12-10→0

Bonnes pratiques​

  • Parsez d'abord : commencez par parse sur les colonnes textuelles, puis enchaînez extract, diff ou format sur la colonne devenue datetime.
  • Gardez les dates au type datetime le plus longtemps possible dans le pipeline ; réservez format à la fin, juste avant l'export.
  • Après un parse sans format explicite, contrôlez les null produits (par exemple avec un filter de la brick Lignes ou un contrôle Qualité).

Anciennes bricks remplacées​

Cette méga-brick remplace l'ancienne brick atomique Parse Date. Voir Bricks héritées pour la table de correspondance.