Fonctions

• Outil Action
• Outil Graphiques
• Outil Condition
• Outil Attribution dynamique d’un nouveau nom
• Outil Message d’erreur
• Outil Filtrer
• Outil Formule
• Outil Générer les lignes
• Outil Message
• Outil de formule à plusieurs champs
• Outil Formule à plusieurs lignes
• Outil Carte de rapport
• Outil Table
• Outil Test

Une fonction conditionnelle exécute une action ou un calcul sur la base d’un test de données à l’aide d’une instruction IF. Utilisez une fonction conditionnelle pour fournir un résultat TRUE ou FALSE mettant en évidence ou filtrant les données en fonction de critères spécifiques. Les fonctions conditionnelles peuvent être utilisées avec tout type de données.

Considérez chaque fonction conditionnelle avant d’écrire votre test. Certaines fonctions conditionnelles sont mieux adaptées à des cas d’utilisation spécifiques.

Si c alors t else f endif: si la condition alors vrai else false endif

Exemple

IF [Classe]==1 THEN "Or" ELSE "Autre" ENDIF

Classe	Résultat
1	Or
2	Autres
1	Or
3	Autres

Si c alors t ElseIf C2 alors T2 else f endif: Si condition Then true ElseIf condition2 puis true2 else false endif

Plusieurs instructions ELSEIF peuvent être incluses.

Exemple

IF [Class]==1 THEN "Or" ELSEIF [Class]==2 THEN "Argent" ELSE "Autre" ENDIF

Classe	Résultat
1	Or
2	Argent
1	Or
3	Autres

IIF (bool, x, y): if ([bool] true) return (x), else return (y)

Exemple

IIF([CUSTOMER], "Envoyer une brochure", "Envoyer une documentation")

Si la valeur du champ [CUSTOMER] est TRUE, la valeur renvoyée est Envoyer une brochure.

Si la valeur du champ [CUSTOMER] est FALSE, la valeur renvoyée est Envoyer une documentation.

Switch (valeur, default, Case1, result1,..., CASEN, resultatn): compare une valeur à une liste de cas et retourne le résultat correspondant.

Exemple

Switch([Class], Null(), "Or",1,"Argent",2,"Bronze", 3,"Étain", 4, "Aluminium",5)

Résultat	Classe
5	Aluminium
2	Argent
1	Or
3	Bronze
4	Étain
2	Argent
1	Or
Null	Autres

Une fonction de conversion convertit un format ou un type de données en un autre format ou type de données. Utilisez une fonction de conversion pour convertir des nombres en chaînes ou vice-versa. Les fonctions de conversion peuvent être utilisées avec des données de type Chaîne et Nombre.

BinToInts (s): convertit la chaîne binaire s en un entier. (Limité à 53 bits).

Exemple

BinToInts (101010101) résultats en 341

CharFromInt (x): renvoie le caractère Unicode ® qui correspond au numéro d'entrée.

Exemple

CharFromInt (66) renvoie b (U + 0042 'lettre majuscule latine b')

CharFromInt (169) retourne © (U + 00A9 'Copyright signe')

CharFromInt (1071) retourne Я (U + 042F'lettre majuscule cyrillique ya')

CharFromInt (127944) retourne (U + 1F3C8 'American Football')

CharFromInt (0) retourne [NULL] (U + 000 'null') car tout entier qui ne peut pas être utilisé pour représenter un caractère peut donner un résultat nul.

CharFromInt (55300) retourne [NULL] car tout entier qui ne représente pas actuellement un caractère ne sera pas restitué par une police normale.

CharToInt (S): renvoie le numéro correspondant au caractère d'entrée Unicode ®.

Exemple

CharFromInt (b) renvoie 66 (U + 0042 'lettre majuscule latine b')

CharFromInt (©) retourne 169 (U + 00A9 'Copyright signe')

CharFromInt (Я) retourne 1071 (U + 042F'lettre majuscule cyrillique ya')

CharFromInt () retourne 127944 (U + 1F3C8 'American Football')

ConvertFromCodepage (s, CodePage): traduit le texte d'une page de codes en Unicode. Voir Pages de code.

ConvertToCodepage (s, CodePage): traduit le texte du codage Unicode ® vers une page de codes spécifique. Voir Pages de code.

HexToNumber (x): convertit une chaîne hexadécimale en nombre. (Limité à 53 bits).

Exemple

HexToNumber (DD) convertit au nombre 221

IntToBin (x): convertit x en chaîne binaire

IntToHex (x): convertit x en une chaîne hexadécimale

ToNumber (x, bIgnoreErrors, keepNulls, decimalSeparator): convertit un paramètre de chaîne en nombre. ToNumber accepte les chaînes qui peuvent être interprétées comme une double précision de notation scientifique. Par défaut, la période est utilisée comme séparateur décimal.

Paramètres facultatifs

bIgnoreErrors: 0 ou false (par défaut) signale les messages d'erreur de conversion; 1 ou true ignore les erreurs de conversion.

keepNulls: 0 ou false (Default) convertit des valeurs non numériques (y compris null) en zéro; 1 ou true convertit des valeurs non numériques en null.

decimalSeparator: "." (valeur par défaut) spécifie la période comme séparateur décimal; "," spécifie la virgule comme séparateur décimal.

Exemple

ToNumber ("878") retourne la chaîne 878 sous la forme d'un nombre.

ToNumber ("4.256411411 E9") retourne la chaîne 4256411411 sous la forme d'un nombre.

ToNumber ("Number", "false") retourne 0 avec l'erreur de conversion: ToNumber: Number a perdu des informations dans la conversion.

ToNumber ("Number", 0, 0) retourne 0 avec l'erreur de conversion: ToNumber: Number a perdu des informations dans la conversion.

ToNumber ("Number", 1, 0) retourne 0 sans erreur de conversion.

ToNumber ("Number", 1, 1) retourne [NULL] et aucune erreur de conversion.

ToNumber ("123456, 789", 1, 1, ",") renvoie 123456,789 comme un nombre.

ToNumber ("123.456, 789", 1, 1, ",") renvoie 123 comme un nombre. (Cela est dû au fait que la conversion s’arrête au séparateur de milliers, qui n’est pas une entrée valide avec la fonction ToNumber.)

ToString (x, numDec, addThousandsSeparator, decimalSeparator): convertit un paramètre numérique en chaîne à l'aide de numDec décimales. Par défaut, la période est utilisée comme séparateur décimal.

Paramètres facultatifs

addThousandsSeparator: 0 (par défaut) formate la chaîne numérique sans séparateur de milliers; 1 formats avec un séparateur de milliers. Par défaut, le séparateur de milliers est une virgule à moins que "," soit spécifié pour decimalSeparator, auquel cas il s'agit d'une période.

decimalSeparator: "." (valeur par défaut) spécifie la période comme séparateur décimal; "," spécifie la virgule comme séparateur décimal.

Exemple

ToString (10, 0) retourne 10 comme une chaîne.

ToString (10.4, 2) retourne 10,40 comme une chaîne.

ToString (100.4, 2) retourne 100,40 comme une chaîne.

ToString (1000.4, 2, 1) retourne 1 000,40 en tant que chaîne.

ToString (123456.789, 3, 1, ",") retourne 123.456, 789 sous la forme d'une chaîne.

ToString (123456.789, 3, 0, ",") retourne 123 456 789 comme une chaîne.

Une fonction DateTime effectue une action ou un calcul sur une valeur de date et d'heure. Utilisez une fonction DateTime pour ajouter ou soustraire des intervalles, rechercher la date actuelle, Rechercher le premier ou le dernier jour du mois, extraire un composant d'une valeur DateTime ou convertir une valeur en un format différent.

Alteryx représente les dates et les heures au format ISO aaaa-mm-jj HH:MM:SS. Si une valeur DateTime n'est pas dans ce format, Alteryx la lit comme une chaîne. Pour convertir une colonne pour une utilisation et une manipulation au format DateTime, utilisez la fonction DateTimeParse dans l'éditeur d'expressions ou le Outil DateTime.

Certaines fonctions DateTime vous obligent à définir le format de la date. Les chaînes de format sont composées de spécificateurs et de séparateurs.

Marqueurs

Les marqueurs commencent toujours par un symbole de pourcentage (%), suivi d’une lettre sensible à la casse. Les données doivent comporter au moins deux chiffres Année.

Marqueur	Sortie de DateTimeFormat	Entrée prise en charge avec DateTimeParse
%a	Nom abrégé du jour de la semaine (« Lun »)	Toute abréviation valide d’un jour de la semaine (« lun », « mar », « jeu »), signalant une erreur uniquement si le texte indiqué n’est pas un jour de la semaine. Notez qu’Alteryx ne vérifie pas si le nom du jour correspond bien à la date indiquée.
%A	Nom complet du jour de la semaine (« Lundi »)	Nom du jour ou toute abréviation valide d’un jour de la semaine (« lun », « mar », « jeu »), signalant une erreur uniquement si le texte indiqué n’est pas un jour de la semaine. Notez qu’Alteryx ne vérifie pas si le nom du jour correspond bien à la date indiquée.
%b	Nom abrégé du mois (« Sep »)	Toute abréviation valide d’un nom de mois (« Sep », « SEPT »), signalant une erreur uniquement si le texte indiqué n’est pas le nom d’un mois.
%B	Nom complet du mois (« Septembre »)	Nom du mois ou toute abréviation valide d’un nom de mois (« Sep », « SEPT »), signalant une erreur uniquement si le texte indiqué n’est pas le nom d’un mois.
%c	Date et heure des paramètres régionaux de l’ordinateur	Non pris en charge
%C	Nombre représentant le siècle (« 20 »).	Non pris en charge
%d	Jour du mois (« 01 »)	Un ou deux chiffres, ignorant les espaces (« 1 » ou « 01 »)
%D	Équivalent de %m/%d/%y	Non pris en charge
%e	Jour du mois, 0 au début remplacé par un espace (« 1 »)	Un ou deux chiffres, ignorant les espaces (« 1 » ou « 01 »)
%h	Identique à %b ("Sep")	Toute abréviation valide d’un nom de mois (« Sep », « SEPT »), signalant une erreur uniquement si le texte indiqué n’est pas le nom d’un mois.
%H	Heure au format 24 heures, de 00 à 23	Jusqu’à deux chiffres pour l’heure, de 0 à 23. Non compatible avec % p ou % p.
%I (« i » en majuscules)	Heure au format 12 heures, de 01 à 12	Jusqu’à deux chiffres pour l’heure, de 1 à 12. Doit suivre avec % p ou % p.
%j	Jour de l’année, de 001 à 365 (ou 366 en années bissextiles)	Jour de l’année à 3 chiffres, de 001 à 365 (ou 366 en années bissextiles)
%k	24 heures, le zéro au début est un espace, de « 0 » à « 23 »	Jusqu’à deux chiffres pour l’heure
%l (« ell » en minuscules)	12 heures, le zéro au début est un espace, de « 1 » à « 12 »	Non pris en charge
%M	Minutes, de 00 à 59	Jusqu’à deux chiffres pour les minutes
%m	Nombre représentant le mois, de 01 à 12	Nombre représentant le mois à un ou deux chiffres, de 1 ou 01 à 12
%p	« AM » ou « PM »	Insensible à la casse (« aM » ou « Pm »). Doit suivre % I (capital "Eye", heure en format 12 heures)
%P	« am » ou « pm »	Insensible à la casse (« aM » ou « Pm »). Doit suivre % I (capital "Eye", heure en format 12 heures)
%S	Secondes, de 00 à 59	Jusqu’à deux chiffres pour les secondes
%T	Heure au format 24 heures. Équivalent à % H:%M:% S	Non pris en charge
%u	Jour de la semaine sous forme de décimale, de 1 à 7, Lundi étant représenté par 1	Non pris en charge
%U	Renvoie le numéro de la semaine, de 00 à 53 (le dimanche étant considéré comme premier jour de la semaine).	Non pris en charge
%w	Jour de la semaine sous forme de nombre, de 0 à 6, Dimanche étant représenté par 0	Non pris en charge
%W	Renvoie le numéro de la semaine, de 00 à 53 (le lundi étant considéré comme premier jour de la semaine).	Non pris en charge
%x	Date des paramètres régionaux de l’ordinateur	Non pris en charge
%X	Heure de l’horloge au format 12 heures, incluant AM ou PM (« 11:51:02 AM »)	Heures:Minutes:Secondes [AM / PM]
%y	Deux derniers chiffres de l’année (« 16 »)	Quatre chiffres peuvent être lus. La lecture s’arrête à la fin de la chaîne ou dès la détection d’un séparateur. Les chiffres sont ensuite associés à une plage allant de l’année actuelle moins 66 à l’année actuelle plus 33. (Par exemple, 1950 à 2049 en 2016.) Conséquences de l'utilisation de dates à 6 chiffres Quatre chiffres maximum peuvent être lus pour l’année. Par conséquent, les dates incluant 6 chiffres sans séparateurs (par exemple, 170522 pour le 22 mai 2017) ne sont pas correctement interprétées. Pour contourner ce problème, deux solutions s’offrent à vous : Utilisez quatre chiffres pour l’année (par exemple, saisissez 2017 au lieu de 17). Utilisez la Outil RegEx pour insérer un espace après les deux premiers chiffres de la chaîne.
%Y	Les quatre chiffres de l’année (« 2016 »)	Deux ou quatre chiffres sont lus. Deux chiffres sont associés à une plage allant de l’année actuelle moins 66 à l’année actuelle plus 33. (Par exemple, 1950 à 2049 en 2016.)
%z	Décalage par rapport au temps UTC (« -600 »)	Non pris en charge
%Z	Nom complet du fuseau horaire (« GMT+1 »)	Non pris en charge

Séparateurs

Les séparateurs sont insérés entre des spécificateurs DateTime pour former une chaîne de format.

Séparateur	Sortie de DateTimeFormat	Entrée prise en charge avec DateTimeParse*
/	/	/ ou -
-	-	/ ou -
espace	Un espace	Toute séquence de caractères d’espace vide
%n	Une nouvelle ligne	Non pris en charge
%t	Une tabulation	Non pris en charge
autre	Autres caractères, p. ex. virgule, point et point virgule	Autres caractères, p. ex. virgule, point et point virgule

* DateTimeParse accepte les barres obliques ( / ) et les traits d'Union ( -) interchangeables . Toutefois, les virgules, points virgules et tous les autres séparateurs doivent correspondre exactement aux données entrantes.

DateTimeAdd (DT, i, u): ajoute un intervalle spécifique à une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

i: nombre entier positif ou négatif de temps à ajouter ou à soustraire.

u: unité DateTime, spécifiée entre guillemets: années, mois, jours, heures, minutes ou secondes.

Exemple

DateTimeAdd (DateTimeToday (),-1, "Days") renvoie la date d'hier.

DateTimeAdd (DateTimeFirstOfMonth (), 1, "months")retourne le premier du mois suivant.

DateTimeAdd ("2016-01-30", 1, "mois") renvoie 2016-02-29 (parce que février n'a pas un 30e, mais son dernier jour de cette année est le 29)

DateTimeAdd ("2016-03-30",-1, "mois")renvoie 2016-02-29 (parce que février n'a pas un 30e, mais son dernier jour de cette année est le 29)

En savoir plus

• Toute fraction de la durée est tronquée. Par exemple, il n’est pas possible d’ajouter « 1,5 heure ». Ajoutez plutôt « 90 minutes ».
• L’ajout d’une unité ne modifie pas la valeur des petites unités. Par exemple, l’ajout d’heures ne modifie pas la valeur des minutes ou des secondes. L’ajout de mois ne modifie pas le jour ou l’heure, sauf si le mois résultant ne comprend pas ce jour. Dans ce cas, le système affiche le dernier jour du mois en question.

DateTimeDay (DT): retourne la valeur numérique du jour du mois dans une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeDay ("2017-03-24 11:43:23") renvoie 24.

DateTimeDiff (DT1, DT2, u): soustraire le deuxième argument de la première et le retourner comme une différence de nombre entier. La durée est retournée sous la forme d'un nombre, et non d'une chaîne, dans les unités de temps spécifiées.

Exemple

DateTimeDiff ("2016-02-15 00:00:00", "2016-01-15 00:00:01", "months") retourne 1 (parce que le début et la fin sont le même jour du mois)

DateTimeDiff ("2012-02-29", "2011-03-01", "années") retourne 0 (même si 2012-02-29 est 365 jours après 2011-03-01, le 29 février est avant le 1er mars, donc "un an" n'a pas encore été achevé)

DateTimeDiff ("2016-02-14", "2016-01-15", "mois") retourne 0 (parce que le jour de février est inférieur au jour de janvier)

DateTimeDiff ("2016-02-14 23:59:59", "2016-01-15 00:00:00", "months") retourne 0 (même s'il n'est qu'une seconde à court d'atteindre le jour requis)

DateTimeDiff (' 2017-02-28 ', ' 2016-02-29 ', 'months') renvoie 11 (même si le 28 est le dernier jour de février en 2017, le 28 est inférieur à 29)

En savoir plus

• Pour les différences de mois et d’année, un mois est uniquement pris en considération quand le jour de fin atteint le jour de début, en ignorant l’heure du jour.
• Pour la précision des paramètres Jour, Heure, Minute et Seconde, le résultat est calculé avec exactitude, puis les fractions sont tronquées, non arrondies. En conséquence :

DateTimeDiff (' 2016-01-01 00:59:59 ', ' 2016-01-01 00:00:00 ', 'hours') est zéro.

DateTimeDiff (' 2016-01-01 23:59:59 ', ' 2016-01-01 00:00:00 ', 'Days') est zéro.

• Les noms de précision peuvent être raccourcis à leurs trois premiers caractères (comme'sec'et'min'); l'affaire est insensible.
• Faites attention lorsque vous enregistrez les différences temporelles en secondes. Int32 ne peut enregistrer qu’une différence de 68 ans en secondes ou de 4082 ans en minutes. Vous pouvez utiliser un paramètre Double ou Int64 pour conserver les intervalles entre toutes les dates prises en charge.

DateTimeFirstOfMonth (): retourne le premier jour du mois, à minuit.

DateTimeFormat (DT, f): convertir les données DateTime du format ISO en un format à utiliser par une autre application. Sortie vers un type de données String.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

f: le format auquel convertir les données, exprimée dans une chaîne de format.

Exemple

DateTimeFormat ([DateTime_Out], "% d-% m-% Y") renvoie 22-04-2008 pour la date du 22 avril 2008 (format ISO: 2008-04-22)

DateTimeHour (DT): retourne la partie heure de l'heure dans une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeHour ("2017-03-24 11:43:23") renvoie 11.

DateTimeHour ("2017-03-24") retourne 0, comme minuit est l'heure supposée quand aucun temps n'est spécifié avec une date.

DateTimeLastOfMonth (): retourne le dernier jour du mois en cours, l'horloge étant réglée sur une seconde avant la fin de la journée (23:59:59).

Designer utilise la date et l'heure où la formule est d'abord analysée. Dans le cadre d’un traitement par lots, cette même heure est utilisée pour chaque nouvel ensemble de données. Cela permet de garantir la cohérence des résultats en cas de processus long.

DateTimeMinutes (DT): retourne la partie minutes de l'heure dans une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeMinutes ("2017-03-24 11:43:23") retourne 43.

DateTimeMonth (DT): retourne la valeur numérique du mois dans une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeMonth ("2017-03-24 11:43:23") renvoie 3.

DateTimeMonth ("11:43:23") retourne [NULL], car les données entrantes ne sont pas valides.

DateTimeNow (): retourne la date et l'heure du système actuel.

DateTimeParse (DT, f): convertit une chaîne de date avec le format spécifié au format standard ISO AAAA-MM-DD HH: mm: SS.

Paramètres

DT: données de chaîne DateTime, exprimées sous la forme d'un champ sélectionné ou d'une chaîne DateTime entre guillemets. Les données entrantes doivent être de type chaîne de données, et peuvent être dans n'importe quel format de DateTime tant que ce format est d'accord avec le format que vous spécifiez pour le paramètre f.

f: le format des données que vous convertissez, exprimée dans une chaîne de format entre guillemets.

Exemple

DateTimeParse ("2016/28-03", "% Y/% d-% m") renvoie 2016-03-28.

DateTimeSeconds (DT): retourne la partie secondes de l'heure dans une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeSeconds ("2017-03-24 11:43:23") renvoie 23.

DateTimeStart (): retourne la date et l'heure auxquelles le workflow en cours a commencé à s'exécuter.

DateTimeToday (): renvoie la date d'aujourd'hui.

ToDateTime (DateTimeToday ())

DateTimeToLocal (DT): convertit un DateTime UTC en fuseau horaire du système local.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeToLocal (' 2014-08-01 20:01:25 ') renvoie le fuseau horaire du système local (heure des Rocheuses) comme 2014-08-01 14:01:25

DateTimeToUTC (DT): convertit un DateTime (dans le fuseau horaire du système local) en UTC.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeToUTC (DateTimeNow ()) retourne le temps universel coordonné à l'exécution de workflow: 2014-08-01 20:01:25 (où le temps de montagne local était 2014-08-01 14:01:25)

DateTimeTrim (DT, t): supprime les parties non désirées d'un DateTime et retourne le DateTime modifié.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

t: type de garniture. Plusieurs options sont possibles :

• firstofmonth:  ajustement au début du mois (identique à l’ajustement au mois).
• lastofmonth: ajustement une seconde avant la fin du dernier jour du mois.
• année: ajustement à minuit le 1er janvier.
• mois: ajustement à minuit le premier jour du mois.
• jour: ajustement au jour (à minuit). Cette option permet de convertir une date/heure en jour, en remettant l’heure à zéro.
• heure:  ajustement à l’heure.
• minute:  ajustement à la minute.

Le rognage d'un DateTime ne contourne pas la valeur retournée. Par exemple, le temps 15:59:59 paré à l'heure devient 15:00:00, pas 16:00:00.

Exemple

DateTimeTrim ("2016-12-07 16:03:00", "Year") renvoie 2016-01-01 00:00:00.

DateTimeYear (DT): retourne la valeur numérique de l'année dans une valeur DateTime.

Paramètres

DT: données DateTime, exprimées sous la forme d'une colonne sélectionnée ou d'une valeur DateTime spécifiée entre guillemets.

Exemple

DateTimeYear ("2017-03-24 11:43:23") retourne 2017.

ToDate (x): convertit une chaîne, un nombre ou un DateTime en une date.

ToDateTime (x): convertit une chaîne, un nombre ou une date en DateTime.

Une fonction Fichier construit les chemins de fichier, vérifie l’existence d’un fichier ou extrait une partie d’un chemin de fichier. Les fonctions Fichier ne peuvent être utilisées qu’avec des données de type Chaîne.

FileAddPaths (chemin1, chemin2): ajoute deux parties de chemin d'accès au fichier, en veillant à ce qu'il y ait exactement un \ (barre oblique inverse) entre les deux chemins.

Exemple

FileAddPaths ([C:\temp], [Data\file.csv]) retourne "C:\Temp\Data\file.csv"

FileExists (Path): retourne true si le fichier existe, false si ce n'est pas le cas.

Exemple

FileExists (C:\temp) retourne "true"

FileExists (C:\Temp\Data\file.csv) retourne "true"

FileExists (C:\Temp\Data\NoFile.csv) retourne "false"

FileGetDir (Path): retourne la partie du répertoire du chemin d'accès.

Exemple

FileGetDir (C:\Temp\Data\file.csv) retourne C:\Temp\Data

FileGetDir (C:\Temp\Data) retourne C:\temp

FileGetExt (Path): retourne l'extension du chemin d'accès, y compris le. (point).

Exemple

FileGetExt (C:\Temp\Data\file.csv) retourne ". csv"

FileGetExt (C:\Temp\Data) retourne ""

FileGetFileName (Path): retourne la partie nom du chemin d'accès, sans l'extension.

Exemple

FileGetName (C:\Temp\Data\file.csv) retourne "fichier"

FileGetName (C:\Temp\Data) retourne "Data"

Une fonction Finance applique des algorithmes financiers ou des calculs mathématiques.

FinanceCAGR (BeginningValue, EndingValue, NumYears): taux de croissance annuel composé: le taux de croissance moyen géométrique sur une base annualisée.

FinanceEffectiveRate (NominalRate, PaymentsPerYear): taux d'intérêt annuel effectif: taux d'intérêt sur un prêt ou un produit financier relibellé du taux d'intérêt nominal comme taux d'intérêt avec intérêts composés annuels payables en arrérages

FinanceFV (rate, NumPayments, PaymentAmount, PresentValue, PayAtPeriodBegin): valeur future d'un investissement: la valeur d'un actif à un moment déterminé à l'avenir en supposant un certain taux d'intérêt ou taux de rendement.

FinanceFVSchedule (principe, Year1Rate, Year2Rate): calendrier des valeurs futures: la valeur future d'un capital initial après l'application d'une série de taux d'intérêt à un investissement.

FinanceIRR (value1, value2): taux de rendement interne: taux d'intérêt auquel les coûts de l'investissement débouchent sur les avantages de l'investissement. Cela signifie que tous les gains liés à l’investissement sont inhérents à la valeur temporelle de l’argent et que l’investissement possède une valeur présente nette nulle à ce taux d’intérêt.

FinanceMIRR (FinanceRate, reinvestrate, value1, value2): taux de rendement interne modifié: une modification du taux de rendement interne qui vise à résoudre certains problèmes avec l'IRR. Le MIRR est une mesure de l’attractivité d’un investissement dans le secteur financier.

FinanceMXIRR (FinanceRate, reinvestrate, value1, date1, value2, date2): taux de rendement interne modifié d'un investissement avec dates

FinanceNominalRate (EffectiveRate, PaymentsPerYear): taux d'intérêt nominal annuel: un taux d'intérêt est appelé nominal si la fréquence de la composition (par exemple un mois) n'est pas identique à l'unité de temps de base (normalement une année).

FinanceNPER (taux, PaymentAmount, PresentValue, estimation, PayAtPeriodBegin): nombre de périodes pour un investissement ou un prêt

FinanceNPV (taux, value1, value2): valeur actualisée nette d'un investissement: mesure l'excédent ou le déficit des flux de trésorerie, en valeur actualisée, une fois les frais de financement respectés.

FinancePMT (rate, NumPayments, PresentValue, estimation, PayAtPeriodBegin): calcule les paiements sur un prêt

FinancePV (rate, NumPayments, PaymentAmount, estimation, PayAtPeriodBegin): valeur actualisée d'un investissement: la valeur à une date donnée d'un paiement futur ou d'une série de paiements futurs, actualisée pour refléter la valeur temporelle de l'argent et d'autres facteurs tels que risque d'investissement.

FinanceRate (NumPayments, PaymentAmount, PresentValue, estimation, PayAtPeriodBegin): renvoie le taux d'intérêt (par période)

FinanceXIRR (value1, date1, value2, date2): taux de rendement interne d'un investissement avec dates

FinanceXNPV (rate, value1, date1, value2, date2): valeur actualisée nette d'un investissement avec des dates

Une fonction mathématique exécute des calculs mathématiques. Les fonctions mathématiques ne peuvent être utilisées qu’avec des données de type Nombre.

ABS (x): valeur absolue de (x). Cette valeur représente la distance entre 0 et un nombre. La valeur est toujours positive.

Exemple

ABS (32) retourne 32

ABS (-32) retourne 32

OCA (x): arc-cosinus de (x)

Renvoie l’arc cosinus, ou le cosinus inverse, d’un nombre. L’arc cosinus correspond à l’angle dont le cosinus est (x). L’angle renvoyé est indiqué en radians dans la plage allant de 0 (zéro) à pi. Le nombre (x) doit être compris entre -1 et 1.

Exemple

Le CoA (0.5) retourne 1,047198

ASIN (x): arc-sinus de (x)

Renvoie l’arc sinus, ou le sinus inverse, d’un nombre. L’arc sinus correspond à l’angle dont le sinus est (x). L’angle renvoyé est indiqué en radians dans la plage allant de -pi/2 à pi/2.

Exemple

ASIN (0.5) renvoie 0,523599

ATAN (x): arc-tangente de (x)

Renvoie l’arc tangente, ou la tangente inverse, d’un nombre. L’arc tangente correspond à l’angle dont la tangente est (x). L’angle renvoyé est indiqué en radians dans la plage allant de -pi/2 à pi/2.

Exemple

ATAN(0.8) renvoie la valeur 0,674741

Atan2 (y, x): arc-tangente de (y/x)

Renvoie l’arc tangente de y et x.

Exemple

ATAN2(4, -3) renvoie la valeur 2,2143

Moyenne (N1,...) : Moyenne d'une liste de nombres.

Exemple

Moyenne (20, 30, 55) renvoie 35 depuis [(20 + 30 + 55)/3] = 35

Cellule (x): renvoie le plus petit entier supérieur ou égal à (x). Fonctionne comme l’arrondi dans Excel.

Exemple

La cellule (1.1) renvoie 2

La cellule (6,54) renvoie 7

La cellule (-30,42) retourne-30

COS (x): cosinus de (x)

Cosh (x) : cosinus hyperbolique de (x)

Distance (from_Lat, from_Lon, to_Lat, to_Lon): renvoie la distance de (lat1, Lon1) à (LAT2, lon2)

Exemple

DISTANCE (42,-90, 43,-80) renvoie une valeur de 513,473706 milles

EXP (x): retourne e ^ x

Floor (x): renvoie le plus grand entier inférieur ou égal à (x)

Exemple

Floor (1.1) retourne 1

Floor (6.54) retourne 6

Floor (-30,42) retourne-31

LOG (x): logarithme naturel de (x)

Exemple

LOG (1) retourne 0

LOG (14) retourne 2,639057

Log10 (x): logarithme de base 10 de (x)

Exemple

Log10 (1) retourne 0

Log10 (14) retourne 1,146128

Médiane (...) : Calcule la médiane d'une ou plusieurs valeurs (éventuellement non triées).

Exemple

Médiane (5, 4, 3, 7, 6) renvoie 5

Mod (n, d): modulo de n divisé par d (opération entière)

L'opération modulo trouve le reste d'un entier (n) divisé par un entier diviseur (d). Si (n) est positif, le résultat est positif. Si (n) est négatif, le résultat est négatif.

Si des valeurs décimales sont utilisées, la décimale est tronquée. Cela peut entraîner une erreur "divisée par 0" si le diviseur est une décimale inférieure à 1.

Exemple

MOD (6, 4) renvoie 2

MOD (6,-4) renvoie 2

MOD (-6, 4) retourne-2

MOD (-6,-4) retourne-2

MOD (6,. 4) retourne [NULL]

Pi (): renvoie la valeur de la constante pi à 15 chiffres de précision

Exemple

PI () retourne 3,141593

Pow (x, e): renvoie (x) élevé à la puissance (e)

Exemple

Pow (2,3) équivaut à 2 ³ et retourne 8

Rand (): renvoie un nombre aléatoire entre 0 et 1

Exemple

Rand () retourne un nombre aléatoire comme 0,256

RandInt (n): retourne un entier aléatoire compris entre 0 et le paramètre spécifié

Exemple

RandInt (10) renvoie 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 ou 10

RandInt (5000) renvoie un nombre entier aléatoire compris entre 0 et 5000, tel que 741

Round (x, mult): renvoie (x) arrondi au multiple le plus proche (mult)

Exemple

Round (55.34, 2) retourne une valeur de 56

Round (39.88) retourne la valeur 40

Round (41.1, 10) renvoie la valeur 40

Round (1.25, 0,1) retourne une valeur de 1,3

Round (1.227, 0,01) retourne une valeur de 1,23

Sin (x): sinus de (x)

SINH (x): sinus hyperbolique de (x)

SmartRound (x): renvoie (x) arrondi au multiple le plus proche d'une valeur déterminée dynamiquement en fonction de la taille de (x)

SQRT (x): racine carrée de (x)

Exemple

SQRT (100) retourne une valeur de 10

Tan (x): tangente de (x)

TANH (x): tangente hyperbolique de (x)

Une fonction bit par bit s’applique à une ou plusieurs séquences de bits ou valeurs numériques binaires au niveau de leurs bits individuels. Utilisez une fonction bit par bit pour manipuler les valeurs dans le cadre de comparaisons et de calculs. Les fonctions bit par bit ne peuvent être utilisées qu’avec des données de type Nombre.

BinaryAnd (n, m): retourne un binaire de n et m. Le résultat est 1 si n et m sont tous deux 1, sinon 0. Si 0 est assimilé à false et 1 à true, l’opération BinaryAnd fonctionne comme un AND logique.

Exemple

BinaryAnd (1, 1) retourne 1

BinaryAnd (1, 0) retourne 0

BinaryNot (n): retourne un binaire non de n

Exemple

BinaryNot (6) retourne-7

BinaryNot (2) retourne-3

Binaryr (n, m): renvoie un binaire ou n et m

Exemple

Binaryer (6, 6) renvoie 6

Binaryer (6, 2) renvoie 6

BinaryXOr (n, m): retourne un XOR binaire de n et m

Exemple

BinaryXOr (6, 6) retourne 0

BinaryXOr (6, 2) renvoie 4

ShiftLeft (n, b): décalages gauches n (As Integer) par b bits

ShiftRight (n, b): décalages vers la droite n (comme entier) par b bits

Une fonction minimum ou maximum recherche la plus petite et la plus grande valeur d’un ensemble de valeurs. Les fonctions Min/Max ne peuvent être utilisées qu’avec des données de type Nombre.

Lié (x, min, max): if (x < min)="" return="" min;="" else="" if="" (x=""> max) return Max; else return x

Exemple

Bound (6, 1, 5) renvoie 5

Bound (3, 1, 5) retourne 3

Max (v0, v1,..., VN): renvoie la valeur maximale de la liste.

Exemple

Max (15180, 7, 13, 45, 2, 13) retourne 180

MaxIDX (v0, v1,..., VN): renvoie l'index 0 basé sur la valeur maximale de la liste.

Exemple

MaxIDX (15180, 7, 13, 45, 2, 13) retourne 1

Min (v0, v1,..., VN): renvoie la valeur minimale de la liste.

Exemple

Min (15180, 7, 13, 45, 2, 13) renvoie 2

MinIDX (v0, v1,..., VN): renvoie l'index 0 basé sur la valeur minimale de la liste.

Exemple

MinIDX (15180, 7, 13, 45, 2, 13) renvoie 5

Un opérateur est un caractère représentant une action. Utilisez un opérateur arithmétique pour exécuter des calculs mathématiques ou un opérateur booléen pour travailler avec des valeurs true/false. Les opérateurs peuvent être utilisés avec tous les types de données.

/* comment */: Block Comment: vous permet d'ajouter des commentaires à un éditeur d'expression (dans la ligne d'expression) sans interférer avec l'expression.

Commentaire: single line Comment: vous permet d'ajouter des commentaires à un éditeur d'expression sans interférer avec l'expression.

Addition +: ajout

Boolean et & &: booléen et: utilisé pour combiner deux valeurs booléennes. Le résultat est également une valeur booléenne. Le résultat est true si les deux valeurs combinées sont vraies et il est false si l’une des valeurs combinées est fausse.

Boolean et-Keyword: Boolean et: utilisé pour combiner deux valeurs booléennes. Le résultat est également une valeur booléenne. Le résultat est true si les deux valeurs combinées sont vraies et il est false si l’une des valeurs combinées est fausse.

Booléen non! : Boolean not: accepte une entrée. Si cette entrée est TRUE, elle renvoie FALSE. Si cette entrée est FALSE, elle renvoie TRUE.

Boolean not-mot-clé: Boolean not: accepte une entrée. Si cette entrée est TRUE, elle renvoie FALSE. Si cette entrée est FALSE, elle renvoie TRUE.

Boolean ou-Keyword: Boolean ou: si l'une ou l'autre des deux valeurs qu'il vérifie sont vraies, elle retourne true.

Booléen ou | | : Booléen ou: si l'une ou l'autre des deux valeurs qu'il vérifie sont vraies, elle retourne true.

Parenthèse fermante): fermer la parenthèse

Division/: Division

Égal à =: égal à

Supérieur à >: supérieur à

Supérieur ou égal à > =: supérieur ou égal à

Inférieur à : inférieur à

Inférieur ou égal : inférieur ou égal à

Multiplication *: multiplication

Pas égal à! =: pas égal à

Parenthèse ouverte (: parenthèse ouverte

Soustraction-: soustraction

valeur dans (...)-mot-clé: tester la valeur dans la liste: détermine si une valeur donnée correspond à n'importe quelle valeur dans une sous-requête ou une liste.

valeur non dans (...)-mot-clé: valeur de test non dans la liste: détermine si une valeur donnée correspond à une valeur qui n'est pas dans une sous-requête ou une liste.

Une fonction géographique construit des objets géographiques, analyse des données géographiques et renvoie des métriques à partir de champs géographiques. Une fonction géographique ne peut être utilisée qu’avec des données de type géographique.

Les fonctions géographiques sont identiques à celles de l’Open GIS Consortium, Inc. Pour plus d'informations , voir http://Portal.opengeospatial.org/files/?artifact_id=829.

Les objets géographiques dans les formules peuvent utiliser les opérateurs : plus +, moins -, égal == et non égal à !=

ST_Area (Object, Units): retourne la zone dans les unités spécifiées de l'objet spatial. (valeur de données numérique)

ST_Boundary (Object): retourne la limite de l'objet spatial. (Objet géographique polyligne indiquant le périmètre du polygone d’entrée)

ST_BoundingRectangle (objet,...) : Retourne le rectangle englobant de l'objet spatial. (Objet géographique polygone)

Exemple

ST_Centroid (Object): retourne le point médian de l'objet spatial. (Objet géographique point)

ST_CentroidX (Object): retourne la longitude du point médian de l'objet spatial (valeur de données numériques)

ST_CentroidY (Object): retourne la latitude du point médian de l'objet spatial (valeur de données numériques)

ST_Combine (object1, Object2,...) : Combine les objets spatiaux. (objet géographique)

Exemple

ST_Contains (object1, Object2): retourne true si object1 contient object2. (Valeur booléenne)

ST_ConvexHull (object1,...) : Retourne la coque convexe de l'objet (s). (objet géographique)

Exemple

ST_CreateLine (point1, point2...) : Crée une ligne en connectant les points et lignes spécifiés dans une séquence. (objet géographique)

ST_CreatePoint (x, y): retourne un objet spatial contenant les coordonnées de longitude et de latitude spécifiées. (objet géographique)

ST_CreatePolygon (obj1, obj2...) : Crée un polygone en connectant les points et lignes spécifiés dans une séquence. (objet géographique)

ST_Cut (object1, Object2): renvoie le résultat de la coupe object1 de l'objet 2. (objet géographique)

Exemple

ST_Dimension (Object): retourne la dimension de l'objet spatial. La dimension géographique est le nombre minimum de coordonnées requises pour spécifier chaque point composant l’objet géographique. Les objets point renvoient la valeur 0, les objets ligne renvoient la valeur 1 et les objets polygone renvoient la valeur 2. (valeur de données numérique)

ST_Distance (object1, Object2, Units): retourne la distance dans les unités spécifiées de object1 à object2. Les unités prises en charge sont : Miles (Mi), Kilomètres (KM), Mètres et Pieds. (valeur de données numérique)

ST_EndPoint (Object): retourne le dernier point de l'objet spatial. (Objet géographique point)

ST_Intersection (object1, Object2,...) : Retourne l'intersection des objets spatiaux spécifiés. (objet géographique)

ST_Intersects (object1, Object2...) : Retourne true si les objets spatiaux se croisent. (Valeur booléenne)

ST_InverseIntersection (object1, Object2...) : Retourne l'intersection inverse des objets spatiaux spécifiés. (objet géographique)

ST_Length (Object, Units): retourne la longueur linéaire de l'objet spatial. (valeur de données numérique)

ST_MaxX (Object): retourne la longitude maximale de l'objet spatial. (valeur de données numérique)

ST_MaxY (Object): retourne la latitude maximale de l'objet spatial. (valeur de données numérique)

ST_MinX (Object): retourne la longitude minimale de l'objet spatial. (valeur de données numérique)

ST_MinY (Object): retourne la latitude minimale de l'objet spatial. (valeur de données numérique)

ST_NumParts (Object): retourne le nombre de parties dans l'objet spatial. (valeur de données numérique)

ST_NumPoints (Object): retourne le nombre de points dans l'objet spatial. (valeur de données numérique)

ST_ObjectType (Object): retourne le type d'objet spatial en tant que valeur de chaîne. (valeur de données de type Chaîne)

ST_PointN (Object, n): retourne le nième point dans l'objet spatial. (Objet géographique point)

ST_RandomPoint (Object): retourne un point aléatoire dans l'objet spatial. (Objet géographique point)

ST_Relate (object1, Object2, relation): retourne true si les objets satisfont la relation de 9IM fournie. (Valeur booléenne)

ST_StartPoint (Object): retourne le premier point de l'objet spatial. (objet géographique)

ST_Touches (object1, Object2): retourne true si l'objet 1 touche l'objet 2. (Valeur booléenne)

ST_TouchesOrIntersects (object1, Object2): retourne true si l'objet 1 touche ou croise l'objet 2. (Valeur booléenne)

ST_Within (object1, Object2): retourne true si l'objet 1 est contenu par l'objet 2. (Valeur booléenne)

Ces fonctions exécutent diverses actions spécialisées et peuvent être utilisées avec tous les types de données.

EscapeXMLMetacharacters (String): remplace les caractères de caractère XML par leurs versions échappées. Cinq caractères possèdent une version avec échappement.

Exemple

EscapeXMLMetacharacters ("2 > 1 & 1 renvoie 2 &gt; 1 &amp; 1 &lt; 2

GetVal (index, v0,... vn): retourne la valeur (v0,..., VN) spécifiée par le [index] basé sur 0.

GetEnvironmentVariable (nom): retourne la variable d'environnement spécifiée dans Name. Pour obtenir la liste des variables d’environnement, sélectionnez Panneau de configuration > Système > Paramètres système avancés > Variables d’environnement. La liste des variables système apparaît. Vous pouvez utiliser n’importe laquelle de ces valeurs.

Exemple

GetEnvironmentVariable (COMMONPROGRAMFILES) retourne C:\Program Files\Common Files

GetEnvironmentVariable (OS) retourne Windows_NT

Message (MessageType, message, returnValue): utilisez avec une instruction conditionnelle pour afficher un message dans le journal des messages et mettre à jour les données de colonne avec une valeur spécifiée lorsqu'une condition est remplie.

Le type et le texte du message sont indiqués dans la fenêtre Résultats. Si la journalisation est activée, le fichier journal de sortie est également similaire à ces informations. Voir Fenêtre Résultats et Fichier journal de sortie.

Paramètres

MessageType: nombre correspondant au type de message:

• 1 = Messages
• 2 = Avertissements
• 3 = Erreurs
• 5 = Erreurs de conversion (erreurs de conversion de champ)
• 8 = Fichiers (entrée)
• 9 = Fichiers (sortie)

message: texte du message, exprimé sous forme de chaîne entre guillemets.

returnValue: valeur à produire dans les données de colonne. Il peut s’agir d’une valeur numérique (par exemple, 0), null ou d’une chaîne de texte entre guillemets (par exemple, "False").

Exemple

Dans cet exemple, la fonction Message est utilisée dans une expression conditionnelle pour générer un message d’erreur de conversion de champ et mettre à jour les données de la colonne avec la valeur "False" si les valeurs de date/heure indiquées ne contiennent pas des données temporelles valides.

If [Hour] = "0" et [minutes] = "0" Then
message (5, "heure non valide dans DateTime", "false")
else
"true"
endif

Null (): retourne une valeur null

RangeMedian (...) : Calcule la médiane d'une série de plages agrégées. Voir Médiane de la plage.

ReadRegistryString (Key, valueName, DefaultValue = "): retourne une valeur du Registre.

Exemple

ReadRegistryString ('HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SRC\Alteryx', 'InstallDir64 ') retourne C:\Program Files\Alteryx\bin

SOUNDEX (String): retourne le Soundex de la chaîne. Soundex crée un code basé sur le premier caractère de la chaîne, plus trois caractères en fonction des éléments suivants :

Exemple

Si le code obtenu ne contient que 2 ou 3 caractères, Soundex utilise des zéros pour atteindre les 4 caractères. Par exemple, dans le prénom Lauren, seuls le L, le r et le n sont traduits (Lrn), et donc la clé Soundex devient L650.Si le code obtenu possède plus de 4 caractères, tous les caractères situés après le quatrième sont ignorés. Par exemple, dans le nom de Patrick, les P, t, r, c et k peuvent être traduits (Ptrck), mais le code Soundex résultant ne sera que de quatre caractères: P362.

Soundex_Digits (String): retourne les quatre premiers chiffres ou le Soundex si aucun. Si la chaîne comporte des chiffres (numéros), les quatre premiers sont renvoyés. Si la chaîne ne contient aucun chiffre, la clé Soundex est renvoyée.

TOPNIDX (N, v0, v1,..., VN): retourne l'index 0 basé sur le nième à partir de la valeur maximale de la liste. Si N==0, cette fonction est identique à MaxIdx(...).

N est le point de départ, v0 est le champ indexé (les variables suivantes sont facultatives), et VN est l'objectif.

Exemple

TOPNIDX (0, [ChampIndexé], 5) retourne les cinq premiers d'un flux

UrlEncode (String): encode la chaîne en tant qu'URL légale Web

Exemple

C:\temp\Alteryx url encode renvoie C:/Temp/Alteryx% 2 0 URL% 2 0 encode

Une fonction string exécute des opérations sur des données de texte. Utilisez une fonction string pour nettoyer les données, convertir des données dans un autre format ou casse, calculer des métriques relatives aux données ou effectuer d’autres manipulations. Une fonction string ne peut être utilisée qu’avec des données de type Chaîne.

Contains (String, Target, CaseInsensitive = 1): recherche l'occurrence d'une chaîne particulière dans une chaîne. Renvoie TRUE ou FALSE si la chaîne concorde avec le schéma. Par défaut, il est insensible à la casse.

Contrairement à la fonction FINDSTRING, la fonction CONTAINS est insensible à la casse.

Exemple

Contains (' 123abc', 'ABC') retourne true

Contains (' 123abc', 'ABC') retourne true

Contains (' 123abc', 'ABC', 0) retourne false

CountWords (String): retourne le nombre de mots dans la chaîne spécifiée. Les mots sont définis comme des ensembles de caractères séparés par un espace.

Exemple

CountWords ("variables de base ménages") renvoie 3

CountWords ("variables de base âge: femelle (POP) âge 1") renvoie 5

DecomposeUnicodeForMatch (String): supprime les accents et développe les caractères composés lors de la conversion en Narrow. Cette fonction prend une chaîne Unicode ® et il traduit en minuscules, chaîne de caractères étroite. Les accents et les autres éléments décoratifs sont tous supprimés.

Cette fonction n’est utile que pour les opérations de concordance. Son résultat n’est pas considéré comme une chaîne normalisée.

Exemple

DecomposeUnicodeForMatch ("prénoms français") retourne prenoms francais

EndsWith (String, Target, CaseInsensitive = 1): vérifie si une chaîne se termine par une chaîne particulière. Renvoie TRUE ou FALSE si la chaîne concorde avec le schéma. Par défaut, il est insensible à la casse.

Exemple

EndsWith (' 123abc', 'ABC') retourne true

EndsWith (' 123abc', 'ABC') retourne true

EndsWith (' 123abc', 'ABC', 0) retourne false

Contrairement à la fonction FindString, la fonction EndsWith est insensible à la casse.

FindString (String, target): recherche l'occurrence d'une chaîne particulière (cible) dans une autre chaîne (String) et retourne la position numérique de son occurrence dans la chaîne.

Renvoie l’index en base 0 de la première occurrence de la cible dans String. Renvoie -1 en l’absence d’occurrence.

Exemple

FindString ([nom], "John") retourne 0 lorsque la chaîne contient John et retourne-1 lorsque la chaîne ne l'est pas.

IF (FindString ([nom], "John") = 0) puis "John Smith" Else "autre" endif retourne John Smith lorsque la chaîne contient John et retourne d'autres lorsque la chaîne n'est pas.

GetWord (String, n): retourne le nième (0-based) Word dans la chaîne. Les mots sont définis comme des ensembles de caractères séparés par un espace. L’index en base 0 signifie que le premier mot se trouve à la position 0.

Exemple

GetWord ("Basic variables Households", 0) renvoie "Basic"

GetWord ("variables de base ménages", 1) renvoie "variables"

Left (x, Len): renvoie les premiers caractères [len] de la chaîne (x). Si len est inférieur à 0 ou supérieur à la longueur de la x, x reste inchangé.

Exemple

Left ("92688", 3) retourne la valeur "926"

Length (x) : renvoie la longueur de la chaîne (x).

Exemple

Length ("92688") retourne une valeur de 5

Minuscules (x): convertit un String en minuscules

Exemple

Minuscule ("M1P 1G6") retourne "M1P 1G6"

MD5_ASCII (String): calcule le hachage MD5 de la chaîne. La chaîne ne devrait comporter que des caractères ASCII. Les caractères Unicode ® sont-ils transformés? avant de calculer le hachage MD5.

MD5_UNICODE (String): calcule le hachage MD5 de la chaîne.

PadLeft (STR, Len, Char): pads la chaîne à gauche avec le caractère spécifié à la longueur spécifiée. Si le « car » de remplissage comporte plus d’un caractère, seul le premier caractère est utilisé.

Exemple

PadLeft ("M", 4, "x") retourne "xxxM"

PadRight (STR, Len, Char): pads la chaîne à droite avec le caractère spécifié à la longueur spécifiée. Si le « car » de remplissage comporte plus d’un caractère, seul le premier caractère est utilisé.

Exemple

PadRight ("M", 4, "x") retourne "Mxxx"

REGEX_CountMatches (String, pattern, iCase): retourne le nombre de correspondances dans la chaîne au modèle.

Le paramètre icase est facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 signifie que la casse est ignorée. S’il est défini sur 0, la casse doit concorder.

Consultez la page de syntaxe d'expression régulière de Boost Regex perl pour simplifier le développement de l'expression.

REGEX_Match (String, pattern, iCase): recherche une chaîne pour une occurrence d'une expression régulière.

Indique si la chaîne concorde avec le schéma du premier caractère jusqu’à la fin. Pour rechercher un élément qui ne commence pas nécessairement au début de la chaîne, commencez le schéma par « .* ». Pour rechercher un élément qui ne s’arrête pas nécessairement à la fin de la chaîne, terminez le schéma par « .* ».

Consultez la page de syntaxe d'expression régulière de Boost Regex perl pour plus d'informations sur la façon de construire correctement une expression régulière.

iCase est un paramètre facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 signifie que la casse est ignorée. S’il est défini sur 0, la casse doit concorder.

Exemple

REGEX_Match (123-45-6789, "\d{3}-\d{2}-\d{4}") retourne-1 (true)

REGEX_Replace (String, pattern, Replace, iCase): permet le remplacement du texte à l'aide d'expressions régulières et retourne la chaîne résultant du modèle Regex Find et remplacer la chaîne. Toutes les occurrences de la concordance sont remplacées, pas seulement la première.

Consultez la page de syntaxe d'expression régulière de Boost Regex perl pour simplifier le développement de l'expression. Le paramètre de remplacement peut être une valeur spécifiée (comme indiqué ci-dessous) ou un groupe marqué, par exemple « $1 ».

iCase est un paramètre facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 signifie que la casse est ignorée. S’il est défini sur 0, la casse doit concorder.

Exemple

REGEX_Replace ("ne pas révéler votre numéro de sécurité sociale, 123-45-6789", "\d{3}-\d{2}-\d{4}", "classifié") retours ne révèlent pas votre numéro de sécurité sociale, classés

REGEX_Replace ("modifier tous les noms de domaine de alteryx@Alteryx.com", "@. * \.", "@extendthereach.") retourne modifier tous les noms de domaine de alteryx@extendthereach.com

Remplacer (STR, Target, Replacement): retourne la chaîne (STR) après avoir remplacé chaque occurrence de la chaîne (target) par la chaîne (remplacement).

Exemple

Remplacer («bon jugement vient de l'expérience», «expérience», «sensibilisation») renvoie «le bon jugement vient de la conscience»

ReplaceChar (x, y, z): retourne la chaîne (x) après avoir remplacé chaque occurrence du caractère (y) par le caractère (z). Si le caractère de remplacement (z) est une chaîne comportant plusieurs caractères, seul le premier est utilisé. Si (z) est vide, chaque caractère (x) correspondant à tout caractère de (y) est simplement supprimé.

Exemple

ReplaceChar ("abcdefb", "b", "_") retourne "a_cdef_"

ReplaceChar ("@ a # b% c", "@, #,%", "_") retourne "_a_b_c"

ReplaceFirst (STR, Target, Replacement): retourne la chaîne (STR) après avoir remplacé la première occurrence de la chaîne (target) par la chaîne (remplacement).

Exemple

ReplaceFirst ("abcdefb", "b", "_") retourne "a_cdefb"

ReverseString (STR): inverse tous les caractères de la chaîne.

Exemple

ReverseString ("abcdefb") retourne "bfedcba"

Right (String, Len): retourne les derniers caractères (Len) de la chaîne. Si len est inférieur à 0 ou supérieur à la longueur de String, la chaîne reste inchangée.

Exemple

Right ("92688", 3) retourne la valeur "688"

StartsWith (String, Target, CaseInsensitive = 1): vérifie si une chaîne commence par une chaîne particulière. Renvoie TRUE ou FALSE si la chaîne concorde avec le schéma. Par défaut, il est insensible à la casse.

Contrairement à la fonction FindString, la fonction StartsWith est insensible à la casse.

Exemple

StartsWith ('ABC123 ', 'ABC') retourne true

StartsWith ('ABC123 ', 'ABC') retourne true

StartsWith ('ABC123 ', 'ABC', 0) retourne false

STRCSPN (x, y): renvoie la longueur du segment initial de la chaîne (x) consistant en caractères non dans la chaîne (y)

Exemple

STRCSPN ("Amaco de Bob", "~! @ # $% ^ & * ' ()") retourne 3.  Cette fonction est utile pour contrôler l’absence de ponctuation dans la chaîne.

StripQuotes (x): supprime un jeu de guillemets ou d'apostrophes correspondant aux extrémités de la chaîne

Exemple

StripQuotes ("Bonjour il") retourne Bonjour il

StripQuotes («Bonjour, dit-elle. ") retourne «Bonjour, dit-elle.

StripQuotes («Bonjour, dit-elle. ') retourne "Bonjour," dit-elle.

STRSPN (x, y): renvoie la longueur du segment initial de la chaîne [x] composée de caractères dans la chaîne [y]

Exemple

STRSPN ("3034408896x105", "0123456789") retourne 10.  Cette fonction est utile pour contrôler si une chaîne est formée d’un jeu de caractères.

Sous-chaîne (x, début, longueur): retourne la sous-chaîne de (x) à partir de (début), arrêt après (longueur), si elle est fournie

Exemple

Substring ("949-222-4356", 4, 8) retourne "222-4356"

Substring ("949-222-4356", 4, 6) retourne "222-43"

Substring ("949-222-4356", 4) retourne "222-4356"

TitleCase (x) : convertit une chaîne en cas de titre

Exemple

TitleCase ("John Smith") retourne "John Smith"

Trim (x, y): supprime le (s) caractère (s) dans la chaîne y des extrémités de la chaîne x. Par défaut, il précise que les espaces vides doivent être supprimés. Notez, dans les exemples de la fonction TRIM, que les caractères spécifiés sont supprimés. L’ordre des caractères n’a pas d’importance.

Exemple

Trim ("! voir instructions!!!", "!") retourne "voir instructions"

Trim ("Test123") retourne "Test123"

TrimLeft (x, y): supprime le caractère dans la chaîne y du début de la chaîne x. Par défaut, il précise que les espaces vides doivent être supprimés.

Exemple

TrimLeft ("* * invitation spéciale", "*") renvoie "invitation spéciale"

TrimRight (x, y): supprime le caractère de la chaîne y à partir de la fin de la chaîne x. Par défaut, il précise que les espaces vides doivent être supprimés.

Exemple

TrimRight ("John Smith") retourne "John Smith"

TrimRight ("John Smith * *", "*") retourne "John Smith"

Bien que vous puissiez passer une chaîne de caractères à trimer, les fonctions Trim ne respectent pas l'ordre des caractères; Il traite la chaîne comme une «liste». Par conséquent, il va couper tous les caractères de la liste. Si vous cherchez à remplacer une chaîne, utilisez une fonction REPLACE ou REGEX dans votre expression.

Uppercase(x)

Convertit une chaîne en majuscules

A propos de la longueur et des chaînes: lorsque vous référencez la longueur d'une chaîne, le premier caractère est compté comme 1 (la longueur de la chaîne suivante "record" est 6).

TOUTEFOIS, lorsque vous faites référence à la position d’un caractère dans une CHAÎNE, les positions sont comptées ENTRE les caractères. La position du premier caractère est alors considérée comme le point 0.  Par conséquent, la lettre « r » dans la chaîne enregistrement est à la position 2.

Exemple

Majuscules ("John Smith") retourne "John Smith"

UuidCreate (): crée un identificateur unique.

Exemple

UuidCreate () retourne une valeur unique telle que ba131836-1ba3-4d42-8f7e-b81a99c2e838

Une fonction test soumet les données à des tests de validation. Utilisez une fonction test pour identifier le type de données d’une valeur ou déterminer si une valeur existe. Une fonction test peut être utilisée avec tous les types de données.

CompareDictionary (a, b): compare deux chaînes dans l'ordre du dictionnaire. Renvoie -1 si a<b, 0 si a=b, 1 si a>b.

Exemple

CompareDictionary (pommes, bananes) retourne-1

CompareDictionary (cerises, bananes) retourne 1

CompareDictionary (bananes, bananes) retourne 0

CompareDigits (a, b, nNumDigits): compare deux nombres et détermine s'ils sont identiques au nombre donné de chiffres. La comparaison trouve la différence entre les nombres et rapporte A et B comme identiques lorsque le premier chiffre de la différence se trouve au moins à NumDigits emplacements à droite des chiffres de la plus grande valeur entre A et B.

L’argument NumDigits ne doit pas être nul et il doit figurer entre 1 et 19, sinon une erreur est générée. Si un nombre décimal est fourni, il est arrondi à l’entier le plus proche (NumDigits peut être compris entre 0,5 et 19,499).

Exemple

CompareDigits (12345, 12444, 3) retourne "true" (parce que la différence est 99, et son chiffre principal est de 3 places à droite du chiffre principal de A)

CompareDigits (12345, 123445, 3) retourne "false" (parce que la différence est 100, et son chiffre principal n'est que de 2 places à droite du chiffre de premier plan de A)

CompareDigits (12.345, 12,347, 3) retourne "true" (parce que la différence est 0,002, et son chiffre principal est de 4 places à droite du chiffre principal de A)

CompareDigits (12.345, 12,435, 3) retourne "true" (parce que la différence est 0,09, et son chiffre principal est de 3 places à droite du chiffre principal de A)

CompareDigits (. 91234,. 91334, 3) retourne "false" (parce que la différence est .001, et son chiffre principal n'est que de 2 places à droite du chiffre principal de A)

CompareEpsilon (a, b, Epsilon): compare deux nombres à virgule flottante et retourne true s'ils se trouvent dans Epsilon.

Exemple

CompareEpsilon ([123.456789101112], [123.456789101114], 0,0001) retourne "true"

CompareEpsilon ([123.456], [123.456789101112], 0,0001) retourne "false"

IsEmpty (v): teste si v est null ou égal à "" ou non

Exemple

Nom	IsEmpty
John	Faux
	Vrai
Mary	Faux
[NULL]	Vrai

IsInteger (v) : teste si v contient une valeur qui peut être convertie en un entier. Si c’est le cas, TRUE est renvoyé.

Exemple

Valeur	IsInteger
1	Vrai
1,23	Faux
B	Faux

IsNull (v) : teste si v est null ou pas

Pour renseigner un enregistrement avec une valeur NULL, utilisez la fonction NULL()

Exemple

Nom	IsNull
John	Faux
[NULL]	Vrai
Mary	Faux

IsNumber (v) : teste si le type de champ pour v est un nombre ou non.

IsSpatialObj (v): teste si le type de champ pour v est un objet spatial ou non.

IsString, (v): teste si le type de champ pour v est une chaîne ou non.