Présentation de l’éditeur d’expression expression
La modification d’une expression consiste à saisir manuellement des conditions pour former une règle. Ce mode permet d’utiliser des fonctions avancées, vous permettant ainsi de manipuler les valeurs utilisées afin de réaliser des requêtes spécifiques : manipulation de dates, de chaînes, de champs numériques, tris, etc.
Utiliser l’éditeur d’expression edit
L’éditeur d’expression est disponible à partir du bouton Modifier une expression du concepteur de requête, disponible pour les champs Attribut et Valeur lors de la configuration d’une condition personnalisée.
L’éditeur d’expression fournit :
- un champ de saisie (1), dans lequel l’expression est définie ;
- la liste des champs (2) disponibles, utilisables dans l’expression et correspondant au schéma, ou dimension de ciblage, de la requête ;
- des fonctions d’assistance (3), triées par catégorie.
Modifiez l’expression en saisissant une expression directement dans le champ de saisie. Pour ajouter un champ ou une fonction d'assistance, placez le curseur dans l'expression à l'endroit où vous souhaitez l'ajouter et sélectionnez le bouton + .
Lorsque votre expression est prête, sélectionnez Confirmer. L’expression s’affiche dans le champ sélectionné. Pour la modifier, ouvrez l’éditeur d’expression et apportez les modifications souhaitées.
L’exemple ci-dessous présente une expression configurée pour le champ Valeur. Pour la modifier, vous devez ouvrir l’éditeur d’expression à l’aide du bouton Modifier une expression.
Fonctions d’assistance
L’outil d’édition de requêtes permet d’utiliser des fonctions avancées pour réaliser un filtrage complexe en fonction des résultats souhaités et des types de données manipulées. Les fonctions suivantes sont disponibles :
Date
Les fonctions de date sont utilisées pour manipuler des valeurs de date ou d’heure.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| AddYears | Ajoute le nombre d’années spécifié à la date et à l’heure indiquées. | AddYears(<DATEHEURE>, <NOMBRE>) | AddYears("2019-12-25 15:30:00", 3) |
| AddMonths | Ajoute le nombre de mois spécifié à la date et à l’heure indiquées. | AddMonths(<DATEHEURE>, <NOMBRE>) | AddMonths("2019-12-25 15:30:00", 6) |
| AddDays | Ajoute le nombre de jours spécifié à la date et à l’heure indiquées. | AddDays(<DATEHEURE>, <NOMBRE>) | AddDays("2019-12-25 15:30:00", 10) |
| AddHours | Ajoute le nombre d’heures spécifié à la date et à l’heure indiquées. | AddHours(<DATEHEURE>, <NOMBRE>) | AddHours("2019-12-25 15:30:00", 3) |
| AddMinutes | Ajoute le nombre de minutes spécifié à la date et à l’heure indiquées. | AddMinutes(<DATEHEURE>, <NOMBRE>) | AddMinutes("2019-12-25 15:30:00", 32) |
| AddSeconds | Ajoute le nombre de secondes spécifié à la date et à l’heure indiquées. | AddSeconds(<DATEHEURE>, <NOMBRE>) | AddSeconds("2019-12-25 15:30:00", 37) |
| SubYears | Soustrait le nombre d’années spécifié à la date et à l’heure indiquées. | SubYears(<DATEHEURE>, <NOMBRE>) | SubYears("2019-12-25 15:30:00", 3) |
| SubMonths | Soustrait le nombre de mois spécifié à la date et à l’heure indiquées. | SubMonths(<DATEHEURE>, <NOMBRE>) | SubMonths("2019-12-25 15:30:00", 6) |
| SubDays | Soustrait le nombre de jours spécifié à la date et à l’heure indiquées. | SubDays(<DATEHEURE>, <NOMBRE>) | SubDays("2019-12-25 15:30:00", 10) |
| SubHours | Soustrait le nombre d’heures spécifié à la date et à l’heure indiquées. | SubHours(<DATEHEURE>, <NOMBRE>) | SubHours("2019-12-25 15:30:00", 3) |
| SubMinutes | Soustrait le nombre de minutes spécifié à la date et à l’heure indiquées. | SubMinutes(<DATEHEURE>, <NOMBRE>) | SubMinutes("2019-12-25 15:30:00", 32) |
| SubSeconds | Soustrait le nombre de secondes spécifié à la date et à l’heure indiquées. | SubSeconds(<DATEHEURE>, <NOMBRE>) | SubSeconds("2019-12-25 15:30:00", 37) |
| Year | Extrait l’année de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Month | Extrait le mois de l’objet date/heure donné. | Month(<DATEHEURE>) | Month("2019-12-15 15:30:00") |
| Jour | Extrait le jour de l’objet date/heure donné. | Day(<DATEHEURE>) | Day("2019-12-15 15:30:00") |
| DayOfYear | Extrait le jour de l’année de l’objet date/heure donné. Par exemple, si la date et l’heure indiquées sont le 2 février, la valeur 33 est renvoyée. | DayOfYear(<DATEHEURE>) | DayOfYear("2019-12-15 15:30:00") |
| WeekDay | Extrait le jour de la semaine de l’objet date/heure donné, sous la forme d’un nombre compris entre 0 et 6, avec 0 représentant le dimanche. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Hour | Extrait la valeur de l’heure de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Minute | Extrait la valeur de minute de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Second | Extrait la valeur de seconde de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| YearsDiff | Trouve la différence entre les dates et heures données, avec une granularité en années. | YearsDiff(<DATEHEURE>, <DATEHEURE>) | YearsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MonthsDiff | Trouve la différence entre les dates et heures données, avec une granularité en mois. | MonthsDiff(<DATEHEURE>, <DATEHEURE>) | MonthsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| DaysDiff | Trouve la différence entre les dates et heures données, avec une granularité en jours. | DaysDiff(<DATEHEURE>, <DATEHEURE>) | DaysDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| HoursDiff | Trouve la différence entre les dates et heures données, avec une granularité en heures. | HoursDiff(<DATEHEURE>, <DATEHEURE>) | HoursDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MinutesDiff | Trouve la différence entre les dates et heures données, avec une granularité en minutes. | MinutesDiff(<DATEHEURE>, <DATEHEURE>) | MinutesDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| SecondsDiff | Trouve la différence entre les dates et heures données, avec une granularité en secondes. | SecondsDiff(<DATEHEURE>, <DATEHEURE>) | SecondsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| YearsOld | Trouve la différence entre la date et l’heure données et le moment présent, avec une granularité en années. | YearsOld(<DATEHEURE>) | YearsOld("2019-12-25 15:30:00") |
| MonthsOld | Trouve la différence entre la date et l’heure données et le moment présent, avec une granularité en mois. | MonthsOld(<DATEHEURE>) | MonthsOld("2019-12-25 15:30:00") |
| DaysOld | Trouve la différence entre la date et l’heure données et le moment présent, avec une granularité en jours. | DaysOld(<DATEHEURE>) | DaysOld("2019-12-25 15:30:00") |
| GetDate | Obtient la date actuelle du serveur. | GetDate() | GetDate() |
| DateOnly | Tronque la date et l’heure pour ne conserver que l’année, le mois et le jour. | DateOnly(<DATEHEURE>) | DateOnly("2019-12-25 15:30:00") |
| ToDate | Convertit le champ en champ de date. | ToDate(<DATEHEURE>) | ToDate("2019-12-25 15:30:00") |
| ToDateTime | Convertit le champ en champ de date/heure. | ToDateTime(<DATE>) | ToDateTime("2019-12-25 15:30:00") |
| ToTimestamp | Convertit le champ en champ d’horodatage. | ToTimestamp(<DATEHEURE>) | ToTimestamp("2019-12-25 15:30:00") |
| Oldest | Renvoie la date la plus ancienne parmi les deux indiquées. | Oldest(<DATEHEURE>, <DATEHEURE>) | Oldest("2015-02-13 11:59:59", "2016-04-13 19:28:14") |
| TruncDate | Tronque la date et l’heure à l’unité la plus proche, en fonction de la valeur numérique donnée. Si la valeur numérique est égale à 60, elle est tronquée à la minute la plus proche. Si la valeur numérique est égale à 3 600, elle est tronquée à l’heure la plus proche. Si la valeur numérique est égale à 86 400, elle est tronquée au jour le plus proche. Sinon, elle est tronquée à la seconde la plus proche. | TruncDate(<DATEHEURE>, <NOMBRE>) | TruncDate("2016-04-13 19:28:14", 3600) |
| TruncDateTZ | Tronque la date et l’heure à l’unité la plus proche, en fonction de la valeur numérique donnée, et définit la date et l’heure sur le fuseau horaire spécifié. Si la valeur numérique est égale à 60, elle est tronquée à la minute la plus proche. Si la valeur numérique est égale à 3 600, elle est tronquée à l’heure la plus proche. Si la valeur numérique est égale à 86 400, elle est tronquée au jour le plus proche. | TruncDateTZ(<DATEHEURE>, <NOMBRE>, <FUSEAUHORAIRE>) | TruncDateTZ("2016-04-13 19:28:14", 3600, "America/Los_Angeles") |
| TruncTime | Définit la date et l’heure sur le 1er janvier 2000 et arrondit le reste de la date et de l’heure à l’unité la plus proche, en fonction de la valeur numérique donnée. Si la valeur numérique est égale à 60, elle est tronquée à la minute la plus proche. Si la valeur numérique est égale à 3 600, elle est tronquée à l’heure la plus proche. | TruncTime(<DATEHEURE>, <NOMBRE>) | TruncTime("2016-04-13 19:28:14", 3600) |
| TruncQuarter | Tronque la date et l’heure à la première date du trimestre le plus proche. | TruncQuarter(<DATEHEURE>) | TruncQuarter("2016-04-13 19:28:14") |
| TruncYear | Tronque la date et l’heure à la première date de l’année la plus proche. | TruncYear(<DATEHEURE>) | TruncYear("2016-04-13 19:28:14") |
| TruncWeek | Tronque la date et l’heure au dimanche de la semaine la plus proche. | TruncWeek(<DATEHEURE>) | TruncWeek("2016-04-13 19:28:14") |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| AddYears | Ajoute le nombre d’années spécifié à la date et à l’heure indiquées. | AddYears(<DATEHEURE>, <NOMBRE>) | AddYears("2019-12-25 15:30:00", 3) |
| AddMonths | Ajoute le nombre de mois spécifié à la date et à l’heure indiquées. | AddMonths(<DATEHEURE>, <NOMBRE>) | AddMonths("2019-12-25 15:30:00", 6) |
| AddDays | Ajoute le nombre de jours spécifié à la date et à l’heure indiquées. | AddDays(<DATEHEURE>, <NOMBRE>) | AddDays("2019-12-25 15:30:00", 10) |
| AddHours | Ajoute le nombre d’heures spécifié à la date et à l’heure indiquées. | AddHours(<DATEHEURE>, <NOMBRE>) | AddHours("2019-12-25 15:30:00", 3) |
| AddMinutes | Ajoute le nombre de minutes spécifié à la date et à l’heure indiquées. | AddMinutes(<DATEHEURE>, <NOMBRE>) | AddMinutes("2019-12-25 15:30:00", 32) |
| AddSeconds | Ajoute le nombre de secondes spécifié à la date et à l’heure indiquées. | AddSeconds(<DATEHEURE>, <NOMBRE>) | AddSeconds("2019-12-25 15:30:00", 37) |
| SubYears | Soustrait le nombre d’années spécifié à la date et à l’heure indiquées. | SubYears(<DATEHEURE>, <NOMBRE>) | SubYears("2019-12-25 15:30:00", 3) |
| SubMonths | Soustrait le nombre de mois spécifié à la date et à l’heure indiquées. | SubMonths(<DATEHEURE>, <NOMBRE>) | SubMonths("2019-12-25 15:30:00", 6) |
| SubDays | Soustrait le nombre de jours spécifié à la date et à l’heure indiquées. | SubDays(<DATEHEURE>, <NOMBRE>) | SubDays("2019-12-25 15:30:00", 10) |
| SubHours | Soustrait le nombre d’heures spécifié à la date et à l’heure indiquées. | SubHours(<DATEHEURE>, <NOMBRE>) | SubHours("2019-12-25 15:30:00", 3) |
| SubMinutes | Soustrait le nombre de minutes spécifié à la date et à l’heure indiquées. | SubMinutes(<DATEHEURE>, <NOMBRE>) | SubMinutes("2019-12-25 15:30:00", 32) |
| SubSeconds | AdSubstractsds le nombre de secondes spécifié à la date et et à l’heure indiquées. | SubSeconds(<DATEHEURE>, <NOMBRE>) | SubSeconds("2019-12-25 15:30:00", 37) |
| Year | Extrait l’année de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Month | Extrait le mois de l’objet date/heure donné. | Month(<DATEHEURE>) | Month("2019-12-15 15:30:00") |
| Jour | Extrait le jour de l’objet date/heure donné. | Day(<DATEHEURE>) | Day("2019-12-15 15:30:00") |
| DayOfYear | Extrait le jour de l’année de l’objet date/heure donné. Par exemple, si la date et l’heure indiquées sont le 2 février, la valeur 33 est renvoyée. | DayOfYear(<DATEHEURE>) | DayOfYear("2019-12-15 15:30:00") |
| WeekDay | Extrait le jour de la semaine de l’objet date/heure donné, sous la forme d’un nombre compris entre 1 et 7, 1 représentant le dimanche. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Hour | Extrait la valeur de l’heure de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Minute | Extrait la valeur de minute de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| Second | Extrait la valeur de seconde de l’objet date/heure donné. | Year(<DATEHEURE>) | Year("2019-12-15 15:30:00") |
| YearsDiff | Trouve la différence entre les dates et heures données, avec une granularité en années. | YearsDiff(<DATEHEURE>, <DATEHEURE>) | YearsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MonthsDiff | Trouve la différence entre les dates et heures données, avec une granularité en mois. | MonthsDiff(<DATEHEURE>, <DATEHEURE>) | MonthsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| DaysDiff | Trouve la différence entre les dates et heures données, avec une granularité en jours. | DaysDiff(<DATEHEURE>, <DATEHEURE>) | DaysDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| HoursDiff | Trouve la différence entre les dates et heures données, avec une granularité en heures. | HoursDiff(<DATEHEURE>, <DATEHEURE>) | HoursDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MinutesDiff | Trouve la différence entre les dates et heures données, avec une granularité en minutes. | MinutesDiff(<DATEHEURE>, <DATEHEURE>) | MinutesDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| SecondsDiff | Trouve la différence entre les dates et heures données, avec une granularité en secondes. | SecondsDiff(<DATEHEURE>, <DATEHEURE>) | SecondsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MonthsOld | Trouve la différence entre la date et l’heure données et le moment présent, avec une granularité en mois. | MonthsOld(<DATEHEURE>) | MonthsOld("2019-12-25 15:30:00") |
| DaysOld | Trouve la différence entre la date et l’heure données et le moment présent, avec une granularité en jours. | DaysOld(<DATEHEURE>) | DaysOld("2019-12-25 15:30:00") |
| GetDate | Obtient la date actuelle du serveur. | GetDate() | GetDate() |
| DateOnly | Tronque la date et l’heure pour ne conserver que l’année, le mois et le jour. | DateOnly(<DATEHEURE>) | DateOnly("2019-12-25 15:30:00") |
| ToDate | Convertit le champ en champ de date. | ToDate(<DATEHEURE>) | ToDate("2019-12-25 15:30:00") |
| ToDateTime | Convertit le champ en champ de date/heure. | ToDateTime(<DATE>) | ToDateTime("2019-12-25 15:30:00") |
| ToTimestamp | Convertit le champ en champ d’horodatage. | ToTimestamp(<DATEHEURE>) | ToTimestamp("2019-12-25 15:30:00") |
| Oldest | Renvoie la date la plus ancienne parmi les deux indiquées. | Oldest(<DATEHEURE>, <DATEHEURE>) | Oldest("2015-02-13 11:59:59", "2016-04-13 19:28:14") |
| TruncDate | Tronque la date et l’heure à l’unité la plus proche, en fonction de la valeur numérique donnée. Si la valeur numérique est égale à 60, elle est tronquée à la minute la plus proche. Si la valeur numérique est égale à 3 600, elle est tronquée à l’heure la plus proche. Si la valeur numérique est égale à 86 400, elle est tronquée au jour le plus proche. Sinon, elle est tronquée à la seconde la plus proche. | TruncDate(<DATEHEURE>, <NOMBRE>) | TruncDate("2016-04-13 19:28:14", 3600) |
| TruncDateTZ | Tronque la date et l’heure à l’unité la plus proche, en fonction de la valeur numérique donnée, et définit la date et l’heure sur le fuseau horaire spécifié. Si la valeur numérique est égale à 60, elle est tronquée à la minute la plus proche. Si la valeur numérique est égale à 3 600, elle est tronquée à l’heure la plus proche. Si la valeur numérique est égale à 86 400, elle est tronquée au jour le plus proche. | TruncDateTZ(<DATEHEURE>, <NOMBRE>, <FUSEAUHORAIRE>) | TruncDateTZ("2016-04-13 19:28:14", 3600, "America/Los_Angeles") |
| TruncTime | Définit la date et l’heure sur le 1er janvier 2000 et arrondit le reste de la date et de l’heure à l’unité la plus proche, en fonction de la valeur numérique donnée. Si la valeur numérique est égale à 60, elle est tronquée à la minute la plus proche. Si la valeur numérique est égale à 3 600, elle est tronquée à l’heure la plus proche. | TruncTime(<DATEHEURE>, <NOMBRE>) | TruncTime("2016-04-13 19:28:14", 3600) |
| TruncQuarter | Tronque la date et l’heure à la première date du trimestre le plus proche. | TruncQuarter(<DATEHEURE>) | TruncQuarter("2016-04-13 19:28:14") |
| TruncYear | Tronque la date et l’heure à la première date de l’année la plus proche. | TruncYear(<DATEHEURE>) | TruncYear("2016-04-13 19:28:14") |
| TruncWeek | Tronque la date et l’heure au dimanche de la semaine la plus proche. | TruncWeek(<DATEHEURE>) | TruncWeek("2016-04-13 19:28:14") |
| ConvertNTZ | Convertit un horodatage sans fuseau horaire à un horodatage avec fuseau horaire. Le fuseau horaire associé sera celui du compte externe. | ConvertNTZ(<DATEHEURE>) | ConvertNTZ("2024-06-24 14:43:49") |
Géomarketing
Les fonctions de géomarketing sont utilisées pour manipuler des valeurs géographiques.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| Distance | Renvoie la distance entre deux points donnés par leur longitude et leur latitude, exprimées en degrés, sous forme de nombre double. | Distance(<NOMBRE>, <NOMBRE>, <NOMBRE>, <NOMBRE>) | Distance(40.345, 39.2345, -35.5834, 34.599) |
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| Distance | Renvoie la distance entre deux points donnés par leur longitude et leur latitude, exprimées en degrés, sous forme de nombre double. | Distance(<NOMBRE>, <NOMBRE>, <NOMBRE>, <NOMBRE>) | Distance(40.345, 39.2345, -35.5834, 34.599) |
Numérique
Les fonctions numériques sont utilisées pour convertir du texte en nombres.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| Mod | Renvoie le reste du premier nombre divisé par le second. | Mod(<NOMBRE>, <NOMBRE>) | Mod (3, 2) |
| Percent | Calcule le pourcentage du premier nombre par rapport au second. | Percent(<NOMBRE>, <NOMBRE>) | Percent(1, 2) |
| Random | Renvoie un nombre aléatoire compris entre 0 (inclusif) et 1 (exclusif). | Random() | Random () |
| Round | Renvoie le nombre indiqué à la décimale demandée la plus proche. | Round(<NOMBRE>, <NOMBRE>) | Round(4.5394, 2) |
| ToDouble | Convertit le nombre indiqué en nombre double. | ToDouble(<NOMBRE>) | ToDouble(5) |
| ToInteger | Convertit le nombre indiqué en entier. | ToInteger(<NOMBRE>) | ToInteger(45) |
| ToInt64 | Convertit le nombre indiqué en un entier 64 bits. | ToInt64(<NOMBRE>) | ToInt64(493) |
| Trunc | Tronque le nombre indiqué au nombre de décimales demandé. | Trunc(<NOMBRE>, <NOMBRE>) | Trunc(36.9348934, 3) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| Mod | Renvoie le reste du premier nombre divisé par le second. | Mod(<NOMBRE>, <NOMBRE>) | Mod (3, 2) |
| Percent | Calcule le pourcentage du premier nombre par rapport au second. | Percent(<NOMBRE>, <NOMBRE>) | Percent(1, 2) |
| Random | Renvoie un nombre aléatoire compris entre 0 (inclusif) et 1 (exclusif). | Random() | Random () |
| ToDouble | Convertit le nombre indiqué en nombre double. | ToDouble(<NOMBRE>) | ToDouble(5) |
| ToInteger | Convertit le nombre indiqué en entier. | ToInteger(<NOMBRE>) | ToInteger(45) |
| ToInt64 | Convertit le nombre indiqué en un entier 64 bits. | ToInt64(<NOMBRE>) | ToInt64(493) |
| Trunc | Tronque le nombre indiqué au nombre de décimales demandé. | Trunc(<NOMBRE>, <NOMBRE>) | Trunc(36.9348934, 3) |
Autres
Ce tableau contient les autres fonctions disponibles.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| Case | Renvoie la première valeur si l’expression est vraie. Dans le cas contraire, renvoie la deuxième valeur. | Case(When(<EXPRESSION> <VALEUR>), Else(<VALEUR>)) | Case(When(a > b, "yes"), Else("no")) |
| When | Utilisé dans le cadre de la fonction Case. Utilisé pour vérifier l’expression dans Case. | When(<EXPRESSION> <VALEUR>) | When(a > b, "yes") |
| Else | Utilisé dans le cadre de la fonction Case. Utilisé pour choisir l’autre option, si l’expression When est fausse. | Else(<VALEUR>) | Else ("no") |
| Coalesce | Renvoie la première valeur non nulle. | Coalesce(<VALEUR>, <VALEUR>) | Coalesce ("", "string") |
| Decode | Renvoie la première option si les valeurs sont égales. Renvoie la seconde option si les valeurs ne sont pas égales. | Decode(<VALEUR>, <VALEUR>, <VALEUR>, <VALEUR>) | Decode(1, 2, "true", "false") |
| GetEmailDomain | Extrait le domaine d’une adresse e-mail indiquée. | GetEmailDomain(<CHAÎNE>) | GetEmailDomain("sample@example.com") |
| Iif | Renvoie la première option si la condition est vraie et renvoie la seconde option si la condition est fausse. | Iif(<CONDITION>, <VALEUR>, <VALEUR>) | Iif(10 < 20, "true", "false") |
| IsEmptyString | Renvoie la première option si la chaîne est vide. Dans le cas contraire, renvoie la seconde option. | IsEmptyString( <CHAÎNE> ,<VALEUR>, <VALEUR>) | IsEmptyString("string", "yes", "no") |
| NewUUID | Génère un nouvel UUID unique. | NewUUID() | NewUUID() |
| NoNull | Renvoie la chaîne indiquée si elle n’est pas vide et renvoie une chaîne vide si la chaîne fournie est vide. | NoNull(<CHAÎNE>) | NoNull("test") |
| IsBitSet | Effectue une opération bit à bit ET (&) sur les nombres indiqués. Vous pouvez ainsi vérifier si le bit du premier paramètre est défini à la position indiquée dans le second paramètre. | IsBitSet(<NOMBRE>, <NOMBRE>) | IsBitSet(5, 3) |
| ClearBit | Vous pouvez ainsi effacer le bit du premier paramètre à la position indiquée dans le second paramètre. | ClearBit(<NOMBRE>, <NOMBRE>) | |
| SetBit | Effectue une opération bit à bit OU (|) sur les nombres indiqués. Vous pouvez ainsi définir le bit dans le premier paramètre à la position indiquée dans le second paramètre. | SetBit(<NOMBRE>, <NOMBRE>) | SetBit(5, 3) |
| RowId | Renvoie le numéro de la ligne. | RowId() | RowId() |
| ToBoolean | Convertit la valeur en booléen. | ToBoolean(<VALEUR>) | ToBoolean(a=b) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| Case | Renvoie la première valeur si l’expression est vraie. Dans le cas contraire, renvoie la deuxième valeur. | Case(When(<EXPRESSION> <VALEUR>), Else(<VALEUR>)) | Case(When(a > b, "yes"), Else("no")) |
| When | Utilisé dans le cadre de la fonction Case. Utilisé pour vérifier l’expression dans Case. | When(<EXPRESSION> <VALEUR>) | When(a > b, "yes") |
| Else | Utilisé dans le cadre de la fonction Case. Utilisé pour choisir l’autre option, si l’expression When est fausse. | Else(<VALEUR>) | Else ("no") |
| GetEmailDomain | Extrait le domaine d’une adresse e-mail indiquée. | GetEmailDomain(<CHAÎNE>) | GetEmailDomain("sample@example.com") |
| Iif | Renvoie la première option si la condition est vraie et renvoie la seconde option si la condition est fausse. | Iif(<CONDITION>, <VALEUR>, <VALEUR>) | Iif(10 < 20, "true", "false") |
| IsEmptyString | Renvoie la première option si la chaîne est vide. Dans le cas contraire, renvoie la seconde option. | IsEmptyString( <CHAÎNE> ,<VALEUR>, <VALEUR>) | IsEmptyString("string", "yes", "no") |
| ToBoolean | Renvoie 1 si la valeur est vraie. Renvoie 0 si la valeur est fausse. | ToBoolean(<VALEUR>) | ToBoolean(a=b) |
| ToBooleanType | Convertit la valeur en booléen. | ToBooleanType(<VALEUR>) | ToBooleanType(a=b) |
| IsBitSet | Effectue une opération bit à bit ET (&) sur les nombres indiqués. Vous pouvez ainsi vérifier si le bit du premier paramètre est défini à la position indiquée dans le second paramètre. | IsBitSet(<NOMBRE>, <NOMBRE>) | IsBitSet(5, 3) |
| ClearBit | Vous pouvez ainsi effacer le bit du premier paramètre à la position indiquée dans le second paramètre. | ClearBit(<NOMBRE>, <NOMBRE>) | |
| SetBit | Effectue une opération bit à bit OU (|) sur les nombres indiqués. Vous pouvez ainsi définir le bit dans le premier paramètre à la position indiquée dans le second paramètre. | SetBit(<NOMBRE>, <NOMBRE>) | SetBit(5, 3) |
| RowId | Renvoie le numéro de la ligne. | RowId() | RowId() |
| NewUUID | Génère un nouvel UUID unique. | NewUUID() | NewUUID() |
| NoNull | Renvoie la chaîne indiquée si elle n’est pas vide et renvoie une chaîne vide si la chaîne fournie est vide. | NoNull(<CHAÎNE>) | NoNull("test") |
| AESEncrypt | Chiffre la chaîne fournie avec le type de chiffrement AES. | AESEncrypt() | AESEncrypt("hello") |
| ObjectConstruct | Crée un objet basé sur les paires clé/valeur indiquées. | ObjectConstruct(<CHAÎNE>, <CHAÎNE>) | ObjectConstruct("key", "value") |
Chaîne
Les fonctions de chaîne sont utilisées pour manipuler un ensemble de chaînes.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| AllNonNull2 | Prend deux chaînes et vérifie si elles ne sont ni nulles ni vides. | AllNonNull2(<CHAÎNE>, <CHAÎNE>) | AllNonNull2("", "string2") |
| AllNonNull3 | Prend trois chaînes et vérifie si elles ne sont ni nulles ni vides. | AllNonNull3(<CHAÎNE>, <CHAÎNE>, <CHAÎNE>) | AllNonNull3("", "one", "three") |
| Ascii | Prend une chaîne et renvoie le résultat. | Ascii(<CHAÎNE>) | Ascii ("foo") |
| Char | Prend un tableau de points de code Unicode et renvoie la chaîne résultante. | Char(<ARRAY>) | Char([65, 68, 79, 66, 69]) |
| Charindex | Trouve la première occurrence de la sous-chaîne spécifiée dans la chaîne principale. | Charindex(<CHAÎNE>, <SOUSCHAÎNE>) | Charindex ("bar@example.com", "@") |
| dataLength | Renvoie le nombre d’octets dans la chaîne. | dataLength(<CHAÎNE>) | dataLength("My string") |
| GetLine | Renvoie la ligne demandée de la chaîne indiquée. | GetLine(<CHAÎNE>, <NOMBRE>) | GetLine(multilinestring, 5) |
| IfEquals | Prend quatre chaînes et renvoie la troisième chaîne si les deux premières chaînes sont égales et renvoie la quatrième chaîne si les deux premières chaînes ne sont pas égales. | IfEquals(<CHAÎNE>, <CHAÎNE>, <CHAÎNE>, <CHAÎNE>) | IfEquals("a", "a", "yes", "no") |
| IsMemoNull | Renvoie 1 si la chaîne est nulle, sinon 0. | IsMemoNull(<CHAÎNE>) | IsMemoNull("hello") |
| JuxtWords | Prend deux chaînes et les combine en une seule chaîne. Des espaces entre les chaînes sont ajoutés si nécessaire. | JuxtWords(<CHAÎNE>, <CHAÎNE>) | JuxtWords("Hello", "World") |
| JuxtWords3 | Prend trois chaînes et les combine en une seule chaîne. Des espaces entre les chaînes sont ajoutés si nécessaire. | JuxtWords3(<CHAÎNE>, <CHAÎNE>, <CHAÎNE>) | JuxtWords3("Hello", "New", "World") |
| Left | Prend une chaîne et renvoie les caractères les plus à gauche comme spécifié. | Left(<CHAÎNE>, <NOMBRE>) | Left("Substring", 3) |
| Length | Renvoie la longueur de la chaîne. | Length(<CHAÎNE>) | Length("MyString") |
| Md5Digest | Convertit la chaîne hachée MD5 en sa représentation hexadécimale. | Md5Digest(<CHAÎNE>) | Md5Digest("String") |
| MemoContains | Vérifie si la chaîne contient la sous-chaîne indiquée. | MemoContains(<CHAÎNE>, <CHAÎNE>) | MemoContains("string", "str") |
| Right | Prend une chaîne et renvoie les caractères les plus à droite comme spécifié. | Right(<CHAÎNE>, <NOMBRE>) | Right ("Substring", 3) |
| Smart | Renvoie la chaîne avec la première lettre de chaque mot en majuscule. | Smart(<CHAÎNE>) | Smart("hello world") |
| Substring | Prend une chaîne et renvoie une partie de la chaîne indiquée, en fonction des positions données. | Substring(<CHAÎNE>, <NOMBRE_GAUCHE>, NOMBRE_DROIT>) | Substring("Substring", 3, 5) |
| Sha256Digest | Convertit la chaîne hachée SHA256 en sa représentation hexadécimale. | Sha256Digest(<CHAÎNE>) | Sha256Digest("string") |
| Sha512Digest | Convertit la chaîne hachée SHA512 en sa représentation hexadécimale. | Sha512Digest(<CHAÎNE>) | Sha512Digest("string") |
| ToString | Renvoie la valeur sous forme de chaîne. | ToString(<VALEUR>) | ToString(123) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| AllNonNull2 | Prend deux chaînes et vérifie si elles ne sont ni nulles ni vides. | AllNonNull2(<CHAÎNE>, <CHAÎNE>) | AllNonNull2("", "string2") |
| AllNonNull3 | Prend trois chaînes et vérifie si elles ne sont ni nulles ni vides. | AllNonNull3(<CHAÎNE>, <CHAÎNE>, <CHAÎNE>) | AllNonNull3("", "one", "three") |
| Char | Prend un tableau de points de code Unicode et renvoie la chaîne résultante. | Char(<ARRAY>) | Char([65, 68, 79, 66, 69]) |
| Charindex | Trouve la première occurrence de la sous-chaîne spécifiée dans la chaîne principale. | Charindex(<CHAÎNE>, <SOUSCHAÎNE>) | Charindex ("bar@example.com", "@") |
| dataLength | Renvoie le nombre d’octets dans la chaîne. | dataLength(<CHAÎNE>) | dataLength("My string") |
| GetLine | Renvoie la ligne demandée de la chaîne indiquée. | GetLine(<CHAÎNE>, <NOMBRE>) | GetLine(multilinestring, 5) |
| IfEquals | Prend quatre chaînes et renvoie la troisième chaîne si les deux premières chaînes sont égales et renvoie la quatrième chaîne si les deux premières chaînes ne sont pas égales. | IfEquals(<CHAÎNE>, <CHAÎNE>, <CHAÎNE>, <CHAÎNE>) | IfEquals("a", "a", "yes", "no") |
| IsMemoNull | Renvoie 1 si la chaîne est nulle, sinon 0. | IsMemoNull(<CHAÎNE>) | IsMemoNull("hello") |
| JuxtWords | Prend deux chaînes et les combine en une seule chaîne. Des espaces entre les chaînes sont ajoutés si nécessaire. | JuxtWords(<CHAÎNE>, <CHAÎNE>) | JuxtWords("Hello", "World") |
| JuxtWords3 | Prend trois chaînes et les combine en une seule chaîne. Des espaces entre les chaînes sont ajoutés si nécessaire. | JuxtWords3(<CHAÎNE>, <CHAÎNE>, <CHAÎNE>) | JuxtWords3("Hello", "New", "World") |
| Left | Prend une chaîne et renvoie les caractères les plus à gauche comme spécifié. | Left(<CHAÎNE>, <NOMBRE>) | Left("Substring", 3) |
| Length | Renvoie la longueur de la chaîne. | Length(<CHAÎNE>) | Length("MyString") |
| Line | Renvoie la ligne numérotée spécifiée à partir de la chaîne. | Line(<CHAÎNE>, <NOMBRE>) | Line(multilinestring, 5) |
| Md5Digest | Convertit la chaîne hachée MD5 en sa représentation hexadécimale. | Md5Digest(<CHAÎNE>) | Md5Digest("String") |
| Replace | Prend une chaîne et remplace toutes les instances de la sous-chaîne par une sous-chaîne de remplacement. | Replace(<CHAÎNE>, <STRING>, <STRING>) | Replace("Captain Steve", "Captain", "Engineer") |
| Right | Prend une chaîne et renvoie les caractères les plus à droite comme spécifié. | Right(<CHAÎNE>, <NOMBRE>) | Right ("Substring", 3) |
| Sha256Digest | Convertit la chaîne hachée SHA256 en sa représentation hexadécimale. | Sha256Digest(<CHAÎNE>) | Sha256Digest("string") |
| Sha512Digest | Convertit la chaîne hachée SHA512 en sa représentation hexadécimale. | Sha512Digest(<CHAÎNE>) | Sha512Digest("string") |
| Smart | Renvoie la chaîne avec la première lettre de chaque mot en majuscule. | Smart(<CHAÎNE>) | Smart("hello world") |
| ToString | Renvoie la valeur sous forme de chaîne. | ToString(<VALEUR>) | ToString(123) |
Période
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| RowNum | Renvoie une séquence de lignes en fonction de la partition du tableau et de la séquence de tri. | RowNum(PartitionBy(<EXPRESSION>), OrderBy(<EXPRESSION>)) | RowNum(PartitionBy(division), OrderBy(time)) |
| PartitionBy | Sépare les lignes d’entrée en différentes partitions, selon l’expression donnée. | PartitionBy(<EXPRESSION>) | PartitionBy(division) |
| OrderBy | Trie le résultat au sein de la partition. | OrderBy(<EXPRESSION>) | OrderBy(age) |
| Desc | Permet à votre fonction OrderBy de trier par ordre décroissant, plutôt que par ordre croissant. | Desc(OrderBy(<EXPRESSION>)) | Desc(OrderBy(age)) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Nom | Description | Syntaxe | Exemple |
| RowNum | Renvoie une séquence de lignes en fonction de la partition du tableau et de la séquence de tri. | RowNum(PartitionBy(<EXPRESSION>), OrderBy(<EXPRESSION>)) | RowNum(PartitionBy(division), OrderBy(time)) |
| PartitionBy | Sépare les lignes d’entrée en différentes partitions, selon l’expression donnée. | PartitionBy(<EXPRESSION>) | PartitionBy(division) |
| OrderBy | Trie le résultat au sein de la partition. | OrderBy(<EXPRESSION>) | OrderBy(age) |
| Desc | Permet à votre fonction OrderBy de trier par ordre décroissant, plutôt que par ordre croissant. | Desc(OrderBy(<EXPRESSION>)) | Desc(OrderBy(age)) |