Fonctions de conversion
Les fonctions de conversion disponibles sont répertoriées.
Fonction | Description |
---|---|
Base64Decode(Arg1) | Décode une chaîne base64 dans un blob pour qu'elle s'affiche en tant qu'image dans Spotfire. Exemple : Base64Decode([Column]) |
Base64Encode(Arg1) | Encode un blob sous forme de chaîne base64. Cela peut être intéressant si les données de Spotfire doivent être exportées vers d'autres applications. Exemple : Base64Encode([Column]) |
Boolean(Arg1) | Convertit la colonne ou la valeur en type de donnéesBoolean.
Exemple : Boolean([Column]) |
Cast(Arg1 as type) | Convertit une expression en un type (sauf Null ou Non défini). Les valeurs non valides sont propagées. La conversion exécutée pour les différents types d'entrée et de sortie entraîne des valeurs de sortie différentes. Pour plus d'informations, reportez-vous à la rubrique Méthode de conversion.
Exemple : Cast([IntegerColumn] as Currency) |
Currency(Arg1) | Convertit la colonne ou la valeur en type de donnéesCurrency.
Exemple : Currency([Column]) |
Date(Arg1, ..., Arg3) | Convertit la colonne ou les valeurs en type de donnéesDate. Si un seul argument est donné,Arg1 peut être de typeString ouDateTime. Si une valeur de typeString est spécifiée, la date doit être écrite dans un format reconnu parSpotfire. De plus, tous les éléments de la date (année, mois et jour) doivent être présents. Voir les exemples ci-dessous. Si une valeur de typeDateTime est spécifiée, la partie de l'heure est supprimée. Si trois arguments sont donnés, il doit s'agir de valeurs de typeInteger. Si le premier argument représente l'année, le deuxième argument représente le mois et le troisième représente le jour du mois. Si un seul argumentInteger est donné, la fonctionDate interprétera l'argument Integer comme une mesure. Les mesures sont exprimées en unités de 100 nanosecondes, à partir du 01-01-01 (premier janvier de l'année 1). Reportez-vous également aux rubriques Fonctions de date et d'heure et Méthode de conversion.
Exemples : Date("2003-03-21") → 3/21/2003 Date("3/21/03") → 3/21/2003 Date("10") → (Vide) Date(null) → (Vide) Date("2003-03-21 11:37:00") → 3/21/2003 Date(2003,03, 21) → 3/21/2003 Date(605000000000000000l) → 3/4/1918 (Les formats de sortie disponibles dépendent de vos paramètres régionaux actuels.) |
DateTime(Arg1, Arg2,..., Arg7) | Convertit la colonne ou les valeurs en type de donnéesDateTime. Si un seul argument est donné,Arg1 peut être de typeString ouDate. Si une valeur de typeString est spécifiée, la date doit être écrite dans un format reconnu parSpotfire. De plus, absolument tous les éléments de la date (année, mois et jour) doivent être présents. Si une valeur de typeDate est spécifiée, la partie de l'heure est configurée sur 00:00:00 (12:00:00 AM). Si sept arguments sont donnés, il doit s'agir de valeurs de typeInteger. Le premier argument représente l'année, le deuxième le mois, le troisième le jour, le quatrième l'heure, le cinquième les minutes, le sixième les secondes et le septième les millisecondes. Si un seul argument de typeInteger est donné, la fonctionDateTime l'interprétera comme une mesure. Les mesures sont exprimées en unités de 100 nanosecondes, à partir du 01-01-01 (premier janvier de l'année 1). Reportez-vous également aux rubriques Fonctions de date et d'heure et Méthode de conversion.
Exemples : DateTime("2003-03-21 11:37:00") → 3/21/2003 11:37:00 AM DateTime("10") → (Vide) DateTime(null) → (Vide) DateTime("2003-03-21") → 2003-03-21 00:00:00 DateTime(2003, 03, 21, 11, 37, 00) → 2003-03-21 11:37:00 DateTime(605000000000000000l) → 3/4/1918 11:33:20 AM (Les formats de sortie disponibles dépendent de vos paramètres régionaux actuels.) |
FirstValidAfter(Arg1) |
Replace les valeurs null d'une colonne par la première valeur valide après la manquante.
Exemple : FirstValidAfter([Column]) |
FromEpochMilliseconds(Arg1) |
Convertit la colonne ou la valeur en date et heure. Les nombres sont ainsi interprétés comme le nombre de millisecondes écoulées depuis le 1er janvier 1970.
Exemple : FromEpochMilliseconds(231312) |
FromEpochSeconds(Arg1) |
Convertit la colonne ou la valeur en date et heure. Les nombres sont ainsi interprétés comme le nombre de secondes écoulées depuis le 1er janvier 1970.
Exemple : FromEpochSeconds(231312) |
Integer(Arg1) | Convertit la colonne ou la valeur en un nombre de typeInteger. En cas d'échec de la conversion, une erreur est renvoyée.Arg1 peut être de typeInteger,Real ouString et le résultat est de typeInteger. Les nombres de typeReal sont tronqués, c'est-à-dire que seule la partie entière est utilisée.
Exemples : Integer("-123") → -123 Integer(-2.99) → -2 Integer("0%") → (Vide) Integer(1e20) → (Vide) Integer(null) → (Vide) |
LastValidBefore(Arg1) |
Remplace les valeurs Null d'une colonne par la dernière valeur valide avant la manquante.
Exemple : LastValidBefore([Column]) |
LongInteger(Arg1) | Convertit la colonne ou la valeur en type de donnéesLongInteger.
Exemple : LongInteger([Column]) |
ParseDate(Arg1, ..., Arg3) | Analyse une date à partir d'une chaîne en appliquant un format de typeDate. Le premier argument est une chaîne ou une colonne de chaîne contenant une date. Le deuxième argument est une chaîne de format expliquant de quelle manière la date est créée et le troisième argument (facultatif) est un code de culture.
Exemples : ParseDate("2013-09-17", "yyyy-MM-dd") ParseDate("17-okt-2013","dd-MMM-yyyy","sv-SE") |
ParseDateTime(Arg1, ..., Arg3) | Analyse les informations de date et d'heure à partir d'une chaîne en appliquant un format de typeDateTime. Le premier argument est une chaîne ou une colonne de chaîne contenant des informations de type date/heure. Le deuxième argument est une chaîne de format expliquant de quelle manière les informations sont créées et le troisième argument (facultatif) est un code de culture.
Exemples : ParseDateTime("2013-09-17 10:30", "yyyy-MM-dd h:mm") ParseDateTime("17-okt-2013 13:25","dd-MMM-yyyy HH:mm","sv-SE") |
ParseReal(Arg1, Arg2) |
Analyse une chaîne en appliquant une valeur de typeReal. Le premier argument est une chaîne ou une colonne de chaîne. Le deuxième argument (facultatif) est un code de culture.
Exemples : ParseReal([Column], "en-US") ParseReal("7.25") |
ParseTime(Arg1, ..., Arg3) | Analyse une heure à partir d'une chaîne en appliquant un format de typeTime. Le premier argument est une chaîne ou une colonne de chaîne contenant une heure. Le deuxième argument est une chaîne de format expliquant de quelle manière l'heure est créée et le troisième argument (facultatif) est un code de culture.
Exemples : ParseTime("9:25", "h:mm") ParseTime("17:30", "HH:mm","sv-SE") |
ParseTimeSpan(Arg1, ..., Arg3) |
Analyse les informations de période à partir d'une chaîne en appliquant un format de typeTimeSpan. Le premier argument est une chaîne ou une colonne de chaîne contenant des informations de période. Le deuxième argument est une chaîne de format expliquant de quelle manière les informations sont créées et le troisième argument (facultatif) est un code de culture.
Exemples : ParseTimeSpan("5.7:11:3.1", "d.h:m:s.f", "sv-SE") ParseTimeSpan("123 3 11 7 -5", "f s m h d") |
Real(Arg1) | Convertit la colonne ou la valeur en un nombre de typeReal. En cas d'échec de la conversion, une erreur est renvoyée.Arg1 peut être de typeInteger,Real ouString et le résultat est de typeReal.
Exemples : Real(1.23) → 1,23 Real(2) → 2 Real("0%") → (Vide) Real(null) → (Vide) |
SingleReal(Arg1) | Convertit la colonne ou la valeur en type de donnéesSingleReal.
Exemple : SingleReal([Column]) |
SN(Arg1, Arg2) | Substitue les valeurs null. RenvoieArg1 s'il ne s'agit pas d'une valeur null ouArg2 dans le cas contraire.Arg1 etArg2 peuvent être de tout type, mais ils doivent être du même type ou null. Le résultat est du même type que les arguments. En général il est préférable de remplacer les valeurs null dans une colonne. SiArg1 est une colonne,Arg2 peut être une valeur du même type que le contenu de la colonne ou une colonne avec le même type de contenu. SiArg2 est aussi une colonne, l'erreur dansArg1 est remplacée par la valeur de la même ligne dansArg2.
Exemples : SN(1, 2) → 1 SN(null, 2) → 2 SN(0/0, 2) → #NA SN([Column], 1) → 1 (si la colonne contient une valeur null) SN([Column1], [Column2]) → (valeur deColumn2 siColumn1 contient une valeur null) |
String(Arg1) | Convertit la colonne ou la valeur enString.Arg1 peut être de tout type et le résultat est de type chaîne. Remarque : Cette fonction utilise toujours le formatage de valeur par défaut. Cela peut entraîner une perte de précision lors de la conversion de valeurs numériques.
Exemples : String(1.23) → "1.23" String(null) → (Vide) |
Time(Arg1, Arg2,..., Arg4) | Convertit la colonne ou les valeurs enTime. Si la conversion échoue, une erreur est renvoyée. Si un seul argument est donné,Arg1 peut être de typeString ouDateTime. Si une valeur de typeString est spécifiée, l'heure doit être écrite dans un format reconnu par Spotfire. De plus, l'heure et les minutes doivent absolument être spécifiés. Voir les exemples ci-dessous. Si une valeur de typeDateTime est spécifiée, la partie de la date est supprimée. Si quatre arguments sont donnés, il doit s'agir de valeurs de typeInteger. Si le premier argument représente l'heure, le deuxième argument représente les minutes, le troisième les secondes et le quatrième les millisecondes. Si un seul argument de typeInteger est donné, la fonctionTime l'interprétera comme une mesure. Les mesures sont exprimées en unités de 100 nanosecondes, à partir du 01-01-01 (premier janvier de l'année 1). Reportez-vous également aux rubriques Fonctions de date et d'heure et Méthode de conversion.
Exemples : Time("11:37:00") → 11:37:00 AM Time("10") → (Vide) Time(null) → (Vide) Time(11, 30, 20, 4) → 11:30:20 AM Time(605000000000000000l) → 11:33:20 AM (Les formats de sortie disponibles dépendent de vos paramètres régionaux actuels.) |
TimeSpan(Arg1, Arg2,...,Arg5)) | Crée une valeur de typeTimeSpan à partir d'une colonne ou de valeurs. Si un seul argument est donné, la colonne d'entrée peut être de typeString ouTimeSpan. Si une valeur de typeString est spécifiée, la période doit être indiquée au format « [-]d.h:m:s.ms ». Si cinq arguments sont donnés, alors le premier correspond au jour, le second aux heures, le troisième aux minutes, le quatrième aux secondes et le cinquième aux millisecondes. Les quatre premiers arguments sont des nombres de typeIntegers, le dernier est un nombre de typeReal.
Exemples : TimeSpan([Column]) TimeSpan("247.5:17:11.5002") TimeSpan(247, 05, 17, 11, 500.2) |
ToEpochMilliseconds([Arg1]) |
Convertit la colonne ou la valeur depuis une date et heure vers le nombre de millisecondes écoulées depuis le 1er janvier 1970.
Exemple : ToEpochMilliseconds([Date]) |
ToEpochSeconds([Arg1]) |
Convertit la colonne ou la valeur depuis une date et heure vers le nombre de secondes écoulées depuis le 1er janvier 1970.
Exemple : ToEpochSeconds([Date]) |
Pour avoir la liste des types de données disponibles pour la conversion, voir Types de données.
Voir aussi Fonctions.