Expressions adaptatives et fonctions prédéfiniesAdaptive expressions prebuilt functions

s’applique à : SDK v4APPLIES TO: SDK v4

Cet article présente les fonctions prédéfinies disponibles classées selon leur usage général.This article lists the available prebuilt functions ordered by their general purpose. Pour plus d’informations sur les opérateurs utilisés dans les fonctions prédéfinies et la syntaxe des expressions, consultez opérateurs.For information about operators used in prebuilt functions and expression syntax, see Operators.

Les expressions prédéfinies se répartissent en plusieurs types de fonctions :Prebuilt expressions are divided into the following function types:

Vous pouvez également consulter la liste par ordre alphabétique.You can also view the list in alphabetical order.

Fonctions de chaînesString functions

FonctionFunction ExplicationExplanation
lengthlength Retourne la longueur d'une chaîne.Return the length of a string.
replacereplace Remplace une sous-chaîne par la chaîne spécifiée et retourne la chaîne mise à jour.Replace a substring with the specified string and return the updated string. Cette fonction respecte la casse.This function is case-sensitive.
replaceIgnoreCasereplaceIgnoreCase Remplacer une sous-chaîne par la chaîne spécifiée et renvoyer la chaîne mise à jour.Replace a substring with the specified string, and return the updated string. Cette fonction ne respecte pas la casse.This function is case-insensitive.
splitsplit Retourne un tableau contenant les sous-chaînes obtenues en fonction du délimiteur spécifié.Return an array that contains substrings based on the delimiter specified.
substringsubstring Retourne les caractères d’une chaîne.Return characters from a string.
toLowertoLower Retourne une chaîne en minuscules dans un format de paramètres régionaux facultatif.Return a string in lowercase in an optional locale format.
toUppertoUpper Retourne une chaîne en majuscules dans un format de paramètres régionaux facultatif.Return a string in uppercase in an optional locale format.
trimtrim Supprime les espaces blancs de début et de fin d’une chaîne.Remove leading and trailing white spaces from a string.
addOrdinaladdOrdinal Retourne le numéro ordinal du nombre d’entrée.Return the ordinal number of the input number.
endsWithendsWith Vérifie si une chaîne se termine par une sous-chaîne spécifique.Check whether a string ends with a specific substring. Retourne true si la sous-chaîne est trouvée, false sinon.Return true if the substring is found, or return false if not found. Cette fonction ne respecte pas la casse.This function is case-insensitive.
startsWithstartsWith Vérifie si une chaîne commence par une sous-chaîne spécifique.Check whether a string starts with a specific substring. Retourne true si la sous-chaîne est trouvée, false sinon.Return true if the substring is found, or return false if not found. Cette fonction ne respecte pas la casse.This function is case-insensitive.
countWordcountWord Retourne le nombre de mots de la chaîne donnée.Return the number of words in the given string.
concatconcat Combine au moins deux chaînes et retourne la chaîne obtenue.Combine two or more strings and return the resulting string.
newGuidnewGuid Retourne une nouvelle chaîne GUID.Return a new Guid string.
indexOfindexOf Retourne la position ou la valeur d’index de départ d’une sous-chaîne ou recherche l’objet spécifié et retourne l’index en base zéro de la première occurrence dans toute la liste.Return the starting position or index value of a substring or searches for the specified object and return the zero-based index of the first occurrence within the entire list. Cette fonction ne respecte pas la casse, et les index commencent par le chiffre 0.This function is case-insensitive, and indexes start with the number 0.
lastIndexOflastIndexOf Retourne la position ou la valeur d’index de départ de la dernière occurrence d’une sous-chaîne ou recherche l’objet spécifié et retourne l’index en base zéro de la dernière occurrence dans la plage d’éléments de la liste. Cette fonction ne respecte pas la casse, et les index commencent par le chiffre 0.Return the starting position or index value of the last occurrence of a substring or search for the specified object and return the zero-based index of the last occurrence within the range of elements in the list.This function is case-insensitive, and indexes start with the number 0.
sentenceCasesentenceCase Mettre en majuscule la première lettre du premier mot d’une chaîne dans un format local facultatif.Capitalize the first letter of the first word in a string in an optional local format.
Initiale majusculetitleCase Mettre en majuscule la première lettre de chaque mot dans une chaîne dans un format de paramètres régionaux facultatif.Capitalize the first letter of each word in a string in an optional locale format.

Fonctions de collectionCollection functions

FonctionFunction ExplicationExplanation
containscontains Permet de rechercher un élément dans une chaîne, un élément dans un tableau ou un paramètre dans un objet complexe.Works to find an item in a string, to find an item in an array, or to find a parameter in a complex object.
Exemples :Examples:
contains('hello world', 'hello')contains('hello world', 'hello')
contains(createArray('1','2'), '1')contains(createArray('1','2'), '1')
contains(json("{'foo':'bar'}"), 'foo')contains(json("{'foo':'bar'}"), 'foo')
firstfirst Retourne le premier élément de la collection.Return the first item from the collection.
joinjoin Retourne une chaîne contenant tous les éléments d’un tableau, dont les caractères sont séparés par un délimiteur.Return a string that has all the items from an array and has each character separated by a delimiter.
Exemple :Example:
join(createArray('a','b'), '.') = "a.b"join(createArray('a','b'), '.') = "a.b"
lastlast Retourne le dernier élément de la collection.Return the last item from the collection.
countcount Retourne le nombre d'éléments de la collection.Return the number of items in the collection.
foreachforeach S’applique à chaque élément et retourne la nouvelle collection.Operate on each element and return the new collection.
unionunion Retourne une collection contenant tous les éléments des collections spécifiées.Return a collection that has all the items from the specified collections.
skipskip Supprime des éléments du début d’une collection et retourne les autres éléments.Remove items from the front of a collection, and return the remaining items.
taketake Retourne des éléments du début d’une collection.Return items from the front of a collection.
intersectionintersection Retourne une collection contenant uniquement les éléments communs aux collections spécifiées.Return a collection that has only the common items across the specified collections.
subArraysubArray Retourne un sous-tableau à partir des positions de début et de fin spécifiées.Return a subarray from specified start and end position. Les valeurs d’index commencent par le chiffre 0.Index values start with the number 0.
selectselect S’applique à chaque élément et retourne la nouvelle collection d’éléments transformés.Operate on each element and return the new collection of transformed elements.
wherewhere Filtre sur chaque élément et retourne la nouvelle collection d’éléments filtrés qui respectent la condition spécifiée.Filter on each element and return the new collection of filtered elements which match the specific condition.
sortBysortBy Trie les éléments de la collection par ordre croissant et retourne la collection triée.Sort elements in the collection in ascending order and return the sorted collection.
sortByDescendingsortByDescending Trie les éléments de la collection par ordre décroissant et retourne la collection triée.Sort elements in the collection in descending order and return the sorted collection.
indicesAndValuesindicesAndValues Transforme un tableau ou un objet en tableau d’objets avec la propriété d’index et de valeur.Turn an array or object into an array of objects with index and value property.
flattenflatten Aplatit les tableaux dans un tableau dont les valeurs ne sont pas des tableaux.Flatten arrays into an array with non-array values.
uniqueunique Supprime tous les doublons d’un tableau.Remove all duplicates from an array.

Fonctions de comparaison logiquesLogical comparison functions

FonctionFunction ExplicationExplanation
andand Opérateur AND logique.Logical and. Retourne true si toutes les expressions spécifiées donnent true.Return true if all specified expressions evaluate to true.
equalsequals Opérateur de comparaison égal à.Comparison equal. Retourne true si les valeurs spécifiées sont égales.Return true if specified values are equal.
emptyempty Vérifiez si la cible est vide.Check if the target is empty.
greatergreater Opérateur de comparaison supérieur à.Comparison greater than. Retourne true si la première valeur est supérieure, false si elle est inférieure.Return true if the first value is more, or return false if less.
greaterOrEqualsgreaterOrEquals Opérateur de comparaison supérieur ou égal à.Comparison greater than or equal to. Retourne true si la première valeur est supérieure ou égale, false si elle est inférieure.Return true if the first value is greater or equal, or return false if the first value is less.
ifif Vérifie si une expression est vraie ou fausse.Check whether an expression is true or false. En fonction du résultat, retourne une valeur spécifiée.Based on the result, return a specified value.
lessless Opérateur de comparaison inférieur à.Comparison less than opearation. Retourne true si la première valeur est inférieure, false si elle est supérieure.Return true if the first value is less, or return false if the first value is more.
lessOrEqualslessOrEquals Opérateur de comparaison inférieur ou égal à.Comparison less than or equal operation. Retourne true si la première valeur est inférieure ou égale, false si elle est supérieure.Return true if the first value is less than or equal, or return false if the first value is more.
notnot Opérateur NOT logique.Logical not opearator. Retourne true si l’expression est fausse, false si elle est vraie.Return true if the expression is false, or return false if true.
oror Opérateur OR logique.Logical or opearation. Retourne true si au moins une expression est vraie, false si elles sont toutes fausses.Return true if at least one expression is true, or return false if all are false.
existsexists Évalue la vérité d’une expression.Evaluate an expression for truthiness.

Fonctions de conversionConversion functions

FonctionFunction ExplicationExplanation
floatfloat Retourne la représentation à virgule flottante de la chaîne spécifiée.Return the floating point representation of the specified string.
intint Retourne la représentation sous forme d’entier de la chaîne spécifiée.Return the integer representation of the specified string.
stringstring Retourne la version de chaîne de la valeur spécifiée dans un format de paramètres régionaux facultatif.Return the string version of the specified value in an optional locale format.
boolbool Retourne la représentation booléenne de la chaîne spécifiée.Return the Boolean representation of the specified string.
createArraycreateArray Crée un tableau à partir de plusieurs entrées.Create an array from multiple inputs.
jsonjson Retourne la valeur ou l’objet de type JavaScript Object Notation (JSON) d’une chaîne ou d’un élément XML.Return the JavaScript Object Notation (JSON) type value or object of a string or XML.
base64base64 Retourne la version encodée en base64 d’une chaîne ou d’un tableau d’octets.Return the base64-encoded version of a string or byte array.
base64ToBinarybase64ToBinary Retourne la version binaire d’une chaîne encodée en Base64.Return the binary version for a base64-encoded string.
base64ToStringbase64ToString Retourne la version de type chaîne d’une chaîne encodée en base64.Return the string version of a base64-encoded string.
binarybinary Renvoyer la version binaire d’une valeur d’entrée.Return the binary version for an input value.
dataUridataUri Retourne l’URI d’une valeur d’entrée.Return the URI for an input value.
dataUriToBinarydataUriToBinary Retourne la version binaire d’un URI de données.Return the binary version of a data URI.
dataUriToStringdataUriToString Retourne la version de type chaîne d’un URI de données.Return the string version of a data URI.
uriComponenturiComponent Renvoyer la version encodée dans un URI d’une valeur d’entrée en remplaçant les caractères non sécurisés pour les URL par des caractères d’échappement.Return the URI-encoded version for an input value by replacing URL-unsafe characters with escape characters.
uriComponentToStringuriComponentToString Retourne la version de type chaîne d’une chaîne encodée dans un URI.Return the string version of a URI-encoded string.
xmlxml C# uniquement.C# only. Retourne la version XML d’une chaîne.Return the XML version of a string.
formatNumberformatNumber Mettre en forme une valeur avec le nombre le plus proche du nombre spécifié de chiffres fractionnaires et de paramètres régionaux spécifiés facultatifs.Format a value to the nearest number to the specified number of fractional digits and an optional specified locale.

Fonctions mathématiquesMath functions

FonctionFunction ExplicationExplanation
addadd AND mathématique.Mathematical and. Retourne le résultat de l’addition de deux nombres (dans le cas de nombres purs), ou de la concaténation de deux chaînes ou plus.Return the result from adding two numbers (pure number case) or concatting two or more strings.
divdiv Division mathématique.Mathematical division. Retourne l’entier résultant de la division de deux nombres.Return the integer result from dividing two numbers.
maxmax Retourne la plus grande valeur d’une collection.Return the largest value from a collection.
minmin Retourne la plus petite valeur d’une collection.Return the smallest value from a collection.
modmod Retourne le reste de la division de deux nombres.Return the remainder from dividing two numbers.
mulmul Multiplication mathématique.Mathematical multiplication. Retourne le produit de la multiplication de deux nombres.Return the product from multiplying two numbers.
randrand Retourne un nombre aléatoire compris entre la valeur minimale et la valeur maximale spécifiées.Return a random number between specified min and max value.
subsub Soustraction mathématique.Mathematical subtraction. Retourne le résultat de la soustraction du second nombre du premier.Return the result from subtracting the second number from the first number.
sumsum Retourne la somme des nombres d’un tableau.Return the sum of numbers in an array.
rangerange Retourne un tableau d’entiers qui commence par un entier spécifique.Return an integer array that starts from a specified integer.
expexp Retourne l’élévation d’un nombre à la puissance d’un autre.Return exponentiation of one number to another.
averageaverage Retourne le nombre moyen d’un tableau numérique.Return the average number of an numeric array.
floorfloor Retourne la plus grande valeur intégrale inférieure ou égale au nombre spécifié.Return the largest integral value less than or equal to the specified number.
plafondceiling Retourne la plus petite valeur intégrale supérieure ou égale au nombre spécifié.Return the smallest integral value greater than or equal to the specified number.
Roundround Arrondit une valeur à l’entier le plus proche ou au nombre spécifié de chiffres fractionnaires.Round a value to the nearest integer or to the specified number of fractional digits.

Fonctions de date et heureDate and time functions

FonctionFunction ExplicationExplanation
addDaysaddDays Ajoutez un nombre de jours spécifié à un horodatage donné dans un format de paramètres régionaux facultatif.Add a number of specified days to a given timestamp in an optional locale format.
addHoursaddHours Ajoute un nombre spécifié d’heures à un horodatage donné dans un format de paramètres régionaux facultatif.Add a specified number of hours to a given timestamp in an optional locale format.
addMinutesaddMinutes Ajoute un nombre spécifié de minutes à un horodatage donné dans un format de paramètres régionaux facultatif.Add a specified number of minutes to a given timestamp in an optional locale format.
addSecondsaddSeconds Ajoute un nombre de secondes spécifié à un timestamp donné.Add a specified number of seconds to a given timestamp.
dayOfMonthdayOfMonth Retourne le jour d’un mois pour un timestamp ou une expression Timex donné.Return the day of a month for a given timestamp or Timex expression.
dayOfWeekdayOfWeek Retourne le jour de la semaine d’un timestamp donné.Return the day of the week for a given timestamp.
dayOfYeardayOfYear Retourne le jour de l’année d’un timestamp donné.Return the day of the year for a given timestamp.
formatDateTimeformatDateTime Retourne un horodateur dans un format de paramètres régionaux facultatif.Return a timestamp in an optional locale format.
formatEpochformatEpoch Retourne un horodateur dans un format de paramètres régionaux facultatif à partir de l’heure d’époque UNIX (heure UNIX, heure POSIX).Return a timestamp in an optional locale format from UNIX Epoch time (Unix time, POSIX time).
formatTicksformatTicks Retourne un horodatage dans un format de paramètres régionaux facultatif à partir de graduations.Return a timestamp in an optional locale format from ticks.
subtractFromTimesubtractFromTime Soustraire un nombre d’unités de temps d’un horodatage dans un format de paramètres régionaux facultatif.Subtract a number of time units from a timestamp in an optional locale format.
utcNowutcNow Retourne l’horodatage actuel dans un format de paramètres régionaux facultatif sous forme de chaîne.Return the current timestamp in an optional locale format as a string.
dateReadBackdateReadBack Utilise la bibliothèque date-heure pour fournir une relecture de date.Use the date-time library to provide a date readback.
monthmonth Retourne le mois du timestamp donné.Return the month of given timestamp.
datedate Retourne la date du timestamp donné.Return the date for a given timestamp.
yearyear Retourne l’année du timestamp donné.Return the year for the given timestamp.
getTimeOfDaygetTimeOfDay Retourne l’heure de la journée du timestamp donné.Return the time of day for a given timestamp.
getFutureTimegetFutureTime Retourne l’horodatage actuel dans un format de paramètres régionaux facultatifs plus les unités de temps spécifiées.Return the current timestamp in an optional locale format plus the specified time units.
getPastTimegetPastTime Retourne l’horodatage actuel dans un format de paramètres régionaux facultatif moins les unités de temps spécifiées.Return the current timestamp in an optional locale format minus the specified time units.
addToTimeaddToTime Ajoutez un nombre d’unités de temps à un horodatage dans un format de paramètres régionaux facultatif.Add a number of time units to a timestamp in an optional locale format.
convertFromUTCconvertFromUTC Convertit un horodatage dans un format de paramètres régionaux facultatif à partir du temps universel coordonné (UTC).Convert a timestamp in an optional locale format from Universal Time Coordinated (UTC).
convertToUTCconvertToUTC Convertit un horodatage dans un format de paramètres régionaux facultatif en temps universel coordonné (UTC).Convert a timestamp in an optional locale format to Universal Time Coordinated (UTC).
startOfDaystartOfDay Retourne le début de la journée d’un horodatage dans un format de paramètres régionaux facultatif.Return the start of the day for a timestamp in an optional locale format.
startOfHourstartOfHour Retourne le début de l’heure pour un horodatage dans un format de paramètres régionaux facultatif.Return the start of the hour for a timestamp in an optional locale format.
startOfMonthstartOfMonth Retourne le début du mois pour un horodatage dans un format de paramètres régionaux facultatif.Return the start of the month for a timestamp in an optional locale format.
ticksticks Retourne la valeur de la propriété Ticks d’un timestamp spécifié.Return the ticks property value of a specified timestamp.
ticksToDaysticksToDays Convertit une valeur de propriété Ticks en nombre de jours.Convert a ticks property value to the number of days.
ticksToHoursticksToHours Convertit une valeur de propriété Ticks en nombre d’heures.Convert a ticks property value to the number of hours.
ticksToMinutesticksToMinutes Convertit une valeur de propriété Ticks en nombre de minutes.Convert a ticks property value to the number of minutes.
dateTimeDiffdateTimeDiff Retourne la différence de graduations entre deux horodatages.Return the difference in ticks between two timestamps.
getPreviousViableDategetPreviousViableDate Retourne la date viable précédente d’une expression Timex en fonction de la date actuelle et d’un fuseau horaire facultatif spécifié.Return the previous viable date of a timex expression based on the current date and an optionally specified timezone.
getNextViableDategetNextViableDate Retourne la date viable suivante d’une expression Timex en fonction de la date actuelle et d’un TimeZone éventuellement spécifié.Return the next viable date of a timex expression based on the current date and an optionally specified timezone.
getPreviousViableTimegetPreviousViableTime Retourne l’heure viable précédente d’une expression Timex en fonction de l’heure actuelle et d’un TimeZone éventuellement spécifié.Return the previous viable time of a timex expression based on the current time and an optionally specified timezone.
getNextViableTimegetNextViableTime Retourne l’heure viable suivante d’une expression Timex en fonction de l’heure actuelle et d’un TimeZone éventuellement spécifié.Return the next viable time of a timex expression based on the current time and an optionally specified timezone.

Fonctions TimexTimex functions

FonctionFunction ExplicationExplanation
isPresentisPresent Retourne true si l’expression TimexProperty ou Timex fait référence au moment présent.Return true if the TimexProperty or Timex expression refers to the present.
isDurationisDuration Retourne true si l’expression TimexProperty ou Timex fait référence à une durée.Return true if the TimexProperty or Timex expression refers to a duration.
isTimeisTime Retourne true si l’expression TimexProperty ou Timex fait référence à une heure.Return true if the TimexProperty or Timex expression refers to a time.
isDateisDate Retourne true si l’expression TimexProperty ou Timex fait référence à une date.Return true if the TimexProperty or Timex expression refers to a date.
isTimeRangeisTimeRange Retourne true si l’expression TimexProperty ou Timex fait référence à un intervalle de temps.Return true if the TimexProperty or Timex expression refers to a time range.
isDateRangeisDateRange Retourne true si l’expression TimexProperty ou Timex fait référence à une plage de dates.Return true if the TimexProperty or Timex expression refers to a date range.
isDefiniteisDefinite Retourne true si l’expression TimexProperty ou Timex fait référence à un jour défini.Return true if the TimexProperty or Timex expression refers to a definite day.

Fonctions d’analyse d’URIURI parsing functions

FonctionFunction ExplicationExplanation
uriHosturiHost Retourne la valeur d’hôte d’un URI (Uniform Resource Identifier).Return the host value of a uniform resource identifier (URI).
uriPathuriPath Retourne la valeur de chemin d’un URI (Uniform Resource Identifier).Return the path value of a unifor resource identifier (URI).
uriPathAndQueryuriPathAndQuery Retourne les valeurs de chemin et de requête d’un URI (Uniform Resource Identifier).Return the path and query values for a uniform resource identifier (URI).
uriPorturiPort Retourne la valeur de port d’un URI (Uniform Resource Identifier).Return the port value of a uniform resource identifier (URI).
uriQueryuriQuery Retourne la valeur de requête d’un URI (Uniform Resource Identifier).Retur0sn the query value of a uniform resouce identifier (URI).
uriSchemeuriScheme Retourne la valeur de schéma d’un URI (Uniform Resource Identifier).Return the scheme value of a uniform resource identifier (URI).

Fonctions de manipulation et de construction d’objetObject manipulation and construction functions

FonctionFunction ExplicationExplanation
addPropertyaddProperty Ajoute une propriété et sa valeur, ou sa paire nom-valeur, à un objet JSON et retourne l’objet mis à jour.Add a property and its value, or name-value pair, to a JSON object and return the updated object.
removePropertyremoveProperty Supprime une propriété d’un objet JSON et retourne l’objet mis à jour.Remove a property from JSON object and return the updated object.
setPropertysetProperty Définit la valeur d’une propriété d’un objet JSON et retourne l’objet mis à jour.Set the value of a JSON object's property and return the updated object.
getPropertygetProperty Retourne la valeur d’une propriété racine ou d’une propriété spécifiée à partir d’un objet JSON.Return the value of a specified property or root property from a JSON object.
coalescecoalesce Retourne la première valeur autre que Null d’un ou plusieurs paramètres.Return the first non-null value from one or more parameters.
xPathxPath C# uniquement.C# only. Vérifie si le code XML contient des valeurs ou des nœuds qui correspondent à une expression de langage XPath et retourne les valeurs ou les nœuds correspondants.Check XML for nodes or values that match an XPath (XML Path Language) expression, and return the matching nodes or values.
jPathjPath Vérifie si les nœuds ou la valeur d’un code ou d’une chaîne JSON correspondent à une expression de chemin, et retourne les nœuds correspondants.Check JSON or a JSON string for nodes or value that match a path expression, and return the matching nodes.
setPathToValuesetPathToValue Définit la valeur d’un chemin spécifié et retourne la valeur.Set the value of a specific path and return the value.

Fonctions d’expression régulièreRegular expression functions

FonctionFunction ExplicationExplanation
isMatchisMatch Retourne true si une chaîne correspond à un modèle de regex courant.Return true if a string matches a common regex pattern.

Fonctions de vérification du typeType checking functions

FonctionFunction ExplicationExplanation
ÉCHÉANCEEOL C# uniquement.C# only. Retourne le texte de la séquence de fin de ligne (EOL).Return the end of line (EOL) sequence text.
isIntegerisInteger Retourne true si l’entrée donnée est un nombre entier.Return true if given input is an integer number
isFloatisFloat Retourne true si l’entrée donnée est un nombre à virgule flottante.Return true if the given input is a float point number
isBooleanisBoolean Retourne true si l’entrée donnée est un booléen.Return true if the given input is a Boolean.
isArrayisArray Retourne true si l’entrée donnée est un tableau.Return true if the given input is an array.
isObjectisObject Retourne true si l’entrée donnée est un objet.Return true if the given input is an object.
isDateTimeisDateTime Retourne true si l’entrée donnée est un timestamp au format ISO UTC.Return true if the given input is a UTC ISO format timestamp.
isStringisString Retourne true si l’entrée donnée est une chaîne.Return true if the given input is a string.

Fonctions prédéfinies triées par ordre alphabétiquePrebuilt functions sorted alphabetically

addadd

Retourne le résultat de l’addition de deux nombres ou plus (dans le cas de nombres purs), ou de la concaténation de deux chaînes ou plus (autre cas).Return the result from adding two or more numbers (pure number case) or concatting two or more strings (other case).

add(<item1>, <item2>, ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<élément1>, <élément2>,...<item1>, <item2>,... OuiYes n'importe laquelleany itemsitems
Valeur retournéeReturn value TypeType DescriptionDescription
<result-sum><result-sum> nombre ou chaînenumber or string Résultat de l’addition des nombres spécifiés ou résultat de la concaténation.The result from adding the specified numbers or the concat result.

ExempleExample

Cet exemple illustre l’addition des nombres spécifiés :This example adds the specified numbers:

add(1, 1.5)

Le résultat retourné est 2.5.And returns the result 2.5.

Cet exemple concatène les éléments spécifiés :This example concats the specified items:

add('hello',null)
add('hello','world')

Et retourne les résultatsAnd returns the results

  • hellohello
  • helloworldhelloworld

addDaysaddDays

Ajoutez un nombre de jours à un horodateur dans un format de paramètres régionaux facultatif.Add a number of days to a timestamp in an optional locale format.

addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne contenant le timestamp qui doit être au format ISO UTC standard.The string that contains the timestamp which must be standard UTC ISO format
AAAA-MM-JJTHH:mm:ss.fffZYYYY-MM-DDTHH:mm:ss.fffZ
<days><days> OuiYes entierinteger Nombre de jours positif ou négatif à ajouterThe positive or negative number of days to add
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage plus le nombre de jours spécifiéThe timestamp plus the specified number of days

Exemple 1Example 1

Cet exemple ajoute 10 jours à l’horodateur spécifié :This example adds 10 days to the specified timestamp:

addDays('2018-03-15T13:00:00.000Z', 10)

Le résultat retourné est 2018-03-25T00:00:00.000Z.And returns the result 2018-03-25T00:00:00.000Z.

Exemple 2Example 2

Cet exemple illustre le retrait de cinq jours de l’horodatage spécifié :This example subtracts five days from the specified timestamp:

addDays('2018-03-15T00:00:00.000Z', -5)

Le résultat retourné est 2018-03-10T00:00:00.000Z.And returns the result 2018-03-10T00:00:00.000Z.

Exemple 3Example 3

Cet exemple ajoute 1 jour à l’horodateur spécifié dans la région de-de :This examples adds 1 day to the specified timestamp in the de-DE locale:

addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')

Et retourne le résultat 16.03.18 13:00:00.And returns the result 16.03.18 13:00:00.

addHoursaddHours

Ajoutez un nombre d’heures à un horodatage dans un format de paramètres régionaux facultatif.Add a number of hours to a timestamp in an optional locale format.

addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<hours><hours> OuiYes entierinteger Nombre d’heures positif ou négatif à ajouterThe positive or negative number of hours to add
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage plus le nombre d’heures spécifiéThe timestamp plus the specified number of hours

Exemple 1Example 1

Cet exemple ajoute 10 heures à l’horodateur spécifié :This example adds 10 hours to the specified timestamp:

addHours('2018-03-15T00:00:00.000Z', 10)

Le résultat retourné est 2018-03-15T10:00:00.000Z.And returns the result 2018-03-15T10:00:00.000Z.

Exemple 2Example 2

Cet exemple illustre le retrait de cinq heures de l’horodatage spécifié :This example subtracts five hours from the specified timestamp:

addHours('2018-03-15T15:00:00.000Z', -5)

Le résultat retourné est 2018-03-15T10:00:00.000Z.And returns the result 2018-03-15T10:00:00.000Z.

Exemple 3Example 3

Cet exemple ajoute 2 heures à l’horodateur spécifié dans la région de-de :This examples adds 2 hours to the specified timestamp in the de-DE locale:

addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')

Et retourne le résultat 15.03.18 15:00:00.And returns the result 15.03.18 15:00:00.

addMinutesaddMinutes

Ajoutez un nombre de minutes à un horodateur dans un format de paramètres régionaux facultatif.Add a number of minutes to a timestamp in an optional locale format.

addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<minutes><minutes> OuiYes entierinteger Nombre de minutes positif ou négatif à ajouterThe positive or negative number of minutes to add
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage plus le nombre de minutes spécifiéThe timestamp plus the specified number of minutes

Exemple 1Example 1

Cet exemple ajoute 10 minutes à l’horodateur spécifié :This example adds 10 minutes to the specified timestamp:

addMinutes('2018-03-15T00:10:00.000Z', 10)

Le résultat retourné est 2018-03-15T00:20:00.000Z.And returns the result 2018-03-15T00:20:00.000Z.

Exemple 2Example 2

Cet exemple illustre le retrait de cinq minutes de l’horodatage spécifié :This example subtracts five minutes from the specified timestamp:

addMinutes('2018-03-15T00:20:00.000Z', -5)

Le résultat retourné est 2018-03-15T00:15:00.000Z.And returns the result 2018-03-15T00:15:00.000Z.

Exemple 3Example 3

Cet exemple ajoute 30 minutes à l’horodateur spécifié dans la région de-de :This examples adds 30 minutes to the specified timestamp in the de-DE locale:

addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')

Et retourne le résultat 15.03.18 13:30:00.And returns the result 15.03.18 13:30:00.

addOrdinaladdOrdinal

Retourne le numéro ordinal du nombre d’entrée.Return the ordinal number of the input number.

addOrdinal(<number>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number><number> OuiYes entierinteger Nombres à convertir en nombre ordinalThe numbers to convert to an ordinal number
Valeur retournéeReturn value TypeType DescriptionDescription
<result><result> stringstring Nombre ordinal converti à partir du nombre d’entréeThe ordinal number converted from the input number

ExempleExample

addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)

Les résultats retournés sont respectivement :And respectively returns these results:

  • 11th11th
  • 12th12th
  • 13th13th
  • 21st21st
  • 22nd22nd
  • 23rd23rd

addPropertyaddProperty

Ajouter une propriété et sa valeur, ou paire nom-valeur, à un objet JSON et renvoyer l’objet mis à jour.Add a property and its value, or name-value pair, to a JSON object, and return the updated object. Si l’objet existe déjà à l’exécution, la fonction génère une erreur.If the object already exists at runtime the function throws an error.

addProperty('<object>', '<property>', value)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object><object> OuiYes objectobject Objet JSON dans lequel vous souhaitez ajouter une propriétéThe JSON object where you want to add a property
<property><property> OuiYes stringstring Nom de la propriété à ajouterThe name of the property to add
<value><value> OuiYes n'importe laquelleany Valeur de la propriétéThe value of the property
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-object><updated-object> objectobject Objet JSON mis à jour après l’ajout d’une nouvelle propriétéThe updated JSON object after adding a new property

ExempleExample
Dans cet exemple, la propriété accountNumber est ajoutée à l’objet customerProfile, qui est converti au format JSON avec la fonction json().This example adds the accountNumber property to the customerProfile object, which is converted to JSON with the json() function. La fonction affecte une valeur qui est générée par la fonction newGuid(), et retourne l’objet mis à jour :The function assigns a value that is generated by the newGuid() function, and returns the updated object:

addProperty(json('customerProfile'), 'accountNumber', newGuid())

addSecondsaddSeconds

Ajoute un nombre de secondes à un horodatage.Add a number of seconds to a timestamp.

addSeconds('<timestamp>', <seconds>, '<format>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<seconds><seconds> OuiYes entierinteger Nombre de secondes positif ou négatif à ajouterThe positive or negative number of seconds to add
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage plus le nombre de secondes spécifiéThe timestamp plus the specified number of seconds

Exemple 1Example 1

Cet exemple illustre l’ajout de 10 secondes à l’horodatage spécifié :This example adds 10 seconds to the specified timestamp:

addSeconds('2018-03-15T00:00:00.000Z', 10)

Le résultat retourné est 2018-03-15T00:00:10.000Z.And returns the result 2018-03-15T00:00:10.000Z.

Exemple 2Example 2

Cet exemple illustre le retrait de cinq secondes de l’horodatage spécifié :This example subtracts five seconds to the specified timestamp:

addSeconds('2018-03-15T00:00:30.000Z', -5)

Le résultat retourné est 2018-03-15T00:00:25.000Z.And returns the result 2018-03-15T00:00:25.000Z.

addToTimeaddToTime

Ajoutez un nombre d’unités de temps à un horodatage dans un format de paramètres régionaux facultatif.Add a number of time units to a timestamp in an optional locale format. Voir aussi getFutureTime().See also getFutureTime().

addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<interval><interval> OuiYes entierinteger Nombre d’unités de temps spécifiées à ajouterThe number of specified time units to add
<timeUnit><timeUnit> OuiYes stringstring Unité de temps à utiliser avec interval.The unit of time to use with interval. Unités possibles : « Second » (seconde), « Minute » (minute), « Hour » (heure), « Day » (jour), « Week » (semaine), « Month » (mois) et « Year » (année).Possible units are "Second", "Minute", "Hour", "Day", "Week", "Month", and "Year".
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Timestamp plus le nombre d’unités de temps spécifiées au format donné.The timestamp plus the number of specified time units with given format.

Exemple 1Example 1

Dans cet exemple, un jour est ajouté au timestamp spécifié.This example adds one day to specified timestamp.

addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')

Le résultat retourné est 2018-01-02T00:00:00.000Z.And returns the result 2018-01-02T00:00:00.000Z.

Exemple 2Example 2

Dans cet exemple, deux semaines sont ajoutées au timestamp spécifié.This example adds two weeks to the specified timestamp.

addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')

Le résultat, retourné au format « MM-JJ-AA », est 01-15-18.And returns the result in the 'MM-DD-YY' format as 01-15-18.

andand

Vérifie si toutes les expressions sont vraies.Check whether all expressions are true. Retourne true si toutes les expressions sont vraies, false si au moins une expression est fausse.Return true if all expressions are true, or return false if at least one expression is false.

and(<expression1>, <expression2>, ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<expression1>, <expression2>...<expression1>, <expression2>, ... OuiYes BooleanBoolean Expressions à vérifierThe expressions to check
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si toutes les expressions sont vraies.Return true if all expressions are true. Retourne false si au moins une expression est fausse.Return false if at least one expression is false.

Exemple 1Example 1

Ces exemples vérifient si toutes les valeurs booléennes spécifiées sont vraies :These examples check whether the specified Boolean values are all true:

and(true, true)
and(false, true)
and(false, false)

Les résultats retournés sont respectivement :And respectively returns these results:

  • Comme les deux expressions sont vraies, la fonction retourne true.Both expressions are true, so the functions returns true.
  • Comme l’une des expressions est fausse, la fonction retourne false.One expression is false, so the functions returns false.
  • comme les deux expressions sont fausses, la fonction retourne false.Both expressions are false, so the function returns false.

Exemple 2Example 2

Ces exemples vérifient si toutes les expressions spécifiées sont vraies :These examples check whether the specified expressions are all true:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

Les résultats retournés sont respectivement :And respectively returns these results:

  • Comme les deux expressions sont vraies, la fonction retourne true.Both expressions are true, so the functions returns true.
  • Comme l’une des expressions est fausse, la fonction retourne false.One expression is false, so the functions returns false.
  • Comme les deux expressions sont fausses, la fonction retourne false.Both expressions are false, so the functions returns false.

averageaverage

Retourne le nombre moyen d’un tableau numérique.Return the number average of a numeric array.

average(<numericArray>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<numericArray><numericArray> OuiYes tableau de nombresarray of number Tableau d’entrée pour calculer la moyenneThe input array to calculate the average
Valeur retournéeReturn value TypeType DescriptionDescription
<average-of-array><average-of-array> nombrenumber Valeur moyenne du tableau donnéThe average value of the given array

ExempleExample

Dans cet exemple, la moyenne du tableau est calculée dans createArray() :This example calculates the average of the array in createArray():

average(createArray(1,2,3))

Le résultat retourné est 2.And returns the result 2.

base64base64

Retourne la version encodée en base64 d’une chaîne ou d’un tableau d’octets.Return the base64-encoded version of a string or byte array.

base64('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes Chaîne ou tableau d’octetsstring or byte array Chaîne d’entréeThe input string
Valeur retournéeReturn value TypeType DescriptionDescription
<base64-string><base64-string> stringstring Version encodée en base64 de la chaîne d’entréeThe base64-encoded version of the input string

Exemple 1Example 1

Dans cet exemple, la chaîne hello est convertie en chaîne encodée en base64 :This example converts the string hello to a base64-encoded string:

base64('hello')

Le résultat retourné est "aGVsbG8=" .And returns the result "aGVsbG8=".

Exemple 2Example 2

Dans cet exemple, byteArr est égal à new byte[] { 3, 5, 1, 12 } :This examples takes byteArr, which equals new byte[] { 3, 5, 1, 12 }:

base64('byteArr')

Le résultat retourné est "AwUBDA==" .And returns the result "AwUBDA==".

base64ToBinarybase64ToBinary

Retourne le tableau binaire d’une chaîne encodée en base64.Return the binary array of a base64-encoded string.

base64ToBinary('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne encodée en Base64 à convertirThe base64-encoded string to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<binary-for-base64-string><binary-for-base64-string> tableau d’octetsbyte array Version binaire de la chaîne encodée en base64The binary version of the base64-encoded string

ExempleExample

Dans cet exemple, la chaîne AwUBDA== encodée en base64 est convertie en chaîne binaire :This example converts the base64-encoded string AwUBDA== to a binary string:

base64ToBinary('AwUBDA==')

Le résultat retourné est new byte[] { 3, 5, 1, 12 } .And returns the result new byte[] { 3, 5, 1, 12 }.

base64ToStringbase64ToString

Retourne la version de type chaîne d’une chaîne encodée en base64, en décodant la chaîne base64.Return the string version of a base64-encoded string, effectively decoding the base64 string.

base64ToString('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne encodée en Base64 à décoderThe base64-encoded string to decode
Valeur retournéeReturn value TypeType DescriptionDescription
<decoded-base64-string><decoded-base64-string> stringstring Version de type chaîne d’une chaîne encodée en base64The string version of a base64-encoded string

ExempleExample

Dans cet exemple, la chaîne aGVsbG8= encodée en base64 est convertie en chaîne décodée :This example converts the base64-encoded string aGVsbG8= to a decoded string:

base64ToString('aGVsbG8=')

Le résultat retourné est hello.And returns the result hello.

binarybinary

Retourne la version binaire d’une chaîne.Return the binary version of a string.

binary('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne à convertirThe string to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<binary-for-input-value><binary-for-input-value> tableau d’octetsbyte array Version binaire de la chaîne spécifiéeThe binary version of the specified string

ExempleExample

Dans cet exemple, la chaîne hello est convertie en chaîne binaire :This example converts the string hello to a binary string:

binary('hello')

Le résultat retourné est new byte[] { 104, 101, 108, 108, 111 } .And returns the result new byte[] { 104, 101, 108, 108, 111 }.

boolbool

Retourne la version booléenne d’une valeur.Return the Boolean version of a value.

bool(<value>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes n'importe laquelleany Valeur à convertirThe value to convert
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Version booléenne de la valeur spécifiéeThe Boolean version of the specified value

ExempleExample

Ces exemples illustrent la conversion des valeurs spécifiées en valeurs booléennes :These examples convert the specified values to Boolean values:

bool(1)
bool(0)

Les résultats retournés sont respectivement :And respectively returns these results:

  • true
  • false

ceilingceiling

Retourne la plus grande valeur intégrale inférieure ou égale au nombre spécifié.Return the largest integral value less than or equal to the specified number.

ceiling('<number>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number><number> OuiYes nombrenumber Un numéro d’entréeAn input number
Valeur retournéeReturn value TypeType DescriptionDescription
<valeur entière><integer-value> entierinteger Plus grande valeur intégrale supérieure ou égale au nombre d’entréeThe largest integral value greater than or equal to the input number

ExempleExample

Cet exemple retourne la plus grande valeur intégrale inférieure ou égale au nombre 10,333:This example returns the largest integral value less than or equal to the number 10.333:

ceiling(10.333)

Et retourne l’entier 11.And returns the integer 11.

coalescecoalesce

Retourne la première valeur autre que Null d’un ou plusieurs paramètres.Return the first non-null value from one or more parameters. Les chaînes vides, les tableaux vides et les objets vides ne sont pas null.Empty strings, empty arrays, and empty objects are not null.

coalesce(<object**1>, <object**2>, ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object**1>, <object**2>, ...<object**1>, <object**2>, ... OuiYes Indifférent (types mixtes acceptés)any (mixed types acceptable) Recherche de la valeur Null dans un ou plusieurs élémentsOne or more items to check for null
Valeur retournéeReturn value TypeType DescriptionDescription
<first-non-null-item><first-non-null-item> n'importe laquelleany Premier élément ou valeur autre que Null.The first item or value that is not null. Si tous les paramètres ont la valeur Null, cette fonction retourne la valeur Null.If all parameters are null, this function returns null.

ExempleExample

Ces exemples retournent la première valeur autre que Null à partir des valeurs spécifiées ou la valeur Null lorsque toutes les valeurs le sont :These examples return the first non-null value from the specified values, or null when all the values are null:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

Et retournent respectivement :And respectively return:

  • true
  • hellohello
  • nullnull

concatconcat

Combinez deux objets ou plus et retournez les objets combinés dans une liste ou une chaîne.Combine two or more objects, and return the combined objects in a list or string.

concat('<text1>', '<text2>', ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object1>, <object2>...<object1>, <object2>, ... OuiYes n'importe laquelleany Au moins deux objets à Concat.At least two objects to concat.
Valeur retournéeReturn value TypeType DescriptionDescription
<object1object2...><object1object2...> chaîne ou listestring or list Chaîne ou liste combinée.The combined string or list. Les valeurs NULL sont ignorées.Null values are skipped.

Valeurs de retour attendues :Expected return values:

  • Si tous les éléments sont des listes, une liste est retournée.If all items are lists, a list will be returned.
  • S’il existe un élément qui n’est pas une liste, une chaîne est retournée.If there exists an item that is not a list, a string will be returned.
  • Si une valeur est null, elle est ignorée et n’est pas concatanated.If a value is null, it is skipped and not concatanated.

ExempleExample

Dans cet exemple, les chaînes Hello et World sont combinées :This example combines the strings Hello and World:

concat('Hello', 'World')

Le résultat retourné est HelloWorld.And returns the result HelloWorld.

Exemple 2Example 2

Cet exemple combine les listes [1, 2] et [3,4]:This example combines the lists [1,2] and [3,4]:

concat([1,2],[3,4])

Et retourne le résultat [1, 2, 3, 4].And returns the result [1,2,3,4].

Exemple 3Example 3

Ces exemples combinent des objets de types différents :These examples combine objects of different types:

concat('a', 'b', 1, 2)
concat('a', [1,2])

Les résultats retournés sont respectivement :And return the following results respectively:

  • Chaîne AB12.The string ab12.
  • Objet aSystem. Collections. Generic. List 1 [System. Object].The object aSystem.Collections.Generic.List 1[System.Object]. Ce n’est pas lisible et il est préférable de l’éviter.This is unreadable and best to avoid.

Exemple 4Example 4

Les exemples suivants combinent des objets null :These example combine objects will null:

concat([1,2], null)
concat('a', 1, null)

Les résultats retournés sont respectivement :And return the following results respectively:

  • Liste [1, 2].The list [1,2].
  • Chaîne a1.The string a1.

containscontains

Vérifie si une collection contient un élément spécifique.Check whether a collection has a specific item. Retourne true si l’élément est trouvé, false sinon.Return true if the item is found, or return false if not found. Cette fonction respecte la casse.This function is case-sensitive.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Cette fonction agit sur ces types de collections suivants :This function works on the following collection types:

  • Une chaîne pour y rechercher une sous-chaîneA string to find a substring
  • Un tableau pour y rechercher une valeurAn array to find a value
  • Un dictionnaire pour y rechercher une cléA dictionary to find a key
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes Chaîne, tableau ou dictionnairestring, array, or dictionary Collection à vérifierThe collection to check
<value><value> OuiYes Respectivement chaîne, tableau ou dictionnairestring, array, or dictionary, respectively Élément à rechercherThe item to find
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si l’élément est trouvé.Return true if the item is found. Retourne false s’il n’est pas trouvé.Return false if not found.

Exemple 1Example 1

Dans cet exemple, la sous-chaîne world est recherchée dans la chaîne hello world :This example checks the string hello world for the substring world:

contains('hello world', 'world')

Le résultat retourné est true.And returns the result true.

Exemple 2Example 2

Dans cet exemple, la sous-chaîne universe est recherchée dans la chaîne hello world :This example checks the string hello world for the substring universe:

contains('hello world', 'universe')

Le résultat retourné est false.And returns the result false.

countcount

Retourne le nombre d’éléments d’une collection.Return the number of items in a collection.

count('<collection>')
count([<collection>])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes chaîne ou tableaustring or array Collection contenant les éléments à comptabiliserThe collection with the items to count
Valeur retournéeReturn value TypeType DescriptionDescription
<length-or-count><length-or-count> entierinteger Nombre d’éléments de la collectionThe number of items in the collection

Exemples :Examples:

Ces exemples illustrent le comptage du nombre d’éléments contenus dans ces collections :These examples count the number of items in these collections:

count('abcd')
count(createArray(0, 1, 2, 3))

Le résultat retourné est 4 dans les deux cas.And both return the result 4.

countWordcountWord

Retourne le nombre de mots d’une chaîne.Return the number of words in a string

countWord('<text>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne sur laquelle porte le comptageThe string to count
Valeur retournéeReturn value TypeType DescriptionDescription
<count><count> entierinteger Nombre de mots de la chaîneThe number of words in the string

ExempleExample

Dans cet exemple, le nombre de mots de la chaîne Hello World est compté :This example counts the number of words in the string hello world:

countWord("hello word")

Le résultat retourné est 2.And it returns the result 2.

convertFromUTCconvertFromUTC

Convertit un horodatage dans un format de paramètres régionaux facultatif à partir du temps universel coordonné (UTC) en un fuseau horaire cible.Convert a timestamp in an optional locale format from Universal Time Coordinated (UTC) to a target time zone.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<destinationTimeZone><destinationTimeZone> OuiYes stringstring Nom du fuseau horaire source.The name of the target time zone. Les fuseaux horaires Windows et IANA sont pris en charge.Supports Windows and Iana time zones.
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le format par défaut de l’horodateur est le format « o », AAAA-MM-JJThh : mm : SS. fffffffK, qui est conforme à la norme ISO 8601.The default format for the timestamp is the "o" format, yyyy-MM-ddTHH:mm:ss.fffffffK, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<converted-timestamp><converted-timestamp> stringstring Horodatage converti au fuseau horaire cibleThe timestamp converted to the target time zone

Exemples :Examples:

Dans ces exemples, l’heure UTC est convertie en heure normale du Pacifique :These examples convert from UTC to Pacific Standard Time:

convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')

Les résultats retournés sont respectivement :And respectively return these results:

  • 02-01-1802-01-18
  • 2018-01-01T18:00:00.00000002018-01-01T18:00:00.0000000

Exemple 2Example 2

Cet exemple convertit un horodateur dans les paramètres régionaux en -US de l’heure UTC à l’heure standard du Pacifique :This example converts a timestamp in the en-US locale from UTC to Pacific Standard Time:

convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')

Et retourne le résultat du lundi 1er janvier 2018.And returns the result Monday, January 1, 2018.

convertToUTCconvertToUTC

Convertit un horodatage dans un format de paramètres régionaux facultatif en temps universel coordonné (UTC, Universal Time Coordinated) à partir du fuseau horaire source.Convert a timestamp in an optional locale format to Universal Time Coordinated (UTC) from the source time zone.

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<sourceTimeZone><sourceTimeZone> OuiYes stringstring Nom du fuseau horaire source.The name of the target time zone. Les fuseaux horaires Windows et IANA sont pris en charge.Supports Windows and Iana time zones.
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<converted-timestamp><converted-timestamp> stringstring Horodatage converti au fuseau horaire cibleThe timestamp converted to the target time zone

ExempleExample

Cet exemple convertit un horodateur en heure UTC à partir du PacifiqueThis example converts a timestamp to UTC from Pacific Standard Time

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')

Et retourne le résultat 2018-01-01T08:00:00.000 z.And returns the result 2018-01-01T08:00:00.000Z.

Exemple 2Example 2

L’exemple suivant convertit un horodateur dans le de-de local en UTC à partir de l’heure du Pacifique :This example converts a timestamp in the de-DE locale to UTC from Pacific Standard Time:

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')

Et retourne le résultat 01.01.18 08:00:00.And returns the result 01.01.18 08:00:00.

createArraycreateArray

Retourne un tableau à partir de plusieurs entrées.Return an array from multiple inputs.

createArray('<object1>', '<object2>', ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object1>, <object2>...<object1>, <object2>, ... OuiYes N’importe lequel (non mixte)any, but not mixed Au moins deux éléments pour créer le tableauAt least two items to create the array
Valeur retournéeReturn value TypeType DescriptionDescription
[<object1>, <object2>...][<object1>, <object2>, ...] tableauarray Tableau créé à partir de tous les éléments d’entréeThe array created from all the input items

ExempleExample

Dans cet exemple, un tableau est créé à partir des entrées suivantes :This example creates an array from the following inputs:

createArray('h', 'e', 'l', 'l', 'o')

Le résultat retourné est [h ,e, l, l, o] .And returns the result [h ,e, l, l, o].

dataUridataUri

Retourne un URI (Uniform Resource Identifier) de données d’une chaîne.Return a data uniform resource identifier (URI) of a string.

dataUri('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne à convertirThe string to convert
Valeur retournéeReturn value TypeType DescriptionDescription
[<date-uri>][<date-uri>] stringstring URI de données de la chaîne d’entréeThe data URI for the input string

ExempleExample

dataUri('hello')

Le résultat retourné est data:text/plain;charset=utf-8;base64,aGVsbG8= .Returns the result data:text/plain;charset=utf-8;base64,aGVsbG8=.

dataUriToBinarydataUriToBinary

Retourne la version binaire d’un URI (Uniform Resource Identifier) de données.Return the binary version of a data uniform resource identifier (URI).

dataUriToBinary('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring URI de données à convertirThe data URI to convert
Valeur retournéeReturn value TypeType DescriptionDescription
[<binary-for-data-uri>][<binary-for-data-uri>] tableau d’octetsbyte array Version binaire de l’URI de donnéesThe binary version of the data URI

ExempleExample

Dans cet exemple, une version binaire est créée pour l’URI de données suivant :This example creates a binary version for the following data URI:

dataUriToBinary('aGVsbG8=')

Le résultat retourné est new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 } .And returns the result new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }.

dataUriToStringdataUriToString

Retourne la version de type chaîne d’un URI (Uniform Resource Identifier) de données.Return the string version of a data uniform resource identifier (URI).

dataUriToString('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring URI de données à convertirThe data URI to convert
Valeur retournéeReturn value TypeType DescriptionDescription
[<string-for-data-uri>][<string-for-data-uri>] stringstring Version de type chaîne de l’URI de donnéesThe string version of the data URI

ExempleExample

Dans cet exemple, une chaîne est créée à partir de l’URI de données suivant :This example creates a string from the following data URI:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Le résultat retourné est hello.And returns the result hello.

Datedate

Retourne la date d’un timestamp spécifié au format m/jj/aaaa.Return the date of a specified timestamp in m/dd/yyyy format.

date('<timestramp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<date><date> stringstring Date du timestamp spécifiéThe date of the specified timestamp
date('2018-03-15T13:00:00.000Z')

Le résultat retourné est 3-15-2018.Returns the result 3-15-2018.

dateReadBackdateReadBack

Utilise la bibliothèque date-heure pour fournir une relecture de date.Uses the date-time library to provide a date readback.

dateReadBack('<currentDate>', '<targetDate>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<currentDate><currentDate> OuiYes stringstring Chaîne contenant la date actuelleThe string that contains the current date
<targetDate><targetDate> OuiYes stringstring Chaîne contenant la date cibleThe string that contains the target date
Valeur retournéeReturn value TypeType DescriptionDescription
<date-readback><date-readback> stringstring Relecture entre la date actuelle et la date cibleThe readback between current date and the target date

Exemple 1Example 1

dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')

Le résultat retourné est tomorrow.Returns the result tomorrow.

dateTimeDiffdateTimeDiff

Retourne la différence de graduations entre deux horodatages.Return the difference in ticks between two timestamps.

dateTimeDiff('<timestamp1>', '<timestamp2>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp1><timestamp1> OuiYes stringstring Première chaîne d’horodatage à comparerThe first timestamp string to compare
<timestamp2><timestamp2> OuiYes stringstring Deuxième chaîne d’horodatage à comparerThe second timestamp string to compare
Valeur retournéeReturn value TypeType DescriptionDescription
<graduations><ticks> nombrenumber Différence de graduations entre deux horodatagesThe difference in ticks between two timestamps

Exemple 1Example 1

Cet exemple retourne la différence de graduations entre deux horodateurs :This example returns the difference in ticks between two timestamps:

dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')

Et retourne le nombre 315360000000000.And returns the number 315360000000000.

Exemple 2Example 2

Cet exemple retourne la différence de graduations entre deux horodateurs :This example returns the difference in ticks between two timestamps:

dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')

Retourne le résultat -315360000000000.Returns the result -315360000000000. Notez que la valeur est un nombre négatif.Note that the value is a negative number.

dayOfMonthdayOfMonth

Retourne le jour du mois d’un horodatage.Return the day of the month from a timestamp.

dayOfMonth('<timestamp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<day-of-month><day-of-month> entierinteger Jour du mois de l’horodatage spécifiéThe day of the month from the specified timestamp

ExempleExample

Dans cet exemple, le numéro du jour du mois est retourné à partir du timestamp suivant :This example returns the number for the day of the month from the following timestamp:

dayOfMonth('2018-03-15T13:27:36Z')

Le résultat retourné est 15.And returns the result 15.

dayOfWeekdayOfWeek

Retourne le jour de la semaine à partir d’un horodatage.Return the day of the week from a timestamp.

dayOfWeek('<timestamp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<day-of-week><day-of-week> entierinteger Jour de la semaine à partir du timestamp spécifié.The day of the week from the specified timestamp. Le dimanche correspond à la valeur 0, le lundi à la valeur 1 et ainsi de suite.Sunday is 0, Monday is 1, and so forth.

ExempleExample

Dans cet exemple, le numéro du jour de la semaine est retourné à partir du timestamp suivant :This example returns the number for the day of the week from the following timestamp:

dayOfWeek('2018-03-15T13:27:36Z')

Le résultat retourné est 3.And returns the result 3.

dayOfYeardayOfYear

Retourne le jour de l’année à partir d’un horodatage.Return the day of the year from a timestamp.

dayOfYear('<timestamp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<day-of-year><day-of-year> entierinteger Jour de l’année à partir de l’horodatage spécifiéThe day of the year from the specified timestamp

ExempleExample

Dans cet exemple, le numéro du jour de l’année est retourné à partir du timestamp suivant :This example returns the number of the day of the year from the following timestamp:

dayOfYear('2018-03-15T13:27:36Z')

Le résultat retourné est 74.And returns the result 74.

divdiv

Retourne l’entier résultant de la division de deux nombres.Return the integer result from dividing two numbers. Pour retourner le reste, consultez mod().To return the remainder see mod().

div(<dividend>, <divisor>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<dividend><dividend> OuiYes nombrenumber Nombre à diviser par le diviseurThe number to divide by the divisor
<divisor><divisor> OuiYes nombrenumber Nombre qui divise dividend.The number that divides the dividend. Ne peut pas être 0.Cannot be 0.
Valeur retournéeReturn value TypeType DescriptionDescription
<quotient-result><quotient-result> nombrenumber Résultat de la division du premier nombre par le secondThe result from dividing the first number by the second number

ExempleExample

Les deux exemples illustrent la division du premier nombre par le second :Both examples divide the first number by the second number:

div(10, 5)
div(11, 5)

Le résultat retourné est 2.And return the result 2.

Si l’un des paramètres est un flottant, le résultat sera également un flottant.If one of the parameters is a float, the result will be also be a float.

ExempleExample

div(11.2, 3)

Le résultat retourné est 5.5.Returns the result 5.5.

emptyempty

Vérifie si une instance est vide.Check whether an instance is empty. Retourne true si l’entrée est vide.Return true if the input is empty. « Vide » signifie :Empty means:

  • l’entrée est null ou n’est pas définieinput is null or undefined
  • l’entrée est null ou est une chaîne videinput is a null or empty string
  • l’entrée est une collection de taille « zéro »input is zero size collection
  • l’entrée est un objet sans propriété.input is an object with no property.
empty('<instance>')
empty([<instance>])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<instance><instance> OuiYes n'importe laquelleany Instance à vérifierThe instance to check
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true quand l’instance est vide.Return true when the instance is empty.

ExempleExample

Ces exemples vérifient si l’instance spécifiée est vide :These examples check whether the specified instance is empty:

empty('')
empty('abc')
empty([1])
empty(null)

Les résultats retournés sont respectivement :And return these results respectively:

  • comme une chaîne vide est passée, la fonction retourne true.Passes an empty string, so the function returns true.
  • Comme la chaîne abc est passée, la fonction retourne false.Passes the string abc, so the function returns false.
  • Passe la collection avec un seul élément, de sorte que la fonction retourne false.Passes the collection with one item, so the function returns false.
  • Passe l’objet null, de sorte que la fonction retourne true.Passes the null object, so the function returns true.

endsWithendsWith

Vérifie si une chaîne se termine par une sous-chaîne spécifique.Check whether a string ends with a specific substring. Retourne true si la sous-chaîne est trouvée, false sinon.Return true if the substring is found, or return false if not found. Cette fonction ne respecte pas la casse.This function is case-insensitive.

endsWith('<text>', '<searchText>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne à vérifierThe string to check
<searchText><searchText> OuiYes stringstring Sous-chaîne de fin à rechercherThe ending substring to find
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si la sous-chaîne de fin est trouvée.Return true when the ending substring is found. Retourne false si elle n’est pas trouvée.Return false if not found

Exemple 1Example 1

Dans cet exemple, la chaîne hello world est examinée pour savoir si elle se termine par la chaîne world :This example checks whether the hello world string ends with the string world:

endsWith('hello world', 'world')

Le résultat retourné est true.And it returns the result true.

Exemple 2Example 2

Dans cet exemple, la chaîne hello world est examinée pour savoir si elle se termine par la chaîne universe :This example checks whether the hello world string ends with the string universe:

endsWith('hello world', 'universe')

Le résultat retourné est false.And it returns the result false.

ÉCHÉANCEEOL

C# uniquement.C# only. Retourne le texte de la séquence de fin de ligne (EOL).Return the end of line (EOL) sequence text.

EOL()
Valeur retournéeReturn value TypeType DescriptionDescription
<IsOSPlatform><IsOSPlatform> stringstring Retournez \r\n dans Windows et \n dans Mac et Linux.Return \r\n in Windows and \n in Mac and Linux.

ExempleExample

Cet exemple vérifie la fin du texte de la séquence de lignes :This example checks the end of the line sequence text:

EOL()

Et retourne les chaînes suivantes :And returns the following strings:

  • Windows : \r\nWindows: \r\n
  • Mac ou Linux : \nMac or Linux: \n

equalsequals

Vérifie si les deux valeurs, expressions ou objets sont équivalents.Check whether both values, expressions, or objects are equivalent. Retourne true si les deux sont équivalents, false sinon.Return true if both are equivalent, or return false if they're not equivalent.

equals('<object1>', '<object2>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object1>, <object2><object1>, <object2> OuiYes n'importe laquelleany Valeurs, expressions ou objets à comparerThe values, expressions, or objects to compare
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si les deux sont équivalents.Return true when both are equivalent. Retourne false s’ils ne sont pas équivalents.Return false if not equivalent.

ExempleExample

Dans ces exemples, les entrées spécifiées sont examinées pour savoir si elles sont équivalentes :These examples check whether the specified inputs are equivalent:

equals(true, 1)
equals('abc', 'abcd')

Les résultats retournés sont respectivement :And returns these results respectively:

  • comme les deux valeurs sont équivalentes, la fonction retourne true.Both values are equivalent, so the function returns true.
  • comme les deux valeurs ne sont pas équivalentes, la fonction retourne false.Both values aren't equivalent, so the function returns false.

existsexists

Évalue la vérité d’une expression.Evaluates an expression for truthiness.

exists(expression)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
expressionexpression OuiYes expressionexpression Expression dont la vérité est évaluéeExpression to evaluate for truthiness
Valeur retournéeReturn value TypeType DescriptionDescription
<true ou false><true or false> BooleanBoolean Résultat de l’évaluation de l'expressionResult of evaluating the expression

ExempleExample

Dans ces exemples, la vérité de foo = {"bar":"value"} est évaluée :These example evaluate the truthiness of foo = {"bar":"value"}:

exists(foo.bar)
exists(foo.bar2)

Les résultats retournés sont respectivement :And return these results respectively:

  • true
  • false

expexp

Retourne l’élévation d’un nombre à la puissance d’un autre.Return exponentiation of one number to another.

exp(realNumber, exponentNumber)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
realNumberrealNumber OuiYes nombrenumber Nombre réel pour calculer l’exposant deReal number to compute exponent of
exponentNumberexponentNumber OuiYes nombrenumber Nombre d’exposantExponent number
Valeur retournéeReturn value TypeType DescriptionDescription
<result-exp><result-exp> nombrenumber Résultat du calcul de l’exposant de realNumberThe result from computing exponent of realNumber

ExempleExample

Dans cet exemple, l’exposant est calculé :This example computes the exponent:

exp(2, 2)

Le résultat retourné est 4.And returns the result 4.

firstfirst

Retourne le premier élément d’une chaîne ou d’un tableau.Return the first item from a string or array.

first('<collection>')
first([<collection>])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes chaîne ou tableaustring or array Collection dans laquelle est recherché le premier élémentThe collection in which to find the first item
Valeur retournéeReturn value TypeType DescriptionDescription
<first-collection-item><first-collection-item> n'importe laquelleany Premier élément de la collectionThe first item in the collection

ExempleExample

Dans ces exemples, le premier élément est recherché dans les collections suivantes :These examples find the first item in the following collections:

first('hello')
first(createArray(0, 1, 2))

Les résultats retournés sont respectivement :And return these results respectively:

  • hh
  • 00

aplatirflatten

Aplatit un tableau en valeurs qui ne sont pas des tableaux.Flatten an array into non-array values. Vous pouvez éventuellement définir la profondeur maximale à aplatir.You can optionally set the maximum depth to flatten to.

flatten([<collection>], '<depth>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes tableauarray Collection à aplatirThe collection to flatten
<depth><depth> NonNo nombrenumber Profondeur maximale à aplatir.Maximum depth to flatten. La valeur par défaut est l’infini.Default is infinity.
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection><new-collection> tableauarray Nouvelle collection dont les éléments ont été aplatis en un élément qui n’est pas un tableau à la profondeur spécifiéeNew collection whose elements have been flattened to a non-array to the specified depth

Exemple 1Example 1

Dans cet exemple, le tableau suivant est aplati :THis example flattens the following array:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))

Le résultat retourné est [1, 2, 3, 4, 5, 6] .And returns the result [1, 2, 3, 4, 5, 6].

Exemple 2Example 2

Dans cet exemple, le tableau est aplati à une profondeur de 1 :This example flattens the array to a depth of 1:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)

Le résultat retourné est [1, 2, [3, 4], [5, 6]] .And returns the result [1, 2, [3, 4], [5, 6]].

floatfloat

Convertit la version de type chaîne d’un nombre à virgule flottante en nombre à virgule flottante.Convert the string version of a floating-point number to a floating-point number. Vous pouvez utiliser cette fonction uniquement lors de la transmission de paramètres personnalisés à une application, telle qu’une application logique.You can use this function only when passing custom parameters to an app, such as a logic app. Une exception est levée si la chaîne ne peut pas être convertie en valeur float.An exception will be thrown if the string cannot be converted to a float.

float('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne contenant un nombre valide à virgule flottante à convertirThe string that has a valid floating-point number to convert to
Valeur retournéeReturn value TypeType DescriptionDescription
<float-value><float-value> floatfloat Nombre à virgule flottante de la chaîne spécifiéeThe floating-point number of the specified string

ExempleExample

L’exemple suivant convertit la version float d’une chaîne :This example converts the float version of a string:

float('10.333')

Et retourne le float 10,333.And returns the float 10.333.

floorfloor

Retourne la plus grande valeur intégrale inférieure ou égale au nombre spécifié.Return the largest integral value less than or equal to the specified number.

floor('<number>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number><number> OuiYes nombrenumber Un numéro d’entréeAn input number
Valeur retournéeReturn value TypeType DescriptionDescription
<valeur entière><integer-value> entierinteger Valeur intégrale la plus grande inférieure ou égale au nombre d’entréeThe largest integral value less than or equal to the input number

ExempleExample

L’exemple suivant calcule la valeur plancher du nombre 10,333:This example calculates the floor value of the number 10.333:

floor(10.333)

Et retourne l’entier 10.And returns the integer 10.

foreachforeach

S’applique à chaque élément et retourne la nouvelle collection.Operate on each element and return the new collection.

foreach([<collection/instance>], <iteratorName>, <function>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection/instance><collection/instance> OuiYes objet ou tableauarray or object Collection contenant les élémentsThe collection with the items
<iteratorName><iteratorName> OuiYes Nom de l’itérateuriterator name Élément clé de la fonction fléchéeThe key item of arrow function
<function><function> OuiYes expressionexpression Fonction contenant iteratorNameFunction that contains iteratorName
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection><new-collection> tableauarray Nouvelle collection dans laquelle chaque élément a été évalué par la fonctionThe new collection in which each element has been evaluated by the function

Exemple 1Example 1

Dans cet exemple, une nouvelle collection est générée :This example generates a new collection:

foreach(createArray(0, 1, 2, 3), x, x + 1)

Le résultat retourné est [1, 2, 3, 4] .And returns the result [1, 2, 3, 4].

Exemple 2Example 2

Ces exemples génèrent une nouvelle collection :These examples generate a new collection:

foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

Et retournent le résultat ['Name : Jack', 'Age : 15 '].And return the result ['name:jack', 'age:15']. Notez que la deuxième expression est une expression lambda, qui est plus lisible.Note that the second expression is a lambda expression, which some find more readable.

formatDateTimeformatDateTime

Retourne un horodateur dans un format de paramètres régionaux facultatif.Return a timestamp in an optional locale format.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<reformatted-timestamp><reformatted-timestamp> stringstring Horodatage mis à jour au format spécifiéThe updated timestamp in the specified format

Exemple 1Example 1

Cet exemple illustre la conversion d’un horodatage au format spécifié :This example converts a timestamp to the specified format:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

Et retourne le résultat 2018-03-15T12:00:00.And returns the result 2018-03-15T12:00:00.

Exemple 2Example 2

L’exemple suivant convertit un horodateur dans le de paramètres régionaux :This example converts a timestamp in the de-DE locale:

formatDateTime('2018-03-15', '', 'de-DE')

Et retourne le résultat 15.03.18 00:00:00.And returns the result 15.03.18 00:00:00.

formatEpochformatEpoch

Retourne un horodatage dans un format de paramètres régionaux facultatif dans le format spécifié à partir de l’heure UNIX (également connu comme heure d’époque, heure POSIX, heure d’époque UNIX).Return a timestamp in an optional locale format in the specified format from UNIX time (also know as Epoch time, POSIX time, UNIX Epoch time).

formatEpoch('<epoch>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<epoch><epoch> OuiYes nombrenumber Nombre correspondant à l’heure EpochThe epoch number
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<reformatted-timestamp><reformatted-timestamp> stringstring Horodatage mis à jour au format spécifiéThe updated timestamp in the specified format

ExempleExample

Cet exemple convertit un horodateur UNIX au format spécifié :This example converts a Unix timestamp to the specified format:

formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'

Et retourne le résultat 2018-03-15T12:00:00.000Z.And returns the result 2018-03-15T12:00:00.000Z.

ExempleExample

L’exemple suivant convertit un horodateur UNIX dans le de paramètres régionaux :This example converts a Unix timestamp in the de-DE locale:

formatEpoch(1521118800, '', 'de-DE')

Et retourne le résultat 15.03.18 13:00:00.And returns the result 15.03.18 13:00:00.

formatNumberformatNumber

Mettre en forme une valeur avec le nombre spécifié de chiffres fractionnaires et un paramètre régional facultatif spécifié.Format a value to the specified number of fractional digits and an optional specified locale.

formatNumber('<number>', '<precision-digits>', '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number><number> OuiYes nombrenumber Un numéro d’entréeAn input number
<chiffres de précision><precision-digits> OuiYes entierinteger Nombre spécifié de chiffres fractionnairesA specified number of fractional digits
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<valeur de retour><return-value> nombrenumber Valeur de retour de l’entrée mise en forme à un nombre spécifié de chiffres fractionnaires et de paramètres régionaux spécifiésThe return value of the input formated at a specified number of fractional digits and a specified locale

Exemple 1Example 1

Cet exemple met en forme le n ° de trame 10,333 à 2 chiffres fractionnaires :This example formats ther number 10.333 to 2 fractional digits:

formatNumber(10.333, 2)

Et retourne la chaîne 10,33.And returns the string 10.33.

Exemple 2Example 2

Ces exemples mettent en forme des nombres sur un nombre spécifié de chiffres dans les paramètres régionaux en -US :These examples format numbers to a specified number of digits in the en-US locale:

formatNumber(12.123, 4, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')

Les résultats retournés sont respectivement :And return the following results respectively:

  • 12,1212.12
  • 1,551.55
  • 12,123012.1230

formatTicksformatTicks

Retourne un horodatage dans un format de paramètres régionaux facultatif dans le format spécifié à partir de graduations.Return a timestamp in an optional locale format in the specified format from ticks.

formatTicks('<ticks>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<epoch><epoch> OuiYes nombre (ou bigint en JavaScript)number (or bigint in Javascript) Nombre de cyclesThe ticks number
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<reformatted-timestamp><reformatted-timestamp> stringstring Horodatage mis à jour au format spécifiéThe updated timestamp in the specified format

Exemple 1Example 1

Cet exemple convertit les cycles au format spécifié :This example converts ticks to the specified format:

formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')

Et retourne le résultat 2020-05-06T11:47:00.000Z.And returns the result 2020-05-06T11:47:00.000Z.

Exemple 2Example 2

L’exemple suivant convertit les graduations au format spécifié dans la région de-de :This example converts ticks to the specified format in the de-DE locale:

formatTicks(637243624200000000, '', 'de-DE')

Et retourne le résultat 06.05.20 11:47:00.And returns the result 06.05.20 11:47:00.

getFutureTimegetFutureTime

Retourne l’horodatage actuel dans un format de paramètres régionaux facultatifs plus les unités de temps spécifiées.Return the current timestamp in an optional locale format plus the specified time units.

getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<interval><interval> OuiYes entierinteger Nombre d’unités de temps spécifiées à ajouterThe number of specific time units to add
<timeUnit><timeUnit> OuiYes stringstring Unité de temps à utiliser avec interval.The unit of time to use with interval. Unités possibles : « Second » (seconde), « Minute » (minute), « Hour » (heure), « Day » (jour), « Week » (semaine), « Month » (mois) et « Year » (année).Possible units are "Second", "Minute", "Hour", "Day", "Week", "Month", and "Year".
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage actuel plus nombre d’unités de temps spécifiéThe current timestamp plus the specified number of time units

Exemple 1Example 1

Supposons que le timestamp actuel soit 2019-03-01T00:00:00.000Z.Suppose the current timestamp is 2019-03-01T00:00:00.000Z. Dans cet exemple, cinq jours sont ajoutés à ce timestamp :The example below adds five days to that timestamp:

getFutureTime(2, 'Week')

Le résultat retourné est 2019-03-15T00:00:00.000Z.And returns the result 2019-03-15T00:00:00.000Z.

Exemple 2Example 2

Supposons que le timestamp actuel soit 2018-03-01T00:00:00.000Z.Suppose the current timestamp is 2018-03-01T00:00:00.000Z. Dans cet exemple, cinq jours sont ajoutés à ce timestamp et le résultat est converti au format MM-JJ-AA :The example below adds five days to the timestamp and converts the result to MM-DD-YY format:

getFutureTime(5, 'Day', 'MM-DD-YY')

Et retourne le résultat 03-06-18.And returns the result 03-06-18.

Exemple 3Example 3

Supposons que l’horodatage actuel soit 2020-05-01T00:00:00.000 z et que les paramètres régionaux sont de-de.Suppose the current timestamp is 2020-05-01T00:00:00.000Z and the locale is de-DE. L’exemple ci-dessous ajoute 1 jour à l’horodateur :The example below adds 1 day to the timestamp:

getFutureTime(1,'Day', '', 'de-DE')

Et retourne le résultat 02.05.20 00:00:00.And returns the result 02.05.20 00:00:00.

getNextViableDategetNextViableDate

Retourne la date viable suivante d’une expression Timex en fonction de la date actuelle et d’un TimeZone éventuellement spécifié.Return the next viable date of a timex expression based on the current date and an optionally specified timezone.

getNextViableDate(<timexString>, <timezone>?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timexString><timexString> OuiYes stringstring Chaîne Timex de la date à évaluer.The timex string of the date to evaluate.
<horaires><timezone> NonNo stringstring Fuseau horaire facultatif.The optional timezone.
Valeur retournéeReturn value TypeType DescriptionDescription
<nextViableTime><nextViableTime> stringstring Date viable suivante.The next viable date.

ExemplesExamples

Disons que la date est 2020-06-12 et que l’heure actuelle est 15:42:21.Say the date is 2020-06-12 and current time is 15:42:21.

Ces exemples évaluent la chaîne Timex pour la date viable suivante en fonction de la date et de l’heure ci-dessus :These examples evaluate the timex string for the next viable date based on the above date and time:

getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")

Et retournent respectivement les chaînes suivantes :And return the following strings respectively:

  • 2020-12-202020-12-20
  • 2024-02-292024-02-29

getNextViableTimegetNextViableTime

Retourne l’heure viable suivante d’une expression Timex en fonction de l’heure actuelle et d’un TimeZone éventuellement spécifié.Return the next viable time of a timex expression based on the current time and an optionally specified timezone.

getNextViableTime(<timexString>, <timezone>?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timexString><timexString> OuiYes stringstring Chaîne Timex du temps à évaluer.The timex string of the time to evaluate.
<horaires><timezone> NonNo stringstring Fuseau horaire facultatif.The optional timezone.
Valeur retournéeReturn value TypeType DescriptionDescription
<nextViableTime><nextViableTime> stringstring Heure viable suivante.The next viable time.

ExemplesExamples

Disons que la date est 2020-06-12 et que l’heure actuelle est 15:42:21.Say the date is 2020-06-12 and current time is 15:42:21.

Ces exemples évaluent une Timex String pour l’heure viable suivante en fonction de la date et de l’heure ci-dessus :These examples evaluate a timex string for the next viable time based on the above date and time:

getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")

Et retournent les chaînes suivantes repsectively :And return the following strings repsectively:

  • T16:12:14T16:12:14
  • T15:52:14T15:52:14

getPastTimegetPastTime

Retourne l’horodatage actuel moins les unités de temps spécifiées.Return the current timestamp minus the specified time units.

getPastTime(<interval>, <timeUnit>, '<format>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<interval><interval> OuiYes entierinteger Nombre d’unités de temps spécifiées à soustraireThe number of specific time units to substract
<timeUnit><timeUnit> OuiYes stringstring Unité de temps à utiliser avec interval.The unit of time to use with interval. Unités possibles : « Second » (seconde), « Minute » (minute), « Hour » (heure), « Day » (jour), « Week » (semaine), « Month » (mois) et « Year » (année).Possible units are "Second", "Minute", "Hour", "Day", "Week", "Month", and "Year".
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage actuel moins nombre d’unités de temps spécifiéThe current timestamp minus the specified number of time units

Exemple 1Example 1

Supposons que le timestamp actuel soit 2018-02-01T00:00:00.000Z.Suppose the current timestamp is 2018-02-01T00:00:00.000Z. Cet exemple illustre le retrait de cinq jours de cet horodatage :This example subtracts five days from that timestamp:

getPastTime(5, 'Day')

Le résultat retourné est 2019-01-27T00:00:00.000Z.And returns the result 2019-01-27T00:00:00.000Z.

Exemple 2Example 2

Supposons que le timestamp actuel soit 2018-03-01T00:00:00.000Z.Suppose the current timestamp is 2018-03-01T00:00:00.000Z. Cet exemple soustrait cinq jours à l’horodateur au format mm-jj-aa :This example subtracts five days to the timestamp in the MM-DD-YY format:

getPastTime(5, 'Day', 'MM-DD-YY')

Et retourne le résultat 02-26-18.And returns the result 02-26-18.

Exemple 3Example 3

Supposons que l’horodatage actuel soit 2020-05-01T00:00:00.000 z et que les paramètres régionaux sont de-de.Suppose the current timestamp is 2020-05-01T00:00:00.000Z and the locale is de-DE. L’exemple ci-dessous soustrait 1 jour de l’horodateur :The example below subtracts 1 day from the timestamp:

getPastTime(1,'Day', '', 'de-DE')

Et retourne le résultat 31.04.20 00:00:00.And returns the result 31.04.20 00:00:00.

getPreviousViableDategetPreviousViableDate

Retourne la date viable précédente d’une expression Timex en fonction de la date actuelle et d’un fuseau horaire facultatif spécifié.Return the previous viable date of a timex expression based on the current date and an optionally specified timezone.

getPreviousViableDate(<timexString>, <timezone>?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timexString><timexString> OuiYes stringstring Chaîne Timex de la date à évaluer.The timex string of the date to evaluate.
<horaires><timezone> NonNo stringstring Fuseau horaire facultatif.The optional timezone.
Valeur retournéeReturn value TypeType DescriptionDescription
<previousViableDate><previousViableDate> stringstring Date viable précédente.The previous viable date.

ExemplesExamples

Disons que la date est 2020-06-12 et que l’heure actuelle est 15:42:21.Say the date is 2020-06-12 and current time is 15:42:21.

Ces exemples évaluent une Timex String pour la date viable précédente en fonction de la date et de l’heure ci-dessus :These examples evaluate a timex string for the previous viable date based on the above date and time:

getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")

Et retournent les chaînes suivantes repsectively :And return the following strings repsectively:

  • 2019-12-202019-12-20
  • 2020-02-292020-02-29

getPreviousViableTimegetPreviousViableTime

Retourne l’heure viable précédente d’une expression Timex en fonction de la date actuelle et d’un TimeZone éventuellement spécifié.Return the previous viable time of a timex expression based on the current date and an optionally specified timezone.

getPreviousViableTime(<timexString>, <timezone>?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timexString><timexString> OuiYes stringstring Chaîne Timex du temps à évaluer.The timex string of the time to evaluate.
<horaires><timezone> NonNo stringstring Fuseau horaire facultatif.The optional timezone.
Valeur retournéeReturn value TypeType DescriptionDescription
<previousViableTime><previousViableTime> stringstring Heure viable précédente.The previous viable time.

ExemplesExamples

Disons que la date est 2020-06-12 et que l’heure actuelle est 15:42:21.Say the date is 2020-06-12 and current time is 15:42:21.

Ces exemples évaluent une Timex String pour l’heure viable précédente en fonction de la date et de l’heure ci-dessus :These examples evaluate a timex string for the previous viable time based on the above date and time:

getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')

Et retournent les chaînes suivantes repsectively :And return the following strings repsectively:

  • T14:52:14T14:52:14
  • T15:12:14T15:12:14

getPropertygetProperty

Retourne la valeur d’une propriété spécifiée ou la propriété racine à partir d’un objet JSON.Return the value of a specified property or the root property from a JSON object.

Retourne la valeur d’une propriété spécifiéeReturn the value of a specified property

getProperty(<JSONObject>, '<propertyName>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<JSONObject><JSONObject> OuiYes objectobject Objet JSON contenant la propriété et les valeurs.The JSON object containing the property and values.
<propertyName><propertyName> NonNo stringstring Nom de la propriété facultative à partir de laquelle accéder les valeurs.The name of the optional property to access values from.
Valeur retournéeReturn value TypeType DescriptionDescription
valuevalue stringstring Valeur de la propriété spécifiée dans l’objet JSON.The value of the specified property in the JSON object.

ExempleExample

Imaginons que vous ayez l’objet JSON suivant :Say you have the following JSON object:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

L’exemple suivant extrait une propriété spécifiée de l’objet JSON ci-dessus :These example retrieve a specified property from the above JSON object:

getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')

Et retournent respectivement les chaînes suivantes :And return the following strings respectively:

  • valeur a :ba:b value
  • touche dd key

Retourner la propriété racineReturn the root property

getProperty('<propertyName>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<propertyName><propertyName> OuiYes stringstring Nom de la propriété facultative permettant d’accéder aux valeurs de la portée de la mémoire racine.The name of the optional property to access values from the root memory scope.
Valeur retournéeReturn value TypeType DescriptionDescription
valuevalue stringstring Valeur de la propriété racine dans un objet JSON.The value of the root property in a JSON object.

ExempleExample

Imaginons que vous ayez l’objet JSON suivant :Say you have the following JSON object:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

Cet exemple récupère la propriété racine de l’objet JSON ci-dessus :This example retrieves the root property from the above JSON object:

getProperty("a:b")

Et retourne la valeur de la chaîne a :b.And returns the string a:b value.

getTimeOfDaygetTimeOfDay

Retourne l’heure de la journée du timestamp donné.Returns time of day for a given timestamp.

getTimeOfDay('<timestamp>')

L’heure retournée est l’une des chaînes suivantes :Time returned is one of the following strings:

ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne contenant le timestamp spécifiéThe string that contains the specified timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<time-of-day><time-of-day> stringstring Heure de la journée du timestamp spécifiéThe time of day for the specified timestamp

Voici la liste des chaînes associées à l’heure de la journée :Listed below are the strings associated with the time of day:

Heure de la journéeTime of day TimestampTimestamp
midnightmidnight 00:0012AM
matinmorning 00:01 – 23:5912:01AM – 11:59PM
afternoonafternoon 12:0012PM
eveningevening 18:00 – 22:0006:00PM – 10:00PM
nuitnight 22:01 – 23:5910:01PM – 11:59PM

ExempleExample

getTimeOfDay('2018-03-15T08:00:00.000Z')

Le résultat retourné est morning.Returns the result morning.

greatergreater

Vérifie si la première valeur est supérieure à la seconde.Check whether the first value is greater than the second value. Retourne true si la première valeur est supérieure, false si elle est inférieure.Return true if the first value is more, or return false if less.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes Entier, flottant ou chaîneinteger, float, or string Première valeur à vérifier pour déterminer si elle est supérieure à la secondeThe first value to check whether greater than the second value
<compareTo><compareTo> OuiYes Respectivement entier, flottant ou chaîneinteger, float, or string, respectively Valeur de comparaisonThe comparison value
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si la première valeur est supérieure à la seconde.Return true if the first value is greater than the second value. Retourne false si la première valeur est inférieure ou égale à la seconde.Return false if the first value is equal to or less than the second value.

ExempleExample

Ces exemples vérifient si la première valeur est supérieure à la seconde :These examples check whether the first value is greater than the second value:

greater(10, 5)
greater('apple', 'banana')

Les résultats retournés sont respectivement :And return the following results respectively:

  • true
  • false

greaterOrEqualsgreaterOrEquals

Vérifie si la première valeur est supérieure ou égale à la seconde.Check whether the first value is greater than or equal to the second value. Retourne true si la première valeur est supérieure ou égale, false si elle est inférieure.Return true when the first value is greater or equal, or return false if the first value is less.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes Entier, flottant ou chaîneinteger, float, or string Première valeur à vérifier pour déterminer si elle est supérieure ou égale à la secondeThe first value to check whether greater than or equal to the second value
<compareTo><compareTo> OuiYes Respectivement entier, flottant ou chaîneinteger, float, or string, respectively Valeur de comparaisonThe comparison value
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si la première valeur est supérieure ou égale à la seconde.Return true if the first value is greater than or equal to the second value. Retourne false si la première valeur est inférieure à la seconde.Return false if the first value is less than the second value.

ExempleExample

Ces exemples vérifient si la première valeur est supérieure ou égale à la seconde :These examples check whether the first value is greater or equal than the second value:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Les résultats retournés sont respectivement :And return the following results respectively:

  • true
  • false

ifif

Vérifie si une expression est vraie ou fausse.Check whether an expression is true or false. En fonction du résultat, retourne une valeur spécifiée.Based on the result, return a specified value.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<expression><expression> OuiYes BooleanBoolean Expression à vérifierThe expression to check
<valueIfTrue><valueIfTrue> OuiYes n'importe laquelleany Valeur à retourner si l’expression est vraieThe value to return if the expression is true
<valueIfFalse><valueIfFalse> OuiYes n'importe laquelleany Valeur à retourner si l’expression est fausseThe value to return if the expression is false
Valeur retournéeReturn value TypeType DescriptionDescription
<specified-return-value><specified-return-value> n'importe laquelleany Valeur spécifiée retournée selon que l’expression est true ou falseThe specified value that returns based on whether the expression is true or false

ExempleExample

Dans cet exemple, la vérité de equals(1,1) est évaluée :This example evaluates whether equals(1,1) is true:

if(equals(1, 1), 'yes', 'no')

Le résultat est yes, car l’expression spécifiée retourne true.And returns yes because the specified expression returns true. Sinon, l’exemple retourne no.Otherwise, the example returns no.

indexOfindexOf

Retourne la position ou la valeur d’index de départ d’une sous-chaîne.Return the starting position or index value of a substring. Cette fonction ne respecte pas la casse, et les index commencent par le chiffre 0.This function is case-insensitive, and indexes start with the number 0.

indexOf('<text>', '<searchText>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes chaîne ou tableaustring or array Chaîne comportant la sous-chaîne à rechercherThe string that has the substring to find
<searchText><searchText> OuiYes stringstring Sous-chaîne à rechercherThe substring to find
Valeur retournéeReturn value TypeType DescriptionDescription
<index-value><index-value> entierinteger Position ou valeur d’index de départ de la sous-chaîne spécifiée.The starting position or index value of the specified substring.
Si la chaîne est introuvable, retourne le chiffre -1.If the string is not found, return the number -1.

Exemple 1Example 1

Dans cet exemple, la valeur d’index de départ de la sous-chaîne world est recherchée dans la chaîne hello world :This example finds the starting index value of the substring world in the string hello world:

indexOf('hello world', 'world')

Le résultat retourné est 6.And returns the result 6.

Exemple 2Example 2

Dans cet exemple, la valeur d’index de départ de la sous-chaîne def est recherchée dans le tableau ['abc', 'def', 'ghi'] :This example finds the starting index value of the substring def in the array ['abc', 'def', 'ghi']:

indexOf(createArray('abc', 'def', 'ghi'), 'def')

Le résultat retourné est 1.And returns the result 1.

indicesAndValuesindicesAndValues

Transforme un tableau ou un objet en tableau d’objets avec la propriété d’index (actuel) et de valeur.Turn an array or object into an array of objects with index (current index) and value properties. Pour les tableaux, l’index correspond à la position dans le tableau.For arrays, the index is the position in the array. Pour les objets, il s’agit de la clé de la valeur.For objects, it is the key for the value.

indicesAndValues('<collection or object>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection or object><collection or object> OuiYes objet ou tableauarray or object Tableau ou objet d’origineOriginal array or object
Valeur retournéeReturn value TypeType DescriptionDescription
<collection><collection> tableauarray Nouveau tableau.New array. Chaque élément possède deux propriétés : l’index avec la position dans un tableau ou la clé d’un objet ainsi que la valeur correspondante.Each item has two properties: the index with the position in an array or the key for an object, and the corresponding value.

Exemple 1Example 1

Prenons la liste { items: ["zero", "one", "two"] } .Say you have a list { items: ["zero", "one", "two"] }. La fonction suivante prend cette liste :The following function takes that list:

indicesAndValues(items)

Et en retourne une nouvelle :And returns a new list:

[
  {
    index: 0,
    value: 'zero'
  },
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Exemple 2Example 2

Prenons la liste { items: ["zero", "one", "two"] } .Say you have a list { items: ["zero", "one", "two"] }. La fonction suivante prend cette liste :The following function takes that list:

where(indicesAndValues(items), elt, elt.index >= 1)

Et en retourne une nouvelle :And returns a new list:

[
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Exemple 3Example 3

Prenons la liste { items: ["zero", "one", "two"] } .Say you have a list { items: ["zero", "one", "two"] }. La fonction suivante prend cette liste :The following function takes that list:

join(foreach(indicesAndValues(items), item, item.value), ',')

Le résultat retourné est zero,one,two.And returns the result zero,one,two. Cette expression a le même effet que join(items, ',').This expression has the same effect as join(items, ',').

Exemple 4Example 4

Prenons l’objet { user: {name: 'jack', age: 20} } .Say you have an object { user: {name: 'jack', age: 20} }. La fonction suivante prend cet objet :The following function takes that object:

indicesAndValues(user)

Elle retourne un nouvel objet :And returns a new object:

[
  {
    index: 'name',
    value: 'jack'
  },
  {
    index: 'age',
    value: 20
  }
]

intint

Retourne la version entière d’une chaîne.Return the integer version of a string. Une exception est levée si la chaîne ne peut pas être convertie en entier.An exception will be thrown if the string cannot be converted to an integer.

int('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne à convertirThe string to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<integer-result><integer-result> entierinteger Version entière de la chaîne spécifiéeThe integer version of the specified string

ExempleExample

Dans cet exemple, une version entière de la chaîne 10 est créée :This example creates an integer version for the string 10:

int('10')

Le résultat retourné est l’entier 10.And returns the result as the integer 10.

intersectionintersection

Retourne une collection contenant uniquement les éléments communs aux collections spécifiées.Return a collection that has only the common items across the specified collections. Pour qu’il apparaisse dans le résultat, un élément doit apparaître dans toutes les collections transmises à cette fonction.To appear in the result, an item must appear in all the collections passed to this function. Si un ou plusieurs éléments portent le même nom, le dernier élément de ce nom apparaît dans le résultat.If one or more items have the same name, the last item with that name appears in the result.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection1>, <collection2><collection1>, <collection2> OuiYes Tableau ou objet, mais pas les deuxarray or object, but not both Collections dont les éléments communs uniquement sont récupérésThe collections from which you want only the common items
Valeur retournéeReturn value TypeType DescriptionDescription
<common-items><common-items> Respectivement tableau ou objetarray or object, respectively Collection qui contient uniquement les éléments communs aux collections spécifiéesA collection that has only the common items across the specified collections

ExempleExample

Dans cet exemple, les éléments communs aux tableaux suivants sont recherchés :This example finds the common items across the following arrays:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Un tableau comportant uniquement les éléments [1, 2] est retourné.And returns an array with only the items [1, 2].

isArrayisArray

Retourne true si une entrée donnée est un tableau.Return true if a given input is an array.

isArray('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une entrée donnée est un tableau, false sinon.Return true if a given input is an array, or return false if it is not an array.

ExemplesExamples

Dans ces exemples, l’entrée est examinée pour savoir s’il s’agit d’un tableau :The following examples check if the input is an array:

isArray('hello')
isArray(createArray('hello', 'world'))

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne false.The input is a string, so the function returns false.
  • Comme l’entrée est un tableau, la fonction retourne true.The input is an array, so the function returns true.

isBooleanisBoolean

Retourne true si une entrée donnée est un booléen.Return true if a given input is a Boolean.

isBoolean('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une entrée donnée est un booléen, false sinon.Return true if a given input is a Boolean, or return false if it not a Boolean.

ExemplesExamples

Dans ces exemples, l’entrée est examinée pour savoir s’il s’agit d’un booléen :The following examples check if the input is a Boolean:

isBoolean('hello')
isBoolean(32 > 16)

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne false.The input is a string, so the function returns false.
  • Comme l’entrée est un booléen, la fonction retourne true.The input is a Boolean, so the function returns true.

isDateisDate

Retourne true si une expression TimexProperty ou Timex donnée fait référence à une date valide.Return true if a given TimexProperty or Timex expression refers to a valid date. Les dates valides contiennent le mois et le jour du mois (dayOfMonth), ou bien le jour de la semaine (dayOfWeek).Valid dates contain the month and dayOfMonth, or contain the dayOfWeek.

isDate('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaînebbject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object or a Timex expression string.
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée fait référence à une date valide, false si la date n’est pas valide.Return true if the input refers to a valid date, or return false if the date is invalid.

ExemplesExamples

Dans ces exemples, les entrées suivantes sont examinées pour savoir s’il s’agit de dates valides :These examples check if the following inputs are valid dates:

isDate('2020-12')
isDate('xxxx-12-21')

Les résultats retournés sont les suivants :And return the following results:

  • false
  • true

isDateRangeisDateRange

Retourne true si une expression TimexProperty ou Timex donnée fait référence à une plage de dates valide.Return true if a given TimexProperty or Timex expression refers to a valid date range.

isDateRange('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaîneobject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object a Timex expression string.
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée donnée fait référence à une plage de dates valide, false sinon.Return true if given input refers to a valid date range, or return false if it is not a valid date range.

ExemplesExamples

Dans ces exemples, l’entrée suivante est examinée pour savoir s’il s’agit d’une plage de dates valide :These examples check if the following input is a valid date range:

isDateRange('PT30M')
isDateRange('2012-02')

Les résultats retournés sont les suivants :And return the following results:

  • false
  • true

isDateTimeisDateTime

Retourne true si une entrée donnée est une chaîne de timestamp au format ISO UTC (AAAA-MM-JJTHH:mm:ss.fffZ).Return true if a given input is a UTC ISO format (YYYY-MM-DDTHH:mm:ss.fffZ) timestamp string.

isDateTime('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une entrée donnée est une chaîne de timestamp au format ISO UTC, false sinon.Return true if a given input is a UTC ISO format timestamp string, or return false if it is not a UTC ISO format timestamp string.

ExemplesExamples

Dans ces exemples, l’entrée est examinée pour savoir s’il s’agit d’une chaîne au format ISO UTC :The following examples check if the input is a UTC ISO format string:

isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne false.The input is a string, so the function returns false.
  • Comme l’entrée est une chaîne au format ISO UTC, la fonction retourne true.The input is a UTC ISO format string, so the function returns true.

isDefiniteisDefinite

Retourne true si une expression TimexProperty ou Timex donnée fait référence à une date valide.Return true if a given TimexProperty or Timex expression refers to a valid date. Les dates valides contiennent l’année, le mois et le jour du mois (dayOfMonth).Valid dates contain the year, month and dayOfMonth.

isDefinite('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaîneobject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object a Timex expression string.
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée donnée fait référence à une date complète valide, false sinon.Return true if the given input refers to a valid full date, or return false if it does not refere to a valid full date.

ExemplesExamples

Prenons un objet TimexProperty validFullDate = new TimexProperty("2020-02-20") , avec la propriété Now définie sur true.Suppose there is a TimexProperty object validFullDate = new TimexProperty("2020-02-20") and the Now property is set to true. Dans ces exemples, l’objet est examiné pour savoir s’il fait référence à une date complète valide :The following examples check if the object refers a valid full date:

isDefinite('xxxx-12-21')
isDefinite(validFullDate)

Les résultats retournés sont respectivement :And return the following results respectively:

  • false
  • true

isDurationisDuration

Retourne true si une expression TimexProperty ou Timex donnée fait référence à une durée valide.Return true if a given TimexProperty or Timex expression refers to a valid duration.

isDuration('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaîneobject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object a Timex expression string.
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée fait référence à une durée valide, false sinon.Return true if the input refers to a valid duration, or return false if the input doesn't refer to a valid duration.

ExemplesExamples

Dans ces exemples, l’entrée suivante est examinée pour savoir si elle fait référence à une durée valide :The examples below check if the following input refers to a valid duration:

isDuration('PT30M')
isDuration('2012-02')

Les résultats retournés sont respectivement :And return the following results respectively:

  • true
  • false

isFloatisFloat

Retourne true si une entrée donnée est un nombre à virgule flottante.Return true if a given input is a floating-point number. En raison de l’alignement entre C# et JavaScript, un nombre dont le reste du modulo 1 est différent de zéro est traité comme un nombre à virgule flottante.Due to the alignment between C#and JavaScript, a number with an non-zero residue of its modulo 1 will be treated as a floating-point number.

isFloat('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une entrée donnée est un nombre à virgule flottante, false sinon.Return true if a given input is a floating-point number, or return false if the input is not a floating-point number.

ExemplesExamples

Dans ces exemples, l’entrée est examinée pour savoir s’il s’agit d’un nombre à virgule flottante :The following examples check if the input is a floating-point number:

isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne false.The input is a string, so the function returns false.
  • Comme l’entrée a un modulo égal à 0, la fonction retourne false.The input has a modulo that equals 0, so the function returns false.
  • Comme l’entrée est un nombre à virgule flottante, la fonction retourne true.The input is a floating-point number, so the function returns true.

isIntegerisInteger

Retourne true si une entrée donnée est un nombre entier.Return true if a given input is an integer number. En raison de l’alignement entre C# et JavaScript, un nombre dont le reste du modulo 1 est égal à zéro est traité comme un nombre entier.Due to the alignment between C# and JavaScript, a number with an zero residue of its modulo 1 will be treated as an integer number.

isInteger('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si l’entrée est un nombre entier.Is the input is an integer number

ExemplesExamples

Dans ces exemples, l’entrée est examinée pour savoir s’il s’agit d’un entier :The following examples check if the input is an integer:

isInteger('hello world!')
isInteger(1.0)
isInteger(12)

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne false.The input is a string, so the function returns false.
  • Comme l’entrée a un modulo égal à 0, la fonction retourne true.The input has a modulo that equals 0, so the function returns true.
  • Comme l’entrée est un entier, la fonction retourne true.The input is an integer, so the function returns true.

isMatchisMatch

Retourne true si une chaîne donnée correspond à un modèle d’expression régulière spécifié.Return true if a given string is matches a specified regular expression pattern.

isMatch('<target**string>', '<pattern>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<target**string><target**string> OuiYes stringstring Chaîne de correspondanceThe string to be matched
<pattern><pattern> OuiYes stringstring Modèle d’expression régulièreA regular expression pattern
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une chaîne donnée correspond à un modèle d’expression régulière courant, false sinon.Return true if a given string is matches a common regular expression pattern, or return false if it does not match the pattern.

ExemplesExamples

Dans ces exemples, l'entrée est examinée pour savoir si elle correspond au modèle d'expression régulière spécifié :The following examples check if the input matches the specified regular expression pattern:

isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')

Le résultat retourné est true dans tous les cas.And return the same result true.

isObjectisObject

Retourne true si une entrée donnée est un objet complexe, false s’il s’agit d’un objet primitif.Return true if a given input is a complex object or return false if it is a primitive object. Les objets primitifs sont notamment les chaînes, les nombres et les booléens. Les types complexes, comme les classes, contiennent des propriétés.Primitive objects include strings, numbers, and Booleans; complex types, like classes, contain properties.

isObject('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une entrée donnée est un objet complexe, false s’il s’agit d’un objet primitif.Return true if a given input is a complex object, or return false if it is a primitive object.

ExemplesExamples

Dans ces exemples, l’entrée donnée est examinée pour savoir s’il s’agit d’un objet :The following examples check if the given input is an object:

isObject('hello world!')
isObject({userName: "Sam"})

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne false.The input is a string, so the function returns false.
  • Comme l’entrée est un objet, la fonction retourne true.The input is an object, so the function returns true.

isPresentisPresent

Retourne true si une expression TimexProperty ou Timex donnée fait référence au moment présent.Return true if a given TimexProperty or Timex expression refers to the present.

isPresent('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaîneobject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object a Timex expression string
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée fait référence au moment présent, false sinon.Return true if the input refers to the present, or return false if it doesn't refere to the present.

Exemples Prenons un objet TimexProperty validNow = new TimexProperty() { Now = true } , avec la propriété Now définie sur true.Examples Suppose we have an TimexProperty object validNow = new TimexProperty() { Now = true } and set the Now property to true. Dans ces exemples, l’entrée suivante est examinée pour savoir si elle fait référence au moment présent :The examples below check if the following input refers to the present:

isPresent('PT30M')
isPresent(validNow)

Les résultats retournés sont respectivement :And return the following results respectively:

  • false
  • true

isStringisString

Retourne true si une entrée donnée est une chaîne.Return true if a given input is a string.

isString('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes n'importe laquelleany Entrée à testerThe input to be tested
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><Boolean-result> BooleanBoolean Retourne true si une entrée donnée est une chaîne, false sinon.Return true if a given input is a string, or return false if not a string.

ExemplesExamples

Dans ces exemples, l’entrée donnée est examinée pour savoir s’il s’agit d’une chaîne :The following examples check if the given input is a string:

isString('hello world!')
isString(3.14)

Les résultats retournés sont respectivement :And return the following results respectively:

  • Comme l’entrée est une chaîne, la fonction retourne true.The input is a string, so the function returns true.
  • Comme l’entrée est un flottant, la fonction retourne false.The input is a float, so the function returns false.

isTimeisTime

Retourne true si une expression TimexProperty ou Timex donnée fait référence à une heure valide.Return true if a given TimexProperty or Timex expression refers to a valid time. L’heure valide comporte des heures, des minutes et des secondes.Valid time contains hours, minutes and seconds.

isTime('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaîneobject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object a Timex expression string
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée fait référence à une heure valide, false sinon.Return true if the input refers to a valid time, or return false if it doesn't refer to a valid time..

ExemplesExamples

Dans ces exemples, l’entrée suivante est examinée pour savoir si elle fait référence à une heure valide :These examples check if the following input referes to a valid time:

isTime('PT30M')
isTime('2012-02-21T12:30:45')

Les résultats retournés sont respectivement :And return the following results respectively:

  • false
  • true

isTimeRangeisTimeRange

Retourne true si une expression TimexProperty ou Timex donnée fait référence à un intervalle de temps valide. Les intervalles de temps valides contiennent un moment de la journée (partOfDay).Return true if a given TimexProperty or Timex expression refers to a valid time range Valid time ranges contain partOfDay.

isTime('<input>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<input><input> OuiYes Objet ou chaîneobject or string Objet TimexProperty ou chaîne d’expression Timex d’entréeThe input TimexProperty object a Timex expression string.
Valeur retournéeReturn value TypeType DescriptionDescription
<Boolean-result><boolean-result> BooleanBoolean Retourne true si l’entrée fait référence à un intervalle de temps valide, false sinon.Return true if the input refers to a valid time range, or return false if it doesn't refer to a valid time range.

ExemplesExamples

Prenons un objet TimexProperty validTimeRange = new TimexProperty() { PartOfDay = "morning" } , avec la propriété Now définie sur true.Suppose we have an TimexProperty object validTimeRange = new TimexProperty() { PartOfDay = "morning" } and set the Now property to true. Dans ces exemples, les entrées suivantes sont examinées pour savoir s’il s’agit d’intervalles de temps valides :These examples check if the following inputs are valid time ranges:

isTimeRange('PT30M')
isTimeRange(validTimeRange)

Les résultats retournés sont respectivement :And return the following results respectively:

  • false
  • true

joinjoin

Retourne une chaîne contenant tous les éléments d’un tableau, dont les caractères sont séparés par un délimiteur.Return a string that has all the items from an array, with each character separated by a delimiter.

join([<collection>], '<delimiter>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes tableauarray Tableau qui comporte les éléments à joindreThe array that has the items to join
<delimiter><delimiter> OuiYes stringstring Séparateur affiché entre chaque caractère de la chaîne obtenueThe separator that appears between each character in the resulting string
Valeur retournéeReturn value TypeType DescriptionDescription
<char1><delimiter><char2><delimiter>...<char1><delimiter><char2><delimiter>... stringstring Chaîne obtenue créée à partir de tous les éléments du tableau spécifiéThe resulting string created from all the items in the specified array

ExempleExample

Dans cet exemple, une chaîne est créée à partir de tous les éléments de ce tableau avec le caractère spécifié ( . )This example creates a string from all the items in this array with the specified character . comme délimiteur :as the delimiter:

join(createArray('a', 'b', 'c'), '.')

Le résultat retourné est a.b.c.And returns the result a.b.c.

jPathjPath

Vérifie si les nœuds ou les valeurs d’un code ou d’une chaîne JSON correspondent à une expression de chemin, et retourne les nœuds correspondants.Check JSON or a JSON string for nodes or values that match a path expression, and return the matching nodes.

jPath(<json>, '<path>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<json><json> OuiYes n'importe laquelleany Objet JSON ou chaîne dans lequel sont recherchés des nœuds ou des valeurs qui correspondent à la valeur de l’expression de cheminThe JSON object or string to search for nodes or values that match the path expression value
<path><path> OuiYes n'importe laquelleany Expression de chemin utilisée pour rechercher des nœuds JSON ou des valeurs correspondantsThe path expression used to find matching JSONnodes or values
Valeur retournéeReturn value TypeType DescriptionDescription
[ <json-node>][ <json-node>] tableauarray Liste de nœuds JSON ou de valeurs qui correspond à l’expression de chemin spécifiéeAn list of JSON nodes or value that matches the specified path expression

Exemple C#C# Example

Prenons le JSON suivant :Say you have the following JSON:

{
    "Stores": [
        "Lambton Quay",
        "Willis Street"
    ],
    "Manufacturers": [
        {
            "Name": "Acme Co",
            "Products": [
                {
                    "Name": "Anvil",
                    "Price": 50
                }
            ]
        },
        {
            "Name": "Contoso",
            "Products": [
                {
                    "Name": "Elbow Grease",
                    "Price": 99.95
                },
                {
                    "Name": "Headlight Fluid",
                    "Price": 4
                }
            ]
        }
    ]
}

L’expression de chemin est $..Products[?(@.Price >= 50)].Name.The path expression is $..Products[?(@.Price >= 50)].Name

jPath(jsonStr, path)

Le résultat retourné est ["Anvil", "Elbow Grease"] .And it returns the result ["Anvil", "Elbow Grease"].

Exemple JavaScriptJavascript Example

Prenons le JSON suivant :Say you have the following JSON:

{
    "automobiles": [
        {
            "maker": "Nissan",
            "model": "Teana",
            "year": 2011
        },
        {
            "maker": "Honda",
            "model": "Jazz",
            "year": 2010
        },
        {
            "maker": "Honda",
            "model": "Civic",
            "year": 2007
        },
        {
            "maker": "Toyota",
            "model": "Yaris",
            "year": 2008
        },
        {
            "maker": "Honda",
            "model": "Accord",
            "year": 2011
        }
    ],
    "motorcycles": [
        {
            "maker": "Honda",
            "model": "ST1300",
            "year": 2012
        }
    ]
}

L’expression de chemin est .automobiles{.maker === "Honda" && .year > 2009}.model.The path expression is .automobiles{.maker === "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

Le résultat retourné est ['Jazz', 'Accord'] .And it returns the result ['Jazz', 'Accord'].

jsonjson

Retourne la valeur ou l’objet de type JavaScript Object Notation (JSON) d’une chaîne ou d’un élément XML.Return the JavaScript Object Notation (JSON) type value or object of a string or XML.

json('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes Chaîne ou élément XMLstring or XML Chaîne ou élément XML à convertirThe string or XML to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<JSON-result><JSON-result> stringstring Objet JSON résultant créé à partir de la chaîne ou du XML spécifié.The resulting JSON object created from the specified string or XML.

Exemple 1Example 1

Dans cet exemple, une chaîne est convertie au format JSON :This example converts a string to JSON:

json('{"fullName": "Sophia Owen"}')

Le résultat retourné est :And returns the result:

{
  "fullName": "Sophia Owen"
}

Exemple 2Example 2

Dans cet exemple, un élément XML est converti au format JSON :This example converts XML to JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

Le résultat retourné est :And returns the result:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

lastlast

Retourne le dernier élément d’une collection.Return the last item from a collection.

last('<collection>')
last([<collection>])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes chaîne ou tableaustring or array Collection dans laquelle est recherché le dernier élémentThe collection in which to find the last item
Valeur retournéeReturn value TypeType DescriptionDescription
<last-collection-item><last-collection-item> Respectivement chaîne ou tableaustring or array, respectively Dernier élément de la collectionThe last item in the collection

ExempleExample

Ces exemples illustrent la recherche du dernier élément dans ces collections :These examples find the last item in these collections:

last('abcd')
last(createArray(0, 1, 2, 3))

Les résultats retournés sont respectivement :And returns the following results respectively:

  • dd
  • 33

lastIndexOflastIndexOf

Retourne la position ou la valeur d’index de départ de la dernière occurrence d’une sous-chaîne.Return the starting position or index value of the last occurrence of a substring. Cette fonction ne respecte pas la casse, et les index commencent par le chiffre 0.This function is case-insensitive, and indexes start with the number 0.

lastIndexOf('<text>', '<searchText>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes chaîne ou tableaustring or array Chaîne comportant la sous-chaîne à rechercherThe string that has the substring to find
<searchText><searchText> OuiYes stringstring Sous-chaîne à rechercherThe substring to find
Valeur retournéeReturn value TypeType DescriptionDescription
<ending-index-value><ending-index-value> entierinteger Position ou valeur d’index de départ de la dernière occurrence de la sous-chaîne spécifiée.The starting position or index value of the last occurrence of the specified substring. Si la chaîne est introuvable, retourne le chiffre -1.If the string is not found, return the number -1.

Exemple 1Example 1

Dans cet exemple, la valeur d’index de départ de la dernière occurrence de la sous-chaîne world est recherchée dans la chaîne hello world :This example finds the starting index value of the last occurrence of the substring world in the hello world string:

lastIndexOf('hello world', 'world')

Le résultat retourné est 6.And returns the result 6.

Exemple 2Example 2

Dans cet exemple, la valeur d’index de départ de la dernière occurrence de la sous-chaîne def est recherchée dans le tableau ['abc', 'def', 'ghi', 'def'] .This example finds the starting index value of the last occurrence of substring def in the array ['abc', 'def', 'ghi', 'def'].

lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')

Le résultat retourné est 3.And returns the result 3.

lengthlength

Retourne la longueur d'une chaîne.Return the length of a string.

length('<str>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<str><str> OuiYes stringstring Chaîne dont la longueur doit être calculéeThe string to calculate for length
Valeur retournéeReturn value TypeType DescriptionDescription
<length><length> entierinteger Longueur de cette chaîneThe length of this string

ExemplesExamples

Dans ces exemples, la longueur des chaînes est calculée :These examples get the length of strings:

length('hello')
length('hello world')

Les résultats retournés sont respectivement :And returns the following results respectively:

  • 55
  • 1111

lessless

Vérifie si la première valeur est inférieure à la seconde.Check whether the first value is less than the second value. Retourne true si la première valeur est inférieure, false si elle est supérieure.Return true if the first value is less, or return false if the first value is more.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes Entier, flottant ou chaîneinteger, float, or string Première valeur à vérifier pour déterminer si elle est inférieure à la secondeThe first value to check whether less than the second value
<compareTo><compareTo> OuiYes Respectivement entier, flottant ou chaîneinteger, float, or string, respectively Élément de comparaisonThe comparison item
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si la première valeur est inférieure à la seconde.Return true if the first value is less than the second value. Retourne false si la première valeur est supérieure ou égale à la seconde.Return false if the first value is equal to or greater than the second value.

ExemplesExamples

Ces exemples vérifient si la première valeur est inférieure à la seconde.These examples check whether the first value is less than the second value.

less(5, 10)
less('banana', 'apple')

Les résultats retournés sont respectivement :And return the following results respectively:

  • true
  • false

lessOrEqualslessOrEquals

Vérifie si la première valeur est inférieure ou égale à la seconde.Check whether the first value is less than or equal to the second value. Retourne true si la première valeur est inférieure ou égale, false si elle est supérieure.Return true if the first value is less than or equal, or return false if the first value is more.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes Entier, flottant ou chaîneinteger, float, or string Première valeur à vérifier pour déterminer si elle est inférieure ou égale à la secondeThe first value to check whether less than or equal to the second value
<compareTo><compareTo> OuiYes Respectivement entier, flottant ou chaîneinteger, float, or string, respectively Élément de comparaisonThe comparison item
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si la première valeur est inférieure ou égale à la seconde.Return true if the first value is less than or equal to the second value. Retourne false si la première valeur est supérieure à la seconde.Return false if the first value is greater than the second value.

ExempleExample

Dans ces exemples, la première valeur est examinée pour savoir si elle est inférieure ou égale à la seconde.These examples check whether the first value is less than or equal to the second value.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Les résultats retournés sont respectivement :And return the following results respectively:

  • true
  • false

maxmax

Retourne la valeur la plus élevée d’une liste ou d’un tableau.Return the highest value from a list or array. La liste ou le tableau est inclusif aux deux extrémités.The list or arary is inclusive at both ends.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number1>, <number2>...<number1>, <number2>, ... OuiYes nombrenumber Ensemble de nombres dont vous voulez la valeur la plus élevéeThe set of numbers from which you want the highest value
[<number1>, <number2>...][<number1>, <number2>, ...] OuiYes Tableau de nombresarray of numbers Tableau de nombres dont vous voulez la valeur la plus élevéeThe array of numbers from which you want the highest value
Valeur retournéeReturn value TypeType DescriptionDescription
<max-value><max-value> nombrenumber Valeur la plus élevée dans le tableau ou l’ensemble de nombres spécifiéThe highest value in the specified array or set of numbers

ExemplesExamples

Ces exemples illustrent l’obtention de la valeur la plus élevée de l’ensemble des nombres et du tableau :These examples get the highest value from the set of numbers and the array:

max(1, 2, 3)
max(createArray(1, 2, 3))

Le résultat retourné est 3.And return the result 3.

minmin

Retourne la plus petite valeur d’un ensemble de nombres ou d’un tableau.Return the lowest value from a set of numbers or an array.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number1>, <number2>...<number1>, <number2>, ... OuiYes nombrenumber Ensemble de nombres dont vous voulez la valeur la plus petiteThe set of numbers from which you want the lowest value
[<number1>, <number2>...][<number1>, <number2>, ...] OuiYes Tableau de nombresarray of numbers Tableau de nombres dont vous voulez la valeur la plus petiteThe array of numbers from which you want the lowest value
Valeur retournéeReturn value TypeType DescriptionDescription
<min-value><min-value> nombrenumber Valeur la moins élevée dans le tableau ou l’ensemble de nombres spécifiéThe lowest value in the specified array or set of numbers

ExemplesExamples

Ces exemples illustrent l’obtention de la valeur la plus petite de l’ensemble des nombres et du tableau :These examples get the lowest value in the set of numbers and the array:

min(1, 2, 3)
min(createArray(1, 2, 3))

Le résultat retourné est 1.And return the result 1.

modmod

Retourne le reste de la division de deux nombres.Return the remainder from dividing two numbers. Pour obtenir le résultat sous forme d’un entier, consultez div().To get the integer result, see div().

mod(<dividend>, <divisor>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<dividend><dividend> OuiYes nombrenumber Nombre à diviser par le diviseurThe number to divide by the divisor
<divisor><divisor> OuiYes nombrenumber Nombre qui divise dividend.The number that divides the dividend. Ne peut pas être 0.Cannot be 0.
Valeur retournéeReturn value TypeType DescriptionDescription
<modulo-result><modulo-result> nombrenumber Reste de la division du premier nombre par le second nombreThe remainder from dividing the first number by the second number

ExempleExample

Cet exemple illustre la division du premier nombre par le second nombre :This example divides the first number by the second number:

mod(3, 2)

Le résultat retourné est 1.And returns the result 1.

monthmonth

Retourne le mois du timestamp spécifié.Return the month of the specified timestamp.

month('<timestamp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<number-of-month><number-of-month> entierinteger Numéro du mois du timestamp spécifiéThe number of the month in the specified timestamp

ExempleExample

month('2018-03-15T13:01:00.000Z')

Le résultat retourné est 3.And it returns the result 3.

mulmul

Retourne le produit de la multiplication de deux nombres.Return the product from multiplying two numbers.

mul(<multiplicand1>, <multiplicand2>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<multiplicand1><multiplicand1> OuiYes Entier ou flottantinteger or float Nombre à multiplier par multiplicand2The number to multiply by multiplicand2
<multiplicand2><multiplicand2> OuiYes Entier ou flottantinteger or float Nombre qui multiplie multiplicand1The number that multiples multiplicand1
Valeur retournéeReturn value TypeType DescriptionDescription
<product-result><product-result> Entier ou flottantinteger or float Produit de la multiplication du premier nombre par le second nombreThe product from multiplying the first number by the second number

ExemplesExamples

Ces exemples illustrent la multiplication du premier nombre par le second nombre :These examples multiple the first number by the second number:

mul(1, 2)
mul(1.5, 2)

Les résultats retournés sont respectivement :And return the following results respectively:

  • 22
  • 33

newGuidnewGuid

Retourne une nouvelle chaîne GUID.Return a new Guid string.

newGuid()
Valeur retournéeReturn value TypeType DescriptionDescription
<Guid-string><Guid-string> stringstring Nouvelle chaîne GUID, de longueur 36 et au format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxxA new Guid string, length is 36 and looks like xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

ExempleExample

newGuid()

Le résultat retourné suit le format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.And it returns a result which follows the format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.

notnot

Vérifie si une expression est fausse.Check whether an expression is false. Retourne true si l’expression est fausse, false si elle est vraie.Return true if the expression is false, or return false if true.

not(<expression>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<expression><expression> OuiYes BooleanBoolean Expression à vérifierThe expression to check
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si l’expression est fausse.Return true if the expression is false. Retourne false si l’expression est vraie.Return false if the expression is true.

Exemple 1Example 1

Ces exemples vérifient si les expressions spécifiées sont fausses :These examples check whether the specified expressions are false:

not(false)
not(true)

Les résultats retournés sont respectivement :And return the following results respectively:

  • comme l’expression est fausse, la fonction retourne true.The expression is false, so the function returns true.
  • comme l’expression est vraie, la fonction retourne false.The expression is true, so the function returns false.

Exemple 2Example 2

Ces exemples vérifient si les expressions spécifiées sont fausses :These examples check whether the specified expressions are false:

not(equals(1, 2))
not(equals(1, 1))

Les résultats retournés sont respectivement :And return the following results respectively:

  • comme l’expression est fausse, la fonction retourne true.The expression is false, so the function returns true.
  • comme l’expression est vraie, la fonction retourne false.The expression is true, so the function returns false.

oror

Vérifie si au moins une expression est vraie.Check whether at least one expression is true. Retourne true si au moins une expression est vraie, false si elles sont toutes fausses.Return true if at least one expression is true, or return false if all are false.

or(<expression1>, <expression2>, ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<expression1>, <expression2>...<expression1>, <expression2>, ... OuiYes BooleanBoolean Expressions à vérifierThe expressions to check
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si au moins une expression est vraie.Return true if at least one expression is true. Retourne false si toutes les expressions sont fausses.Return false if all expressions are false.

Exemple 1Example 1

Ces exemples vérifient si au moins une expression est vraie :These examples check whether at least one expression is true:

or(true, false)
or(false, false)

Les résultats retournés sont respectivement :And return the following results respectively:

  • comme au moins une expression est vraie, la fonction retourne true.At least one expression is true, so the function returns true.
  • comme les deux expressions sont fausses, la fonction retourne false.Both expressions are false, so the function returns false.

Exemple 2Example 2

Ces exemples vérifient si au moins une expression est vraie :These examples check whether at least one expression is true:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Les résultats retournés sont respectivement :And return the following results respectively:

  • comme au moins une expression est vraie, la fonction retourne true.At least one expression is true, so the function returns true.
  • comme les deux expressions sont fausses, la fonction retourne false.Both expressions are false, so the function returns false.

randrand

Retourne un entier aléatoire à partir d’une plage spécifiée, qui est inclus uniquement au point de départ.Return a random integer from a specified range, which is inclusive only at the starting end.

rand(<minValue>, <maxValue>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<minValue><minValue> OuiYes entierinteger Entier le plus petit de la plageThe lowest integer in the range
<maxValue><maxValue> OuiYes entierinteger Entier qui suit l’entier le plus élevé dans la plage que la fonction peut retournerThe integer that follows the highest integer in the range that the function can return
Valeur retournéeReturn value TypeType DescriptionDescription
<random-result><random-result> entierinteger Entier aléatoire retourné à partir de la plage spécifiéeThe random integer returned from the specified range

ExempleExample

Cet exemple illustre l’obtention d’un entier aléatoire à partir de la plage spécifiée, en excluant la valeur maximale :This example gets a random integer from the specified range, excluding the maximum value:

rand(1, 5)

Le résultat retourné est 1, 2, 3 ou 4.And returns 1, 2, 3, or 4 as the result.

rangerange

Retourne un tableau d’entiers qui commence par un entier spécifique.Return an integer array that starts from a specified integer.

range(<startIndex>, <count>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<startIndex><startIndex> OuiYes entierinteger Une valeur entière qui constitue le premier élément du tableauAn integer value that starts the array as the first item
<count><count> OuiYes entierinteger Nombre d’entiers du tableauThe number of integers in the array
Valeur retournéeReturn value TypeType DescriptionDescription
<range-result><range-result> entierinteger Tableau dont les entiers commencent à partir de l’index spécifiéThe array with integers starting from the specified index

ExempleExample

Dans cet exemple, un tableau d’entiers commençante à partir de l’index spécifié 1 et possédant le nombre spécifié d’entiers 4 est créé :This example creates an integer array that starts from the specified index 1 and has the specified number of integers as 4:

range(1, 4)

Le résultat retourné est [1, 2, 3, 4] .And returns the result [1, 2, 3, 4].

removePropertyremoveProperty

Supprime une propriété dans un objet et retourne l’objet mis à jour.Remove a property from an object and return the updated object.

removeProperty(<object>, '<property>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object><object> OuiYes objectobject Objet JSON dont une propriété doit être suppriméeThe JSON object in which you want to remove a property
<property><property> OuiYes stringstring Nom de la propriété à supprimerThe name of the property to remove
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-object><updated-object> objectobject Objet JSON mis à jour sans la propriété spécifiéeThe updated JSON object without the specified property

ExempleExample

Dans cet exemple, la propriété accountLocation est supprimée d’un objet customerProfile, qui est converti au format JSON avec la fonction json(). L’objet mis à jour est retourné :This example removes the accountLocation property from a customerProfile object, which is converted to JSON with the json() function, and returns the updated object:

removeProperty(json('customerProfile'), 'accountLocation')

remplacerreplace

Remplace une sous-chaîne par la chaîne spécifiée et retourne la chaîne de résultat.Replace a substring with the specified string, and return the result string. Cette fonction respecte la casse.This function is case-sensitive.

replace('<text>', '<oldText>', '<newText>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne comportant la sous-chaîne à remplacerThe string that has the substring to replace
<oldText><oldText> OuiYes stringstring Sous-chaîne à remplacerThe substring to replace
<newText><newText> OuiYes stringstring Chaîne de remplacementThe replacement string
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-text><updated-text> stringstring Chaîne mise à jour après le remplacement de la sous-chaîne.The updated string after replacing the substring. Si la sous-chaîne est introuvable, la fonction retourne la chaîne d’origine.If the substring is not found, the function returns the original string.

Exemple 1Example 1

Dans cet exemple, la sous-chaîne old est recherchée dans la chaîne the old string et old est remplacé par new :This example finds the substring old in the old string and replaces old with new:

replace('the old string', 'old', 'new')

Le résultat est la chaîne the new string.The result is the string the new string.

Exemple 2Example 2

En présence de caractères d’échappement, le moteur d’expression gère automatiquement la suppression de l’échappement.When dealing with escape characters, the expression engine handles the unescape for you. Cette fonction remplace les chaînes par des caractères d’échappement.This function replaces strings with escape characters.

replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"

Les résultats retournés sont respectivement :And returns the following results respectively:

  • hello\nhello\n
  • hello\\hello\\
  • @"hello\\"@"hello\\"
  • @"hello\\"@"hello\\"

replaceIgnoreCasereplaceIgnoreCase

Remplace une sous-chaîne par la chaîne spécifiée et retourne la chaîne de résultat.Replace a substring with the specified string, and return the result string. Cette fonction ne respecte pas la casse.This function is case-insensitive.

replaceIgnoreCase('<text>', '<oldText>', '<newText>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne comportant la sous-chaîne à remplacerThe string that has the substring to replace
<oldText><oldText> OuiYes stringstring Sous-chaîne à remplacerThe substring to replace
<newText><newText> OuiYes stringstring Chaîne de remplacementThe replacement string
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-text><updated-text> stringstring Chaîne mise à jour après le remplacement de la sous-chaîne.The updated string after replacing the substring. Si la sous-chaîne est introuvable, retourne la chaîne d’origine.If the substring is not found, return the original string.

ExempleExample

Dans cet exemple, la sous-chaîne old est recherchée dans la chaîne the old string et old est remplacé par new :This example finds the substring old in the string the old string and replaces old with new:

replace('the old string', 'old', 'new')

Le résultat retourné est the new string.And returns the result the new string.

roundround

Arrondit une valeur à l’entier le plus proche ou au nombre spécifié de chiffres fractionnaires.Round a value to the nearest integer or to the specified number of fractional digits.

round('<number>', '<precision-digits>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<number><number> OuiYes nombrenumber Un numéro d’entréeAn input number
<chiffres de précision><precision-digits> NonNo entierinteger Nombre spécifié de chiffres fractionnaires.A specified number of fractional digits. La valeur par défaut est 0.The default is 0.
Valeur retournéeReturn value TypeType DescriptionDescription
<valeur de retour><return-value> nombrenumber Valeur de retour de l’entrée arrondie à un nombre spécifié de chiffres fractionnairesThe return value of the input rounded at a specified number of fractional digits

Exemple 1Example 1

Cet exemple arrondit le nombre 10,333:This example rounds the number 10.333:

round(10.333)

Et retourne le nombre 10.And returns the number 10.

Exemple 2Example 2

Cet exemple arrondit le nombre 10,3313 à 2 chiffres fractionnaires :This example rounds the number 10.3313 to 2 fractional digits:

round(10.3313, 2)

Et retourne le nombre 10,33.And returns the number 10.33.

selectselect

S’applique à chaque élément et retourne la nouvelle collection d’éléments transformés.Operate on each element and return the new collection of transformed elements.

select([<collection/instance>], <iteratorName>, <function>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection/instance><collection/instance> OuiYes tableauarray Collection contenant les élémentsThe collection with the items
<iteratorName><iteratorName> OuiYes Nom de l’itérateuriterator name Élément cléThe key item
<function><function> OuiYes expressionexpression Fonction pouvant contenir iteratorNameTh function that can contains iteratorName
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection><new-collection> tableauarray Nouvelle collection dans laquelle chaque élément a été évalué avec la fonctionThe new collection in which each element has been evaluated with the function

Exemple 1Example 1

Dans cet exemple, une nouvelle collection est générée :This example generates a new collection:

select(createArray(0, 1, 2, 3), x, x + 1)

Le résultat retourné est [1, 2, 3, 4] .And returns the result [1, 2, 3, 4].

Exemple 2Example 2

Ces exemples génèrent une nouvelle collection :These examples generate a new collection:

select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

Et retournent le résultat ['Name : Jack', 'Age : 15 '].And return the result ['name:jack', 'age:15']. Notez que la deuxième expression est une expression lambda, qui est plus lisible.Note that the second expression is a lambda expression, which some find more readable.

sentenceCasesentenceCase

Mettre en majuscule la première lettre du premier mot d’une chaîne dans un format de paramètres régionaux facultatif.Capitalize the first letter of the first word in a string in an optional locale format.

sentenceCase('<text>', '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne d’origineThe original string
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
chaîne de résultatresult string stringstring Retourne le résultat de la phrase de casReturns the sentence case result

Exemple 1Example 1

Ces exemples mettent en majuscule la première lettre d’une chaîne :These examples capitalize the first letter in a string:

sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')

Les résultats retournés sont respectivement :And return the following results respectively:

  • AA
  • Abc defAbc def
  • Abc defAbc def

Exemple 2Example 2

Ces exemples mettent en majuscule la première lettre d’une chaîne au format de paramètres régionaux spécifié :These examples capitalizes the first letter in a string in the specified locale format:

sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')

Les résultats retournés sont respectivement :And return the following results respectively:

  • AA
  • ABCAbc
  • ABCAbc

setPathToValuesetPathToValue

Récupère la valeur de la propriété spécifiée à partir de l’objet JSON.Retrieve the value of the specified property from the JSON object.

setPathToValue(<path>, <value>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<Path><Path> OuiYes objectobject Chemin à définirThe path which you want to set
<value><value> OuiYes objectobject Valeur à donner au cheminThe value you want to set to the path
Valeur retournéeReturn value TypeType DescriptionDescription
valuevalue objectobject Valeur définieThe value be set

Exemple 1Example 1

Dans cet exemple, la valeur du chemin est définie sur 1 :The example below sets the value 1 to the path:

setPathToValue(path.x, 1)

Le résultat retourné est 1.And returns the result 1. path.x est défini sur 1.path.x is set to 1.

Exemple 2Example 2

Dans cet exemple, la valeur est définie :This example below sets the value:

setPathToValue(path.array[0], 7) + path.array[0]

Le résultat retourné est 14.And returns the result 14.

SetPropertysetProperty

Définit la valeur d’une propriété d’un objet et retourne l’objet mis à jour.Set the value of an object's property and return the updated object. Pour ajouter une nouvelle propriété, utilisez cette fonction ou la fonction addProperty().To add a new property, use this function or the addProperty() function.

setProperty(<object>, '<property>', <value>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<object><object> OuiYes objectobject Objet JSON dont une propriété doit être définieThe JSON object in which you want to set a property
<property><property> OuiYes stringstring Nom de la propriété à définirThe name of the property to set
<value><value> OuiYes n'importe laquelleany Valeur à définir pour la propriété spécifiéeThe value to set for the specified property
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-object><updated-object> objectobject Objet JSON mis à jour dont vous définissez la propriétéThe updated JSON object whose property you set

ExempleExample

Dans cet exemple, la propriété accountNumber est défini sur un objet customerProfile, qui est converti au format JSON avec la fonction json().This example sets the accountNumber property on a customerProfile object, which is converted to JSON with the json() function. La fonction attribue une valeur générée par la fonction newGuid()L’objet JSON mis à jour est retourné :The function assigns a value generated by the newGuid() function, and returns the updated JSON object:

setProperty(json('customerProfile'), 'accountNumber', newGuid())

skipskip

Supprime des éléments du début d’une collection et retourne tous les autres éléments.Remove items from the front of a collection, and return all the other items.

skip([<collection>], <count>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes tableauarray Collection dont vous voulez supprimer des élémentsThe collection whose items you want to remove
<count><count> OuiYes entierinteger Entier positif correspondant au nombre d’éléments à supprimer au débutA positive integer for the number of items to remove at the front
Valeur retournéeReturn value TypeType DescriptionDescription
<updatedCollection><updatedCollection> tableauarray Collection mise à jour à l’issue de la suppression des éléments spécifiésThe updated collection after removing the specified items

ExempleExample

Dans cet exemple, un élément (le nombre 1) est supprimé au début du tableau spécifié :This example removes one item, the number 1, from the front of the specified array:

skip(createArray(0, 1, 2, 3), 1)

Un tableau comportant les éléments restants est retourné : [1,2,3] .And returns an array with the remaining items: [1,2,3].

sortBysortBy

Trie les éléments de la collection par ordre croissant et retourne la collection triée.Sort elements in the collection in ascending order and return the sorted collection.

sortBy([<collection>], '<property>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes chaîne ou tableaustring or array Collection à trierThe collection to sort
<property><property> NonNo stringstring Propriété spécifiée servant à fixer l’ordre de tri de l’élément d’objet dans la collection, si elle est définieSort by this specific property of the object element in the collection if set
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection><new-collection> tableauarray Nouvelle collection dont les éléments ont été triésThe new collection whose elements have been sorted

Exemple 1Example 1

Dans cet exemple, la collection suivante est triée :This example generates sorts the following collection:

sortBy(createArray(1, 2, 0, 3))

Le résultat retourné est [0, 1, 2, 3] .And return the result [0, 1, 2, 3].

Exemple 2Example 2

Prenons la collection suivante :Suppose you have the following collection:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Dans cet exemple, une nouvelle collection triée est générée en fonction de la propriété de l’objet x.This example generates a new sorted collection based on the x object property

sortBy(nestedItems, 'x')

Le résultat retourné est :And returns the result:

{
  'nestedItems': [
    {'x': 1},
    {'x': 2},
    {'x': 3}
  ]
}

sortByDescendingsortByDescending

Trie les éléments de la collection par ordre décroissant et retourne la collection triée.Sort elements in the collection in descending order, and return the sorted collection.

sortBy([<collection>], '<property>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes chaîne ou tableaustring or array Collection à trierThe collection to sort
<property><property> NonNo stringstring Propriété spécifiée servant à fixer l’ordre de tri de l’élément d’objet dans la collection, si elle est définieSort by this specific property of the object element in the collection if set
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection><new-collection> tableauarray Nouvelle collection dont les éléments ont été triésThe new collection whose elements have been sorted

Exemple 1Example 1

Dans cet exemple, une nouvelle collection triée est générée :This example generates a new sorted collection:

sortByDescending(createArray(1, 2, 0, 3))

Le résultat retourné est [3, 2, 1, 0] .And returns the result [3, 2, 1, 0].

Exemple 2Example 2

Prenons la collection suivante :Suppose you have the following collection:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Dans cet exemple, une nouvelle collection triée est générée en fonction de la propriété de l’objet x :This example generates a new sorted collection based on the x object property:

sortByDescending(nestedItems, 'x')

Et retourne ce résultat :And returns this result:

{
  'nestedItems': [
    {'x': 3},
    {'x': 2},
    {'x': 1}
  ]
}

splitsplit

Retourne un tableau qui contient des sous-chaînes, séparées par des virgules, extraites sur la base du caractère délimiteur spécifié dans la chaîne d’origine.Return an array that contains substrings, separated by commas, based on the specified delimiter character in the original string.

split('<text>', '<delimiter>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne à séparer en sous-chaînes en fonction du délimiteur spécifié dans la chaîne d’origine.The string to separate into substrings based on the specified delimiter in the original string. Si le texte est une valeur Null, il sera considéré comme une chaîne vide.If the text is a null value, it will be taken as an empty string.
<delimiter><delimiter> NonNo stringstring Caractère présent dans la chaîne d’origine à utiliser comme délimiteur.The character in the original string to use as the delimiter. Si aucun délimiteur n’est fourni ou si le délimiteur est une valeur Null, la valeur par défaut est une chaîne vide.If no delimiter provided or the delimiter is a null value, the default value will be an empty string.
Valeur retournéeReturn value TypeType DescriptionDescription
[<substring1>,<substring2>,...][<substring1>,<substring2>,...] tableauarray Un tableau qui contient les sous-chaînes extraites de la chaîne d’origine, séparées par des virgulesAn array that contains substrings from the original string, separated by commas

ExemplesExamples

Dans ces exemples, un tableau comportant des sous-chaînes extraites de la chaîne spécifiée en fonction du caractère délimiteur spécifié est créé :These examples create an array with substrings from the specified string based on the specified delimiter character:

split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')

Les résultats retournés sont respectivement les tableaux suivants :And returns the following arrays as the result repsectively:

  • ["a", "b", "c"]["a", "b", "c"]
  • ["h", "e", "l", "l", "o"]["h", "e", "l", "l", "o"]
  • [""], [ ][""], [ ]
  • ["h", "e", "l", "l", "o"]["h", "e", "l", "l", "o"]

startOfDaystartOfDay

Retourne le début de la journée d’un horodatage dans un format de paramètres régionaux facultatif.Return the start of the day for a timestamp in an optional locale format.

startOfDay('<timestamp>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
'<updated-timestamp>''<updated-timestamp>' stringstring Timestamp spécifié, commençant à la marque zéro heure du jourThe specified timestamp starting at the zero-hour mark for the day

Exemple 1Example 1

Dans cet exemple, le début du jour est recherché :This example finds the start of the day:

startOfDay('2018-03-15T13:30:30.000Z')

Le résultat retourné est 2018-03-15T00:00:00.000Z.And returns the result 2018-03-15T00:00:00.000Z.

Exemple 2Example 2

Cet exemple recherche le début de la journée avec les paramètres régionaux fr-fr:This example finds the start of the day with the locale fr-FR:

startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Et retourne le résultat 15/03/2018 00:00:00.And returns the result 15/03/2018 00:00:00.

startOfHourstartOfHour

Retourne le début de l’heure pour un horodatage dans un format de paramètres régionaux facultatif.Return the start of the hour for a timestamp in an optional locale format.

startOfHour('<timestamp>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
'<updated-timestamp>''<updated-timestamp>' stringstring Timestamp spécifié, commençant à la marque zéro minute du jourThe specified timestamp starting at the zero-minute mark for the day

Exemple 1Example 1

Dans cet exemple, le début de l’heure est recherché :This example finds the start of the hour:

startOfHour('2018-03-15T13:30:30.000Z')

Le résultat retourné est 2018-03-15T13:00:00.000Z.And returns the result 2018-03-15T13:00:00.000Z.

Exemple 2Example 2

Cet exemple recherche le début de l’heure avec les paramètres régionaux fr-fr:This example finds the start of the hour with the locale fr-FR:

startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Et retourne le résultat 15/03/2018 13:00:00.And returns the result 15/03/2018 13:00:00.

startOfMonthstartOfMonth

Retourne le début du mois pour un horodatage dans un format de paramètres régionaux facultatif.Return the start of the month for a timestamp in an optional locale format.

startOfMonth('<timestamp>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
'<updated-timestamp>''<updated-timestamp>' stringstring Timestamp spécifié, commençant le premier jour du mois à la marque zéro heureThe specified timestamp starting on the first day of the month at the zero-hour mark

Exemple 1Example 1

Dans cet exemple, le début du mois est recherché :This example finds the start of the month:

startOfMonth('2018-03-15T13:30:30.000Z')

Le résultat retourné est 2018-03-01T00:00:00.000Z.And returns the result 2018-03-01T00:00:00.000Z.

Exemple 2Example 2

Cet exemple recherche le début du mois avec les paramètres régionaux fr-fr:This example finds the start of the month with the locale fr-FR:

startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Et retourne le résultat 01/03/2018 00:00:00.And returns the result 01/03/2018 00:00:00.

startsWithstartsWith

Vérifie si une chaîne commence par une sous-chaîne spécifique.Check whether a string starts with a specific substring. Retourne true si la sous-chaîne est trouvée, false sinon.Return true if the substring is found, or return false if not found. Cette fonction ne respecte pas la casse.This function is case-insensitive.

startsWith('<text>', '<searchText>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne à vérifierThe string to check
<searchText><searchText> OuiYes stringstring Sous-chaîne de départ à rechercherThe starting substring to find
Valeur retournéeReturn value TypeType DescriptionDescription
True ou Falsetrue or false BooleanBoolean Retourne true si la sous-chaîne de début est trouvée.Return true if the starting substring is found. Retourne false si elle n’est pas trouvée.Return false if not found

Exemple 1Example 1

Dans cet exemple, la chaîne hello world est examinée pour savoir si elle commence par la chaîne hello :This example checks whether the string hello world starts with the string hello:

startsWith('hello world', 'hello')

Le résultat retourné est true.And returns the result true.

Exemple 2Example 2

Dans cet exemple, la chaîne hello world est examinée pour savoir si elle commence par la chaîne greeting :This example checks whether the string hello world starts with the string greeting:

startsWith('hello world', 'greeting')

Le résultat retourné est false.And returns the result false.

stringstring

Retourne la version de chaîne d’une valeur dans un format de paramètres régionaux facultatif.Return the string version of a value in an optional locale format.

string(<value>, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes n'importe laquelleany Valeur à convertirThe value to convert
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<string-value><string-value> stringstring Version de type chaîne de la valeur spécifiéeThe string version of the specified value

Exemple 1Example 1

Dans cet exemple, la version de type chaîne du nombre 10 est créée :This example creates the string version of the number 10:

string(10)

Le résultat retourné est la chaîne 10.And returns the string result 10.

Exemple 2Example 2

Dans cet exemple, une chaîne est créée pour l’objet JSON spécifié avec le caractère de barre oblique inverse ( \\ ) comme caractère d’échappement pour le caractère guillemet double ( " ).This example creates a string for the specified JSON object and uses the backslash character,\\, as an escape character for the double-quotation mark character, ".

string( { "name": "Sophie Owen" } )

Et retourne le résultat {"Name" : "Sophie Owen"}And returns the result { "name": "Sophie Owen" }

Exemple 3Example 3

L’exemple suivant crée une version de chaîne du nombre 10 dans des paramètres régionaux spécifiques :These example creates a string version of the number 10 in a specific locale:

string(100.1, 'fr-FR')
string(100.1, 'en-US')

Et retourne respectivement les chaînes suivantes :And returns the following strings respectively:

  • 100, 1100,1
  • *100,1*100.1

subsub

Retourne le résultat de la soustraction du second nombre du premier.Return the result from subtracting the second number from the first number.

sub(<minuend>, <subtrahend>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<minuend><minuend> OuiYes nombrenumber Nombre à partir duquel soustraire le plus petit termeThe number from which to subtract the subtrahend
<subtrahend><subtrahend> OuiYes nombrenumber Nombre à soustraire du plus petit termeThe number to subtract from the minuend
Valeur retournéeReturn value TypeType DescriptionDescription
<result><result> nombrenumber Résultat de la soustraction du second nombre du premierThe result from subtracting the second number from the first number

ExempleExample

Cet exemple illustre la soustraction du second nombre du premier :This example subtracts the second number from the first number:

sub(10.3, .3)

Le résultat retourné est 10.And returns the result 10.

subArraysubArray

Retourne un sous-tableau à partir des positions de début et de fin spécifiées.Returns a subarray from specified start and end positions. Les valeurs d’index commencent par le chiffre 0.Index values start with the number 0.

subArray(<Array>, <startIndex>, <endIndex>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<array><array> OuiYes tableauarray Tableau à partir duquel le sous-tableau est crééThe array to create the subarray from
<startIndex><startIndex> OuiYes entierinteger Nombre positif supérieur ou égal à 0 à utiliser comme position ou valeur d’index de départA positive number equal to or greater than 0 to use as the starting position or index value
<endIndex><endIndex> OuiYes entierinteger Nombre positif supérieur ou égal à 0 à utiliser comme position ou valeur d’index de finA positive number equal to or greater than 0 to use as the ending position or index value
Valeur retournéeReturn value TypeType DescriptionDescription
<subarray-result><subarray-result> tableauarray Sous-tableau contenant le nombre spécifié d’éléments, en commençant à la position d’index spécifiée dans la chaîne sourceA subarray with the specified number of items, starting at the specified index position in the source string

ExempleExample

Dans cet exemple, un sous-tableau est créé à partir du tableau spécifié :This example creates a subarray from the specified array:

subArray(createArray('H','e','l','l','o'), 2, 5)

Le résultat retourné est ["l", "l", "o"] .And returns the result ["l", "l", "o"].

substringsubstring

Retourne les caractères d’une chaîne, en commençant à partir de la position ou de l’index spécifié.Return characters from a string, starting from the specified position or index. Les valeurs d’index commencent par le chiffre 0.Index values start with the number 0.

substring('<text>', <startIndex>, <length>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne à partir de laquelle la sous-chaîne est crééeThe string to create the substring from
<startIndex><startIndex> OuiYes entierinteger Nombre positif supérieur ou égal à 0 à utiliser comme position ou valeur d’index de départA positive number equal to or greater than 0 subarray to use as the starting position or index value
<length><length> OuiYes entierinteger Nombre positif de caractères dans la sous-chaîneA positive number of characters subarray in the substring
Valeur retournéeReturn value TypeType DescriptionDescription
<substring-result><substring-result> stringstring Sous-chaîne contenant le nombre spécifié de caractères, en commençant à la position d’index spécifiée dans la chaîne sourceA substring with the specified number of characters, starting at the specified index position in the source string

ExempleExample

Cet exemple illustre la création d’une sous-chaîne de cinq caractères à partir de la chaîne spécifiée, en commençant à partir de la valeur d’index 6 :This example creates a five-character substring from the specified string, starting from the index value 6:

substring('hello world', 6, 5)

Le résultat retourné est world.And returns the result world.

subtractFromTimesubtractFromTime

Soustraire un nombre d’unités de temps d’un horodatage dans un format de paramètres régionaux facultatif.Subtract a number of time units from a timestamp in an optional locale format . Voir aussi getPastTime().See also getPastTime().

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
<interval><interval> OuiYes entierinteger Nombre d’unités de temps spécifiées à soustraireThe number of specified time units to subtract
<timeUnit><timeUnit> OuiYes stringstring Unité de temps à utiliser avec interval.The unit of time to use with interval. Unités possibles : « Second » (seconde), « Minute » (minute), « Hour » (heure), « Day » (jour), « Week » (semaine), « Month » (mois) et « Year » (année).Possible units are "Second", "Minute", "Hour", "Day", "Week", "Month", and "Year".
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<updated-timestamp><updated-timestamp> stringstring Horodatage moins le nombre d’unités de temps spécifiéThe timestamp minus the specified number of time units

Exemple 1Example 1

Cet exemple soustrait un jour d’un horodateur suivant :This example subtracts one day from a following timestamp:

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')

Le résultat retourné est 2018-01-01T00:00:00.000Z.And returns the result 2018-01-01T00:00:00.000Z.

Exemple 2Example 2

Cet exemple soustrait un jour d’un horodatage à l’aide du format D :This example subtracts one day from a timestamp using the D format:

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')

Et retourne le résultat lundi, janvier, 1, 2018.And returns the result Monday, January, 1, 2018.

Exemple 3Example 3

L’exemple ci-dessous soustrait 1 heure d’un horodateur dans la région de-de :This example subtracts 1 hour from a timestamp in the de-DE locale:

subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')

Et retourne le résultat 15.03.18 12:00:00.And returns the result 15.03.18 12:00:00.

Sumsum

Retourne le résultat de l’addition des nombres d’une liste.Return the result from adding numbers in a list.

sum([<list of numbers>])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
[<list of numbers>][<list of numbers>] OuiYes Tableau de nombresarray of numbers Nombres à ajouterThe numbers to add
Valeur retournéeReturn value TypeType DescriptionDescription
<result-sum><result-sum> nombrenumber Résultat de l’addition des nombres spécifiésThe result from adding the specified numbers

ExempleExample

Cet exemple illustre l’addition des nombres spécifiés :This example adds the specified numbers:

sum(createArray(1, 1.5))

Le résultat retourné est 2.5.And returns the result 2.5.

taketake

Retourne des éléments du début d’une collection.Return items from the front of a collection.

take('<collection>', <count>)
take([<collection>], <count>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes chaîne ou tableaustring or array Collection dont vous souhaitez des élémentsThe collection whose items you want
<count><count> OuiYes entierinteger Entier positif correspondant au nombre d’éléments souhaités à partir du débutA positive integer for the number of items you want from the front
Valeur retournéeReturn value TypeType DescriptionDescription
<subset> ou [<subset>]<subset> or [<subset>] Chaîne ou tableau, respectivementString or Array, respectively Chaîne ou tableau qui comporte le nombre spécifié d’éléments obtenus à partir du début de la collection d’origineA string or array that has the specified number of items taken from the front of the original collection

ExempleExample

Ces exemples illustrent l’obtention du nombre spécifié d’éléments à partir du début de ces collections :These examples get the specified number of items from the front of these collections:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Les résultats retournés sont respectivement :And return the following results respectively:

  • abcabc
  • [0, 1, 2][0, 1, 2]

ticksticks

Retourne la valeur de la propriété Ticks d’un timestamp spécifié.Return the ticks property value of a specified timestamp. Un tick est un intervalle de 100 nanosecondes.A tick is 100-nanosecond interval.

ticks('<timestamp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne d’un horodatageThe string for a timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<ticks-number><ticks-number> entier (bigint en JavaScript)integer (bigint in Javascript) Nombre de graduations depuis l’horodatage spécifiéThe number of ticks since the specified timestamp

ExempleExample

Dans cet exemple, un timestamp est converti en sa propriété Ticks.The example convert a timestamp to its ticks property

ticks('2018-01-01T08:00:00.000Z')

Le résultat retourné est 636503904000000000.And returns the result 636503904000000000.

ticksToDaysticksToDays

Convertit une valeur de propriété Ticks en nombre de jours.Convert a ticks property value to the number of days.

ticksToDays('ticks')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<graduations><ticks> OuiYes entierinteger Valeur de la propriété Ticks à convertir.The ticks property value to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<nombre de jours><number-of-days> nombrenumber Nombre de jours converties à partir de la valeur de la propriété TicksThe number of days converted from the ticks property value

ExempleExample

Cet exemple convertit une valeur de propriété Ticks en un nombre de jours :This example converts a ticks property value to a number of days:

ticksToDays(2193385800000000)

Et retourne le nombre 2538,64097222.And returns the number 2538.64097222.

ticksToHoursticksToHours

Convertit une valeur de propriété Ticks en nombre d’heures.Convert a ticks property value to the number of hours.

ticksToHours('ticks')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<graduations><ticks> OuiYes IntegerInteger Valeur de la propriété Ticks à convertir.The ticks property value to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<nombre d’heures><number-of-hours> nombrenumber Nombre d’heures converties à partir de la valeur de la propriété TicksThe number of hours converted from the ticks property value

ExempleExample

Cet exemple convertit une valeur de propriété Ticks en un nombre d’heures :This example converts a ticks property value to a number of hours:

ticksToHours(2193385800000000)

Et retourne le nombre 60927.383333333331.And returns the number 60927.383333333331.

ticksToMinutesticksToMinutes

Convertit une valeur de propriété Ticks en nombre de minutes.Convert a ticks property value to the number of minutes.

ticksToMinutes('ticks')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<graduations><ticks> OuiYes entierinteger Valeur de la propriété Ticks à convertir.The ticks property value to convert
Valeur retournéeReturn value TypeType DescriptionDescription
<nombre de minutes><number-of-minutes> nombrenumber Nombre de minutes converties à partir de la valeur de la propriété TicksThe number of minutes converted from the ticks property value

ExempleExample

Cet exemple convertit une valeur de propriété Ticks en un nombre de minutes :This example converts a ticks property value to a number of minutes:

ticksToMinutes(2193385800000000)

Et retourne le nombre 3655643,0185.And returns the number 3655643.0185.

Initiale majusculetitleCase

Mettre en majuscule la première lettre de chaque mot dans une chaîne dans un format local facultatif.Capitalize the first letter of each word in a string in an optional local format.

titleCase('<text>', '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne d’origineThe original string
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
chaîne de résultatresult string stringstring Résultat de la casse du titreThe title case result

Exemple 1Example 1

Ces exemples mettent en majuscule la première lettre de chaque mot dans une chaîne :These examples capitalize the first letter of each word in a string:

titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')

Les résultats retournés sont respectivement :And return the following results respectively:

  • AA
  • Abc defAbc Def
  • Abc defAbc Def

Exemple 2Example 2

Ces exemples mettent en majuscule la première lettre d’une chaîne au format fr-fr :These examples capitalize the first letter in a string in the en-US format:

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

Les résultats retournés sont respectivement :And return the following results respectively:

  • AA
  • Abc defAbc Def

toLowertoLower

Retourne une chaîne en minuscules dans un format de paramètres régionaux facultatif.Return a string in lowercase in an optional locale format. Si un caractère de la chaîne n’a pas de version en minuscules, ce caractère reste tel quel dans la chaîne retournée.If a character in the string doesn't have a lowercase version, that character stays unchanged in the returned string.

toLower('<text>', '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne à retourner en minusculesThe string to return in lowercase format
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<lowercase-text><lowercase-text> stringstring Chaîne d’origine en minusculesThe original string in lowercase format

Exemple 1Example 1

Dans cet exemple, une chaîne est convertie en minuscules :This example converts a string to lowercase:

toLower('Hello World')

Le résultat retourné est hello world.And returns the result hello world.

Exemple 2Example 2

L’exemple suivant convertit une chaîne en minuscules au format fr-fr :This example converts a string to lowercase in the fr-FR format:

toUpper('Hello World', 'fr-FR')

Le résultat retourné est hello world.And returns the result hello world.

toUppertoUpper

Retourne une chaîne en majuscules dans un format de paramètres régionaux facultatif..Return a string in uppercase in an optional locale format.. Si un caractère de la chaîne n’a pas de version en majuscules, ce caractère reste tel quel dans la chaîne retournée.If a character in the string doesn't have an uppercase version, that character stays unchanged in the returned string.

toUpper('<text>', '<locale>'?)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne à retourner en majusculesThe string to return in uppercase format
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<uppercase-text><uppercase-text> stringstring Chaîne d’origine en majusculesThe original string in uppercase format

Exemple 1Example 1

Dans cet exemple, une chaîne est convertie en majuscules :This example converts a string to uppercase:

toUpper('Hello World')

Le résultat retourné est HELLO WORLD.And returns the result HELLO WORLD.

Exemple 2Example 2

L’exemple suivant convertit une chaîne en majuscules au format fr-fr :This example converts a string to uppercase in the fr-FR format:

toUpper('Hello World', 'fr-FR')

Le résultat retourné est HELLO WORLD.And returns the result HELLO WORLD.

trimtrim

Supprime les espaces blancs de début et de fin d’une chaîne et retourne la chaîne mise à jour.Remove leading and trailing whitespace from a string, and return the updated string.

trim('<text>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<text><text> OuiYes stringstring Chaîne contenant les espaces blancs de début et de fin à supprimerThe string that has the leading and trailing whitespace to remove
Valeur retournéeReturn value TypeType DescriptionDescription
<updatedText><updatedText> stringstring Version mise à jour de la chaîne d’origine sans espace blanc de début ou de finAn updated version for the original string without leading or trailing whitespace

ExempleExample

Dans cet exemple, les espaces blancs de début et de fin sont supprimés de la chaîne " Hello World " :This example removes the leading and trailing whitespace from the string " Hello World ":

trim(' Hello World  ')

Le résultat retourné est Hello World.And returns the trimmed result Hello World.

unionunion

Retourne une collection contenant tous les éléments des collections spécifiées.Return a collection that has all the items from the specified collections. Pour qu’il apparaisse dans le résultat, un élément peut apparaître dans n’importe quelle collection transmise à cette fonction.To appear in the result, an item can appear in any collection passed to this function. Si un ou plusieurs éléments portent le même nom, le dernier élément de ce nom apparaît dans le résultat.If one or more items have the same name, the last item with that name appears in the result.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection1>, <collection2>...<collection1>, <collection2>, ... OuiYes Tableau ou objet, mais pas les deuxarray or object, but not both Collections dont tous les éléments doivent être récupérésThe collections from where you want all the items
Valeur retournéeReturn value TypeType DescriptionDescription
<updatedCollection><updatedCollection> Respectivement tableau ou objetarray or object, respectively Collection contenant tous les éléments des collections spécifiées,A collection with all the items from the specified collections. sans ajout de doublonsNo duplicates added.

ExempleExample

Dans cet exemple, tous les éléments des collections suivantes sont récupérés :This example gets all the items from the following collections:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Le résultat retourné est [1, 2, 3, 10, 101] .And returns the result [1, 2, 3, 10, 101].

uniqueunique

Supprime tous les doublons d’un tableau.Remove all duplicates from an array.

unique([<collection>])
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection><collection> OuiYes tableauarray Collection à modifierThe collection to modify
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection><new-collection> tableauarray Nouvelle collection dont les éléments en double ont été supprimésNew collection with duplicate elements removed

Exemple 1Example 1

Dans cet exemple, les éléments en double sont supprimés du tableau suivant :This example removes duplicate elements from the following array:

unique(createArray(1, 2, 1))

Le résultat retourné est [1, 2] .And returns the result [1, 2].

uriComponenturiComponent

Retourne la version binaire d’un composant d’URI (Uniform Resource Identifier).Return the binary version of a uniform resource identifier (URI) component.

uriComponent('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne à convertir au format encodé sous forme d’URIThe string to convert to URI-encoded format
Valeur retournéeReturn value TypeType DescriptionDescription
<encoded-uri><encoded-uri> stringstring Chaîne encodée sous forme d’URI avec des caractères d’échappementThe URI-encoded string with escape characters

ExempleExample

Dans cet exemple, une version encodée sous forme d’URI d’une chaîne est créée :This example creates a URI-encoded version of a string:

uriComponent('https://contoso.com')

Le résultat retourné est http%3A%2F%2Fcontoso.com.And returns the result http%3A%2F%2Fcontoso.com.

uriComponentToStringuriComponentToString

Retourne la version de type chaîne d’une chaîne encodée sous forme d’URI (Uniform Resource Identifier), en décodant la chaîne encodée sous forme d’URI.Return the string version of a uniform resource identifier (URI) encoded string, effectively decoding the URI-encoded string.

uriComponentToString('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne encodée sous forme d’URI à décoderThe URI-encoded string to decode
Valeur retournéeReturn value TypeType DescriptionDescription
<binary-for-encoded-uri><binary-for-encoded-uri> stringstring Version décodée de la chaîne encodée sous forme d’URIThe decoded version for the URI-encoded string

ExempleExample

Dans cet exemple, la version de type chaîne décodée d’une chaîne encodée sous forme d’URI est créée :This example creates the decoded string version of a URI-encoded string:

uriComponentToString('http%3A%2F%2Fcontoso.com')

Le résultat retourné est https://contoso.com .And returns the result https://contoso.com.

uriHosturiHost

Retourne la valeur d’hôte d’un URI (Uniform Resource Identifier).Return the host value of a unified resource identifier (URI).

uriHost('<uri>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<uri><uri> OuiYes stringstring URI dont la valeur d’hôte doit être récupéréeThe URI whose host value you want
Valeur retournéeReturn value TypeType DescriptionDescription
<host-value><host-value> stringstring Valeur d’hôte de l’URI spécifiéThe host value of the specified URI

ExempleExample

Dans cet exemple, la valeur d’hôte de l’URI suivant est recherchée :This example finds the host value of the following URI:

uriHost('https://www.localhost.com:8080')

Le résultat retourné est www.localhost.com.And returns the result www.localhost.com.

uriPathuriPath

Retourne la valeur de chemin d’un URI (Uniform Resource Identifier).Return the path value of a unified resource identifier (URI).

uriPath('<uri>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<uri><uri> OuiYes stringstring URI dont la valeur de port doit être récupéréeThe URI whose path value you want
Valeur retournéeReturn value TypeType DescriptionDescription
<path-value><path-value> stringstring Valeur de chemin de l’URI spécifiéThe path value of the specified URI

ExempleExample

Dans cet exemple, la valeur de chemin de l’URI suivant est recherchée :This example finds the path value of the following URI:

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

Le résultat retourné est /catalog/shownew.htm.And returns the result /catalog/shownew.htm.

uriPathAndQueryuriPathAndQuery

Retourne les valeurs de chemin et de requête d’un URI (Uniform Resource Identifier).Return the path and query value of a unified resource identifier (URI).

uriPathAndQuery('<uri>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<uri><uri> OuiYes stringstring URI dont la valeur de chemin et de requête doit être récupéréeThe URI whose path and query value you want
Valeur retournéeReturn value TypeType DescriptionDescription
<path-query-value><path-query-value> stringstring Valeur de chemin et de requête de l’URI spécifiéThe path and query value of the specified URI

ExempleExample

Dans cet exemple, la valeur de chemin et de requête de l’URI suivant est recherchée :This example finds the path and query value of the following URI:

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Le résultat retourné est /catalog/shownew.htm?date=today.And returns the result /catalog/shownew.htm?date=today.

uriPorturiPort

Retourne la valeur de port d’un URI (Uniform Resource Identifier).Return the port value of a unified resource identifier (URI).

uriPort('<uri>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<uri><uri> OuiYes stringstring URI dont la valeur de port doit être récupéréeThe URI whose path value you want
Valeur retournéeReturn value TypeType DescriptionDescription
<port-value><port-value> stringstring Valeur de port de l’URI spécifiéThe port value of the specified URI

ExempleExample

Dans cet exemple, la valeur de port de l’URI suivant est recherchée :This example finds the port value of the following URI:

uriPort('http://www.localhost:8080')

Le résultat retourné est 8080.And returns the result 8080.

uriQueryuriQuery

Retourne la valeur de requête d’un URI (Uniform Resource Identifier).Return the query value of a unified resource identifier (URI).

uriQuery('<uri>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<uri><uri> OuiYes stringstring URI dont la valeur de schéma doit être récupéréeThe URI whose query value you want
Valeur retournéeReturn value TypeType DescriptionDescription
<query-value><query-value> stringstring Valeur de requête de l’URI spécifiéThe query value of the specified URI

ExempleExample

Dans cet exemple, la valeur de requête de l’URI suivant est recherchée :This example finds the query value of the following URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Le résultat retourné est ?date=today.And returns the result ?date=today.

uriSchemeuriScheme

Retourne la valeur de schéma d’un URI (Uniform Resource Identifier).Return the scheme value of a unified resource identifier (URI).

uriScheme('<uri>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<uri><uri> OuiYes stringstring URI dont la valeur de schéma doit être récupéréeThe URI whose query value you want
Valeur retournéeReturn value TypeType DescriptionDescription
<scheme-value><scheme-value> stringstring Valeur de schéma de l’URI spécifiéThe scheme value of the specified URI

ExempleExample

Dans cet exemple, la valeur de schéma de l’URI suivant est recherchée :This example finds the scheme value of the following URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Le résultat retourné est http.And returns the result http.

utcNowutcNow

Retourne l’horodatage actuel dans un format de paramètres régionaux facultatif sous forme de chaîne.Return the current timestamp in an optional locale format as a string.

utcNow('<format>', '<locale>'?)

Si vous le souhaitez, vous pouvez spécifier un autre format avec le paramètre <format>.Optionally, you can specify a different format with the <format> parameter.

ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<format><format> NonNo stringstring Modèle de format personnalisé.A custom format pattern. Le timestamp est par défaut au format ISO UTC AAAA-MM-JJTHH:mm:ss.fffZ, qui est conforme à la norme ISO 8601.The default format for the timestamp is UTC ISO format, YYYY-MM-DDTHH:mm:ss.fffZ, which complies with ISO 8601.
<locale><locale> NonNo stringstring Paramètres régionaux facultatifs des informations de cultureAn optional locale of culture infomation
Valeur retournéeReturn value TypeType DescriptionDescription
<current-timestamp><current-timestamp> stringstring Date et heure actuellesThe current date and time

Exemple 1Example 1

Supposons que la date soit le 15 avril 2018 à 13:00:00.Suppose the date is April 15, 2018 at 1:00:00 PM. Dans cet exemple, le timestamp est récupéré :This example gets the timestamp:

utcNow()

Le résultat retourné est 2018-04-15T13:00:00.000Z.And returns the result 2018-04-15T13:00:00.000Z.

Exemple 2Example 2

Supposons que la date soit le 15 avril 2018 à 13:00:00.Suppose the date is April 15, 2018 at 1:00:00 PM. Dans cet exemple, le timestamp actuel est récupéré au format D facultatif :This example gets the current timestamp using the optional D format:

utcNow('D')

Le résultat retourné est Sunday, April 15, 2018.And returns the result Sunday, April 15, 2018.

Exemple 3Example 3

Supposons que la date soit le 15 avril 2018 à 13:00:00.Suppose the date is April 15, 2018 at 1:00:00 PM. Cet exemple obtient l’horodateur actuel à l’aide de l’un des paramètres régionaux suivants :This example gets the current timestamp using the de-DE locale:

utcNow('', 'de-DE')

Et retourne le résultat 15.04.18 13:00:00.And returns the result 15.04.18 13:00:00.

wherewhere

Filtre sur chaque élément et retourne la nouvelle collection d’éléments filtrés qui respectent une condition spécifiée.Filter on each element and return the new collection of filtered elements which match a specific condition.

where([<collection/instance>], <iteratorName>, <function>)
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<collection/instance><collection/instance> OuiYes tableauarray Collection contenant les élémentsThe collection with the items
<iteratorName><iteratorName> OuiYes nom de l’itérateuriterater name Élément cléThe key item
<function><function> OuiYes expressionexpression Fonction de condition utilisée pour filtrer les élémentsCondition function used to filter items
Valeur retournéeReturn value TypeType DescriptionDescription
<new-collection/new-object><new-collection/new-object> Tableau/objetarray/object Nouvelle collection dont chaque élément a été filtré avec la fonctionThe new collection which each element has been filtered with the function

Exemple 1Example 1

Dans cet exemple, une nouvelle collection est générée :This example generates a new collection:

where(createArray(0, 1, 2, 3), x, x > 1)

Le résultat retourné est [2, 3] .And returns the result [2, 3].

Exemple 2Example 2

Ces exemples génèrent une nouvelle collection :These examples generate a new collection:

where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')

Et retournent le résultat ['Name : Jack', 'Age : 15 '].And return the result ['name:jack', 'age:15']. Notez que la deuxième expression est une expression lambda, qui est plus lisible.Note that the second expression is a lambda expression, which some find more readable.

Xmlxml

C# uniquement.C# only. Retourne la version XML d’une chaîne contenant un objet JSON.Return the XML version of a string that contains a JSON object.

xml('<value>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<value><value> OuiYes stringstring Chaîne contenant l’objet JSON à convertir. L’objet JSON ne doit avoir qu’une seule propriété racine, qui ne peut pas être un tableau.The string with the JSON object to convert The JSON object must have only one root property, which can't be an array. Utilisez \ comme caractère d’échappement pour le guillemet double (").Use \ as an escape character for the double quotation mark (").
Valeur retournéeReturn value TypeType DescriptionDescription
<xml-version><xml-version> objectobject Élément XML encodé correspondant à la chaîne ou à l’objet JSON spécifiéThe encoded XML for the specified string or JSON object

Exemple 1Example 1

Dans cet exemple, la version XML d’une chaîne contenant un objet JSON est créée :This example creates the XML version for a string, which contains a JSON object:

xml(json('{ \"name\": \"Sophia Owen\" }'))

Le résultat retourné est le XML :And returns the result XML:

<name>Sophia Owen</name>

Exemple 2Example 2

Prenons un objet JSON person :Suppose you have a person JSON object, seen below:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Dans cet exemple, l’élément XML d’une chaîne contenant cet objet JSON est créé :This example creates XML of a string that contains this JSON object:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

Le résultat retourné est le XML :And returns the result XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person

xPathxPath

C# uniquement.C# only. Vérifie si le code XML contient des valeurs ou des nœuds qui correspondent à une expression de langage XPath et retourne les valeurs ou les nœuds correspondants.Check XML for nodes or values that match an XPath (XML Path Language) expression, and return the matching nodes or values. Une expression XPath (appelée XPath) permet de parcourir une structure de document XML de façon à pouvoir sélectionner des nœuds ou des valeurs de calcul dans le contenu XML.An XPath expression (referred to as XPath) helps you navigate an XML document structure so that you can select nodes or compute values in the XML content.

xPath('<xml>', '<xpath>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<xml><xml> OuiYes n'importe laquelleany Chaîne XML pour rechercher des nœuds ou des valeurs qui correspondent à une valeur d’expression XPathThe XML string to search for nodes or values that match an XPath expression value
<xPath><xPath> OuiYes n'importe laquelleany Expression XPath utilisée pour rechercher des nœuds ou des valeurs XML correspondantsThe XPath expression used to find matching XML nodes or values
Valeur retournéeReturn value TypeType DescriptionDescription
<xml-node><xml-node> XMLXML Nœud XML lorsqu’un seul nœud correspond à l’expression XPath spécifiéeAn XML node when only a single node matches the specified XPath expression
<value><value> n'importe laquelleany Valeur d’un nœud XML lorsqu’un seul nœud correspond à l’expression XPath spécifiéeThe value from an XML node when only a single value matches the specified XPath expression
< [, , ...] ou [, , ...] ><[, , ...] -or- [, , ...]> tableauarray Tableau contenant des nœuds ou valeurs XML qui correspondent à l’expression XPath spécifiéeAn array with XML nodes or values that match the specified XPath expression

Exemple 1Example 1

Cet exemple recherche les nœuds qui correspondent au nœud <name></name> dans les arguments spécifiés, et retourne un tableau contenant ces valeurs de nœud :This example finds nodes that match the <name></name> node in the specified arguments, and returns an array with those node values:

xpath(items, '/produce/item/name')

Parmi les arguments figure la chaîne items contenant ce code XML :The arguments include the items string, which contains this XML:

"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"

Le tableau retourné comporte les nœuds qui correspondent à <name></name> :Here's the resulting array with the nodes that match <name></name>:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Exemple 2Example 2

Dans cet exemple, qui s’appuie sur l’exemple 1, les nœuds qui correspondent au nœud <count></count> sont recherchés et ces valeurs de nœud sont ajoutées avec la fonction sum() :Following example 1, this example finds nodes that match the <count></count> node and adds those node values with the sum() function:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Le résultat retourné est 30.And returns the result 30.

yearyear

Retourne l’année du timestamp spécifié.Return the year of the specified timestamp.

year('<timestamp>')
ParamètreParameter ObligatoireRequired TypeType DescriptionDescription
<timestamp><timestamp> OuiYes stringstring Chaîne qui contient l’horodatageThe string that contains the timestamp
Valeur retournéeReturn value TypeType DescriptionDescription
<year><year> entierinteger Année du timestamp spécifiéThe year in the specified timestamp

ExempleExample

Dans cet exemple, le timestamp de l’année est évalué :This example evaluates the timestamp for the year:

year('2018-03-15T00:00:00.000Z')

Le résultat retourné est 2018.And it returns the result 2018.