Fonctions relatives aux types de données - 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ées pour vérifier des valeurs et des types de données, ainsi que pour convertir une valeur en un autre type de données.

Fonction Description Arguments Exemple
hasValue Retourne true si l'élément d'entrée n'est pas null ou n'est pas une chaîne de caractères vide. Lorsqu'elle est utilisée dans une requête, si l'argument est un chemin vers un élément inconnu, la fonction retourne false au lieu d'une erreur. Élément d'entrée. Expression : hasValue("Hello World!")

Résultat : true

isEmpty Retourne true si l'élément d'entrée est null ou s'il est une chaîne de caractères vide. Élément d'entrée. Expression : isEmpty("")

Résultat : true

isNull Retourne true si l'élément d'entrée est null. Élément d'entrée. Expression : isNull(null)

Résultat : true

isBoolean Retourne true si l'élément d'entrée est un type de données boolean. Élément d'entrée. Expression : isBoolean(2 < 3)

Résultat : true

isBytes Retourne true si l'élément d'entrée est un type de données bytes. Élément d'entrée. Expression : isBytes(0xFFFF)

Résultat : true

isDate Retourne true si l'élément d'entrée est un type de données date. Élément d'entrée. Expression : isDate("2021-04-01")

Résultat : false

isDateTime Retourne true si l'élément d'entrée est un type de données datetime. Élément d'entrée. Expression : isDateTime(getCurrentDateTime())

Résultat : true

isDecimal Retourne true si l'élément d'entrée est un type de données decimal. Élément d'entrée. Expression : isDecimal(3.5)

Résultat : true

isDouble Retourne true si l'élément d'entrée est un type de données double. Élément d'entrée. Expression : isDouble(5e+3)

Résultat : true

isFloat Retourne true si l'élément d'entrée est un type de données float. Élément d'entrée. Expression : isFloat(3.5F)

Résultat : true

isInteger Retourne true si l'élément d'entrée est un type de données integer. Élément d'entrée. Expression : isInteger(42)

Résultat : true

isLong Retourne true si l'élément d'entrée est un type de données long. Élément d'entrée. Expression : isLong(42L)

Résultat : true

isNumber Retourne true si l'élément d'entrée est un type de données decimal, double, float, integer ou long. Élément d'entrée. Expression : isNumber(5e+3)

Résultat : true

isString Retourne true si l'élément d'entrée est un type de données string. Élément d'entrée. Expression : isString("Hello World!")

Résultat : true

isTime Retourne true si l'élément d'entrée est un type de données time. Élément d'entrée. Expression : isTime("12:34")

Résultat : false

toBoolean Convertit une valeur en un booléen. Si l'élément d'entrée est un tableau d'octets, la fonction retourne true si au moins un des octets du tableau n'est pas 0. Si l'élément d'entrée est une chaîne de caractères, la fonction retourne true si la chaîne de caractères est "true", quelle que soit sa casse et retourne false pour toute autre chaîne de caractères. Élément d'entrée. Expression : toBoolean(0x0000007B)

Résultat : true

toBytes Convertit une valeur en un type de données bytes. Élément d'entrée. Expression : toBytes(123)

Résultat : 0x0000007B

toDate Convertit une valeur en un type de données date. Élément d'entrée. Expression : toDate("2021-04-21")

Résultat : 2021-04-21

toDateTime Convertit une valeur en un type de données datetime.
  1. Chaîne de caractères ou date à convertir.
  2. Facultatif : Si le premier argument est une date, vous pouvez spécifier une heure en tant que type de données string ou time. Sinon, l'heure locale 00:00 est utilisée.
Expression : toDateTime("2021-04-21")

Résultat : 2021-04-21T00:00Z

toDecimal Convertit une valeur en un type de données decimal.
  1. Élément d'entrée.
  2. Facultatif : Échelle du décimal en tant que type de données string ou numeric.
  3. Facultatif : Mode d'arrondi pour le type decimal. Il peut être le nom du mode en tant que chaîne de caractères (string) ou la constante d'entier (integer) correspondante :
    • "UP" ou 0
    • "DOWN" ou 1
    • "CEILING" ou 2
    • "FLOOR" ou 3
    • "HALF_UP" ou 4
    • "HALF_DOWN" ou 5
    • "HALF_EVEN" ou 6
    • "UNNECESSARY" ou 7
    La valeur par défaut est "FLOOR". Pour plus d'informations concernant les modes d'arrondi, consultez la documentation Oracle (en anglais).
 Expression : toDecimal(531.256986, 2, "DOWN")

Résultat : 531.25

toDouble Convertit une valeur en un type de données double. Élément d'entrée. Expression : toDouble(500)

Résultat : 500.0

toFloat Convertit une valeur en un type de données float. Élément d'entrée. Expression : toFloat(5e+3)

Résultat : 5000.0

toInteger Convertit une valeur en un type de données integer. Si la valeur d'entrée est un nombre avec un point décimal, la fonction conserve la valeur sans la partie décimale. Élément d'entrée. Expression : toInteger(12.95)

Résultat : 12

toLong Convertit une valeur en un type de données long. Élément d'entrée. Expression : toLong(12.03e+20)

Résultat : 9223372036854775807

toString Convertit un élément en une chaîne de caractères (string).
  1. Élément d'entrée.
  2. Facultatif : Format Date/time si l'élément d'entrée est un type de données temporel.
 Expression : toString(123456L)

Résultat : "123456"

toTime Convertit une valeur en un type de données time. Élément d'entrée. Expression : toTime("12:34")

Résultat : 12:34