Fördefinierade funktioner för anpassningsbara uttryck

GÄLLER FÖR: SDK v4

Den här artikeln innehåller en lista över tillgängliga fördefinierade funktioner som ordnas efter deras allmänna syfte. Information om operatorer som används i fördefinierade funktioner och uttryckssyntax finns i Operatorer.

Fördefinierade uttryck är indelade i följande funktionstyper:

• Sträng
• Samling
• Logisk jämförelse
• Konvertering
• Matematik
• Datum
• Timex
• URI-parsning
• Objektmanipulering och konstruktion
• Reguljärt uttryck
• Typkontroll

Du kan också visa listan i alfabetisk ordning.

Strängfunktioner

Funktion	Förklaring
length	Returnera längden på en sträng.
ersätt	Ersätt en delsträng med den angivna strängen och returnera den uppdaterade strängen. Den här funktionen är skiftlägeskänslig.
replaceIgnoreCase	Ersätt en delsträng med den angivna strängen och returnera den uppdaterade strängen. Den här funktionen är skiftlägeskänslig.
dela	Returnera en matris som innehåller delsträngar baserat på den angivna avgränsare.
Delsträng	Returnera tecken från en sträng.
toLower	Returnera en sträng i gemener i ett valfritt språkformat.
toUpper	Returnera en sträng i versaler i ett valfritt språkformat.
Trimma	Ta bort inledande och avslutande blanksteg från en sträng.
addOrdinal	Returnera ordningstalet för indatanumret.
endsWith	Kontrollera om en sträng slutar med en specifik delsträng. Returnera true om delsträngen hittas eller returnera false om den inte hittas. Den här funktionen är skiftlägeskänslig.
startsWith	Kontrollera om en sträng börjar med en specifik delsträng. Returnera true om delsträngen hittas eller returnera false om den inte hittas. Den här funktionen är skiftlägeskänslig.
countWord	Returnera antalet ord i den angivna strängen.
Concat	Kombinera två eller flera strängar och returnera den resulterande strängen.
newGuid	Returnera en ny Guid-sträng.
indexOf	Returnera startpositionen eller indexvärdet för en delsträng eller söker efter det angivna objektet och returnerar det nollbaserade indexet för den första förekomsten i hela listan. Den här funktionen är skiftlägeskänslig och index börjar med talet 0.
lastIndexOf	Returnera startpositionen eller indexvärdet för den senaste förekomsten av en delsträng eller sök efter det angivna objektet och returnera det nollbaserade indexet för den senaste förekomsten inom elementområdet i listan. Den här funktionen är skiftlägeskänslig och index börjar med talet 0.
sentenceCase	Versalisera den första bokstaven i det första ordet i en sträng i ett valfritt lokalt format.
titleCase	Versalisera den första bokstaven i varje ord i en sträng i ett valfritt språkformat.
omvänd	Ändra ordningen på elementen i en sträng eller matris.

Insamlingsfunktioner

Funktion	Förklaring
Innehåller	Fungerar för att hitta ett objekt i en sträng, för att hitta ett objekt i en matris eller för att hitta en parameter i ett komplext objekt. Exempel: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
Första	Returnera det första objektet från samlingen.
join	Returnera en sträng som innehåller alla objekt från en matris och där varje tecken avgränsas med en avgränsare. Exempel: join(createArray('a','b'), '.') = "a.b"
Senaste	Returnera det sista objektet från samlingen.
antal	Returnera antalet objekt i samlingen.
Foreach	Använd varje element och returnera den nya samlingen.
Unionen	Returnera en samling som innehåller alla objekt från de angivna samlingarna.
Hoppa över	Ta bort objekt från framsidan av en samling och returnera de återstående objekten.
Ta	Returnera objekt från framsidan av en samling.
Korsningen	Returnera en samling som bara har de vanliga objekten i de angivna samlingarna.
subArray	Returnera en underordning från angiven start- och slutposition. Indexvärden börjar med talet 0.
Välj	Arbeta på varje element och returnera den nya samlingen transformerade element.
Där	Filtrera på varje element och returnera den nya samlingen filtrerade element som matchar det specifika villkoret.
sortBy	Sortera element i samlingen i stigande ordning och returnera den sorterade samlingen.
sortByDescending	Sortera element i samlingen i fallande ordning och returnera den sorterade samlingen.
indexAndValues	Omvandla en matris eller ett objekt till en matris med objekt med index- och värdeegenskap.
Platta	Platta ut matriser till en matris med värden som inte är matrisvärden.
Unik	Ta bort alla dubbletter från en matris.
Någon	Avgör om några element i en sekvens uppfyller ett villkor.
alla	Avgör om alla element i en sekvens uppfyller ett villkor.
omvänd	Ändra ordningen på elementen i en sträng eller matris.
Sammanfoga	Sammanfogar flera JSON-objekt eller objekt i en matris tillsammans.

Logiska jämförelsefunktioner

Funktion	Förklaring
and	Logiskt och. Returnera sant om alla angivna uttryck utvärderas till true.
Motsvarar	Jämförelse lika med. Returnera sant om angivna värden är lika med.
empty	Kontrollera om målet är tomt.
greater	Jämförelse större än. Returnera true om det första värdet är mer eller returnera false om det är mindre.
greaterOrEquals	Jämförelse större än eller lika med. Returnera true om det första värdet är större eller lika med, eller returnera false om det första värdet är mindre.
Om	Kontrollera om ett uttryck är sant eller falskt. Baserat på resultatet returnerar du ett angivet värde.
less	Jämförelse mindre än åtgärd. Returnera true om det första värdet är mindre eller returnera false om det första värdet är mer.
lessOrEquals	Jämförelse mindre än eller lika med åtgärd. Returnera true om det första värdet är mindre än eller lika med, eller returnera false om det första värdet är mer.
Inte	Logisk operator inte. Returnera true om uttrycket är falskt eller returnera false om det är sant.
or	Logiskt eller åtgärd. Returnera true om minst ett uttryck är sant eller returnera false om alla är falska.
Finns	Utvärdera ett uttryck för sanning.

Konverteringsfunktioner

Funktion	Förklaring
Flyta	Returnera flyttalsrepresentationen av den angivna strängen.
Int	Returnera heltalsrepresentationen av den angivna strängen.
Sträng	Returnera strängversionen av det angivna värdet i ett valfritt språkformat.
Bool	Returnera den booleska representationen av den angivna strängen.
createArray	Skapa en matris från flera indata.
Json	Returnera JSON-typvärdet (JavaScript Object Notation) eller objektet för en sträng eller XML.
base64	Returnera den base64-kodade versionen av en sträng- eller bytematris.
base64ToBinary	Returnera den binära versionen för en base64-kodad sträng.
base64ToString	Returnera strängversionen av en base64-kodad sträng.
Binära	Returnera den binära versionen för ett indatavärde.
dataUri	Returnera URI:n för ett indatavärde.
dataUriToBinary	Returnera den binära versionen av en data-URI.
dataUriToString	Returnera strängversionen av en data-URI.
uriComponent	Returnera den URI-kodade versionen för ett indatavärde genom att ersätta URL-osäkra tecken med escape-tecken.
uriComponentToString	Returnera strängversionen av en URI-kodad sträng.
xml	Returnera XML-versionen av en sträng.
formatNumber	Formatera ett värde till närmaste tal till det angivna antalet bråksiffror och ett valfritt angivet språk.
jsonStringify	Returnera JSON-strängen för ett värde.
stringOrValue Wrap stränginterpolation för att hämta det verkliga värdet. Till exempel stringOrValue('${1}') returnerar talet 1, medan stringOrValue('${1} item') returnerar strängen "1 objekt".

Matematikfunktioner

Funktion	Förklaring
Abs	Returnerar det absoluta värdet för det angivna talet.
Add	Matematisk och. Returnera resultatet från att lägga till två tal (rent talfall) eller sammanfoga två eller flera strängar.
Div	Matematisk division. Returnera heltalsresultatet från att dela upp två tal.
Max	Returnera det största värdet från en samling.
Min	Returnera det minsta värdet från en samling.
Mod	Returnera resten från att dela upp två tal.
mul	Matematisk multiplikation. Returnera produkten från att multiplicera två tal.
Rand	Returnera ett slumpmässigt tal mellan angivet min- och maxvärde.
Rot	Returnera kvadratroten för ett angivet tal.
Sub	Matematisk subtraktion. Returnera resultatet från att subtrahera det andra talet från det första talet.
Summan	Returnera summan av talen i en matris.
intervall	Returnera en heltalsmatris som startar från ett angivet heltal.
Exp	Returnera exponentering av ett tal till ett annat.
Genomsnittliga	Returnera det genomsnittliga antalet för en numerisk matris.
Golvet	Returnera det största integralvärdet som är mindre än eller lika med det angivna talet.
Tak	Returnera det minsta integralvärdet som är större än eller lika med det angivna talet.
Runda	Avrunda ett värde till närmaste heltal eller till det angivna antalet bråksiffror.

Översikt över datum- och tidsfunktioner

Funktion	Förklaring
addDays	Lägg till ett antal angivna dagar i en viss tidsstämpel i ett valfritt språkformat.
addHours	Lägg till ett angivet antal timmar i en viss tidsstämpel i ett valfritt språkformat.
addMinutes	Lägg till ett angivet antal minuter i en viss tidsstämpel i ett valfritt språkformat.
addSeconds	Lägg till ett angivet antal sekunder i en viss tidsstämpel.
dayOfMonth	Returnera dagen i en månad för en viss tidsstämpel eller ett tidsstämpeluttryck.
dayOfWeek	Returnera veckodagen för en viss tidsstämpel.
dayOfYear	Returnera dagen på året för en viss tidsstämpel.
formatDateTime	Returnera en tidsstämpel i ett valfritt språkformat.
formatEpoch	Returnera en tidsstämpel i ett valfritt språkformat från UNIX Epoch-tid (Unix-tid, POSIX-tid).
formatTicks	Returnera en tidsstämpel i ett valfritt språkformat från fästingar.
subtractFromTime	Subtrahera ett antal tidsenheter från en tidsstämpel i ett valfritt språkformat.
utcNow	Returnera den aktuella tidsstämpeln i ett valfritt språkformat som en sträng.
dateReadBack	Använd datum-tid-biblioteket för att ange en återläsning av datum.
Månad	Returnera månaden för angiven tidsstämpel.
Datum	Returnera datumet för en viss tidsstämpel.
År	Returnera året för den angivna tidsstämpeln.
getTimeOfDay	Returnera tiden på dagen för en viss tidsstämpel.
getFutureTime	Returnera den aktuella tidsstämpeln i ett valfritt språkformat plus de angivna tidsenheterna.
getPastTime	Returnera den aktuella tidsstämpeln i ett valfritt språkformat minus de angivna tidsenheterna.
addToTime	Lägg till ett antal tidsenheter i en tidsstämpel i ett valfritt språkformat.
convertFromUTC	Konvertera en tidsstämpel i ett valfritt språkformat från Universal Time Coordinated (UTC).
convertToUTC	Konvertera en tidsstämpel i ett valfritt språkformat till Universal Time Coordinated (UTC).
startOfDay	Returnera dagens start för en tidsstämpel i ett valfritt språkformat.
startOfHour	Returnera timmens start för en tidsstämpel i ett valfritt språkformat.
startOfMonth	Returnera början av månaden för en tidsstämpel i ett valfritt språkformat.
Fästingar	Returnera egenskapsvärdet ticks för en angiven tidsstämpel.
ticksToDays	Konvertera ett egenskapsvärde för tick till antalet dagar.
ticksToHours	Konvertera ett egenskapsvärde för tick till antalet timmar.
ticksToMinutes	Konvertera ett egenskapsvärde för tick till antalet minuter.
dateTimeDiff	Returnera skillnaden i fästingar mellan två tidsstämplar.
getPreviousViableDate	Returnera det tidigare livskraftiga datumet för ett Timex-uttryck baserat på aktuellt datum och en valfri angiven tidszon.
getNextViableDate	Returnera nästa livskraftiga datum för ett Timex-uttryck baserat på aktuellt datum och en valfri angiven tidszon.
getPreviousViableTime	Returnera den tidigare gångbara tiden för ett Timex-uttryck baserat på aktuell tid och en valfri angiven tidszon.
getNextViableTime	Returnera nästa livskraftiga tid för ett Timex-uttryck baserat på aktuell tid och en valfri angiven tidszon.

Timex-funktioner

Funktion	Förklaring
isPresent	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till nuet.
isDuration	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till en varaktighet.
isTime	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till en tid.
isDate	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till ett datum.
isTimeRange	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till ett tidsintervall.
isDateRange	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till ett datumintervall.
isDefinite	Returnera sant om TimexProperty- eller Timex-uttrycket refererar till en bestämd dag.
Lösa	Returnera en sträng med ett angivet TimexProperty- eller Timex-uttryck om det refererar till en giltig tid. Giltig tid innehåller timmar, minuter och sekunder.

URI tolkningsfunktioner

Funktion	Förklaring
uriHost	Returnera värdvärdet för en enhetlig resursidentifierare (URI).
uriPath	Returnera sökvägsvärdet för en enhetlig resursidentifierare (URI).
uriPathAndQuery	Returnera sökvägen och frågevärdena för en enhetlig resursidentifierare (URI).
uriPort	Returnera portvärdet för en enhetlig resursidentifierare (URI).
uriQuery	Retur0sn frågevärdet för en enhetlig resursidentifierare (URI).
uriScheme	Returnera schemavärdet för en enhetlig resursidentifierare (URI).

Objektmanipulering och konstruktionsfunktioner

Funktion	Förklaring
addProperty	Lägg till en egenskap och dess värde, eller namn/värde-par, i ett JSON-objekt och returnera det uppdaterade objektet.
removeProperty	Ta bort en egenskap från JSON-objektet och returnera det uppdaterade objektet.
Setproperty	Ange värdet för ett JSON-objekts egenskap och returnera det uppdaterade objektet.
getProperty	Returnera värdet för en angiven egenskap eller rotegenskap från ett JSON-objekt.
sammanstärning	Returnera det första värdet som inte är null från en eller flera parametrar.
Xpath	Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden.
jPath	Kontrollera JSON eller en JSON-sträng för noder eller värden som matchar ett sökvägsuttryck och returnera matchande noder.
setPathToValue	Ange värdet för en specifik sökväg och returnera värdet.

Funktioner för reguljära uttryck

Funktion	Förklaring
isMatch	Returnera sant om en sträng matchar ett vanligt regex-mönster.

Funktioner för typkontroll

Funktion	Förklaring
EOL	Returnera slutet av radsekvenstexten (EOL).
isInteger	Returnera sant om angivna indata är ett heltalsnummer
isFloat	Returnera sant om den angivna indatan är ett flyttalpunktsnummer
isBoolean	Returnera sant om de angivna indata är booleska.
isArray	Returnera sant om angivna indata är en matris.
isObject	Returnera sant om angivna indata är ett objekt.
isDateTime	Returnera sant om angivna indata är en tidsstämpel för UTC ISO-format.
isString	Returnerar sant om angivna indata är en sträng.

Fördefinierade funktioner sorterade alfabetiskt

Abs

Returnera det absoluta värdet för det angivna talet.

abs(<number>)

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	Nummer	Tal för att hämta det absoluta värdet för

Returvärde	Typ	Description
<Resultatet>	Nummer	Resultatet från beräkning av det absoluta värdet.

Exempel

I de här exemplen beräknas det absoluta värdet:

abs(3.12134)
abs(-3.12134)

Och båda returnerar resultatet 3.12134.

add

Returnera resultatet från att lägga till två eller flera tal (rent talfall) eller sammanfoga två eller flera strängar (annat skiftläge).

add(<item1>, <item2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<item1>, <item2>,...	Ja	någon	objekt

Returvärde	Typ	Beskrivning
<result-sum>	tal eller sträng	Resultatet från att lägga till de angivna talen eller det sammanfogade resultatet.

Exempel

Det här exemplet lägger till de angivna talen:

add(1, 1.5)

Och returnerar resultatet 2,5.

I det här exemplet sammanfogas de angivna objekten:

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

Och returnerar resultatet

• Hej
• helloworld

addDays

Lägg till ett antal dagar i en tidsstämpel i ett valfritt språkformat.

addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln som måste vara standard-UTC ISO-format ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ
<Dagar>	Ja	integer	Det positiva eller negativa antalet dagar som ska läggas till
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Tidsstämpeln plus det angivna antalet dagar

Exempel 1

Det här exemplet lägger till 10 dagar till den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-25T00:00:00.000Z.

Exempel 2

Det här exemplet subtraherar fem dagar från den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-10T00:00:00.000Z.

Exempel 3

Det här exemplet lägger till 1 dag till den angivna tidsstämpeln i de-DE-språket:

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

Och returnerar resultatet 16.03.18 13:00:00.

addHours

Lägg till ett antal timmar i en tidsstämpel i ett valfritt språkformat.

addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<hours>	Ja	integer	Det positiva eller negativa antalet timmar som ska läggas till
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Tidsstämpeln plus det angivna antalet timmar

Exempel 1

Det här exemplet lägger till 10 timmar till den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-15T10:00:00.000Z.

Exempel 2

Det här exemplet subtraherar fem timmar från den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-15T10:00:00.000Z.

Exempel 3

Det här exemplet lägger till 2 timmar till den angivna tidsstämpeln i de-DE-språket:

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

Och returnerar resultatet 15.03.18 15:00:00.

addMinutes

Lägg till ett antal minuter i en tidsstämpel i ett valfritt språkformat.

addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<minutes>	Ja	integer	Det positiva eller negativa antalet minuter som ska läggas till
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Tidsstämpeln plus det angivna antalet minuter

Exempel 1

Det här exemplet lägger till 10 minuter till den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-15T00:20:00.000Z.

Exempel 2

Det här exemplet subtraherar fem minuter från den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-15T00:15:00.000Z.

Exempel 3

Det här exemplet lägger till 30 minuter till den angivna tidsstämpeln i de-DE-språket:

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

Och returnerar resultatet 15.03.18 13:30:00.

addOrdinal

Returnera ordningstalet för indatanumret.

addOrdinal(<number>)

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	integer	Talen som ska konverteras till ett ordningstal

Returvärde	Typ	Description
<Resultatet>	sträng	Ordningstalet som konverterats från indatanumret

Exempel

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

Respektive returnerar följande resultat:

• 11.00
• 12.00
• 13:e
• 21:a
• 22.00
• 23:e

addProperty

Lägg till en egenskap och dess värde, eller namn/värde-par, i ett JSON-objekt och returnera det uppdaterade objektet. Om objektet redan finns vid körning utlöser funktionen ett fel.

addProperty('<object>', '<property>', value)

Parameter	Obligatoriskt	Type	Beskrivning
<Objekt>	Ja	objekt	JSON-objektet där du vill lägga till en egenskap
<Egenskapen>	Ja	sträng	Namnet på den egenskap som ska läggas till
<värde>	Ja	någon	Värdet på egenskapen

Returvärde	Typ	Beskrivning
<updated-object>	objekt	Det uppdaterade JSON-objektet efter att en ny egenskap har lagts till

Exempel

Det här exemplet lägger till egenskapen accountNumber i objektet customerProfile, som konverteras till JSON med funktionen json(). Funktionen tilldelar ett värde som genereras av funktionen newGuid() och returnerar det uppdaterade objektet:

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

addSeconds

Lägg till ett antal sekunder i en tidsstämpel.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<Sekunder>	Ja	integer	Det positiva eller negativa antalet sekunder som ska läggas till
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Tidsstämpeln plus det angivna antalet sekunder

Exempel 1

Det här exemplet lägger till 10 sekunder till den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-15T00:00:10.000Z.

Exempel 2

Det här exemplet subtraherar fem sekunder till den angivna tidsstämpeln:

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

Och returnerar resultatet 2018-03-15T00:00:25.000Z.

addToTime

Lägg till ett antal tidsenheter i en tidsstämpel i ett valfritt språkformat. Se även getFutureTime().

addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<interval>	Ja	integer	Antalet angivna tidsenheter som ska läggas till
<timeUnit>	Ja	sträng	Den tidsenhet som ska användas med intervall. Möjliga enheter är "Second", "Minute", "Hour", "Day", "Week", "Month" och "Year".
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Tidsstämpeln plus antalet angivna tidsenheter med angivet format.

Exempel 1

Det här exemplet lägger till en dag i angiven tidsstämpel.

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

Och returnerar resultatet 2018-01-02T00:00:00.000Z.

Exempel 2

Det här exemplet lägger till två veckor till den angivna tidsstämpeln.

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

Och returnerar resultatet i formatet "MM-DD-YY" som 01-15-18.

alla

Avgör om alla element i en sekvens uppfyller ett villkor.

all(<sequence>, <item>, <condition>)

Parameter	Obligatoriskt	Type	Beskrivning
<Sekvens>	Ja	objekt	En sekvens som ska utvärderas.
<Objekt>	Ja	sträng	Refererar till de element som ska utvärderas i sekvensen.
<Villkor>	Ja	Uttryck	Uttrycket för att utvärdera villkoret.

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om alla element uppfyller ett villkor. Returnera false om minst en inte gör det.

Exempel

De här exemplen avgör om alla element i en sekvens uppfyller ett villkor:

all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))

Och returnera följande resultat:

• false eftersom båda objekten i sekvensen inte är heltal.
• sant eftersom båda objekten i sekvensen är heltal.

and

Kontrollera om alla uttryck är sanna. Returnera true om alla uttryck är sanna eller returnerar false om minst ett uttryck är falskt.

and(<expression1>, <expression2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<expression1>, <expression2>, ...	Ja	Booleskt	De uttryck som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om alla uttryck är sanna. Returnera false om minst ett uttryck är falskt.

Exempel 1

De här exemplen kontrollerar om de angivna booleska värdena är sanna:

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

Respektive returnerar följande resultat:

• Båda uttrycken är sanna, så funktionerna returnerar true.
• Ett uttryck är falskt, så funktionerna returnerar false.
• Båda uttrycken är falska, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken är sanna:

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

Respektive returnerar följande resultat:

• Båda uttrycken är sanna, så funktionerna returnerar true.
• Ett uttryck är falskt, så funktionerna returnerar false.
• Båda uttrycken är falska, så funktionerna returnerar false.

någon

Avgör om några element i en sekvens uppfyller ett villkor.

all(<sequence>, <item>, <condition>)

Parameter	Obligatoriskt	Type	Beskrivning
<Sekvens>	Ja	objekt	En sekvens som ska utvärderas.
<Objekt>	Ja	sträng	Refererar till de element som ska utvärderas i sekvensen.
<Villkor>	Ja	Uttryck	Uttrycket för att utvärdera villkoret.

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om alla element uppfyller villkoret. Returnera false om minst en inte gör det.

Exempel

De här exemplen avgör om alla element i en sekvens uppfyller ett villkor:

any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))

Och returnera följande resultat:

• sant, eftersom minst ett objekt i sekvensen är ett heltal
• false eftersom inget av objekten i sekvensen är ett heltal.

Genomsnittliga

Returnera antalet medelvärden för en numerisk matris.

average(<numericArray>)

Parameter	Obligatoriskt	Type	Beskrivning
<numericArray>	Ja	matris med tal	Indatamatrisen för att beräkna medelvärdet

Returvärde	Typ	Beskrivning
<average-of-array>	Nummer	Det genomsnittliga värdet för den angivna matrisen

Exempel

I det här exemplet beräknas medelvärdet för matrisen i createArray():

average(createArray(1,2,3))

Och returnerar resultatet 2.

base64

Returnera den base64-kodade versionen av en sträng- eller bytematris.

base64('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng- eller bytematris	Indatasträngen

Returvärde	Typ	Beskrivning
<base64-string>	sträng	Den base64-kodade versionen av indatasträngen

Exempel 1

I det här exemplet konverteras strängen hello till en base64-kodad sträng:

base64('hello')

Och returnerar resultatet "aGVsbG8=".

Exempel 2

Det här exemplet tar byteArr, vilket är lika med new byte[] { 3, 5, 1, 12 }:

base64('byteArr')

Och returnerar resultatet "AwUBDA==".

base64ToBinary

Returnera den binära matrisen för en base64-kodad sträng.

base64ToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Den base64-kodade sträng som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-base64-string>	bytematris	Binärversionen av den base64-kodade strängen

Exempel

I det här exemplet konverteras den base64-kodade strängen AwUBDA== till en binär sträng:

base64ToBinary('AwUBDA==')

Och returnerar resultatet ny byte[] { 3, 5, 1, 12 }.

base64ToString

Returnera strängversionen av en base64-kodad sträng, vilket effektivt avkodar base64-strängen.

base64ToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Den base64-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<decoded-base64-string>	sträng	Strängversionen av en base64-kodad sträng

Exempel

Det här exemplet konverterar den base64-kodade strängen aGVsbG8= till en avkodad sträng:

base64ToString('aGVsbG8=')

Och returnerar resultatet hello.

binary

Returnera den binära versionen av en sträng.

binary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<binary-for-input-value>	bytematris	Den binära versionen av den angivna strängen

Exempel

I det här exemplet konverteras strängen hello till en binär sträng:

binary('hello')

Och returnerar resultatet new byte[] { 104, 101, 108, 108, 111 }.

bool

Returnera den booleska versionen av ett värde.

bool(<value>)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	någon	Värdet som ska konverteras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Den booleska versionen av det angivna värdet

Exempel

I de här exemplen konverteras de angivna värdena till booleska värden:

bool(1)
bool(0)

Respektive returnerar följande resultat:

• true
• false

Tak

Returnera det största integralvärdet som är mindre än eller lika med det angivna talet.

ceiling('<number>')

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	Nummer	Ett indatanummer

Returvärde	Typ	Beskrivning
<heltalsvärde>	integer	Det största integralvärdet som är större än eller lika med indatanumret

Exempel

Det här exemplet returnerar det största integralvärdet mindre än eller lika med talet 10,333:

ceiling(10.333)

Och returnerar heltal 11.

sammanstärning

Returnera det första värdet som inte är null från en eller flera parametrar. Tomma strängar, tomma matriser och tomma objekt är inte null.

coalesce(<object**1>, <object**2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<object**1>, <object**2>, ...	Ja	alla (blandade typer är godtagbara)	Ett eller flera objekt att söka efter null

Returvärde	Typ	Beskrivning
<first-non-null-item>	någon	Det första objektet eller värdet som inte är null. Om alla parametrar är null returnerar den här funktionen null.

Exempel

De här exemplen returnerar det första värdet som inte är null från de angivna värdena eller null när alla värden är null:

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

Respektive retur:

• true
• Hej
• NULL

concat

Kombinera två eller flera objekt och returnera de kombinerade objekten i en lista eller sträng.

concat('<text1>', '<text2>', ...)

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>, ...	Ja	någon	Minst två objekt att sammanfoga.

Returvärde	Typ	Beskrivning
<object1object2...>	sträng eller lista	Den kombinerade strängen eller listan. Null-värden hoppas över.

Förväntade returvärden:

• Om alla objekt är listor returneras en lista.
• Om det finns ett objekt som inte är en lista returneras en sträng.
• Om ett värde är null hoppas det över och sammanfogas inte.

Exempel

I det här exemplet kombineras strängarna Hello och World:

concat('Hello', 'World')

Och returnerar resultatet HelloWorld.

Exempel 2

I det här exemplet kombineras listorna [1,2] och [3,4]:

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

Och returnerar resultatet [1,2,3,4].

Exempel 3

De här exemplen kombinerar objekt av olika typer:

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

Och returnera följande resultat:

• Strängen ab12.
• Objektet aSystem.Collections.Generic.List 1[System.Object]. Detta är oläsligt och bäst att undvika.

Exempel 4

De här exemplen kombinerar objekt kommer att null:

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

Och returnera följande resultat:

• Listan [1,2].
• Strängen a1.

innehåller

Kontrollera om en samling har ett specifikt objekt. Returnera true om objektet hittas eller returnera false om det inte hittas. Den här funktionen är skiftlägeskänslig.

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

Den här funktionen fungerar på följande samlingstyper:

• En sträng för att hitta en delsträng
• En matris för att hitta ett värde
• En ordlista för att hitta en nyckel

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng, matris eller ordlista	Samlingen som ska kontrolleras
<värde>	Ja	sträng, matris eller ordlista	Objektet som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om objektet hittas. Returnera false om det inte hittas.

Exempel 1

Det här exemplet kontrollerar strängens hello-värld för understrängsvärlden:

contains('hello world', 'world')

Och returnerar resultatet true.

Exempel 2

I det här exemplet kontrolleras strängens hello-värld för substring-universumet:

contains('hello world', 'universe')

Och returnerar resultatet false.

antal

Returnera antalet objekt i en samling.

count('<collection>')
count([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng eller matris	Samlingen med de objekt som ska räknas

Returvärde	Typ	Beskrivning
<längd eller antal>	integer	Antalet objekt i samlingen

Exempel:

I de här exemplen räknas antalet objekt i dessa samlingar:

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

Och båda returnerar resultatet 4.

countWord

Returnera antalet ord i en sträng

countWord('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som ska räknas

Returvärde	Typ	Beskrivning
<antal>	integer	Antalet ord i strängen

Exempel

I det här exemplet räknas antalet ord i strängens hello-värld:

countWord("hello word")

Och det returnerar resultatet 2.

convertFromUTC

Konvertera en tidsstämpel i ett valfritt språkformat från Universal Time Coordinated (UTC) till en måltidszon.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<destinationTimeZone>	Ja	sträng	Namnet på måltidszonen. Stöder Tidszoner för Windows och IANA.
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är formatet "o", åååå-MM-ddTHH:mm:ss.fffffffK, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	sträng	Tidsstämpeln konverterad till måltidszonen

Exempel:

De här exemplen konverterar från UTC till 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')

Respektive returnera dessa resultat:

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

Exempel 2

Det här exemplet konverterar en tidsstämpel i språkvarianten en-US från UTC till Pacific Standard Time:

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

Och returnerar resultatet måndag 1 januari 2018.

convertToUTC

Konvertera en tidsstämpel i ett valfritt språkformat till Universal Time Coordinated (UTC) från källtidszonen.

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<sourceTimeZone>	Ja	sträng	Namnet på måltidszonen. Stöder Tidszoner för Windows och IANA.
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<konverterad tidsstämpel>	sträng	Tidsstämpeln konverterad till måltidszonen

Exempel

Det här exemplet konverterar en tidsstämpel till UTC från Pacific Standard Time

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

Och returnerar resultatet 2018-01-01T08:00:00.000Z.

Exempel 2

I det här exemplet konverteras en tidsstämpel i språkvarianten de-DE till UTC från Pacific Standard Time:

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

Och returnerar resultatet 01.01.18 08:00:00.

createArray

Returnera en matris från flera indata.

createArray('<object1>', '<object2>', ...)

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>, ...	Ja	något, men inte blandat	Minst två objekt för att skapa matrisen

Returvärde	Typ	Beskrivning
[<object1>, <object2>, ...]	matris	Matrisen som skapats från alla indataobjekt

Exempel

I det här exemplet skapas en matris från följande indata:

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

Och returnerar resultatet [h ,e, l, l, o].

dataUri

Returnera en datauniform resursidentifierare (URI) för en sträng.

dataUri('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
[<date-uri>]	sträng	Data-URI för indatasträngen

Exempel

dataUri('hello')

Returnerar resultatdata :text/oformaterad; charset=utf-8; base64,aGVsbG8=.

dataUriToBinary

Returnera den binära versionen av en datauniform resursidentifierare (URI).

dataUriToBinary('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Data-URI:n som ska konverteras

Returvärde	Typ	Beskrivning
[<binary-for-data-uri>]	bytematris	Den binära versionen av data-URI:n

Exempel

Det här exemplet skapar en binär version för följande data-URI:

dataUriToBinary('aGVsbG8=')

Och returnerar resultatet new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }.

dataUriToString

Returnera strängversionen av en URI (Data Uniform Resource Identifier).

dataUriToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Data-URI:n som ska konverteras

Returvärde	Typ	Beskrivning
[<string-for-data-uri>]	sträng	Strängversionen av data-URI:n

Exempel

I det här exemplet skapas en sträng från följande data-URI:

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

Och returnerar resultatet hello.

datum

Returnera datumet för en angiven tidsstämpel i m/dd/åååå-format .

date('<timestramp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<Datum>	sträng	Datumet för den angivna tidsstämpeln

date('2018-03-15T13:00:00.000Z')

Returnerar resultatet 3-15-2018.

dateReadBack

Använder datum-tid-biblioteket för att ange en återläsning av datum.

dateReadBack('<currentDate>', '<targetDate>')

Parameter	Obligatoriskt	Type	Beskrivning
<currentDate>	Ja	sträng	Strängen som innehåller aktuellt datum
<targetDate>	Ja	sträng	Strängen som innehåller måldatumet

Returvärde	Typ	Beskrivning
<date-readback>	sträng	Återläsningen mellan aktuellt datum och måldatumet

Exempel 1

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

Returnerar resultatet i morgon.

dateTimeDiff

Returnera skillnaden i fästingar mellan två tidsstämplar.

dateTimeDiff('<timestamp1>', '<timestamp2>')

Parameter	Obligatoriskt	Type	Beskrivning
<tidsstämpel1>	Ja	sträng	Den första tidsstämpelsträngen som ska jämföras
<tidsstämpel2>	Ja	sträng	Den andra tidsstämpelsträngen att jämföra

Returvärde	Typ	Beskrivning
<Fästingar>	Nummer	Skillnaden i fästingar mellan två tidsstämplar

Exempel 1

Det här exemplet returnerar skillnaden i fästingar mellan två tidsstämplar:

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

Och returnerar talet 3153600000000000.

Exempel 2

Det här exemplet returnerar skillnaden i fästingar mellan två tidsstämplar:

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

Returnerar resultatet -3153600000000000. Värdet är ett negativt tal.

dayOfMonth

Returnera dagen i månaden från en tidsstämpel.

dayOfMonth('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<dag i månaden>	integer	Dagen i månaden från den angivna tidsstämpeln

Exempel

Det här exemplet returnerar talet för dagen i månaden från följande tidsstämpel:

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

Och returnerar resultatet 15.

dayOfWeek

Returnera veckodagen från en tidsstämpel.

dayOfWeek('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<veckodag>	integer	Veckodagen från den angivna tidsstämpeln. Söndag är 0, måndag är 1, och så vidare.

Exempel

Det här exemplet returnerar talet för veckodagen från följande tidsstämpel:

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

Och returnerar resultatet 3.

dayOfYear

Returnera dagen på året från en tidsstämpel.

dayOfYear('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<dag på året>	integer	Dagen på året från den angivna tidsstämpeln

Exempel

Det här exemplet returnerar antalet dagar på året från följande tidsstämpel:

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

Och returnerar resultatet 74.

div

Returnera heltalsresultatet från att dela upp två tal. För att returnera resten se mod().

div(<dividend>, <divisor>)

Parameter	Obligatoriskt	Type	Beskrivning
<Utdelning>	Ja	Nummer	Talet som ska divideras med divisorn
<Divisor>	Ja	Nummer	Talet som delar utdelningen. Kan inte vara 0.

Returvärde	Typ	Beskrivning
<kvotresultat>	Nummer	Resultatet från att dividera det första talet med det andra talet

Exempel

Båda exemplen delar det första talet med det andra talet:

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

Och returnera resultatet 2.

Det finns en viss lucka mellan Javascript och .NET SDK. Följande uttryck returnerar till exempel olika resultat i Javascript och .NET SDK:

Om en av parametrarna är en float blir resultatet även en FLOAT med .NET SDK.

Exempel

div(11.2, 2)

Returnerar resultatet 5,6.

Om en av parametrarna är en float blir resultatet en INT med Javascript SDK.

Exempel

div(11.2, 2)

Returnerar resultatet 5.

Lösningen för Javascript för att behålla ett visst antal decimaler i resultatet är att använda ett sådant uttryck. Om du till exempel vill behålla 3 decimaler:

float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))

empty

Kontrollera om en instans är tom. Returnera true om indata är tomma. Tomt innebär:

• indata är null eller odefinierat
• indata är en null- eller tom sträng
• indata är en samling med noll storlek
• indata är ett objekt utan egenskap.

empty('<instance>')
empty([<instance>])

Parameter	Obligatoriskt	Type	Beskrivning
<Instans>	Ja	någon	Den instans som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true när instansen är tom.

Exempel

De här exemplen kontrollerar om den angivna instansen är tom:

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

Och returnera dessa resultat:

• Skickar en tom sträng, så funktionen returnerar true.
• Skickar strängen abc, så funktionen returnerar false.
• Skickar samlingen med ett objekt, så funktionen returnerar false.
• Skickar null-objektet, så funktionen returnerar true.

endsWith

Kontrollera om en sträng slutar med en specifik delsträng. Returnera true om delsträngen hittas eller returnera false om den inte hittas. Den här funktionen är skiftlägeskänslig.

endsWith('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som ska kontrolleras
<searchText>	Ja	sträng	Den avslutande delsträngen som ska hittas

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true när den avslutande delsträngen hittas. Returnera false om det inte hittas

Exempel 1

Det här exemplet kontrollerar om hello world-strängen slutar med strängvärlden:

endsWith('hello world', 'world')

Och det returnerar resultatet true.

Exempel 2

Det här exemplet kontrollerar om hello world-strängen slutar med stränguniversumet:

endsWith('hello world', 'universe')

Och det returnerar resultatet false.

EOL

Returnera slutet av radsekvenstexten (EOL).

EOL()

Returvärde	Typ	Beskrivning
<IsOSPlatform>	sträng	Returnera \r\n i Windows och \n i Mac och Linux.

Exempel

I det här exemplet kontrolleras slutet av radsekvenstexten:

EOL()

Och returnerar följande strängar:

• Windows: \r\n
• Mac eller Linux: \n

equals

Kontrollera om båda värdena, uttrycken eller objekten är likvärdiga. Returnera true om båda är likvärdiga eller returnera false om de inte är likvärdiga.

equals('<object1>', '<object2>')

Parameter	Obligatoriskt	Type	Beskrivning
<object1>, <object2>	Ja	någon	De värden, uttryck eller objekt som ska jämföras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true när båda är likvärdiga. Returnera false om inte motsvarande.

Exempel

De här exemplen kontrollerar om de angivna indata är likvärdiga:

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

Och returnerar följande resultat:

• Båda värdena är likvärdiga, så funktionen returnerar true.
• Båda värdena är inte likvärdiga, så funktionen returnerar false.

finns

Utvärderar ett uttryck för sanning.

exists(expression)

Parameter	Obligatoriskt	Type	Beskrivning
Uttryck	Ja	Uttryck	Uttryck för att utvärdera för sanningsenlighet

Returvärde	Typ	Beskrivning
<sant eller falskt>	Booleskt	Resultat av utvärdering av uttrycket

Exempel

I det här exemplet utvärderas sanningsenligheten i foo = {"bar":"value"}:

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

Och returnera dessa resultat:

• true
• false

exp

Returnera exponentering av ett tal till ett annat.

exp(realNumber, exponentNumber)

Parameter	Obligatoriskt	Type	Beskrivning
realNumber	Ja	Nummer	Verkligt tal att beräkna exponent för
exponentNumber	Ja	Nummer	Exponentnummer

Returvärde	Typ	Beskrivning
<result-exp>	Nummer	Resultatet från beräknings exponenten för realNumber

Exempel

I det här exemplet beräknas exponenten:

exp(2, 2)

Och returnerar resultatet 4.

Första

Returnera det första objektet från en sträng eller matris.

first('<collection>')
first([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng eller matris	Samlingen där det första objektet ska hittas

Returvärde	Typ	Beskrivning
<first-collection-item>	någon	Det första objektet i samlingen

Exempel

De här exemplen hittar det första objektet i följande samlingar:

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

Och returnera dessa resultat:

• h
• 0

Platta

Platta ut en matris till värden som inte är matrisvärden. Du kan också ange det maximala djup som ska plattas ut till.

flatten([<collection>], '<depth>')

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	matris	Samlingen som ska plattas ut
<Djup>	Nej	Nummer	Maximalt djup att platta ut. Standardvärdet är oändligt.

Returvärde	Typ	Beskrivning
<ny samling>	matris	Ny samling vars element har planats ut till en icke-matris till det angivna djupet

Exempel 1

THis-exemplet plattar ut följande matris:

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

Och returnerar resultatet [1, 2, 3, 4, 5, 6].

Exempel 2

I det här exemplet plattas matrisen ut till ett djup av 1:

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

Och returnerar resultatet [1, 2, [3, 4], [5, 6]].

flyttal

Konvertera strängversionen av ett flyttalnummer till ett flyttalsnummer. Du kan bara använda den här funktionen när du skickar anpassade parametrar till en app, till exempel en logikapp. Ett undantag utlöses om strängen inte kan konverteras till en flyttal.

float('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Strängen som har ett giltigt flyttalsnummer att konvertera till

Returvärde	Typ	Beskrivning
<float-value>	flyttal	Flyttalsnumret för den angivna strängen

Exempel

I det här exemplet konverteras flyttalsversionen av en sträng:

float('10.333')

Och returnerar float 10.333.

floor

Returnera det största integralvärdet som är mindre än eller lika med det angivna talet.

floor('<number>')

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	Nummer	Ett indatanummer

Returvärde	Typ	Beskrivning
<heltalsvärde>	integer	Det största integralvärdet som är mindre än eller lika med indatanumret

Exempel

I det här exemplet beräknas golvvärdet för talet 10,333:

floor(10.333)

Och returnerar heltal 10.

foreach

Använd varje element och returnera den nya samlingen.

foreach([<collection/instance>], <iteratorName>, <function>)

Parameter	Obligatoriskt	Type	Beskrivning
<samling/instans>	Ja	matris eller objekt	Samlingen med objekten
<iteratorName>	Ja	iteratornamn	Nyckelobjektet i pilfunktionen
<Funktion>	Ja	Uttryck	Funktion som innehåller iteratorName

Returvärde	Typ	Beskrivning
<ny samling>	matris	Den nya samlingen där varje element har utvärderats av funktionen

Exempel 1

Det här exemplet genererar en ny samling:

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

Och returnerar resultatet [1, 2, 3, 4].

Exempel 2

De här exemplen genererar en ny samling:

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

Och returnera resultatet ['name:jack', 'age:15']. Observera att det andra uttrycket är ett lambda-uttryck, som vissa tycker är mer läsbart.

formatDateTime

Returnera en tidsstämpel i ett valfritt språkformat.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<formaterad tidsstämpel>	sträng	Den uppdaterade tidsstämpeln i det angivna formatet

Exempel 1

I det här exemplet konverteras en tidsstämpel till det angivna formatet:

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

Och returnerar resultatet 2018-03-15T12:00:00.

Exempel 2

I det här exemplet konverteras en tidsstämpel i språkvarianten de-DE :

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

Och returnerar resultatet 15.03.18 00:00:00.

formatEpoch

Returnera en tidsstämpel i ett valfritt språkformat i det angivna formatet från UNIX-tid (även kallat epoktid, POSIX-tid, UNIX-epoktid).

formatEpoch('<epoch>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Epok>	Ja	Nummer	Epoknumret
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<formaterad tidsstämpel>	sträng	Den uppdaterade tidsstämpeln i det angivna formatet

Exempel

I det här exemplet konverteras en Unix-tidsstämpel till det angivna formatet:

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

Och returnerar resultatet 2018-03-15T12:00:00.000Z.

Exempel

I det här exemplet konverteras en Unix-tidsstämpel i språkvarianten de-DE :

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

Och returnerar resultatet 15.03.18 13:00:00.

formatNumber

Formatera ett värde till det angivna antalet bråktalssiffror och ett valfritt angivet språk.

formatNumber('<number>', '<precision-digits>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	Nummer	Ett indatanummer
<precisionssiffror>	Ja	integer	Ett angivet antal bråksiffror
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<return-value>	Nummer	Returvärdet för de indata som har formaterats med ett angivet antal bråksiffror och ett angivet språk

Exempel 1

I det här exemplet formateras talet 10,333 till 2 bråksiffror:

formatNumber(10.333, 2)

Och returnerar strängen 10.33.

Exempel 2

De här exemplen formaterar tal till ett angivet antal siffror i språkvarianten en-US :

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

Och returnera följande resultat:

• 12.12
• 1.55
• 12.1230

formatTicks

Returnera en tidsstämpel i ett valfritt språkformat i det angivna formatet från fästingar.

formatTicks('<ticks>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Epok>	Ja	tal (eller bigint i JavaScript)	Ticks-talet
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<formaterad tidsstämpel>	sträng	Den uppdaterade tidsstämpeln i det angivna formatet

Exempel 1

Det här exemplet konverterar tick till det angivna formatet:

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

Och returnerar resultatet 2020-05-06T11:47:00.000Z.

Exempel 2

Det här exemplet konverterar tick till det angivna formatet i de-DE-språket:

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

Och returnerar resultatet 06.05.20 11:47:00.

getFutureTime

Returnera den aktuella tidsstämpeln i ett valfritt språkformat plus de angivna tidsenheterna.

getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<interval>	Ja	integer	Antalet specifika tidsenheter som ska läggas till
<timeUnit>	Ja	sträng	Den tidsenhet som ska användas med intervall. Möjliga enheter är "Second", "Minute", "Hour", "Day", "Week", "Month" och "Year".
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Den aktuella tidsstämpeln plus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är 2019-03-01T00:00:00.000Z. Exemplet nedan lägger till fem dagar till den tidsstämpeln:

getFutureTime(2, 'Week')

Och returnerar resultatet 2019-03-15T00:00:00.000Z.

Exempel 2

Anta att den aktuella tidsstämpeln är 2018-03-01T00:00:00.000Z. Exemplet nedan lägger till fem dagar i tidsstämpeln och konverterar resultatet till FORMATET MM-DD-YY :

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

Och returnerar resultatet 03-06-18.

Exempel 3

Anta att den aktuella tidsstämpeln är 2020-05-01T00:00:00.000Z och språket är de-DE. Exemplet nedan lägger till 1 dag i tidsstämpeln:

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

Och returnerar resultatet 02.05.20 00:00:00.

getNextViableDate

Returnera nästa livskraftiga datum för ett Timex-uttryck baserat på aktuellt datum och en valfri angiven tidszon.

getNextViableDate(<timexString>, <timezone>?)

Parameter	Obligatoriskt	Type	Beskrivning
<timexString>	Ja	sträng	Timex-strängen för det datum som ska utvärderas.
<Tidszon>	Nej	sträng	Den valfria tidszonen.

Returvärde	Typ	Beskrivning
<nextViableTime>	sträng	Nästa genomförbara datum.

Exempel

Anta att datumet är 2020-06-12 och att aktuell tid är 15:42:21.

De här exemplen utvärderar Timex-strängen för nästa livskraftiga datum baserat på datum och tid ovan:

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

Och returnera följande strängar:

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

getNextViableTime

Returnera nästa livskraftiga tid för ett Timex-uttryck baserat på aktuell tid och en valfri angiven tidszon.

getNextViableTime(<timexString>, <timezone>?)

Parameter	Obligatoriskt	Type	Beskrivning
<timexString>	Ja	sträng	Tidssträngen för den tid som ska utvärderas.
<Tidszon>	Nej	sträng	Den valfria tidszonen.

Returvärde	Typ	Beskrivning
<nextViableTime>	sträng	Nästa gång.

Exempel

Anta att datumet är 2020-06-12 och att aktuell tid är 15:42:21.

De här exemplen utvärderar en Timex-sträng för nästa gång baserat på datum och tid ovan:

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

Och returnera följande strängar:

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

getPastTime

Returnera den aktuella tidsstämpeln minus de angivna tidsenheterna.

getPastTime(<interval>, <timeUnit>, '<format>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<interval>	Ja	integer	Antalet specifika tidsenheter som ska subtraheras
<timeUnit>	Ja	sträng	Den tidsenhet som ska användas med intervall. Möjliga enheter är "Second", "Minute", "Hour", "Day", "Week", "Month" och "Year".
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Den aktuella tidsstämpeln minus det angivna antalet tidsenheter

Exempel 1

Anta att den aktuella tidsstämpeln är 2018-02-01T00:00:00.000Z. Det här exemplet subtraherar fem dagar från den tidsstämpeln:

getPastTime(5, 'Day')

Och returnerar resultatet 2019-01-27T00:00:00.000Z.

Exempel 2

Anta att den aktuella tidsstämpeln är 2018-03-01T00:00:00.000Z. Det här exemplet subtraherar fem dagar till tidsstämpeln i FORMATET MM-DD-YY :

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

Och returnerar resultatet 02-26-18.

Exempel 3

Anta att den aktuella tidsstämpeln är 2020-05-01T00:00:00.000Z och språket är de-DE. Exemplet nedan subtraherar 1 dag från tidsstämpeln:

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

Och returnerar resultatet 31.04.20 00:00:00.

getPreviousViableDate

Returnera det tidigare livskraftiga datumet för ett Timex-uttryck baserat på aktuellt datum och en valfri angiven tidszon.

getPreviousViableDate(<timexString>, <timezone>?)

Parameter	Obligatoriskt	Type	Beskrivning
<timexString>	Ja	sträng	Timex-strängen för det datum som ska utvärderas.
<Tidszon>	Nej	sträng	Den valfria tidszonen.

Returvärde	Typ	Beskrivning
<previousViableDate>	sträng	Föregående dugliga datum.

Exempel

Anta att datumet är 2020-06-12 och att aktuell tid är 15:42:21.

De här exemplen utvärderar en Timex-sträng för det tidigare livskraftiga datumet baserat på datum och tid ovan:

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

Och returnera följande strängar:

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

getPreviousViableTime

Returnera den tidigare gångbara tiden för ett Timex-uttryck baserat på aktuellt datum och en valfri angiven tidszon.

getPreviousViableTime(<timexString>, <timezone>?)

Parameter	Obligatoriskt	Type	Beskrivning
<timexString>	Ja	sträng	Tidssträngen för den tid som ska utvärderas.
<Tidszon>	Nej	sträng	Den valfria tidszonen.

Returvärde	Typ	Beskrivning
<previousViableTime>	sträng	Den tidigare gångbara tiden.

Exempel

Anta att datumet är 2020-06-12 och att aktuell tid är 15:42:21.

De här exemplen utvärderar en Timex-sträng för den tidigare gångbara tiden baserat på datum och tid ovan:

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

Och returnera följande strängar:

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

getProperty

Returnera värdet för en angiven egenskap eller rotegenskapen från ett JSON-objekt.

Returnera värdet för en angiven egenskap

getProperty(<JSONObject>, '<propertyName>')

Parameter	Obligatoriskt	Type	Beskrivning
<JSONObject>	Ja	objekt	JSON-objektet som innehåller egenskapen och värdena.
<propertyName>	Nej	sträng	Namnet på den valfria egenskapen för åtkomst till värden från.

Returvärde	Typ	Beskrivning
värde	sträng	Värdet för den angivna egenskapen i JSON-objektet.

Exempel

Anta att du har följande JSON-objekt:

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

Det här exemplet hämtar en angiven egenskap från ovanstående JSON-objekt:

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

Och returnera följande strängar:

• a:b-värde
• d nyckel

Returnera rotegenskapen

getProperty('<propertyName>')

Parameter	Obligatoriskt	Type	Beskrivning
<propertyName>	Ja	sträng	Namnet på den valfria egenskapen för åtkomst till värden från rotminnesomfånget.

Returvärde	Typ	Beskrivning
värde	sträng	Värdet för rotegenskapen i ett JSON-objekt.

Exempel

Anta att du har följande JSON-objekt:

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

Det här exemplet hämtar rotegenskapen från ovanstående JSON-objekt:

getProperty("a:b")

Och returnerar strängen a:b-värdet.

getTimeOfDay

Returnerar tid på dagen för en viss tidsstämpel.

getTimeOfDay('<timestamp>')

Tiden som returneras är en av följande strängar:

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller den angivna tidsstämpeln

Returvärde	Typ	Beskrivning
<tid på dagen>	sträng	Tid på dagen för den angivna tidsstämpeln

Nedan visas de strängar som är associerade med tiden på dagen:

Tid på dagen	Tidsstämpel
Midnatt	12.00
Morgon	12:01–23:59
Eftermiddag	12.00
Kväll	06:00–22:00
Natt	22:01–23:59

Exempel

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

Returnerar resultatet för morgonen.

greater

Kontrollera om det första värdet är större än det andra värdet. Returnera true om det första värdet är mer eller returnera false om det är mindre.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	heltal, flyttal eller sträng	Det första värdet för att kontrollera om större än det andra värdet
<compareTo>	Ja	heltal, flyttal eller sträng, respektive	Jämförelsevärdet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om det första värdet är större än det andra värdet. Returnera false om det första värdet är lika med eller mindre än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är större än det andra värdet:

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

Och returnera följande resultat:

• true
• false

greaterOrEquals

Kontrollera om det första värdet är större än eller lika med det andra värdet. Returnera true när det första värdet är större eller lika med, eller returnera false om det första värdet är mindre.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	heltal, flyttal eller sträng	Det första värdet för att kontrollera om det är större än eller lika med det andra värdet
<compareTo>	Ja	heltal, flyttal eller sträng, respektive	Jämförelsevärdet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om det första värdet är större än eller lika med det andra värdet. Returnera false om det första värdet är mindre än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är större eller lika med det andra värdet:

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

Och returnera följande resultat:

• true
• false

if

Kontrollera om ett uttryck är sant eller falskt. Baserat på resultatet returnerar du ett angivet värde.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parameter	Obligatoriskt	Type	Beskrivning
<Uttryck>	Ja	Booleskt	Uttrycket som ska kontrolleras
<valueIfTrue>	Ja	någon	Värdet som ska returneras om uttrycket är sant
<valueIfFalse>	Ja	någon	Värdet som ska returneras om uttrycket är falskt

Returvärde	Typ	Beskrivning
<specified-return-value>	någon	Det angivna värdet som returneras baserat på om uttrycket är true eller false

Exempel

I det här exemplet utvärderas om equals(1,1) är sant:

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

Och returnerar ja eftersom det angivna uttrycket returnerar true. Annars returnerar exemplet nej.

indexOf

Returnera startpositionen eller indexvärdet för en delsträng. Den här funktionen är skiftlägeskänslig och index börjar med talet 0.

indexOf('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng eller matris	Strängen som har delsträngen att hitta
<searchText>	Ja	sträng	Delsträngen som ska hittas

Returvärde	Typ	Beskrivning
<indexvärde>	integer	Startpositionen eller indexvärdet för den angivna delsträngen.
Om strängen inte hittas returnerar du talet -1.

Exempel 1

Det här exemplet hittar startindexvärdet för understrängsvärlden i strängens hello-värld:

indexOf('hello world', 'world')

Och returnerar resultatet 6.

Exempel 2

I det här exemplet hittas startindexvärdet för delsträngen def i matrisen ['abc', 'def', 'ghi']:

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

Och returnerar resultatet 1.

indexAndValues

Omvandla en matris eller ett objekt till en matris med objekt med index (aktuellt index) och värdeegenskaper. För matriser är indexet positionen i matrisen. För objekt är det nyckeln för värdet.

indicesAndValues('<collection or object>')

Parameter	Obligatoriskt	Type	Beskrivning
<samling eller objekt>	Ja	matris eller objekt	Ursprunglig matris eller -objekt

Returvärde	Typ	Beskrivning
<Samling>	matris	Ny matris. Varje objekt har två egenskaper: indexet med positionen i en matris eller nyckeln för ett objekt och motsvarande värde.

Exempel 1

Anta att du har en lista { objekt: ["noll", "en", "två"] }. Följande funktion tar den listan:

indicesAndValues(items)

Och returnerar en ny lista:

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

Exempel 2

Anta att du har en lista { objekt: ["noll", "en", "två"] }. Följande funktion tar den listan:

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

Och returnerar en ny lista:

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

Exempel 3

Anta att du har en lista { objekt: ["noll", "en", "två"] }. Följande funktion tar den listan:

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

Och returnerar resultatet noll,ett,två. Det här uttrycket har samma effekt som join(items, ',').

Exempel 4

Anta att du har ett objekt { användare: {name: 'jack', ålder: 20} }. Följande funktion tar objektet:

indicesAndValues(user)

Och returnerar ett nytt objekt:

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

heltal

Returnera heltalsversionen av en sträng. Ett undantag utlöses om strängen inte kan konverteras till ett heltal.

int('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Strängen som ska konverteras

Returvärde	Typ	Beskrivning
<integer-result>	integer	Heltalsversionen av den angivna strängen

Exempel

Det här exemplet skapar en heltalsversion för strängen 10:

int('10')

Och returnerar resultatet som heltal 10.

Korsningen

Returnera en samling som bara har de vanliga objekten i de angivna samlingarna. För att visas i resultatet måste ett objekt visas i alla samlingar som skickas till den här funktionen. Om ett eller flera objekt har samma namn visas det sista objektet med det namnet i resultatet.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parameter	Obligatoriskt	Type	Beskrivning
<collection1>, <collection2>	Ja	matris eller objekt, men inte båda	De samlingar som du bara vill ha de vanliga objekten från

Returvärde	Typ	Beskrivning
<common-items>	matris eller objekt, respektive	En samling som bara har de vanliga objekten i de angivna samlingarna

Exempel

I det här exemplet hittar du de vanliga objekten i följande matriser:

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

Och returnerar en matris med endast objekten [1, 2].

isArray

Returnera true om en angiven indata är en matris.

isArray('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en angiven indata är en matris eller returnera false om den inte är en matris.

Exempel

I följande exempel kontrollerar du om indata är en matris:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar false.
• Indata är en matris, så funktionen returnerar true.

isBoolean

Returnera true om en angiven indata är boolesk.

isBoolean('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en angiven indata är boolesk eller returnera false om den inte är boolesk.

Exempel

I följande exempel kontrollerar du om indata är booleska:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar false.
• Indata är ett booleskt värde, så funktionen returnerar true.

isDate

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till ett giltigt datum. Giltiga datum innehåller månaden och dayOfMonth, eller innehåller dayOfWeek.

isDate('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	Indataobjektet TimexProperty eller en Timex-uttryckssträng.

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Returnera true om indata refererar till ett giltigt datum eller returnerar false om datumet är ogiltigt.

Exempel

De här exemplen kontrollerar om följande indata är giltiga datum:

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

Och returnera följande resultat:

• false
• true

isDateRange

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till ett giltigt datumintervall.

isDateRange('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	Indataobjektet TimexProperty är en Timex-uttryckssträng.

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Retur true om angivna indata refererar till ett giltigt datumintervall eller returnerar false om det inte är ett giltigt datumintervall.

Exempel

De här exemplen kontrollerar om följande indata är ett giltigt datumintervall:

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

Och returnera följande resultat:

• false
• true

isDateTime

Returnera true om en angiven indata är ett UTC ISO-format (ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ) tidsstämpelsträng.

isDateTime('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en angiven indata är en tidsstämpelsträng för UTC ISO-format eller returnera false om det inte är en tidsstämpelsträng för UTC ISO-format.

Exempel

I följande exempel kontrollerar du om indata är en UTC ISO-formatsträng:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar false.
• Indata är en UTC ISO-formatsträng, så funktionen returnerar true.

isDefinite

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till ett giltigt datum. Giltiga datum innehåller år, månad och dayOfMonth.

isDefinite('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	Indataobjektet TimexProperty är en Timex-uttryckssträng.

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Returnera true om angivna indata refererar till ett giltigt fullständigt datum eller returnerar false om det inte refererar till ett giltigt fullständigt datum.

Exempel

Anta att det finns ett TimexProperty-objekt validFullDate = new TimexProperty("2020-02-20") och Now egenskapen är inställd på true. I följande exempel kontrollerar du om objektet refererar till ett giltigt fullständigt datum:

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

Och returnera följande resultat:

• false
• true

isDuration

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till en giltig varaktighet.

isDuration('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	Indataobjektet TimexProperty är en Timex-uttryckssträng.

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Returnera true om indata refererar till en giltig varaktighet eller returnerar false om indata inte refererar till en giltig varaktighet.

Exempel

Exemplen nedan kontrollerar om följande indata refererar till en giltig varaktighet:

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

Och returnera följande resultat:

• true
• false

isFloat

Returnera true om en angiven indata är ett flyttalsnummer. På grund av justeringen mellan C#och JavaScript behandlas ett tal med en icke-noll rest av modulo 1 som ett flyttalsnummer.

isFloat('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en angiven indata är ett flyttalsnummer eller returnerar false om indata inte är ett flyttalsnummer.

Exempel

I följande exempel kontrollerar du om indata är ett flyttalsnummer:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar false.
• Indata har en modulo som är lika med 0, så funktionen returnerar false.
• Indata är ett flyttalsnummer, så funktionen returnerar true.

isInteger

Returnera true om en angiven indata är ett heltalsnummer. På grund av justeringen mellan C# och JavaScript behandlas ett tal med noll rester av modulo 1 som ett heltalsnummer.

isInteger('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Är indata ett heltalsnummer?

Exempel

I följande exempel kontrollerar du om indata är ett heltal:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar false.
• Indata har en modulo som är lika med 0, så funktionen returnerar true.
• Indata är ett heltal, så funktionen returnerar true.

isMatch

Returnera true om en viss sträng matchar ett angivet mönster för reguljära uttryck.

isMatch('<target**string>', '<pattern>')

Parameter	Obligatoriskt	Type	Beskrivning
<target**string>	Ja	sträng	Strängen som ska matchas
<Mönster>	Ja	sträng	Ett mönster för reguljära uttryck

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en viss sträng matchar ett vanligt mönster för reguljära uttryck eller returnerar false om den inte matchar mönstret.

Exempel

I följande exempel kontrollerar du om indata matchar det angivna reguljära uttrycksmönstret:

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

Och returnera samma resultat true.

isObject

Returnera true om en angiven indata är ett komplext objekt eller returnerar false om det är ett primitivt objekt. Primitiva objekt inkluderar strängar, tal och booleska objekt. komplexa typer, till exempel klasser, innehåller egenskaper.

isObject('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en angiven indata är ett komplext objekt eller returnera false om det är ett primitivt objekt.

Exempel

I följande exempel kontrollerar du om de angivna indata är ett objekt:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar false.
• Indata är ett objekt, så funktionen returnerar true.

isPresent

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till nuet.

isPresent('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	TimexProperty-indataobjektet en Timex-uttryckssträng

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Returnera true om indata refererar till nuet eller returnera falskt om det inte refererar till nuet.

Exempel Anta att vi har ett TimexProperty-objekt validNow = ny TimexProperty() { Now = true } och anger Now egenskapen till true. Exemplen nedan kontrollerar om följande indata refererar till nutiden:

isPresent('PT30M')
isPresent(validNow)

Och returnera följande resultat:

• false
• true

isString

Returnera true om en angiven indata är en sträng.

isString('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	någon	Indata som ska testas

Returvärde	Typ	Beskrivning
<Booleskt resultat>	Booleskt	Returnera true om en angiven indata är en sträng eller returnera false om inte en sträng.

Exempel

I följande exempel kontrollerar du om de angivna indata är en sträng:

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

Och returnera följande resultat:

• Indata är en sträng, så funktionen returnerar true.
• Indata är en flyttal, så funktionen returnerar false.

isTime

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till en giltig tid. Giltig tid innehåller timmar, minuter och sekunder.

isTime('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	TimexProperty-indataobjektet en Timex-uttryckssträng

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Returnera true om indata refererar till en giltig tid eller returnera false om den inte refererar till en giltig tid..

Exempel

Dessa exempel kontrollerar om följande indata refererar till en giltig tid:

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

Och returnera följande resultat:

• false
• true

isTimeRange

Returnera true om ett angivet TimexProperty- eller Timex-uttryck refererar till ett giltigt tidsintervall Giltiga tidsintervall innehåller partOfDay.

isTime('<input>')

Parameter	Obligatoriskt	Type	Beskrivning
<Input>	Ja	objekt eller sträng	Indataobjektet TimexProperty är en Timex-uttryckssträng.

Returvärde	Typ	Beskrivning
<booleskt resultat>	Booleskt	Returnera true om indata refererar till ett giltigt tidsintervall eller returnerar false om det inte refererar till ett giltigt tidsintervall.

Exempel

Anta att vi har ett TimexProperty-objekt validTimeRange = new TimexProperty() { PartOfDay = "morning" } och anger Now egenskapen till true. De här exemplen kontrollerar om följande indata är giltiga tidsintervall:

isTimeRange('PT30M')
isTimeRange(validTimeRange)

Och returnera följande resultat:

• false
• true

anslut

Returnera en sträng som innehåller alla objekt från en matris, där varje tecken avgränsas med en avgränsare.

join([<collection>], '<delimiter>')

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	matris	Matrisen som har de objekt som ska kopplas
<Avgränsare>	Ja	sträng	Avgränsaren som visas mellan varje tecken i den resulterande strängen

Returvärde	Typ	Beskrivning
<char1><avgränsare><char2><avgränsare...>	sträng	Den resulterande strängen som skapats från alla objekt i den angivna matrisen

Exempel

Det här exemplet skapar en sträng från alla objekt i den här matrisen med det angivna tecknet . som avgränsare:

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

Och returnerar resultatet a.b.c.

jPath

Kontrollera JSON eller en JSON-sträng för noder eller värden som matchar ett sökvägsuttryck och returnera matchande noder.

jPath(<json>, '<path>')

Parameter	Obligatoriskt	Type	Beskrivning
<Json>	Ja	någon	JSON-objektet eller strängen för att söka efter noder eller värden som matchar sökvägsuttrycksvärdet
<sökväg>	Ja	någon	Sökvägsuttrycket som används för att hitta matchande JSON-noder eller värden

Returvärde	Typ	Beskrivning
[ <json-node>]	matris	En lista över JSON-noder eller värden som matchar det angivna sökvägsuttrycket

C#-exempel

Anta att du har följande 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
                }
            ]
        }
    ]
}

Sökvägsuttrycket är $.. Produkter[?( @. Pris >= 50)]. Namn

jPath(jsonStr, path)

Och det returnerar resultatet ["Anvil", "Elbow Grease"].

JavaScript-exempel

Anta att du har följande 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
        }
    ]
}

Sökvägsuttrycket är .automobiles{.maker === "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

Och det returnerar resultatet ['Jazz', 'Accord'].

json

Returnera JSON-typvärdet (JavaScript Object Notation) eller objektet för en sträng eller XML.

json('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng eller XML	Strängen eller XML som ska konverteras

Returvärde	Typ	Beskrivning
<JSON-resultat>	sträng	Det resulterande JSON-objektet som skapats från den angivna strängen eller XML-filen.

Exempel 1

I det här exemplet konverteras en sträng till JSON:

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

Och returnerar resultatet:

{
  "fullName": "Sophia Owen"
}

Exempel 2

I det här exemplet konverteras XML till JSON:

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

Och returnerar resultatet:

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

jsonStringify

Returnera JSON-strängen för ett värde.

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	objekt	Objektet som ska konverteras till en JSON-sträng

Returvärde	Typ	Beskrivning
<JSON-resultat>	sträng	Den resulterande JSON-strängen.

Exempel

I de här exemplen visas objekt som konverterats till JSON-strängar:

jsonStringify(null)
jsonStringify({a:'b'})

Och returnera följande strängresultat:

• NULL
• {"a":"b"}

senaste

Returnera det sista objektet från en samling.

last('<collection>')
last([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng eller matris	Samlingen där det sista objektet ska hittas

Returvärde	Typ	Beskrivning
<last-collection-item>	sträng eller matris, respektive	Det sista objektet i samlingen

Exempel

De här exemplen hittar det sista objektet i dessa samlingar:

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

Och returnerar följande resultat:

• d
• 3

lastIndexOf

Returnera startpositionen eller indexvärdet för den senaste förekomsten av en delsträng. Den här funktionen är skiftlägeskänslig och index börjar med talet 0.

lastIndexOf('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng eller matris	Strängen som har delsträngen att hitta
<searchText>	Ja	sträng	Delsträngen som ska hittas

Returvärde	Typ	Beskrivning
<ending-index-value>	integer	Startpositionen eller indexvärdet för den senaste förekomsten av den angivna delsträngen. Om strängen inte hittas returnerar du talet -1.

Exempel 1

Det här exemplet hittar startindexvärdet för den senaste förekomsten av understrängsvärlden i hello world-strängen:

lastIndexOf('hello world', 'world')

Och returnerar resultatet 6.

Exempel 2

Det här exemplet hittar startindexvärdet för den senaste förekomsten av substring def i matrisen ['abc', 'def', 'ghi', 'def'].

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

Och returnerar resultatet 3.

längd

Returnera längden på en sträng.

length('<str>')

Parameter	Obligatoriskt	Type	Beskrivning
<Str>	Ja	sträng	Strängen som ska beräknas för längd

Returvärde	Typ	Beskrivning
<length>	integer	Längden på den här strängen

Exempel

De här exemplen hämtar längden på strängar:

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

Och returnerar följande resultat:

• 5
• 11

less

Kontrollera om det första värdet är mindre än det andra värdet. Returnera true om det första värdet är mindre eller returnera false om det första värdet är mer.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	heltal, flyttal eller sträng	Det första värdet för att kontrollera om mindre än det andra värdet
<compareTo>	Ja	heltal, flyttal eller sträng, respektive	Jämförelseobjektet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om det första värdet är mindre än det andra värdet. Returnera false om det första värdet är lika med eller större än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är mindre än det andra värdet.

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

Och returnera följande resultat:

• true
• false

lessOrEquals

Kontrollera om det första värdet är mindre än eller lika med det andra värdet. Returnera true om det första värdet är mindre än eller lika med, eller returnera false om det första värdet är mer.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	heltal, flyttal eller sträng	Det första värdet för att kontrollera om mindre än eller lika med det andra värdet
<compareTo>	Ja	heltal, flyttal eller sträng, respektive	Jämförelseobjektet

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om det första värdet är mindre än eller lika med det andra värdet. Returnera false om det första värdet är större än det andra värdet.

Exempel

De här exemplen kontrollerar om det första värdet är mindre än eller lika med det andra värdet.

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

Och returnera följande resultat:

• true
• false

max

Returnera det högsta värdet från en lista eller matris. Listan eller matrisen är inkluderande i båda ändar.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parameter	Obligatoriskt	Type	Beskrivning
<number1>, <number2>, ...	Ja	Nummer	Den uppsättning tal som du vill ha det högsta värdet från
[<number1>, <number2>, ...]	Ja	matris med tal	Matrisen med tal som du vill ha det högsta värdet från

Returvärde	Typ	Beskrivning
<max-value>	Nummer	Det högsta värdet i den angivna matrisen eller uppsättningen med tal

Exempel

De här exemplen får det högsta värdet från uppsättningen tal och matrisen:

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

Och returnera resultatet 3.

merge

Sammanfogar flera JSON-objekt eller en matris med objekt tillsammans.

merge(<json1>, <json2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<json1>, <json2>, ...	Ja	objekt eller matris	Uppsättningen JSON-objekt eller matris som ska sammanfogas.

Returvärde	Typ	Description
<Resultatet>	objekt	Det kombinerade JSON-objektet eller kombinerade matrisobjekt.

Exempel

Anta att du har följande JSON-objekt:

json1 = @"{
            'FirstName': 'John',
            'LastName': 'Smith',
            'Enabled': false,
            'Roles': [ 'User' ]
          }"
json2 =@"{
            'Enabled': true,
            'Roles': [ 'User', 'Admin' ]
          }"

Det här exemplet sammanfogar JSON-objekten:

string(merge(json(json1), json(json2)))

Och returnerar det resulterande objektet {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Admin"]}.

Anta att du vill kombinera objekt och en lista över objekt tillsammans. I följande exempel kombineras JSON-objekt och en matris med objekt:

merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})

Och returnerar objektet { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.

min

Returnera det lägsta värdet från en uppsättning tal eller en matris.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parameter	Obligatoriskt	Type	Beskrivning
<number1>, <number2>, ...	Ja	Nummer	Den uppsättning tal som du vill ha det lägsta värdet från
[<number1>, <number2>, ...]	Ja	matris med tal	Matrisen med tal som du vill ha det lägsta värdet från

Returvärde	Typ	Beskrivning
<min-value>	Nummer	Det lägsta värdet i den angivna matrisen eller uppsättningen med tal

Exempel

De här exemplen får det lägsta värdet i uppsättningen tal och matrisen:

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

Och returnera resultatet 1.

mod

Returnera resten från att dela upp två tal. Information om hur du hämtar heltalsresultatet finns i div().

mod(<dividend>, <divisor>)

Parameter	Obligatoriskt	Type	Beskrivning
<Utdelning>	Ja	Nummer	Talet som ska divideras med divisorn
<Divisor>	Ja	Nummer	Talet som delar utdelningen. Kan inte vara 0.

Returvärde	Typ	Beskrivning
<modulo-result>	Nummer	Resten från att dividera det första talet med det andra talet

Exempel

I det här exemplet delas det första talet med det andra talet:

mod(3, 2)

Och returnerar resultatet 1.

månad

Returnera månaden för den angivna tidsstämpeln.

month('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<antal månader>	integer	Månadens antal i den angivna tidsstämpeln

Exempel

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

Och det returnerar resultatet 3.

mul

Returnera produkten från att multiplicera två tal.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Obligatoriskt	Type	Beskrivning
<multiplicand1>	Ja	heltal eller flyttal	Talet som ska multipliceras med multiplicand2
<multiplicand2>	Ja	heltal eller flyttal	Talet som multiplicand1 multiplicand1

Returvärde	Typ	Beskrivning
<produktresultat>	heltal eller flyttal	Produkten från att multiplicera det första talet med det andra talet

Exempel

De här exemplen multipel det första talet med det andra talet:

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

Och returnera följande resultat:

• 2
• 3

newGuid

Returnera en ny Guid-sträng.

newGuid()

Returvärde	Typ	Beskrivning
<Guid-string>	sträng	En ny Guid-sträng, längden är 36 och ser ut som xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

Exempel

newGuid()

Och det returnerar ett resultat som följer formatet xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.

not

Kontrollera om ett uttryck är falskt. Returnera true om uttrycket är falskt eller returnera false om det är sant.

not(<expression>)

Parameter	Obligatoriskt	Type	Beskrivning
<Uttryck>	Ja	Booleskt	Uttrycket som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om uttrycket är falskt. Returnera false om uttrycket är sant.

Exempel 1

De här exemplen kontrollerar om de angivna uttrycken är falska:

not(false)
not(true)

Och returnera följande resultat:

• Uttrycket är falskt, så funktionen returnerar true.
• Uttrycket är sant, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om de angivna uttrycken är falska:

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

Och returnera följande resultat:

• Uttrycket är falskt, så funktionen returnerar true.
• Uttrycket är sant, så funktionen returnerar false.

eller

Kontrollera om minst ett uttryck är sant. Returnera true om minst ett uttryck är sant eller returnera false om alla är falska.

or(<expression1>, <expression2>, ...)

Parameter	Obligatoriskt	Type	Beskrivning
<expression1>, <expression2>, ...	Ja	Booleskt	De uttryck som ska kontrolleras

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om minst ett uttryck är sant. Returnera false om alla uttryck är falska.

Exempel 1

De här exemplen kontrollerar om minst ett uttryck är sant:

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

Och returnera följande resultat:

• Minst ett uttryck är sant, så funktionen returnerar true.
• Båda uttrycken är falska, så funktionen returnerar false.

Exempel 2

De här exemplen kontrollerar om minst ett uttryck är sant:

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

Och returnera följande resultat:

• Minst ett uttryck är sant, så funktionen returnerar true.
• Båda uttrycken är falska, så funktionen returnerar false.

Rand

Returnera ett slumpmässigt heltal från ett angivet intervall, som endast är inkluderande i startänden.

rand(<minValue>, <maxValue>)

Parameter	Obligatoriskt	Type	Beskrivning
<minValue>	Ja	integer	Det lägsta heltalet i intervallet
<Maxvalue>	Ja	integer	Det heltal som följer det högsta heltalet i intervallet som funktionen kan returnera

Returvärde	Typ	Beskrivning
<slumpmässigt resultat>	integer	Det slumpmässiga heltal som returneras från det angivna intervallet

Exempel

Det här exemplet hämtar ett slumpmässigt heltal från det angivna intervallet, exklusive det maximala värdet:

rand(1, 5)

Och returnerar 1, 2, 3 eller 4 som resultat.

intervall

Returnera en heltalsmatris som startar från ett angivet heltal.

range(<startIndex>, <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<startIndex>	Ja	integer	Ett heltalsvärde som startar matrisen som det första objektet
<antal>	Ja	integer	Antalet heltal i matrisen

Returvärde	Typ	Beskrivning
<range-result>	integer	Matrisen med heltal från det angivna indexet

Exempel

I det här exemplet skapas en heltalsmatris som startar från det angivna indexet 1 och har det angivna antalet heltal som 4:

range(1, 4)

Och returnerar resultatet [1, 2, 3, 4].

removeProperty

Ta bort en egenskap från ett objekt och returnera det uppdaterade objektet.

removeProperty(<object>, '<property>')

Parameter	Obligatoriskt	Type	Beskrivning
<Objekt>	Ja	objekt	JSON-objektet där du vill ta bort en egenskap
<Egenskapen>	Ja	sträng	Namnet på egenskapen som ska tas bort

Returvärde	Typ	Beskrivning
<updated-object>	objekt	Det uppdaterade JSON-objektet utan den angivna egenskapen

Exempel

Det här exemplet tar accountLocation bort egenskapen från ett customerProfile objekt som konverteras till JSON med funktionen json() och returnerar det uppdaterade objektet:

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

ersätt

Ersätt en delsträng med den angivna strängen och returnera resultatsträngen. Den här funktionen är skiftlägeskänslig.

replace('<text>', '<oldText>', '<newText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som har delsträngen att ersätta
<oldText>	Ja	sträng	Delsträngen som ska ersättas
<newText>	Ja	sträng	Ersättningssträngen

Returvärde	Typ	Beskrivning
<updated-text>	sträng	Den uppdaterade strängen efter att du har ersatt delsträngen. Om delsträngen inte hittas returnerar funktionen den ursprungliga strängen.

Exempel 1

Det här exemplet hittar den gamla delsträngen i den gamla strängen och ersätter gamla med nya:

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

Resultatet är strängen den nya strängen.

Exempel 2

När du hanterar escape-tecken hanterar uttrycksmotorn unescape åt dig. Den här funktionen ersätter strängar med escape-tecken.

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

Och returnerar följande resultat:

• hello\n
• Hej\\
• @"hello\\"
• @"hello\\"

replaceIgnoreCase

Ersätt en delsträng med den angivna strängen och returnera resultatsträngen. Den här funktionen är skiftlägeskänslig.

replaceIgnoreCase('<text>', '<oldText>', '<newText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som har delsträngen att ersätta
<oldText>	Ja	sträng	Delsträngen som ska ersättas
<newText>	Ja	sträng	Ersättningssträngen

Returvärde	Typ	Beskrivning
<updated-text>	sträng	Den uppdaterade strängen efter att du har ersatt delsträngen. Om delsträngen inte hittas returnerar du den ursprungliga strängen.

Exempel

Det här exemplet hittar den gamla delsträngen i strängen den gamla strängen och ersätter gamla med nya:

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

Och returnerar resultatet den nya strängen.

Lösa

Returnera strängen för ett angivet TimexProperty- eller Timex-uttryck om det refererar till en giltig tid. Giltig tid innehåller timmar, minuter och sekunder.

resolve('<timestamp')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln.

Returvärde	Typ	Beskrivning
<Återvända>	sträng	En sträng med det utvärderade TimexProperty- eller Timex-uttrycket.

Exempel

De här exemplen visar om de angivna strängarna refererar till giltig tid:

resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)

Och returnerar följande resultat:

• 14:00:00
• 2020-12-20
• 2020-12-20 14:20:00

omvänd

Ändra ordningen på elementen i en sträng eller matris.

reverse(<value>)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng eller matris	Strängen till matrisen som ska omvändas.

Returvärde	Typ	Beskrivning
<Återvända>	sträng eller matris	Omvända element i en sträng eller matris.

Exempel

De här exemplen vänder elementen i en sträng eller matris:

reverse(hello)
reverse(concat(hello,world))

Och returnera följande värden:

-Strängen olleh. -Strängen dlrowolleh.

avrunda

Avrunda ett värde till närmaste heltal eller till det angivna antalet bråksiffror.

round('<number>', '<precision-digits>')

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	Nummer	Ett indatanummer
<precisionssiffror>	Nej	integer	Ett angivet antal bråksiffror. Standardvärdet är 0.

Returvärde	Typ	Beskrivning
<return-value>	Nummer	Returvärdet för indata avrundat med ett angivet antal bråksiffror

Exempel 1

Det här exemplet avrundar talet 10.333:

round(10.333)

Och returnerar talet 10.

Exempel 2

Det här exemplet avrundar talet 10,3313 till 2 bråksiffror:

round(10.3313, 2)

Och returnerar talet 10,33.

välj

Arbeta på varje element och returnera den nya samlingen transformerade element.

select([<collection/instance>], <iteratorName>, <function>)

Parameter	Obligatoriskt	Type	Beskrivning
<samling/instans>	Ja	matris	Samlingen med objekten
<iteratorName>	Ja	iteratornamn	Nyckelobjektet
<Funktion>	Ja	Uttryck	Den här funktionen som kan innehålla iteratorName

Returvärde	Typ	Beskrivning
<ny samling>	matris	Den nya samlingen där varje element har utvärderats med funktionen

Exempel 1

Det här exemplet genererar en ny samling:

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

Och returnerar resultatet [1, 2, 3, 4].

Exempel 2

De här exemplen genererar en ny samling:

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

Och returnera resultatet ['name:jack', 'age:15']. Observera att det andra uttrycket är ett lambda-uttryck, som vissa tycker är mer läsbart.

sentenceCase

Versalisera den första bokstaven i det första ordet i en sträng i ett valfritt språkformat.

sentenceCase('<text>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Den ursprungliga strängen
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
resultatsträng	sträng	Returnerar resultatet av meningsfallet

Exempel 1

De här exemplen versalerar den första bokstaven i en sträng:

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

Och returnera följande resultat:

• A
• Abc def
• Abc def

Exempel 2

De här exemplen versaliserar den första bokstaven i en sträng i angivet språkformat:

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

Och returnera följande resultat:

• A
• Abc
• Abc

setPathToValue

Hämta värdet för den angivna egenskapen från JSON-objektet.

setPathToValue(<path>, <value>)

Parameter	Obligatoriskt	Type	Beskrivning
<Sökväg>	Ja	objekt	Sökvägen som du vill ange
<värde>	Ja	objekt	Värdet som du vill ange till sökvägen

Returvärde	Typ	Beskrivning
värde	objekt	Värdet anges

Exempel 1

Exemplet nedan anger värdet 1 till sökvägen:

setPathToValue(path.x, 1)

Och returnerar resultatet 1. path.x är inställt på 1.

Exempel 2

I det här exemplet nedan anges värdet:

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

Och returnerar resultatet 14.

Setproperty

Ange värdet för ett objekts egenskap och returnera det uppdaterade objektet. Om du vill lägga till en ny egenskap använder du den här funktionen eller funktionen addProperty().

setProperty(<object>, '<property>', <value>)

Parameter	Obligatoriskt	Type	Beskrivning
<Objekt>	Ja	objekt	JSON-objektet där du vill ange en egenskap
<Egenskapen>	Ja	sträng	Namnet på den egenskap som ska anges
<värde>	Ja	någon	Värdet som ska anges för den angivna egenskapen

Returvärde	Typ	Beskrivning
<updated-object>	objekt	Det uppdaterade JSON-objektet vars egenskap du anger

Exempel

I det accountNumber här exemplet anges egenskapen på ett customerProfile objekt som konverteras till JSON med funktionen json(). Funktionen tilldelar ett värde som genereras av funktionen newGuid() och returnerar det uppdaterade JSON-objektet:

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

hoppa över

Ta bort objekt från framsidan av en samling och returnera alla andra objekt.

skip([<collection>], <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	matris	Samlingen vars objekt du vill ta bort
<antal>	Ja	integer	Ett positivt heltal för antalet objekt att ta bort längst fram

Returvärde	Typ	Beskrivning
<updatedCollection>	matris	Den uppdaterade samlingen efter att de angivna objekten har tagits bort

Exempel

Det här exemplet tar bort ett objekt, talet 1, från den angivna matrisens framsida:

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

Och returnerar en matris med de återstående objekten: [1,2,3].

sortBy

Sortera element i samlingen i stigande ordning och returnera den sorterade samlingen.

sortBy([<collection>], '<property>')

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng eller matris	Samlingen som ska sorteras
<Egenskapen>	Nej	sträng	Sortera efter den här specifika egenskapen för objektelementet i samlingen om det anges

Returvärde	Typ	Beskrivning
<ny samling>	matris	Den nya samlingen vars element har sorterats

Exempel 1

Det här exemplet genererar sorterar följande samling:

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

Och returnera resultatet [0, 1, 2, 3].

Exempel 2

Anta att du har följande samling:

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

Det här exemplet genererar en ny sorterad samling baserat på x-objektegenskapen

sortBy(nestedItems, 'x')

Och returnerar resultatet:

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

sortByDescending

Sortera element i samlingen i fallande ordning och returnera den sorterade samlingen.

sortBy([<collection>], '<property>')

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng eller matris	Samlingen som ska sorteras
<Egenskapen>	Nej	sträng	Sortera efter den här specifika egenskapen för objektelementet i samlingen om det anges

Returvärde	Typ	Beskrivning
<ny samling>	matris	Den nya samlingen vars element har sorterats

Exempel 1

Det här exemplet genererar en ny sorterad samling:

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

Och returnerar resultatet [3, 2, 1, 0].

Exempel 2

Anta att du har följande samling:

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

Det här exemplet genererar en ny sorterad samling baserat på x-objektegenskapen:

sortByDescending(nestedItems, 'x')

Och returnerar det här resultatet:

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

dela

Returnera en matris som innehåller delsträngar, avgränsade med kommatecken, baserat på det angivna avgränsartecknet i den ursprungliga strängen.

split('<text>', '<delimiter>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som ska delas upp i delsträngar baserat på den angivna avgränsaren i den ursprungliga strängen. Om texten är ett null-värde tas den som en tom sträng.
<Avgränsare>	Nej	sträng	Tecknet i den ursprungliga strängen som ska användas som avgränsare. Om ingen avgränsare har angetts eller avgränsaren är ett null-värde blir standardvärdet en tom sträng.

Returvärde	Typ	Beskrivning
[<substring1,substring2><>,...]	matris	En matris som innehåller delsträngar från den ursprungliga strängen, avgränsad med kommatecken

Exempel

De här exemplen skapar en matris med delsträngar från den angivna strängen baserat på det angivna avgränsartecknet:

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

Och returnerar följande matriser som resultat:

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

Rot

Returnera kvadratroten för ett angivet tal.

sqrt(<number>)

Parameter	Obligatoriskt	Type	Beskrivning
<Nummer>	Ja	Nummer	Tal för att hämta kvadratroten för

Returvärde	Typ	Description
<Resultatet>	Nummer	Resultatet från databehandling av kvadratroten.

Exempel

De här exemplen beräknar kvadratroten för angivna tal:

sqrt(9)
sqrt(0)

Och returnera följande resultat:

• 3
• 0

startOfDay

Returnera dagens start för en tidsstämpel i ett valfritt språkformat.

startOfDay('<timestamp>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
"<updated-timestamp>"	sträng	Den angivna tidsstämpeln börjar med nolltimmesmarkeringen för dagen

Exempel 1

Det här exemplet hittar dagens start:

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

Och returnerar resultatet 2018-03-15T00:00:00.000Z.

Exempel 2

Det här exemplet hittar dagens start med språkvarianten fr-FR:

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

Och returnerar resultatet 15/03/2018 00:00:00.

startOfHour

Returnera timmens start för en tidsstämpel i ett valfritt språkformat.

startOfHour('<timestamp>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
"<updated-timestamp>"	sträng	Den angivna tidsstämpeln börjar med nollminutersmarkeringen för dagen

Exempel 1

Det här exemplet hittar början av timmen:

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

Och returnerar resultatet 2018-03-15T13:00:00.000Z.

Exempel 2

Det här exemplet hittar början av timmen med språkvarianten fr-FR:

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

Och returnerar resultatet 15/03/2018 13:00:00.

startOfMonth

Returnera början av månaden för en tidsstämpel i ett valfritt språkformat.

startOfMonth('<timestamp>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
"<updated-timestamp>"	sträng	Den angivna tidsstämpeln börjar den första dagen i månaden med nolltimmesmarkeringen

Exempel 1

Det här exemplet hittar början av månaden:

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

Och returnerar resultatet 2018-03-01T00:00:00.000Z.

Exempel 2

Det här exemplet hittar början av månaden med språkvarianten fr-FR:

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

Och returnerar resultatet 2018-01-03 00:00:00.

startsWith

Kontrollera om en sträng börjar med en specifik delsträng. Returnera true om delsträngen hittas eller returnera false om den inte hittas. Den här funktionen är skiftlägeskänslig.

startsWith('<text>', '<searchText>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som ska kontrolleras
<searchText>	Ja	sträng	Startundersträngen för att hitta

Returvärde	Typ	Beskrivning
sant eller falskt	Booleskt	Returnera true om startundersträngen hittas. Returnera false om det inte hittas

Exempel 1

Det här exemplet kontrollerar om strängen hello world börjar med strängen hello:

startsWith('hello world', 'hello')

Och returnerar resultatet true.

Exempel 2

Det här exemplet kontrollerar om strängen hello world börjar med stränghälsningen:

startsWith('hello world', 'greeting')

Och returnerar resultatet false.

sträng

Returnera strängversionen av ett värde i ett valfritt språkformat.

string(<value>, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	någon	Värdet som ska konverteras
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<string-value>	sträng	Strängversionen av det angivna värdet

Exempel 1

I det här exemplet skapas strängversionen av talet 10:

string(10)

Och returnerar strängresultatet 10.

Exempel 2

Det här exemplet skapar en sträng för det angivna JSON-objektet och använder omvänt\\ snedstreck, som ett escape-tecken för tecknet med dubbla citattecken, ".

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

Och returnerar resultatet { "name": "Sophie Owen" }

Exempel 3

I det här exemplet skapas en strängversion av talet 10 på ett specifikt språk:

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

Och returnerar följande strängar:

• 100,1
• 100.1

stringOrValue

Omslut stränginterpolation för att hämta det verkliga värdet. Till exempel stringOrValue('${1}') returnerar talet 1, medan stringOrValue('${1} item') returnerar strängen "1 objekt".

stringOrValue(<string>)

Parameter	Obligatoriskt	Type	Description
<Sträng>	Ja	sträng	Strängen som du vill hämta det verkliga värdet från.

Returvärde	Typ	Description
<Resultatet>	någon	Resultatet av att hämta det verkliga värdet för den angivna strängen.

Exempel

De här exemplen hämtar det verkliga värdet från strängen:

stringOrValue('${one}')
stringOrValue('${one} item')

Och returnera följande resultat:

• Talet 1.0.
• Strängen 1 objekt.

under

Returnera resultatet från att subtrahera det andra talet från det första talet.

sub(<minuend>, <subtrahend>)

Parameter	Obligatoriskt	Type	Beskrivning
<minuend>	Ja	Nummer	Talet som subtrakten ska subtraheras från
<subtrahend>	Ja	Nummer	Talet som ska subtraheras från minuend

Returvärde	Typ	Description
<Resultatet>	Nummer	Resultatet från att subtrahera det andra talet från det första talet

Exempel

Det här exemplet subtraherar det andra talet från det första talet:

sub(10.3, .3)

Och returnerar resultatet 10.

subArray

Returnerar en underordning från angivna start- och slutpositioner. Indexvärden börjar med talet 0.

subArray(<Array>, <startIndex>, <endIndex>)

Parameter	Obligatoriskt	Type	Beskrivning
<Array>	Ja	matris	Matrisen för att skapa underordnad matris från
<startIndex>	Ja	integer	Ett positivt tal som är lika med eller större än 0 som ska användas som startposition eller indexvärde
<endIndex>	Ja	integer	Ett positivt tal som är lika med eller större än 0 som ska användas som slutposition eller indexvärde

Returvärde	Typ	Beskrivning
<subarray-result>	matris	En underordning med det angivna antalet objekt, med början vid den angivna indexpositionen i källsträngen

Exempel

I det här exemplet skapas en underordning från den angivna matrisen:

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

Och returnerar resultatet ["l", "l", "o"].

Delsträng

Returnera tecken från en sträng med början från den angivna positionen eller indexet. Indexvärden börjar med talet 0.

substring('<text>', <startIndex>, <length>)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som du vill skapa delsträngen från
<startIndex>	Ja	integer	Ett positivt tal som är lika med eller större än 0 underordnat värde som ska användas som startposition eller indexvärde
<length>	Ja	integer	Ett positivt antal tecken underordnad i delsträngen

Returvärde	Typ	Beskrivning
<substring-result>	sträng	En delsträng med det angivna antalet tecken, med början vid den angivna indexpositionen i källsträngen

Exempel

I det här exemplet skapas en delsträng med fem tecken från den angivna strängen, med början från indexvärdet 6:

substring('hello world', 6, 5)

Och returnerar resultatvärlden.

subtractFromTime

Subtrahera ett antal tidsenheter från en tidsstämpel i ett valfritt språkformat. Se även getPastTime().

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln
<interval>	Ja	integer	Antalet angivna tidsenheter som ska subtraheras
<timeUnit>	Ja	sträng	Den tidsenhet som ska användas med intervall. Möjliga enheter är "Second", "Minute", "Hour", "Day", "Week", "Month" och "Year".
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<updated-timestamp>	sträng	Tidsstämpeln minus det angivna antalet tidsenheter

Exempel 1

Det här exemplet subtraherar en dag från följande tidsstämpel:

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

Och returnerar resultatet 2018-01-01T00:00:00.000Z.

Exempel 2

Det här exemplet subtraherar en dag från en tidsstämpel med D-formatet:

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

Och returnerar resultatet måndag, januari, 1, 2018.

Exempel 3

Det här exemplet subtraherar 1 timme från en tidsstämpel i språkvarianten de-DE :

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

Och returnerar resultatet 15.03.18 12:00:00.

summa

Returnera resultatet från att lägga till tal i en lista.

sum([<list of numbers>])

Parameter	Obligatoriskt	Type	Beskrivning
[<lista över tal>]	Ja	matris med tal	De tal som ska läggas till

Returvärde	Typ	Beskrivning
<result-sum>	Nummer	Resultatet av att lägga till de angivna talen

Exempel

Det här exemplet lägger till de angivna talen:

sum(createArray(1, 1.5))

Och returnerar resultatet 2,5.

ta

Returnera objekt från framsidan av en samling.

take('<collection>', <count>)
take([<collection>], <count>)

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	sträng eller matris	Samlingen vars objekt du vill ha
<antal>	Ja	integer	Ett positivt heltal för det antal objekt som du vill ha framifrån

Returvärde	Typ	Beskrivning
<delmängd eller [<delmängd>]>	Sträng eller matris, respektive	En sträng eller matris som har det angivna antalet objekt som tagits framifrån den ursprungliga samlingen

Exempel

I de här exemplen hämtas det angivna antalet objekt längst fram i dessa samlingar:

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

Och returnera följande resultat:

• Abc
• [0, 1, 2]

Fästingar

Returnera egenskapsvärdet ticks för en angiven tidsstämpel. En bock är 100 nanosekunders intervall.

ticks('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen för en tidsstämpel

Returvärde	Typ	Beskrivning
<ticks-number>	heltal (bigint i JavaScript)	Antalet fästingar sedan den angivna tidsstämpeln

Exempel

Det här exemplet konverterar en tidsstämpel till dess tickegenskap:

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

Och returnerar resultatet 636503904000000000.

ticksToDays

Konvertera ett egenskapsvärde för tick till antalet dagar.

ticksToDays('ticks')

Parameter	Obligatoriskt	Type	Beskrivning
<Fästingar>	Ja	integer	Egenskapsvärdet ticks som ska konverteras

Returvärde	Typ	Beskrivning
<antal dagar>	Nummer	Antalet dagar som konverterats från egenskapsvärdet ticks

Exempel

I det här exemplet konverteras ett egenskapsvärde för tick till ett antal dagar:

ticksToDays(2193385800000000)

Och returnerar talet 2538.64097222.

ticksToHours

Konvertera ett egenskapsvärde för tick till antalet timmar.

ticksToHours('ticks')

Parameter	Obligatoriskt	Type	Beskrivning
<Fästingar>	Ja	Integer	Egenskapsvärdet ticks som ska konverteras

Returvärde	Typ	Beskrivning
<antal timmar>	Nummer	Antalet timmar som konverterats från egenskapsvärdet ticks

Exempel

Det här exemplet konverterar ett egenskapsvärde för tick till ett antal timmar:

ticksToHours(2193385800000000)

Och returnerar talet 60927.38333333331.

ticksToMinutes

Konvertera ett egenskapsvärde för tick till antalet minuter.

ticksToMinutes('ticks')

Parameter	Obligatoriskt	Type	Beskrivning
<Fästingar>	Ja	integer	Egenskapsvärdet ticks som ska konverteras

Returvärde	Typ	Beskrivning
<antal minuter>	Nummer	Antalet minuter som konverterats från egenskapsvärdet ticks

Exempel

I det här exemplet konverteras ett egenskapsvärde för tick till ett antal minuter:

ticksToMinutes(2193385800000000)

Och returnerar talet 3655643.0185.

titleCase

Versalisera den första bokstaven i varje ord i en sträng i ett valfritt lokalt format.

titleCase('<text>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Den ursprungliga strängen
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
resultatsträng	sträng	Resultat av rubrikfall

Exempel 1

De här exemplen versalerar den första bokstaven i varje ord i en sträng:

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

Och returnera följande resultat:

• A
• Abc Def
• Abc Def

Exempel 2

De här exemplen versalerar den första bokstaven i en sträng i formatet en-US :

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

Och returnera följande resultat:

• A
• Abc Def

toLower

Returnera en sträng i gemener i ett valfritt språkformat. Om ett tecken i strängen inte har en gemen version förblir det tecknet oförändrat i den returnerade strängen.

toLower('<text>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som ska returneras i gemener
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<gemener-text>	sträng	Den ursprungliga strängen i gemener

Exempel 1

I det här exemplet konverteras en sträng till gemener:

toLower('Hello World')

Och returnerar resultatet hello world.

Exempel 2

I det här exemplet konverteras en sträng till gemener i fr-FR-format :

toUpper('Hello World', 'fr-FR')

Och returnerar resultatet hello world.

toUpper

Returnera en sträng i versaler i ett valfritt språkformat. Om ett tecken i strängen inte har en versalversion förblir det tecknet oförändrat i den returnerade strängen.

toUpper('<text>', '<locale>'?)

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som ska returneras i versaler
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<versaler-text>	sträng	Den ursprungliga strängen i versaler

Exempel 1

I det här exemplet konverteras en sträng till versaler:

toUpper('Hello World')

Och returnerar resultatet HELLO WORLD.

Exempel 2

I det här exemplet konverteras en sträng till versaler i fr-FR-format :

toUpper('Hello World', 'fr-FR')

Och returnerar resultatet HELLO WORLD.

Trimma

Ta bort inledande och avslutande blanksteg från en sträng och returnera den uppdaterade strängen.

trim('<text>')

Parameter	Obligatoriskt	Type	Beskrivning
<text>	Ja	sträng	Strängen som har det inledande och avslutande blanksteget att ta bort

Returvärde	Typ	Beskrivning
<updatedText>	sträng	En uppdaterad version för den ursprungliga strängen utan inledande eller avslutande blanksteg

Exempel

Det här exemplet tar bort det inledande och avslutande blanksteget från strängen " Hello World ":

trim(' Hello World  ')

Och returnerar det trimmade resultatet Hello World.

union

Returnera en samling som innehåller alla objekt från de angivna samlingarna. För att visas i resultatet kan ett objekt visas i valfri samling som skickas till den här funktionen. Om ett eller flera objekt har samma namn visas det sista objektet med det namnet i resultatet.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parameter	Obligatoriskt	Type	Beskrivning
<collection1>, <collection2>, ...	Ja	matris eller objekt, men inte båda	Samlingarna där du vill ha alla objekt

Returvärde	Typ	Beskrivning
<updatedCollection>	matris eller objekt, respektive	En samling med alla objekt från de angivna samlingarna. Inga dubbletter har lagts till.

Exempel

Det här exemplet hämtar alla objekt från följande samlingar:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Och returnerar resultatet [1, 2, 3, 10, 101].

Unik

Ta bort alla dubbletter från en matris.

unique([<collection>])

Parameter	Obligatoriskt	Type	Beskrivning
<Samling>	Ja	matris	Samlingen som ska ändras

Returvärde	Typ	Beskrivning
<ny samling>	matris	Ny samling med duplicerade element borttagna

Exempel 1

Det här exemplet tar bort duplicerade element från följande matris:

unique(createArray(1, 2, 1))

Och returnerar resultatet [1, 2].

uriComponent

Returnera den binära versionen av en URI-komponent (uniform resource identifier).

uriComponent('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Strängen som ska konverteras till URI-kodat format

Returvärde	Typ	Beskrivning
<encoded-uri>	sträng	Den URI-kodade strängen med escape-tecken

Exempel

I det här exemplet skapas en URI-kodad version av en sträng:

uriComponent('https://contoso.com')

Och returnerar resultatet http%3A%2F%2Fcontoso.com.

uriComponentToString

Returnera strängversionen av en URI-kodad sträng (uniform resource identifier) som effektivt avkodar den URI-kodade strängen.

uriComponentToString('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Den URI-kodade strängen som ska avkodas

Returvärde	Typ	Beskrivning
<binary-for-encoded-uri>	sträng	Den avkodade versionen för den URI-kodade strängen

Exempel

I det här exemplet skapas den avkodade strängversionen av en URI-kodad sträng:

uriComponentToString('http%3A%2F%2Fcontoso.com')

Och returnerar resultatet https://contoso.com.

uriHost

Returnera värdvärdet för en enhetlig resursidentifierare (URI).

uriHost('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	sträng	Den URI vars värdvärde du vill ha

Returvärde	Typ	Beskrivning
<värdvärde>	sträng	Värdvärdet för den angivna URI:n

Exempel

Det här exemplet hittar värdvärdet för följande URI:

uriHost('https://www.localhost.com:8080')

Och returnerar resultatet www.localhost.com.

uriPath

Returnera sökvägsvärdet för en enhetlig resursidentifierare (URI).

uriPath('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	sträng	Den URI vars sökvägsvärde du vill ha

Returvärde	Typ	Beskrivning
<path-value>	sträng	Sökvägsvärdet för den angivna URI:n

Exempel

Det här exemplet hittar sökvägsvärdet för följande URI:

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar resultatet /catalog/shownew.htm.

uriPathAndQuery

Returnera sökvägen och frågevärdet för en enhetlig resursidentifierare (URI).

uriPathAndQuery('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	sträng	Den URI vars sökväg och frågevärde du vill ha

Returvärde	Typ	Beskrivning
<path-query-value>	sträng	Sökvägen och frågevärdet för den angivna URI:n

Exempel

Det här exemplet hittar sökvägen och frågevärdet för följande URI:

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar resultatet /catalog/shownew.htm?date=today.

uriPort

Returnera portvärdet för en enhetlig resursidentifierare (URI).

uriPort('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	sträng	Den URI vars sökvägsvärde du vill ha

Returvärde	Typ	Beskrivning
<portvärde>	sträng	Portvärdet för den angivna URI:n

Exempel

Det här exemplet hittar portvärdet för följande URI:

uriPort('http://www.localhost:8080')

Och returnerar resultatet 8080.

uriQuery

Returnera frågevärdet för en enhetlig resursidentifierare (URI).

uriQuery('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	sträng	Den URI vars frågevärde du vill ha

Returvärde	Typ	Beskrivning
<query-value>	sträng	Frågevärdet för den angivna URI:n

Exempel

Det här exemplet hittar frågevärdet för följande URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar resultatet ?date=today.

uriScheme

Returnera schemavärdet för en enhetlig resursidentifierare (URI).

uriScheme('<uri>')

Parameter	Obligatoriskt	Type	Beskrivning
<Uri>	Ja	sträng	Den URI vars frågevärde du vill ha

Returvärde	Typ	Beskrivning
<scheme-value>	sträng	Schemavärdet för den angivna URI:n

Exempel

Det här exemplet hittar schemavärdet för följande URI:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Och returnerar resultatet http.

utcNow

Returnera den aktuella tidsstämpeln i ett valfritt språkformat som en sträng.

utcNow('<format>', '<locale>'?)

Du kan också ange ett annat format med formatparametern<>.

Parameter	Obligatoriskt	Type	Beskrivning
<format>	Nej	sträng	Ett anpassat formatmönster. Standardformatet för tidsstämpeln är UTC ISO-format, ÅÅÅÅ-MM-DDTHH:mm:ss.fffZ, som uppfyller ISO 8601.
<nationella inställningar>	Nej	sträng	Ett valfritt språk för kulturinformation

Returvärde	Typ	Beskrivning
<current-timestamp>	sträng	Aktuellt datum och tid

Exempel 1

Anta att datumet är den 15 april 2018 kl . 13:00:00. Det här exemplet hämtar tidsstämpeln:

utcNow()

Och returnerar resultatet 2018-04-15T13:00:00.000Z.

Exempel 2

Anta att datumet är den 15 april 2018 kl . 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln med det valfria D-formatet:

utcNow('D')

Och returnerar resultatet söndagen den 15 april 2018.

Exempel 3

Anta att datumet är den 15 april 2018 kl . 13:00:00. Det här exemplet hämtar den aktuella tidsstämpeln med de-DE-språkvarianten:

utcNow('', 'de-DE')

Och returnerar resultatet 15.04.18 13:00:00.

där

Filtrera på varje element och returnera den nya samlingen filtrerade element som matchar ett visst villkor.

where([<collection/instance>], <iteratorName>, <function>)

Parameter	Obligatoriskt	Type	Beskrivning
<samling/instans>	Ja	matris	Samlingen med objekten
<iteratorName>	Ja	iteratornamn	Nyckelobjektet
<Funktion>	Ja	Uttryck	Villkorsfunktion som används för att filtrera objekt

Returvärde	Typ	Beskrivning
<new-collection/new-object>	matris/objekt	Den nya samlingen som varje element har filtrerats med funktionen

Exempel 1

Det här exemplet genererar en ny samling:

where(createArray(0, 1, 2, 3), x, x > 1)

Och returnerar resultatet [2, 3].

Exempel 2

De här exemplen genererar en ny samling:

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

Och returnera resultatet ['name:jack', 'age:15']. Observera att det andra uttrycket är ett lambda-uttryck, som vissa tycker är mer läsbart.

xml

Returnera XML-versionen av en sträng som innehåller ett JSON-objekt.

xml('<value>')

Parameter	Obligatoriskt	Type	Beskrivning
<värde>	Ja	sträng	Strängen med JSON-objektet som ska konverteras. JSON-objektet får bara ha en rotegenskap, som inte kan vara en matris. Använd \ som ett escape-tecken för det dubbla citattecknet (").

Returvärde	Typ	Beskrivning
<xml-version>	objekt	Kodad XML för den angivna strängen eller JSON-objektet

Exempel 1

I det här exemplet skapas XML-versionen för en sträng som innehåller ett JSON-objekt:

xml(json('{ \"name\": \"Sophia Owen\" }'))

Och returnerar resultat-XML:

<name>Sophia Owen</name>

Exempel 2

Anta att du har ett person JSON-objekt som visas nedan:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

I det här exemplet skapas XML för en sträng som innehåller det här JSON-objektet:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

Och returnerar resultat-XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person

Xpath

Kontrollera XML för noder eller värden som matchar ett XPath-uttryck (XML Path Language) och returnera matchande noder eller värden. Ett XPath-uttryck (kallas XPath) hjälper dig att navigera i en XML-dokumentstruktur så att du kan välja noder eller beräkningsvärden i XML-innehållet.

xPath('<xml>', '<xpath>')

Parameter	Obligatoriskt	Type	Beskrivning
<xml>	Ja	någon	XML-strängen för att söka efter noder eller värden som matchar ett XPath-uttrycksvärde
<Xpath>	Ja	någon	XPath-uttrycket som används för att hitta matchande XML-noder eller värden

Returvärde	Typ	Beskrivning
<xml-node>	XML	En XML-nod när endast en enskild nod matchar det angivna XPath-uttrycket
<värde>	någon	Värdet från en XML-nod när endast ett enda värde matchar det angivna XPath-uttrycket
<[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]>	matris	En matris med XML-noder eller värden som matchar det angivna XPath-uttrycket

Exempel 1

Det här exemplet hittar noder som matchar <name></name> noden i de angivna argumenten och returnerar en matris med dessa nodvärden:

xPath(items, '/produce/item/name')

Argumenten innehåller objektsträngen som innehåller den här XML:en:

"<?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>"

Här är den resulterande matrisen med de noder som matchar <name></name>:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Exempel 2

I exempel 1 hittar det här exemplet noder som matchar <count></count> noden och lägger till dessa nodvärden med funktionen sum( ):

xPath(xml(parameters('items')), 'sum(/produce/item/count)')

Och returnerar resultatet 30.

år

Returnera året för den angivna tidsstämpeln.

year('<timestamp>')

Parameter	Obligatoriskt	Type	Beskrivning
<Tidsstämpel>	Ja	sträng	Strängen som innehåller tidsstämpeln

Returvärde	Typ	Beskrivning
<År>	integer	Året i den angivna tidsstämpeln

Exempel

I det här exemplet utvärderas tidsstämpeln för året:

year('2018-03-15T00:00:00.000Z')

Och det returnerar resultatet 2018.