Fonctions de date et heure - Cloud

Guide de référence de Talend Data Shaping Language
Version
Cloud
Language
Français
Product
Talend Cloud
Module
Data Shaping Language
Content
Création et développement

Les fonctions suivantes peuvent être utilisée pour effectuer des opéraitons sur des dates, des heures (time) et des dates et heures (datetime).

Fonction Description Arguments Exemple
addToDateTime Ajoute une somme de temps à une date et heure.
  1. Unité à ajouter en tant que chaîne de caractères :
    • Year, Years, Y ou u pour les années
    • Month, Months, M ou L pour les mois
    • Week, Weeks ou W pour les semaines
    • Day, Days ou d pour les jours
    • Hour, Hours ou H pour les heures
    • Minute, Minutes ou m pour les minutes
    • Second, Seconds ou s pour les secondes
    • Millisecond, Milliseconds ou A pour les millisecondes
  2. Somme à ajouter en tant que long. Elle peut être négative pour soustraire une somme de temps.
  3. Datetime d'entrée.
 Expression : addToDateTime("M", -1, "2021-03-21T10:19:26.214+02:00")

Résultat : 2021-02-21T10:19:26.214+02:00

extractFromDateTime Extrait une partie d'une valeur datetime ou date. Si le premier argument est une date, il est d'abord converti en datetime, avec le temps défini à midi dans le fuseau horaire local.
  1. Date ou datetime d'entrée.
  2. Unité à extraire en tant que chaîne de caractères :
    • Date pour la date complète
    • Time pour l'heure complète
    • Year, Years, Y ou u pour l'année
    • Month, Months, M ou L pour le mois
    • Week, Weeks ou W pour la semaine du mois
    • Week of Year ou w pour la semaine de l'année
    • Day, Days ou d pour le jour
    • Day of Year ou D pour le jour de l'année
    • Day of Month pour le jour du mois
    • Day of Week, e ou E pour le jour de la semaine
    • Hour, Hours ou H pour l'heure
    • Minute, Minutes ou m pour la minute
    • Second, Seconds ou s pour la seconde
    • Millisecond, Milliseconds ou A pour la milliseconde
    • TimeZone, V ou z pour le fuseau horaire
 Expression : extractFromDateTime("2021-03-21T10:19:26.214+02:00", "Time")

Résultat : 10:19:26.214

getCurrentDateTime Retourne la date et l'heure actuelles. Aucun(e) Expression : getCurrentDateTime()

Résultat possible : 2021-04-21T10:32:44.851+02:00

formatDateTime
Remarque : Cette fonctionnalité est disponible uniquement dans Talend Cloud Pipeline Designer.
 Crée une chaîne de caractères contenant une valeur datetime avec un modèle spécifique provenant d'un horodatage.
  1. Datetime d'entrée.
  2. Modèle datetime en tant que string :
    • yyyy pour l'année
    • MM pour le mois
    • dd pour le jour
    • HH pour les heures
    • mm pour les minutes
    • ss pour les secondes
    • SSS pour une fraction de seconde
    • ZZZZZ pour le fuseau horaire
 Expression : formatDateTime(getCurrentDateTime(), "YY-dd-MM'T'HH:mm")

Résultat possible : "22-13-07T11:43"

makeDateTime
Remarque : Cette fonctionnalité est disponible uniquement dans Talend Cloud Pipeline Designer.
 Crée une valeur datetime (horodatage) à partir d'une date et d'une heure.
Remarque : Le fuseau horaire est défini en se basant sur les arguments :
  • Si la date ou l'heure comprend un fuseau horaire, ce fuseau horaire est utilisé.
  • Si aucune ne comprend de fuseau horaire, l'heure du fuseau horaire de la machine locale est utilisée.
  • Si les deux comprennent un fuseau horaire, il doit être identique, sinon une erreur se produit.
  1. Date d'entrée en tant que chaîne de caractères ou que type de données de date.
  2. Heure d'entrée en tant que chaîne de caractères ou que type de données d'heure.
 Expression : $date = toDate("2021-01-02"), makeDateTime($date, "13:45-01:00")

Résultat : 2021-01-02T13:45-01:00

parseDateTime Crée un type datetime depuis un type string.
  1. Datetime d'entrée en tant que string.
  2. Modèle datetime en tant que string :
    • yyyy pour l'année
    • MM pour le mois
    • dd pour le jour
    • HH pour les heures
    • mm pour les minutes
    • ss pour les secondes
    • SSS pour une fraction de seconde
    • ZZZZZ pour le fuseau horaire
 Expression : parseDateTime("2021-04-21T11:05:18.337+02:00", "yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ")

Résultat: 2021-04-21T11:05:18.337+02:00

isToday Retourne true si la date ou la date et l'heure d'entrée correspond·ent à la date du jour. Date ou datetime d'entrée. Expression : isToday(getCurrentDateTime())

Résultat : true

isTomorrow Retourne true si la date ou la date et l'heure d'entrée correspond·ent au jour suivant. Date ou datetime d'entrée. Expression : isTomorrow(addToDateTime("d", 1, getCurrentDateTime()))

Résultat : true

isYesterday Retourne true si la date ou la date et l'heure d'entrée correspond·ent au jour précédent. Date ou datetime d'entrée. Expression : isYesterday(addToDateTime("d", -1, getCurrentDateTime()))

Résultat : true