Vooraf gebouwde adaptieve expressies
VAN TOEPASSING OP: SDK v4
In dit artikel vindt u een overzicht van de beschikbare vooraf gedefinieerde functies die zijn geordend op basis van algemeen gebruik. Zie Operators voor informatie over operators die worden gebruikt in vooraf gedefinieerde functies en expressiesyntaxis.
Vooraf gemaakte expressies zijn onderverdeeld in de volgende functietypen:
- Tekenreeks
- Verzameling
- Logische vergelijking
- Conversie
- Wiskunde
- Datum
- Timex
- URI parseren
- Objectmanipulatie en constructie
- Reguliere expressie
- Typecontrole
U kunt de lijst ook in alfabetische volgorde weergeven.
Tekenreeksfuncties
Functie | Uitleg |
---|---|
length | Hiermee wordt de lengte van een tekenreeks geretourneerd. |
replace | Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de bijgewerkte tekenreeks. Deze functie is hoofdlettergevoelig. |
replaceIgnoreCase | Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de bijgewerkte tekenreeks. Deze functie is niet hoofdlettergevoelig. |
split | Hiermee wordt een matrix geretourneerd die subtekenreeksen bevat op basis van het opgegeven scheidingsteken. |
Subtekenreeks | Tekens retourneren uit een tekenreeks. |
toLower | Retourneert een tekenreeks in kleine letters in een optionele landinstellingsindeling. |
toUpper | Retourneert een tekenreeks in hoofdletters in een optionele landinstellingsindeling. |
trim | Verwijder voorloop- en volgspaties uit een tekenreeks. |
addOrdinal | Hiermee wordt het rangnummer van het invoernummer geretourneerd. |
endsWith | Controleer of een tekenreeks eindigt met een specifieke subtekenreeks. Retourneer true als de subtekenreeks is gevonden of als de false subtekenreeks niet wordt gevonden. Deze functie is niet hoofdlettergevoelig. |
startsWith | Controleer of een tekenreeks begint met een specifieke subtekenreeks. Retourneer true als de subtekenreeks is gevonden of als de false subtekenreeks niet wordt gevonden. Deze functie is niet hoofdlettergevoelig. |
countWord | Retourneert het aantal woorden in de opgegeven tekenreeks. |
concat | Combineer twee of meer tekenreeksen en retourneer de resulterende tekenreeks. |
newGuid | Hiermee wordt een nieuwe GUID-tekenreeks geretourneerd. |
indexOf | Retourneert de beginpositie of indexwaarde van een subtekenreeks of zoekt naar het opgegeven object en retourneert de op nul gebaseerde index van het eerste exemplaar in de hele lijst. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0. |
lastIndexOf | Retourneert de beginpositie of indexwaarde van het laatste exemplaar van een subtekenreeks of zoek naar het opgegeven object en retourneer de op nul gebaseerde index van het laatste exemplaar binnen het bereik van elementen in de lijst. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0. |
zinscase | Maak een hoofdletter van de eerste letter van het eerste woord in een tekenreeks in een optionele lokale notatie. |
titleCase | Gebruik de eerste letter van elk woord in een tekenreeks in een optionele landinstelling. |
reverse | De volgorde van de elementen in een tekenreeks of matrix omkeren. |
Verzamelingsfuncties
Functie | Uitleg |
---|---|
Bevat | Werkt om een item in een tekenreeks te vinden, een item in een matrix te zoeken of om een parameter in een complex object te vinden. Voorbeelden: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo') |
eerste | Retourneer het eerste item uit de verzameling. |
join | Retourneert een tekenreeks met alle items uit een matrix en heeft elk teken gescheiden door een scheidingsteken. Voorbeeld: join(createArray('a','b'), '.) = "a.b" |
laatste | Retourneer het laatste item uit de verzameling. |
count | Retourneert het aantal items in de verzameling. |
foreach | Gebruik elk element en retourneer de nieuwe verzameling. |
unie | Hiermee wordt een verzameling geretourneerd die alle items uit de opgegeven verzamelingen bevat. |
skip | Verwijder items aan de voorzijde van een verzameling en retourneer de resterende items. |
nemen | Items retourneren van de voorzijde van een verzameling. |
kruispunt | Retourneert een verzameling met alleen de algemene items in de opgegeven verzamelingen. |
submaarray | Retourneer een submaarray vanaf de opgegeven begin- en eindpositie. Indexwaarden beginnen met het getal 0. |
selecteren | Gebruik elk element en retourneer de nieuwe verzameling getransformeerde elementen. |
waar | Filter op elk element en retourneer de nieuwe verzameling gefilterde elementen die overeenkomen met de specifieke voorwaarde. |
sortBy | Sorteer elementen in de verzameling in oplopende volgorde en retourneer de gesorteerde verzameling. |
sortByDescending | Sorteer elementen in de verzameling in aflopende volgorde en retourneer de gesorteerde verzameling. |
indicesAndValues | Een matrix of object omzetten in een matrix met objecten met index- en waarde-eigenschap. |
pletten | Maak matrices plat in een matrix met niet-matrixwaarden. |
uniek | Verwijder alle duplicaten uit een matrix. |
enig | Bepaalt of alle elementen van een reeks aan een voorwaarde voldoen. |
Alles | Bepalen of alle elementen van een reeks aan een voorwaarde voldoen. |
reverse | De volgorde van de elementen in een tekenreeks of matrix omkeren. |
fuseren | Hiermee worden meerdere JSON-objecten of items in een matrix samengevoegd. |
Logische vergelijkingsfuncties
Functie | Uitleg |
---|---|
and | Logisch en. Retourneer waar als alle opgegeven expressies waar opleveren. |
is gelijk aan | Vergelijking gelijk aan. Retourneert waar als de opgegeven waarden gelijk zijn. |
empty | Controleer of het doel leeg is. |
greater | Vergelijking groter dan. Retourneer true als de eerste waarde meer is of retourneert false als er minder is. |
greaterOrEquals | Vergelijking groter dan of gelijk aan. Geef als resultaat true als de eerste waarde groter of gelijk is aan, of als false de eerste waarde kleiner is. |
if | Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde. |
less | Vergelijking kleiner dan bewerking. Geef als resultaat true als de eerste waarde kleiner is of als false de eerste waarde meer is. |
lessOrEquals | Vergelijking kleiner dan of gelijk aan bewerking. Geef als resultaat true als de eerste waarde kleiner is dan of gelijk is aan, of als false de eerste waarde groter is. |
niet | Logische operator niet. Retourneer true als de expressie onwaar is of retourneer false indien waar. |
or | Logisch of operationeel. Retourneer true als ten minste één expressie waar is of als false alle expressies onwaar zijn. |
Bestaat | Evalueer een expressie op waarheidsgetrouwheid. |
Conversiefuncties
Functie | Uitleg |
---|---|
drijven | Retourneert de drijvende-kommaweergave van de opgegeven tekenreeks. |
int | Retourneert de gehele getalweergave van de opgegeven tekenreeks. |
snaar | Retourneert de tekenreeksversie van de opgegeven waarde in een optionele landinstellingsindeling. |
bool | Retourneert de Booleaanse weergave van de opgegeven tekenreeks. |
createArray | Maak een matrix op basis van meerdere invoerwaarden. |
json | Retourneert de JSON-typewaarde (JavaScript Object Notation) of het object van een tekenreeks of XML. |
base64 | Retourneert de base64-gecodeerde versie van een tekenreeks of bytematrix. |
base64ToBinary | Retourneert de binaire versie voor een met base64 gecodeerde tekenreeks. |
base64ToString | Retourneert de tekenreeksversie van een met base64 gecodeerde tekenreeks. |
binair | Retourneert de binaire versie voor een invoerwaarde. |
dataUri | Retourneert de URI voor een invoerwaarde. |
dataUriToBinary | Retourneert de binaire versie van een gegevens-URI. |
dataUriToString | Retourneert de tekenreeksversie van een gegevens-URI. |
uriComponent | Retourneert de URI-gecodeerde versie voor een invoerwaarde door URL-onveilige tekens te vervangen door escapetekens. |
uriComponentToString | Retourneert de tekenreeksversie van een URI-gecodeerde tekenreeks. |
xml | Hiermee wordt de XML-versie van een tekenreeks geretourneerd. |
formatNumber | Maak een waarde op naar het dichtstbijzijnde getal ten opzichte van het opgegeven aantal fractionele cijfers en een optionele opgegeven landinstelling. |
jsonStringify | Retourneert de JSON-tekenreeks van een waarde. |
stringOrValue Wrap-tekenreeksinterpolatie om de werkelijke waarde op te halen. Retourneert bijvoorbeeld stringOrValue('${1}') het getal 1, terwijl stringOrValue('${1} item') de tekenreeks '1 item' wordt geretourneerd. |
Wiskundige functies
Functie | Uitleg |
---|---|
ABS | Retourneert de absolute waarde van het opgegeven getal. |
add | Wiskundig en. Retourneert het resultaat van het optellen van twee getallen (pure getalcase) of het samenvoegen van twee of meer tekenreeksen. |
div | Wiskundige deling. Retourneert het resultaat van het delen van twee getallen. |
max | Retourneert de grootste waarde uit een verzameling. |
min | Retourneert de kleinste waarde uit een verzameling. |
Mod | Retourneert de rest van het delen van twee getallen. |
mul | Wiskundige vermenigvuldiging. Retourneer het product van het vermenigvuldigen van twee getallen. |
rand | Retourneert een willekeurig getal tussen de opgegeven minimum- en maximumwaarde. |
Sqrt | Retourneert de vierkantswortel van een opgegeven getal. |
sub | Wiskundige aftrekking. Retourneert het resultaat van het aftrekken van het tweede getal van het eerste getal. |
som | Retourneert de som van getallen in een matrix. |
range | Retourneert een matrix met gehele getallen die begint met een opgegeven geheel getal. |
Exp | Retourneer exponentatie van het ene getal naar het andere. |
gemiddeld | Hiermee wordt het gemiddelde getal van een numerieke matrix geretourneerd. |
vloer | Retourneert de grootste integrale waarde kleiner dan of gelijk aan het opgegeven getal. |
plafond | Retourneert de kleinste integrale waarde groter dan of gelijk aan het opgegeven getal. |
rond | Rond een waarde af op het dichtstbijzijnde gehele getal of op het opgegeven aantal fractionele cijfers. |
Datum- en tijdfuncties
Functie | Uitleg |
---|---|
addDays | Voeg een aantal opgegeven dagen toe aan een bepaalde tijdstempel in een optionele landinstellingsindeling. |
addHours | Voeg een opgegeven aantal uren toe aan een bepaalde tijdstempel in een optionele landinstellingsindeling. |
addMinutes | Voeg een opgegeven aantal minuten toe aan een bepaalde tijdstempel in een optionele landinstellingsindeling. |
addSeconds | Voeg een opgegeven aantal seconden toe aan een bepaalde tijdstempel. |
dayOfMonth | Retourneert de dag van een maand voor een bepaalde tijdstempel of Timex-expressie. |
dayOfWeek | Retourneer de dag van de week voor een bepaalde tijdstempel. |
dayOfYear | Retourneer de dag van het jaar voor een bepaalde tijdstempel. |
formatDateTime | Retourneer een tijdstempel in een optionele landinstellingsindeling. |
formatEpoch | Retourneert een tijdstempel in een optionele landinstellingsindeling van UNIX Epoch-tijd (Unix-tijd, POSIX-tijd). |
formatTicks | Retourneer een tijdstempel in een optionele landinstellingnotatie van tikken. |
aftrekkenFromTime | Trek een aantal tijdseenheden af van een tijdstempel in een optionele landinstellingsindeling. |
utcNow | Retourneert de huidige tijdstempel in een optionele landinstellingnotatie als een tekenreeks. |
dateReadBack | Gebruik de datum/tijd-bibliotheek om een datum terug te lezen. |
maand | Retourneer de maand van de opgegeven tijdstempel. |
datum | Retourneer de datum voor een bepaalde tijdstempel. |
jaar | Retourneer het jaar voor de opgegeven tijdstempel. |
getTimeOfDay | Retourneer het tijdstip van de dag voor een bepaalde tijdstempel. |
getFutureTime | Retourneert de huidige tijdstempel in een optionele landinstellingsindeling plus de opgegeven tijdseenheden. |
getPastTime | Retourneert de huidige tijdstempel in een optionele landinstellingnotatie minus de opgegeven tijdseenheden. |
addToTime | Voeg een aantal tijdseenheden toe aan een tijdstempel in een optionele landinstellingsindeling. |
convertFromUTC | Converteer een tijdstempel in een optionele landinstellingsindeling van Universal Time Coordinated (UTC). |
convertToUTC | Converteer een tijdstempel in een optionele landinstellingsindeling naar Universal Time Coordinated (UTC). |
startOfDay | Retourneert het begin van de dag voor een tijdstempel in een optionele landinstellingsindeling. |
startOfHour | Retourneert het begin van het uur voor een tijdstempel in een optionele landinstellingsindeling. |
startOfMonth | Retourneert het begin van de maand voor een tijdstempel in een optionele landinstellingsindeling. |
Teken | Retourneert de waarde van de maatstreepjeseigenschap van een opgegeven tijdstempel. |
ticksToDays | Converteer een maatstreepje eigenschapswaarde naar het aantal dagen. |
ticksToHours | Converteer een tekeneigenschapswaarde naar het aantal uren. |
ticksToMinutes | Converteer een tekeneigenschapswaarde naar het aantal minuten. |
dateTimeDiff | Retourneert het verschil in tikken tussen twee tijdstempels. |
getPreviousViableDate | Retourneert de vorige uitvoerbare datum van een Timex-expressie op basis van de huidige datum en een optioneel opgegeven tijdzone. |
getNextViableDate | Retourneert de volgende levensvatbare datum van een Timex-expressie op basis van de huidige datum en een optioneel opgegeven tijdzone. |
getPreviousViableTime | Retourneer de vorige levensvatbare tijd van een Timex-expressie op basis van de huidige tijd en een optioneel opgegeven tijdzone. |
getNextViableTime | Retourneert de volgende levensvatbare tijd van een Timex-expressie op basis van de huidige tijd en een optioneel opgegeven tijdzone. |
Timex-functies
Functie | Uitleg |
---|---|
isPresent | Retourneer waar als de TimexProperty- of Timex-expressie naar het heden verwijst. |
isDuration | Retourneert true als de TimexProperty- of Timex-expressie verwijst naar een duur. |
isTime | Retourneer waar als de TimexProperty- of Timex-expressie naar een tijd verwijst. |
isDate | Retourneer waar als de TimexProperty- of Timex-expressie verwijst naar een datum. |
isTimeRange | Retourneert true als de TimexProperty- of Timex-expressie verwijst naar een tijdsbereik. |
isDateRange | Retourneert true als de TimexProperty- of Timex-expressie verwijst naar een datumbereik. |
isDefinite | Retourneer waar als de TimexProperty- of Timex-expressie verwijst naar een bepaalde dag. |
oplossen | Retourneert een tekenreeks van een bepaalde TimexProperty- of Timex-expressie als deze verwijst naar een geldig tijdstip. Geldige tijd bevat uren, minuten en seconden. |
URI-parseringsfuncties
Functie | Uitleg |
---|---|
uriHost | Retourneert de hostwaarde van een uniform resource-id (URI). |
URIPath | Retourneert de padwaarde van een URI (Uniform Resource Identifier). |
uriPathAndQuery | Retourneert het pad en de querywaarden voor een uniform resource-id (URI). |
uriPort | Retourneert de poortwaarde van een uniform resource-id (URI). |
uriQuery | Hertur0sneert de querywaarde van een uniform resource-id (URI). |
uriScheme | Retourneert de schemawaarde van een uniform resource-id (URI). |
Objectmanipulatie en bouwfuncties
Functie | Uitleg |
---|---|
addProperty | Voeg een eigenschap en de bijbehorende waarde of naam-waardepaar toe aan een JSON-object en retourneer het bijgewerkte object. |
removeProperty | Verwijder een eigenschap uit het JSON-object en retourneer het bijgewerkte object. |
setProperty | Stel de waarde van de eigenschap van een JSON-object in en retourneer het bijgewerkte object. |
getProperty | Retourneert de waarde van een opgegeven eigenschap of hoofdeigenschap van een JSON-object. |
samensmelten | Retourneert de eerste niet-null-waarde van een of meer parameters. |
xPath | Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden. |
jPath | Controleer JSON of een JSON-tekenreeks voor knooppunten of waarden die overeenkomen met een padexpressie en retourneer de overeenkomende knooppunten. |
setPathToValue | Stel de waarde van een specifiek pad in en retourneer de waarde. |
Reguliere expressiefuncties
Functie | Uitleg |
---|---|
isMatch | Retourneer waar als een tekenreeks overeenkomt met een gemeenschappelijk regex-patroon. |
Functies voor controle van het type
Functie | Uitleg |
---|---|
EOL | Hiermee wordt de reekstekst einde van regel (EOL) geretourneerd. |
isInteger | Retourneer waar als de opgegeven invoer een geheel getal is |
isFloat | Retourneer waar als de opgegeven invoer een floatpuntnummer is |
is Booleaanse waarde | Retourneer waar als de opgegeven invoer een Booleaanse waarde is. |
isArray | Retourneer waar als de opgegeven invoer een matrix is. |
isObject | Retourneer waar als de opgegeven invoer een object is. |
isDateTime | Retourneer waar als de opgegeven invoer een tijdstempel van de UTC ISO-indeling is. |
isString | Retourneert true als de opgegeven invoer een tekenreeks is. |
Vooraf gemaakte functies alfabetisch gesorteerd
ABS
Hiermee wordt de absolute waarde van het opgegeven getal geretourneerd.
abs(<number>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | Nummer | Getal om de absolute waarde van |
Retourwaarde | Type | Omschrijving |
---|---|---|
<resultaat> | Nummer | Het resultaat van het berekenen van de absolute waarde. |
Voorbeelden
In deze voorbeelden wordt de absolute waarde berekend:
abs(3.12134)
abs(-3.12134)
En beide retourneren het resultaat 3,12134.
add
Retourneert het resultaat van het optellen van twee of meer getallen (pure getalcase) of het samenvoegen van twee of meer tekenreeksen (andere hoofdletters).
add(<item1>, <item2>, ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<item1>, <item2>,... | Ja | willekeurige | items |
Retourwaarde | Type | Description |
---|---|---|
<result-sum> | getal of tekenreeks | Het resultaat van het toevoegen van de opgegeven getallen of het samenvoegingsresultaat. |
Voorbeeld
In dit voorbeeld worden de opgegeven getallen toegevoegd:
add(1, 1.5)
En retourneert het resultaat 2,5.
In dit voorbeeld worden de opgegeven items samengevoegd:
add('hello',null)
add('hello','world')
En retourneert de resultaten
- Hallo
- helloworld
addDays
Voeg een aantal dagen toe aan een tijdstempel in een optionele landinstellingsindeling.
addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat die de standaard UTC ISO-indeling moet zijn JJJJ-MM-DDTHH:mm:ss.fffZ |
<Dagen> | Ja | geheel getal | Het positieve of negatieve aantal dagen dat moet worden toegevoegd |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | Het tijdstempel plus het opgegeven aantal dagen |
Voorbeeld 1
In dit voorbeeld wordt 10 dagen toegevoegd aan het opgegeven tijdstempel:
addDays('2018-03-15T13:00:00.000Z', 10)
En retourneert het resultaat 2018-03-25T00:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt vijf dagen afgetrokken van de opgegeven tijdstempel:
addDays('2018-03-15T00:00:00.000Z', -5)
En retourneert het resultaat 2018-03-10T00:00:00.000Z.
Voorbeeld 3
In dit voorbeeld wordt 1 dag toegevoegd aan de opgegeven tijdstempel in de landinstelling de-DE:
addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')
En retourneert het resultaat 16.03.18 13:00:00.
addHours
Voeg een aantal uren toe aan een tijdstempel in een optionele landinstellingsindeling.
addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<hours> | Ja | geheel getal | Het positieve of negatieve aantal uren dat moet worden toegevoegd |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | Het tijdstempel plus het opgegeven aantal uren |
Voorbeeld 1
In dit voorbeeld wordt 10 uur toegevoegd aan de opgegeven tijdstempel:
addHours('2018-03-15T00:00:00.000Z', 10)
En retourneert het resultaat 2018-03-15T10:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt vijf uur afgetrokken van de opgegeven tijdstempel:
addHours('2018-03-15T15:00:00.000Z', -5)
En retourneert het resultaat 2018-03-15T10:00:00.000Z.
Voorbeeld 3
In dit voorbeeld wordt 2 uur toegevoegd aan de opgegeven tijdstempel in de landinstelling de-DE:
addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')
En retourneert het resultaat 15.03.18 15:00:00.
addMinutes
Voeg een aantal minuten toe aan een tijdstempel in een optionele landinstellingsindeling.
addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<minutes> | Ja | geheel getal | Het positieve of negatieve aantal minuten dat moet worden toegevoegd |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | De tijdstempel plus het opgegeven aantal minuten |
Voorbeeld 1
In dit voorbeeld wordt 10 minuten toegevoegd aan het opgegeven tijdstempel:
addMinutes('2018-03-15T00:10:00.000Z', 10)
En retourneert het resultaat 2018-03-15T00:20:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt vijf minuten afgetrokken van de opgegeven tijdstempel:
addMinutes('2018-03-15T00:20:00.000Z', -5)
En retourneert het resultaat 2018-03-15T00:15:00.000Z.
Voorbeeld 3
In dit voorbeeld wordt 30 minuten toegevoegd aan de opgegeven tijdstempel in de landinstelling de-DE:
addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')
En retourneert het resultaat 15.03.18 13:30:00.
addOrdinal
Hiermee wordt het rangnummer van het invoernummer geretourneerd.
addOrdinal(<number>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | geheel getal | De getallen die moeten worden geconverteerd naar een rangnummer |
Retourwaarde | Type | Omschrijving |
---|---|---|
<resultaat> | tekenreeks | Het rangnummer dat is geconverteerd van het invoernummer |
Voorbeeld
addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)
En retourneert respectievelijk deze resultaten:
- 11e
- 12e
- 13e
- 21e
- 22e
- 23e
addProperty
Voeg een eigenschap en de bijbehorende waarde of naam-waardepaar toe aan een JSON-object en retourneer het bijgewerkte object. Als het object al bestaat tijdens runtime, genereert de functie een fout.
addProperty('<object>', '<property>', value)
Parameter | Vereist | Type | Description |
---|---|---|---|
<object> | Ja | object | Het JSON-object waaraan u een eigenschap wilt toevoegen |
<eigenschap> | Ja | tekenreeks | De naam van de eigenschap die u wilt toevoegen |
<value> | Ja | willekeurige | De waarde van de eigenschap |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkt-object> | object | Het bijgewerkte JSON-object na het toevoegen van een nieuwe eigenschap |
Voorbeeld
In dit voorbeeld wordt de eigenschap accountNumber toegevoegd aan het customerProfile-object, dat wordt geconverteerd naar JSON met de functie json(). De functie wijst een waarde toe die wordt gegenereerd door de functie newGuid() en retourneert het bijgewerkte object:
addProperty(json('customerProfile'), 'accountNumber', newGuid())
addSeconds
Voeg een aantal seconden toe aan een tijdstempel.
addSeconds('<timestamp>', <seconds>, '<format>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<Seconden> | Ja | geheel getal | Het positieve of negatieve aantal seconden dat moet worden toegevoegd |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | De tijdstempel plus het opgegeven aantal seconden |
Voorbeeld 1
In dit voorbeeld wordt 10 seconden toegevoegd aan de opgegeven tijdstempel:
addSeconds('2018-03-15T00:00:00.000Z', 10)
En retourneert het resultaat 2018-03-15T00:00:10.000Z.
Voorbeeld 2
In dit voorbeeld wordt vijf seconden afgetrokken van de opgegeven tijdstempel:
addSeconds('2018-03-15T00:00:30.000Z', -5)
En retourneert het resultaat 2018-03-15T00:00:25.000Z.
addToTime
Voeg een aantal tijdseenheden toe aan een tijdstempel in een optionele landinstellingsindeling. Zie ook getFutureTime().
addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<interval> | Ja | geheel getal | Het aantal opgegeven tijdseenheden dat moet worden toegevoegd |
<timeUnit> | Ja | tekenreeks | De tijdseenheid die moet worden gebruikt met interval. Mogelijke eenheden zijn 'Second', 'Minute', 'Hour', 'Day', 'Week', 'Month' en 'Year'. |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | Het tijdstempel plus het aantal opgegeven tijdseenheden met een opgegeven notatie. |
Voorbeeld 1
In dit voorbeeld wordt één dag toegevoegd aan de opgegeven tijdstempel.
addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')
En retourneert het resultaat 2018-01-02T00:00:00.000Z.
Voorbeeld 2
In dit voorbeeld worden twee weken toegevoegd aan de opgegeven tijdstempel.
addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')
En retourneert het resultaat in de notatie MM-DD-JJ als 01-15-18.
Alles
Bepalen of alle elementen van een reeks aan een voorwaarde voldoen.
all(<sequence>, <item>, <condition>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<volgorde> | Ja | object | Een reeks die moet worden geëvalueerd. |
<item> | Ja | tekenreeks | Verwijst naar de elementen die in de reeks moeten worden geëvalueerd. |
<voorwaarde> | Ja | uitdrukking | De expressie om de voorwaarde te evalueren. |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneren true als alle elementen aan een voorwaarde voldoen. Retourneer false als er ten minste één niet is. |
Voorbeelden
Deze voorbeelden bepalen of alle elementen van een reeks voldoen aan een voorwaarde:
all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))
En retourneert respectievelijk de volgende resultaten:
- false, omdat beide items in de reeks geen gehele getallen zijn.
- true, omdat beide items in de reeks gehele getallen zijn.
en
Controleer of alle expressies waar zijn. Retourneer true
als alle expressies waar zijn of als false
ten minste één expressie onwaar is.
and(<expression1>, <expression2>, ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<expressie1>, <expressie2>, ... | Ja | Booleaanse waarde | De expressies die moeten worden gecontroleerd |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als alle expressies waar zijn. Retourneer false als ten minste één expressie onwaar is. |
Voorbeeld 1
In deze voorbeelden wordt gecontroleerd of de opgegeven Booleaanse waarden allemaal waar zijn:
and(true, true)
and(false, true)
and(false, false)
En retourneert respectievelijk deze resultaten:
- Beide expressies zijn waar, dus de functies retourneren
true
. - Eén expressie is onwaar, dus de functies retourneren
false
. - Beide expressies zijn onwaar, dus de functie retourneert
false
.
Voorbeeld 2
In deze voorbeelden wordt gecontroleerd of de opgegeven expressies waar zijn:
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))
En retourneert respectievelijk deze resultaten:
- Beide expressies zijn waar, dus de functies retourneren
true
. - Eén expressie is onwaar, dus de functies retourneren
false
. - Beide expressies zijn onwaar, dus de functies retourneren
false
.
willekeurige
Bepalen of elementen van een reeks aan een voorwaarde voldoen.
all(<sequence>, <item>, <condition>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<volgorde> | Ja | object | Een reeks die moet worden geëvalueerd. |
<item> | Ja | tekenreeks | Verwijst naar de elementen die in de reeks moeten worden geëvalueerd. |
<voorwaarde> | Ja | uitdrukking | De expressie om de voorwaarde te evalueren. |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als alle elementen aan de voorwaarde voldoen. Retourneer false als er ten minste één niet is. |
Voorbeelden
Deze voorbeelden bepalen of alle elementen van een reeks voldoen aan een voorwaarde:
any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))
En retourneert respectievelijk de volgende resultaten:
- true, omdat ten minste één item in de reeks een geheel getal is
- false, omdat geen van beide items in de reeks een geheel getal is.
gemiddeld
Retourneert het numerieke gemiddelde van een numerieke matrix.
average(<numericArray>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<numeriekearray> | Ja | matrix van getal | De invoermatrix om het gemiddelde te berekenen |
Retourwaarde | Type | Description |
---|---|---|
<average-of-array> | Nummer | De gemiddelde waarde van de opgegeven matrix |
Voorbeeld
In dit voorbeeld wordt het gemiddelde van de matrix berekend in createArray()
:
average(createArray(1,2,3))
En retourneert het resultaat 2.
base64
Retourneert de base64-gecodeerde versie van een tekenreeks of bytematrix.
base64('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks of bytematrix | De invoertekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<base64-string> | tekenreeks | De base64-gecodeerde versie van de invoertekenreeks |
Voorbeeld 1
In dit voorbeeld wordt de tekenreeks hello geconverteerd naar een met base64 gecodeerde tekenreeks:
base64('hello')
En retourneert het resultaat 'aGVsbG8='.
Voorbeeld 2
In dit voorbeeld wordt het volgende new byte[] { 3, 5, 1, 12 }
gebruiktbyteArr
:
base64('byteArr')
En retourneert het resultaat "AwUBDA==".
base64ToBinary
Retourneert de binaire matrix van een met base64 gecodeerde tekenreeks.
base64ToBinary('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De met base64 gecodeerde tekenreeks die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<binary-for-base64-string> | bytematrix | De binaire versie van de met base64 gecodeerde tekenreeks |
Voorbeeld
In dit voorbeeld wordt de met base64 gecodeerde tekenreeks AwUBDA== geconverteerd naar een binaire tekenreeks:
base64ToBinary('AwUBDA==')
En retourneert het resultaat nieuwe byte[] { 3, 5, 1, 12 }.
base64ToString
Retourneert de tekenreeksversie van een base64-gecodeerde tekenreeks, waardoor de base64-tekenreeks effectief wordt gedecodeerd.
base64ToString('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De met base64 gecodeerde tekenreeks om te decoderen |
Retourwaarde | Type | Description |
---|---|---|
<decoded-base64-string> | tekenreeks | De tekenreeksversie van een met base64 gecodeerde tekenreeks |
Voorbeeld
In dit voorbeeld wordt de met base64 gecodeerde tekenreeks aGVsbG8= geconverteerd naar een gedecodeerde tekenreeks:
base64ToString('aGVsbG8=')
En retourneert het resultaat hallo.
binair
Retourneert de binaire versie van een tekenreeks.
binary('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<binary-for-input-value> | bytematrix | De binaire versie van de opgegeven tekenreeks |
Voorbeeld
In dit voorbeeld wordt de tekenreeks hello geconverteerd naar een binaire tekenreeks:
binary('hello')
En retourneert het resultaat nieuwe byte[] { 104, 101, 108, 108, 111 }.
bool
Retourneert de Booleaanse versie van een waarde.
bool(<value>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | willekeurige | De waarde die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | De Booleaanse versie van de opgegeven waarde |
Voorbeeld
In deze voorbeelden worden de opgegeven waarden geconverteerd naar Booleaanse waarden:
bool(1)
bool(0)
En retourneert respectievelijk deze resultaten:
true
false
plafond
Retourneert de grootste integrale waarde kleiner dan of gelijk aan het opgegeven getal.
ceiling('<number>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | Nummer | Een invoernummer |
Retourwaarde | Type | Description |
---|---|---|
<geheel getal-waarde> | geheel getal | De grootste integrale waarde groter dan of gelijk aan het invoernummer |
Voorbeeld
In dit voorbeeld wordt de grootste integrale waarde geretourneerd die kleiner is dan of gelijk is aan het getal 10,333:
ceiling(10.333)
En retourneert het gehele getal 11.
samensmelten
Retourneert de eerste niet-null-waarde van een of meer parameters. Lege tekenreeksen, lege matrices en lege objecten zijn niet null.
coalesce(<object**1>, <object**2>, ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<object**1>, <object**2>, ... | Ja | alle (gemengde typen acceptabel) | Een of meer items om te controleren op null |
Retourwaarde | Type | Description |
---|---|---|
<first-non-null-item> | willekeurige | Het eerste item of de eerste waarde die niet null is. Als alle parameters null zijn, retourneert deze functie null. |
Voorbeeld
Deze voorbeelden retourneren de eerste niet-null-waarde van de opgegeven waarden of null wanneer alle waarden null zijn:
coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)
En respectievelijk rendement:
true
- Hallo
- Nul
concat
Combineer twee of meer objecten en retourneer de gecombineerde objecten in een lijst of tekenreeks.
concat('<text1>', '<text2>', ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<object1>, <object2>, ... | Ja | willekeurige | Ten minste twee objecten die moeten worden samengevoegd. |
Retourwaarde | Type | Description |
---|---|---|
<object1object2...> | tekenreeks of lijst | De gecombineerde tekenreeks of lijst. Null-waarden worden overgeslagen. |
Verwachte retourwaarden:
- Als alle items lijsten zijn, wordt er een lijst geretourneerd.
- Als er een item bestaat dat geen lijst is, wordt er een tekenreeks geretourneerd.
- Als een waarde null is, wordt deze overgeslagen en niet samengevoegd.
Voorbeeld
In dit voorbeeld worden de tekenreeksen Hallo en wereld gecombineerd:
concat('Hello', 'World')
En retourneert het resultaat HelloWorld.
Voorbeeld 2
In dit voorbeeld worden de lijsten [1,2] en [3,4] gecombineerd:
concat([1,2],[3,4])
En retourneert het resultaat [1,2,3,4].
Voorbeeld 3
In deze voorbeelden worden objecten van verschillende typen gecombineerd:
concat('a', 'b', 1, 2)
concat('a', [1,2])
En retourneert respectievelijk de volgende resultaten:
- De tekenreeks ab12.
- Het object aSystem.Collections.Generic.List 1[System.Object]. Dit is onleesbaar en het beste om te voorkomen.
Voorbeeld 4
In deze voorbeelden worden null
objecten gecombineerd:
concat([1,2], null)
concat('a', 1, null)
En retourneert respectievelijk de volgende resultaten:
- De lijst [1,2].
- De tekenreeks a1.
bevat
Controleer of een verzameling een specifiek item heeft. Retourneer true
als het item is gevonden of als het false
niet is gevonden. Deze functie is hoofdlettergevoelig.
contains('<collection>', '<value>')
contains([<collection>], '<value>')
Deze functie werkt op de volgende verzamelingstypen:
- Een tekenreeks om een subtekenreeks te vinden
- Een matrix om een waarde te vinden
- Een woordenlijst om een sleutel te vinden
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks, matrix of woordenlijst | De verzameling die moet worden gecontroleerd |
<value> | Ja | tekenreeks, matrix of woordenlijst, respectievelijk | Het item dat moet worden gevonden |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als het item is gevonden. Retourneren false als deze niet is gevonden. |
Voorbeeld 1
In dit voorbeeld wordt de hallo wereld van de tekenreeks gecontroleerd op de subtekenreekswereld:
contains('hello world', 'world')
En retourneert het resultaat true
.
Voorbeeld 2
In dit voorbeeld wordt de hallo wereld van de tekenreeks gecontroleerd op het subtekenreeksal:
contains('hello world', 'universe')
En retourneert het resultaat false
.
aantal
Retourneert het aantal items in een verzameling.
count('<collection>')
count([<collection>])
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks of matrix | De verzameling met de items die moeten worden geteld |
Retourwaarde | Type | Description |
---|---|---|
<lengte of aantal> | geheel getal | Het aantal items in de verzameling |
Voorbeelden:
In deze voorbeelden wordt het aantal items in deze verzamelingen geteld:
count('abcd')
count(createArray(0, 1, 2, 3))
En beide retourneren het resultaat 4.
countWord
Het aantal woorden in een tekenreeks retourneren
countWord('<text>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks die moet worden geteld |
Retourwaarde | Type | Description |
---|---|---|
<count> | geheel getal | Het aantal woorden in de tekenreeks |
Voorbeeld
In dit voorbeeld wordt het aantal woorden in de hallo wereld van de tekenreeks geteld:
countWord("hello word")
En het retourneert het resultaat 2.
convertFromUTC
Converteer een tijdstempel in een optionele landinstellingsindeling van Universal Time Coordinated (UTC) naar een doeltijdzone.
convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<destinationTimeZone> | Ja | tekenreeks | De naam van de doeltijdzone. Ondersteunt Windows- en IANA-tijdzones. |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is de o-indeling, jjjj-MM-ddTHH:mm:ss.fffffffK, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<geconverteerde tijdstempel> | tekenreeks | De tijdstempel geconverteerd naar de doeltijdzone |
Voorbeelden:
Deze voorbeelden worden geconverteerd van UTC naar 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')
En retourneert respectievelijk deze resultaten:
- 02-01-18
- 2018-01-01T18:00:00.0000000
Voorbeeld 2
In dit voorbeeld wordt een tijdstempel in de landinstelling en-US geconverteerd van UTC naar Pacific Standard Time:
convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')
En retourneert het resultaat maandag 1 januari 2018.
convertToUTC
Converteer een tijdstempel in een optionele landinstellingsindeling naar Universal Time Coordinated (UTC) vanuit de brontijdzone.
convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<sourceTimeZone> | Ja | tekenreeks | De naam van de doeltijdzone. Ondersteunt Windows- en IANA-tijdzones. |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<geconverteerde tijdstempel> | tekenreeks | De tijdstempel geconverteerd naar de doeltijdzone |
Voorbeeld
In dit voorbeeld wordt een tijdstempel geconverteerd naar UTC van Pacific Standard Time
convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')
En retourneert het resultaat 2018-01-01T08:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt een tijdstempel in de landinstelling de-DE geconverteerd naar UTC van Pacific Standard Time:
convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')
En retourneert het resultaat 01.01.18 08:00:00.
createArray
Retourneert een matrix van meerdere invoerwaarden.
createArray('<object1>', '<object2>', ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<object1>, <object2>, ... | Ja | alle, maar niet gemengd | Ten minste twee items om de matrix te maken |
Retourwaarde | Type | Description |
---|---|---|
[<object1>, <object2>, ...] | matrix | De matrix die is gemaakt op basis van alle invoeritems |
Voorbeeld
In dit voorbeeld wordt een matrix gemaakt op basis van de volgende invoer:
createArray('h', 'e', 'l', 'l', 'o')
En retourneert het resultaat [h,e, l, l, o].
dataUri
Retourneert een URI (Data Uniform Resource Identifier) van een tekenreeks.
dataUri('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
[<datum-URI>] | tekenreeks | De gegevens-URI voor de invoertekenreeks |
Voorbeeld
dataUri('hello')
Retourneert de resultaatgegevens :text/plain; charset=utf-8; base64,aGVsbG8=.
dataUriToBinary
Retourneert de binaire versie van een gegevens uniform resource-id (URI).
dataUriToBinary('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De gegevens-URI die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
[<binary-for-data-uri>] | bytematrix | De binaire versie van de gegevens-URI |
Voorbeeld
In dit voorbeeld wordt een binaire versie gemaakt voor de volgende gegevens-URI:
dataUriToBinary('aGVsbG8=')
En retourneert het resultaat nieuwe byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }.
dataUriToString
Retourneert de tekenreeksversie van een URI (Data Uniform Resource Identifier).
dataUriToString('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De gegevens-URI die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
[<tekenreeks-voor-gegevens-URI>] | tekenreeks | De tekenreeksversie van de gegevens-URI |
Voorbeeld
In dit voorbeeld wordt een tekenreeks gemaakt op basis van de volgende gegevens-URI:
dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')
En retourneert het resultaat hallo.
datum
Retourneert de datum van een opgegeven tijdstempel in de notatie m/dd/jjjj .
date('<timestramp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<datum> | tekenreeks | De datum van de opgegeven tijdstempel |
date('2018-03-15T13:00:00.000Z')
Retourneert het resultaat 3-15-2018.
dateReadBack
Hiermee gebruikt u de datum/tijd-bibliotheek om een datum terug te lezen.
dateReadBack('<currentDate>', '<targetDate>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<currentDate> | Ja | tekenreeks | De tekenreeks die de huidige datum bevat |
<targetDate> | Ja | tekenreeks | De tekenreeks die de doeldatum bevat |
Retourwaarde | Type | Description |
---|---|---|
<datum-lezen> | tekenreeks | De leesbewerking tussen de huidige datum en de doeldatum |
Voorbeeld 1
dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')
Retourneert het resultaat morgen.
dateTimeDiff
Retourneert het verschil in tikken tussen twee tijdstempels.
dateTimeDiff('<timestamp1>', '<timestamp2>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel1> | Ja | tekenreeks | De eerste tijdstempeltekenreeks die moet worden vergeleken |
<tijdstempel2> | Ja | tekenreeks | De tweede tijdstempeltekenreeks om te vergelijken |
Retourwaarde | Type | Description |
---|---|---|
<Teken> | Nummer | Het verschil in tikken tussen twee tijdstempels |
Voorbeeld 1
In dit voorbeeld wordt het verschil tussen tikken tussen twee tijdstempels geretourneerd:
dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')
En retourneert het getal 31536000000000000.
Voorbeeld 2
In dit voorbeeld wordt het verschil tussen tikken tussen twee tijdstempels geretourneerd:
dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')
Retourneert het resultaat -3153600000000000. De waarde is een negatief getal.
dayOfMonth
Retourneer de dag van de maand uit een tijdstempel.
dayOfMonth('<timestamp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<dag van de maand> | geheel getal | De dag van de maand op basis van de opgegeven tijdstempel |
Voorbeeld
In dit voorbeeld wordt het getal voor de dag van de maand geretourneerd uit de volgende tijdstempel:
dayOfMonth('2018-03-15T13:27:36Z')
En retourneert het resultaat 15.
dayOfWeek
Retourneer de dag van de week vanaf een tijdstempel.
dayOfWeek('<timestamp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<dag van de week> | geheel getal | De dag van de week vanaf de opgegeven tijdstempel. Zondag is 0, maandag is 1, enzovoort. |
Voorbeeld
In dit voorbeeld wordt het getal voor de dag van de week geretourneerd uit de volgende tijdstempel:
dayOfWeek('2018-03-15T13:27:36Z')
En retourneert het resultaat 3.
dayOfYear
Retourneer de dag van het jaar uit een tijdstempel.
dayOfYear('<timestamp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<dag van het jaar> | geheel getal | De dag van het jaar uit de opgegeven tijdstempel |
Voorbeeld
In dit voorbeeld wordt het aantal dagen van het jaar geretourneerd uit de volgende tijdstempel:
dayOfYear('2018-03-15T13:27:36Z')
En retourneert het resultaat 74.
div
Retourneert het resultaat van het delen van twee getallen. Als u de rest wilt retourneren, raadpleegt u mod().
div(<dividend>, <divisor>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<dividend> | Ja | Nummer | Het getal dat moet worden gedeeld door de deler |
<deler> | Ja | Nummer | Het getal dat het dividend deelt. Kan niet 0 zijn. |
Retourwaarde | Type | Description |
---|---|---|
<quotient-result> | Nummer | Het resultaat van het delen van het eerste getal door het tweede getal |
Voorbeeld
In beide voorbeelden wordt het eerste getal gedeeld door het tweede getal:
div(10, 5)
div(11, 5)
En retourneer het resultaat 2.
Er bestaat een tussenruimte tussen Javascript en .NET SDK. De volgende expressie retourneert bijvoorbeeld verschillende resultaten in Javascript en .NET SDK:
Als een van de parameters een float is, is het resultaat ook een FLOAT met .NET SDK.
Voorbeeld
div(11.2, 2)
Retourneert het resultaat 5,6.
Als een van de parameters een float is, is het resultaat een INT met Javascript SDK.
Voorbeeld
div(11.2, 2)
Retourneert het resultaat 5.
De tijdelijke oplossing voor Javascript om een bepaald aantal decimalen in de resultaten te behouden, is door een dergelijke expressie te gebruiken. Als u bijvoorbeeld drie decimalen wilt behouden:
float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))
empty
Controleer of een exemplaar leeg is. Retourneer true
als de invoer leeg is.
Lege middelen:
- invoer is null of niet gedefinieerd
- invoer is een null- of lege tekenreeks
- invoer is verzameling met nulgrootten
- invoer is een object zonder eigenschap.
empty('<instance>')
empty([<instance>])
Parameter | Vereist | Type | Description |
---|---|---|---|
<voorbeeld> | Ja | willekeurige | Het exemplaar dat moet worden gecontroleerd |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true wanneer het exemplaar leeg is. |
Voorbeeld
In deze voorbeelden wordt gecontroleerd of het opgegeven exemplaar leeg is:
empty('')
empty('abc')
empty([1])
empty(null)
En retourneer respectievelijk deze resultaten:
- Geeft een lege tekenreeks door, zodat de functie retourneert
true
. - Geeft de tekenreeks abc door, dus de functie retourneert
false
. - Geeft de verzameling door met één item, zodat de functie retourneert
false
. - Geeft het null-object door, zodat de functie retourneert
true
.
endsWith
Controleer of een tekenreeks eindigt met een specifieke subtekenreeks. Retourneer true
als de subtekenreeks is gevonden of als de false
subtekenreeks niet wordt gevonden. Deze functie is niet hoofdlettergevoelig.
endsWith('<text>', '<searchText>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks die moet worden gecontroleerd |
<searchText> | Ja | tekenreeks | De eindsubtekenreeks om te zoeken |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneert true wanneer de eindsubtekenreeks wordt gevonden. Retourneren false als deze niet is gevonden |
Voorbeeld 1
In dit voorbeeld wordt gecontroleerd of de hello world-tekenreeks eindigt op de tekenreekswereld:
endsWith('hello world', 'world')
En het resultaat true
wordt geretourneerd.
Voorbeeld 2
In dit voorbeeld wordt gecontroleerd of de hello world-tekenreeks eindigt op het tekenreeksalal:
endsWith('hello world', 'universe')
En het resultaat false
wordt geretourneerd.
EOL
Hiermee wordt de reekstekst einde van regel (EOL) geretourneerd.
EOL()
Retourwaarde | Type | Description |
---|---|---|
<IsOSPlatform> | tekenreeks | \r\n in Windows en \n in Mac en Linux retourneren. |
Voorbeeld
In dit voorbeeld wordt het einde van de regelreekstekst gecontroleerd:
EOL()
En retourneert de volgende tekenreeksen:
- Windows: \r\n
- Mac of Linux: \n
equals
Controleer of beide waarden, expressies of objecten gelijkwaardig zijn. Retourneren true
als beide gelijkwaardig zijn of retourneren false
als ze niet gelijkwaardig zijn.
equals('<object1>', '<object2>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<object1>, <object2> | Ja | willekeurige | De waarden, expressies of objecten die moeten worden vergeleken |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneert true wanneer beide gelijkwaardig zijn. Retourneer false indien niet equivalent. |
Voorbeeld
In deze voorbeelden wordt gecontroleerd of de opgegeven invoer gelijkwaardig is:
equals(true, 1)
equals('abc', 'abcd')
En retourneert respectievelijk deze resultaten:
- Beide waarden zijn equivalent, dus de functie retourneert
true
. - Beide waarden zijn niet gelijkwaardig, dus de functie retourneert
false
.
bestaat
Evalueert een expressie op waarheidsgetrouwheid.
exists(expression)
Parameter | Vereist | Type | Description |
---|---|---|---|
uitdrukking | Ja | uitdrukking | Expressie om te evalueren op waarheidsgetrouwheid |
Retourwaarde | Type | Description |
---|---|---|
<waar of onwaar> | Booleaanse waarde | Resultaat van het evalueren van de expressie |
Voorbeeld
In dit voorbeeld wordt de waarheid van foo = {"bar":"value"}
:
exists(foo.bar)
exists(foo.bar2)
En retourneer respectievelijk deze resultaten:
true
false
exp
Retourneer exponentatie van het ene getal naar het andere.
exp(realNumber, exponentNumber)
Parameter | Vereist | Type | Description |
---|---|---|---|
realNumber | Ja | Nummer | Reëel getal voor het berekenen van exponent van |
exponentNumber | Ja | Nummer | Exponentnummer |
Retourwaarde | Type | Description |
---|---|---|
<result-exp> | Nummer | Het resultaat van computing exponent van realNumber |
Voorbeeld
In dit voorbeeld wordt de exponent berekend:
exp(2, 2)
En retourneert het resultaat 4.
Eerste
Retourneert het eerste item uit een tekenreeks of matrix.
first('<collection>')
first([<collection>])
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks of matrix | De verzameling waarin het eerste item moet worden gevonden |
Retourwaarde | Type | Description |
---|---|---|
<first-collection-item> | willekeurige | Het eerste item in de verzameling |
Voorbeeld
In deze voorbeelden vindt u het eerste item in de volgende verzamelingen:
first('hello')
first(createArray(0, 1, 2))
En retourneer respectievelijk deze resultaten:
- h
- 0
pletten
Een matrix platmaken in niet-matrixwaarden. U kunt desgewenst de maximale diepte instellen op afvlakken.
flatten([<collection>], '<depth>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | matrix | De verzameling om af te vlakken |
<diepte> | Nee | Nummer | Maximale diepte om af te vlakken. De standaardwaarde is oneindig. |
Retourwaarde | Type | Description |
---|---|---|
<nieuwe verzameling> | matrix | Nieuwe verzameling waarvan de elementen zijn afgevlakt tot een niet-matrix tot de opgegeven diepte |
Voorbeeld 1
THis-voorbeeld platt de volgende matrix:
flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))
En retourneert het resultaat [1, 2, 3, 4, 5, 6].
Voorbeeld 2
In dit voorbeeld wordt de matrix platgemaakt tot een diepte van 1:
flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)
En retourneert het resultaat [1, 2, [3, 4], [5, 6]].
zwevend
Converteer de tekenreeksversie van een drijvendekommagetal naar een drijvendekommagetal. U kunt deze functie alleen gebruiken wanneer u aangepaste parameters doorgeeft aan een app, zoals een logische app. Er wordt een uitzondering gegenereerd als de tekenreeks niet kan worden geconverteerd naar een float.
float('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks met een geldig drijvende-kommanummer waarnaar moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<float-value> | zwevend | Het drijvendekommagetal van de opgegeven tekenreeks |
Voorbeeld
In dit voorbeeld wordt de float-versie van een tekenreeks geconverteerd:
float('10.333')
En retourneert de float 10,333.
floor
Retourneert de grootste integrale waarde kleiner dan of gelijk aan het opgegeven getal.
floor('<number>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | Nummer | Een invoernummer |
Retourwaarde | Type | Description |
---|---|---|
<geheel getal-waarde> | geheel getal | De grootste integrale waarde kleiner dan of gelijk aan het invoernummer |
Voorbeeld
In dit voorbeeld wordt de vloerwaarde van het getal 10,333 berekend:
floor(10.333)
En retourneert het gehele getal 10.
foreach
Gebruik elk element en retourneer de nieuwe verzameling.
foreach([<collection/instance>], <iteratorName>, <function>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<verzameling/exemplaar> | Ja | matrix of object | De verzameling met de items |
<iteratorName> | Ja | iteratornaam | Het belangrijkste item van de pijlfunctie |
<functie> | Ja | uitdrukking | Functie die iteratorName |
Retourwaarde | Type | Description |
---|---|---|
<nieuwe verzameling> | matrix | De nieuwe verzameling waarin elk element is geëvalueerd door de functie |
Voorbeeld 1
In dit voorbeeld wordt een nieuwe verzameling gegenereerd:
foreach(createArray(0, 1, 2, 3), x, x + 1)
En retourneert het resultaat [1, 2, 3, 4].
Voorbeeld 2
Deze voorbeelden genereren een nieuwe verzameling:
foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))
En retourneer het resultaat ['name:jack', 'age:15']. De tweede expressie is een lambda-expressie, die beter leesbaar is.
formatDateTime
Retourneer een tijdstempel in een optionele landinstellingsindeling.
formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<opnieuw opgemaakte tijdstempel> | tekenreeks | De bijgewerkte tijdstempel in de opgegeven indeling |
Voorbeeld 1
In dit voorbeeld wordt een tijdstempel geconverteerd naar de opgegeven indeling:
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')
En retourneert het resultaat 2018-03-15T12:00:00.
Voorbeeld 2
In dit voorbeeld wordt een tijdstempel in de landinstelling de-DE geconverteerd:
formatDateTime('2018-03-15', '', 'de-DE')
En retourneert het resultaat 15.03.18 00:00:00.
formatEpoch
Retourneer een tijdstempel in een optionele landinstellingsindeling in de opgegeven notatie van UNIX-tijd (ook bekend als Epoch-tijd, POSIX-tijd, UNIX Epoch-tijd).
formatEpoch('<epoch>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdperk> | Ja | Nummer | Het tijdsnummer |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<opnieuw opgemaakte tijdstempel> | tekenreeks | De bijgewerkte tijdstempel in de opgegeven indeling |
Voorbeeld
In dit voorbeeld wordt een Unix-tijdstempel geconverteerd naar de opgegeven indeling:
formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'
En retourneert het resultaat 2018-03-15T12:00:00.000Z.
Voorbeeld
In dit voorbeeld wordt een Unix-tijdstempel geconverteerd in de landinstelling de-DE:
formatEpoch(1521118800, '', 'de-DE')
En retourneert het resultaat 15.03.18 13:00:00.
formatNumber
Maak een waarde op voor het opgegeven aantal fractionele cijfers en een optionele opgegeven landinstelling.
formatNumber('<number>', '<precision-digits>', '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | Nummer | Een invoernummer |
<precisiecijferige cijfers> | Ja | geheel getal | Een opgegeven aantal fractionele cijfers |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<retourwaarde> | Nummer | De retourwaarde van de invoer die is opgemaakt op een opgegeven aantal fractionele cijfers en een opgegeven landinstelling |
Voorbeeld 1
In dit voorbeeld wordt het getal 10,333 tot 2 breukcijfer opgemaakt:
formatNumber(10.333, 2)
En retourneert de tekenreeks 10,33.
Voorbeeld 2
In deze voorbeelden worden getallen opgemaakt naar een opgegeven aantal cijfers in de landinstelling en-US :
formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')
En retourneert respectievelijk de volgende resultaten:
- 12.12
- 1.55
- 12.1230
formatTicks
Retourneer een tijdstempel in een optionele landinstellingsindeling in de opgegeven notatie van tikken.
formatTicks('<ticks>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdperk> | Ja | getal (of bigint in JavaScript) | Het maatstreepnummer |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<opnieuw opgemaakte tijdstempel> | tekenreeks | De bijgewerkte tijdstempel in de opgegeven indeling |
Voorbeeld 1
In dit voorbeeld worden maatstreepjes geconverteerd naar de opgegeven indeling:
formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')
En retourneert het resultaat 2020-05-06T11:47:00.000Z.
Voorbeeld 2
In dit voorbeeld worden maatstreepjes geconverteerd naar de opgegeven indeling in de landinstelling de-DE:
formatTicks(637243624200000000, '', 'de-DE')
En retourneert het resultaat 06.05.20 11:47:00.
getFutureTime
Retourneert de huidige tijdstempel in een optionele landinstellingsindeling plus de opgegeven tijdseenheden.
getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<interval> | Ja | geheel getal | Het aantal specifieke tijdseenheden dat moet worden toegevoegd |
<timeUnit> | Ja | tekenreeks | De tijdseenheid die moet worden gebruikt met interval. Mogelijke eenheden zijn 'Second', 'Minute', 'Hour', 'Day', 'Week', 'Month' en 'Year'. |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | Het huidige tijdstempel plus het opgegeven aantal tijdseenheden |
Voorbeeld 1
Stel dat de huidige tijdstempel 2019-03-01T00:00:00.000Z is. In het onderstaande voorbeeld worden vijf dagen aan die tijdstempel toegevoegd:
getFutureTime(2, 'Week')
En retourneert het resultaat 2019-03-15T00:00:00.000Z.
Voorbeeld 2
Stel dat de huidige tijdstempel 2018-03-01T00:00:00.000Z is. In het onderstaande voorbeeld wordt vijf dagen aan de tijdstempel toegevoegd en wordt het resultaat geconverteerd naar mm-DD-JJ-indeling :
getFutureTime(5, 'Day', 'MM-DD-YY')
En retourneert het resultaat 03-06-18.
Voorbeeld 3
Stel dat de huidige tijdstempel 2020-05-01T00:00:00.000Z is en dat de landinstelling de-DE is. In het onderstaande voorbeeld wordt 1 dag toegevoegd aan de tijdstempel:
getFutureTime(1,'Day', '', 'de-DE')
En retourneert het resultaat 02.05.20 00:00:00.
getNextViableDate
Retourneert de volgende levensvatbare datum van een Timex-expressie op basis van de huidige datum en een optioneel opgegeven tijdzone.
getNextViableDate(<timexString>, <timezone>?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<timexString> | Ja | tekenreeks | De Timex-tekenreeks van de datum die moet worden geëvalueerd. |
<tijdzone> | Nee | tekenreeks | De optionele tijdzone. |
Retourwaarde | Type | Description |
---|---|---|
<nextViableTime> | tekenreeks | De volgende levensvatbare datum. |
Voorbeelden
Stel dat de datum 2020-06-12 is en dat de huidige tijd 15:42:21 is.
Deze voorbeelden evalueren de Timex-tekenreeks voor de volgende uitvoerbare datum op basis van de bovenstaande datum en tijd:
getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")
En retourneert respectievelijk de volgende tekenreeksen:
- 2020-12-20
- 2024-02-29
getNextViableTime
Retourneert de volgende levensvatbare tijd van een Timex-expressie op basis van de huidige tijd en een optioneel opgegeven tijdzone.
getNextViableTime(<timexString>, <timezone>?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<timexString> | Ja | tekenreeks | De Timex-tekenreeks van de tijd die moet worden geëvalueerd. |
<tijdzone> | Nee | tekenreeks | De optionele tijdzone. |
Retourwaarde | Type | Description |
---|---|---|
<nextViableTime> | tekenreeks | De volgende levensvatbare tijd. |
Voorbeelden
Stel dat de datum 2020-06-12 is en dat de huidige tijd 15:42:21 is.
In deze voorbeelden wordt een Timex-tekenreeks geëvalueerd voor de volgende levensvatbare tijd op basis van de bovenstaande datum en tijd:
getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")
En retourneert respectievelijk de volgende tekenreeksen:
- T16:12:14
- T15:52:14
getPastTime
Retourneert de huidige tijdstempel minus de opgegeven tijdseenheden.
getPastTime(<interval>, <timeUnit>, '<format>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<interval> | Ja | geheel getal | Het aantal specifieke tijdseenheden dat moet worden afgetrokken |
<timeUnit> | Ja | tekenreeks | De tijdseenheid die moet worden gebruikt met interval. Mogelijke eenheden zijn 'Second', 'Minute', 'Hour', 'Day', 'Week', 'Month' en 'Year'. |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | De huidige tijdstempel minus het opgegeven aantal tijdseenheden |
Voorbeeld 1
Stel dat de huidige tijdstempel 2018-02-01T00:00:00.000Z is. In dit voorbeeld wordt vijf dagen afgetrokken van die tijdstempel:
getPastTime(5, 'Day')
En retourneert het resultaat 2019-01-27T00:00:00.000Z.
Voorbeeld 2
Stel dat de huidige tijdstempel 2018-03-01T00:00:00.000Z is. In dit voorbeeld wordt vijf dagen afgetrokken van de tijdstempel in de MM-DD-JJ-indeling :
getPastTime(5, 'Day', 'MM-DD-YY')
En retourneert het resultaat 02-26-18.
Voorbeeld 3
Stel dat de huidige tijdstempel 2020-05-01T00:00:00.000Z is en dat de landinstelling de-DE is. In het onderstaande voorbeeld wordt 1 dag afgetrokken van de tijdstempel:
getPastTime(1,'Day', '', 'de-DE')
En retourneert het resultaat 31.04.20 00:00:00.
getPreviousViableDate
Retourneert de vorige uitvoerbare datum van een Timex-expressie op basis van de huidige datum en een optioneel opgegeven tijdzone.
getPreviousViableDate(<timexString>, <timezone>?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<timexString> | Ja | tekenreeks | De Timex-tekenreeks van de datum die moet worden geëvalueerd. |
<tijdzone> | Nee | tekenreeks | De optionele tijdzone. |
Retourwaarde | Type | Description |
---|---|---|
<previousViableDate> | tekenreeks | De vorige levensvatbare datum. |
Voorbeelden
Stel dat de datum 2020-06-12 is en dat de huidige tijd 15:42:21 is.
In deze voorbeelden wordt een Timex-tekenreeks geëvalueerd voor de vorige uitvoerbare datum op basis van de bovenstaande datum en tijd:
getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")
En retourneert respectievelijk de volgende tekenreeksen:
- 2019-12-20
- 2020-02-29
getPreviousViableTime
Retourneert de vorige levensvatbare tijd van een Timex-expressie op basis van de huidige datum en een optioneel opgegeven tijdzone.
getPreviousViableTime(<timexString>, <timezone>?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<timexString> | Ja | tekenreeks | De Timex-tekenreeks van de tijd die moet worden geëvalueerd. |
<tijdzone> | Nee | tekenreeks | De optionele tijdzone. |
Retourwaarde | Type | Description |
---|---|---|
<previousViableTime> | tekenreeks | De vorige levensvatbare tijd. |
Voorbeelden
Stel dat de datum 2020-06-12 is en dat de huidige tijd 15:42:21 is.
In deze voorbeelden wordt een Timex-tekenreeks geëvalueerd voor de vorige levensvatbare tijd op basis van de bovenstaande datum en tijd:
getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')
En retourneert respectievelijk de volgende tekenreeksen:
- T14:52:14
- T15:12:14
getProperty
Retourneert de waarde van een opgegeven eigenschap of de hoofdeigenschap van een JSON-object.
De waarde van een opgegeven eigenschap retourneren
getProperty(<JSONObject>, '<propertyName>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<JSONObject> | Ja | object | Het JSON-object met de eigenschap en waarden. |
<propertyName> | Nee | tekenreeks | De naam van de optionele eigenschap waaruit u toegang wilt krijgen tot waarden. |
Retourwaarde | Type | Description |
---|---|---|
waarde | tekenreeks | De waarde van de opgegeven eigenschap in het JSON-object. |
Voorbeeld
Stel dat u het volgende JSON-object hebt:
{
"a:b" : "a:b value",
"c":
{
"d": "d key"
}
}
In dit voorbeeld wordt een opgegeven eigenschap opgehaald uit het bovenstaande JSON-object:
getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')
En retourneert respectievelijk de volgende tekenreeksen:
- a:b-waarde
- d-toets
De hoofdeigenschap retourneren
getProperty('<propertyName>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<propertyName> | Ja | tekenreeks | De naam van de optionele eigenschap voor toegang tot waarden uit het hoofdgeheugenbereik. |
Retourwaarde | Type | Description |
---|---|---|
waarde | tekenreeks | De waarde van de hoofdeigenschap in een JSON-object. |
Voorbeeld
Stel dat u het volgende JSON-object hebt:
{
"a:b" : "a:b value",
"c":
{
"d": "d key"
}
}
In dit voorbeeld wordt de hoofdeigenschap opgehaald uit het bovenstaande JSON-object:
getProperty("a:b")
En retourneert de tekenreeks a:b-waarde.
getTimeOfDay
Retourneert het tijdstip van de dag voor een bepaalde tijdstempel.
getTimeOfDay('<timestamp>')
De geretourneerde tijd is een van de volgende tekenreeksen:
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de opgegeven tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<time-of-day> | tekenreeks | Het tijdstip van de dag voor de opgegeven tijdstempel |
Hieronder ziet u de tekenreeksen die zijn gekoppeld aan het tijdstip van de dag:
Tijdstip van de dag | Tijdstempel |
---|---|
Middernacht | 12:00 uur |
Ochtend | 12:01 – 11:59 uur |
Middag | 12:00 uur |
Avond | 06:00 – 10:00 |
Nacht | 10:01 – 11:59 |
Voorbeeld
getTimeOfDay('2018-03-15T08:00:00.000Z')
Retourneert de resultaatochtend.
greater
Controleer of de eerste waarde groter is dan de tweede waarde. Retourneer true
als de eerste waarde meer is of retourneert false
als er minder is.
greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | geheel getal, float of tekenreeks | De eerste waarde om te controleren of deze groter is dan de tweede waarde |
<compareTo> | Ja | geheel getal, float of tekenreeks, respectievelijk | De vergelijkingswaarde |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneert true als de eerste waarde groter is dan de tweede waarde. Retourneert false als de eerste waarde gelijk is aan of kleiner is dan de tweede waarde. |
Voorbeeld
In deze voorbeelden wordt gecontroleerd of de eerste waarde groter is dan de tweede waarde:
greater(10, 5)
greater('apple', 'banana')
En retourneert respectievelijk de volgende resultaten:
true
false
greaterOrEquals
Controleer of de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneert true
wanneer de eerste waarde groter of gelijk is of als resultaat false
als de eerste waarde kleiner is.
greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | geheel getal, float of tekenreeks | De eerste waarde om te controleren of deze groter is dan of gelijk is aan de tweede waarde |
<compareTo> | Ja | geheel getal, float of tekenreeks, respectievelijk | De vergelijkingswaarde |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als de eerste waarde groter is dan of gelijk is aan de tweede waarde. Retourneert false als de eerste waarde kleiner is dan de tweede waarde. |
Voorbeeld
In deze voorbeelden wordt gecontroleerd of de eerste waarde groter of gelijk is aan de tweede waarde:
greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')
En retourneert respectievelijk de volgende resultaten:
true
false
if
Controleer of een expressie waar of onwaar is. Op basis van het resultaat retourneert u een opgegeven waarde.
if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<uitdrukking> | Ja | Booleaanse waarde | De expressie die moet worden gecontroleerd |
<waardeIndienWaar> | Ja | willekeurige | De waarde die moet worden geretourneerd als de expressie waar is |
<waardeIndienOnwaar> | Ja | willekeurige | De waarde die moet worden geretourneerd als de expressie onwaar is |
Retourwaarde | Type | Description |
---|---|---|
<opgegeven-retourwaarde> | willekeurige | De opgegeven waarde die wordt geretourneerd op basis van of de expressie is true of false |
Voorbeeld
In dit voorbeeld wordt geëvalueerd of equals(1,1)
waar is:
if(equals(1, 1), 'yes', 'no')
En retourneert ja omdat de opgegeven expressie retourneert.true
Anders retourneert het voorbeeld nee.
indexOf
Retourneert de beginpositie of indexwaarde van een subtekenreeks. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0.
indexOf('<text>', '<searchText>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks of matrix | De tekenreeks met de subtekenreeks die moet worden gevonden |
<searchText> | Ja | tekenreeks | De subtekenreeks om te zoeken |
Retourwaarde | Type | Description |
---|---|---|
<indexwaarde> | geheel getal | De beginpositie of indexwaarde van de opgegeven subtekenreeks. |
Als de tekenreeks niet wordt gevonden, geeft u het getal -1 als resultaat. |
Voorbeeld 1
In dit voorbeeld wordt de beginindexwaarde van de subtekenreekswereld in de hallo wereld van de tekenreeks gevonden:
indexOf('hello world', 'world')
En retourneert het resultaat 6.
Voorbeeld 2
In dit voorbeeld wordt de beginindexwaarde van de subtekenreeksdef gevonden in de matrix ['abc', 'def', 'ghi']:
indexOf(createArray('abc', 'def', 'ghi'), 'def')
En retourneert het resultaat 1.
indicesAndValues
Een matrix of object omzetten in een matrix met objecten met index (huidige index) en waarde-eigenschappen. Voor matrices is de index de positie in de matrix. Voor objecten is dit de sleutel voor de waarde.
indicesAndValues('<collection or object>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<verzameling of object> | Ja | matrix of object | Oorspronkelijke matrix of object |
Retourwaarde | Type | Description |
---|---|---|
<collectie> | matrix | Nieuwe matrix. Elk item heeft twee eigenschappen: de index met de positie in een matrix of de sleutel voor een object en de bijbehorende waarde. |
Voorbeeld 1
Stel dat u een lijst { items hebt: ["nul", "één", "twee"] }. De volgende functie gebruikt die lijst:
indicesAndValues(items)
En retourneert een nieuwe lijst:
[
{
index: 0,
value: 'zero'
},
{
index: 1,
value: 'one'
},
{
index: 2,
value: 'two'
}
]
Voorbeeld 2
Stel dat u een lijst { items hebt: ["nul", "één", "twee"] }. De volgende functie gebruikt die lijst:
where(indicesAndValues(items), elt, elt.index >= 1)
En retourneert een nieuwe lijst:
[
{
index: 1,
value: 'one'
},
{
index: 2,
value: 'two'
}
]
Voorbeeld 3
Stel dat u een lijst { items hebt: ["nul", "één", "twee"] }. De volgende functie gebruikt die lijst:
join(foreach(indicesAndValues(items), item, item.value), ',')
En retourneert het resultaat nul,één,twee. Deze expressie heeft hetzelfde effect als join(items, ',').
Voorbeeld 4
Stel dat u een object { gebruiker hebt: {name: 'jack', leeftijd: 20} }. De volgende functie gebruikt dat object:
indicesAndValues(user)
En retourneert een nieuw object:
[
{
index: 'name',
value: 'jack'
},
{
index: 'age',
value: 20
}
]
int
Retourneert de gehele versie van een tekenreeks. Er wordt een uitzondering gegenereerd als de tekenreeks niet kan worden geconverteerd naar een geheel getal.
int('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<resultaat geheel getal> | geheel getal | De gehele versie van de opgegeven tekenreeks |
Voorbeeld
In dit voorbeeld wordt een geheel getal gemaakt voor de tekenreeks 10:
int('10')
En retourneert het resultaat als het gehele getal 10.
kruispunt
Retourneert een verzameling met alleen de algemene items in de opgegeven verzamelingen. Als u het resultaat wilt weergeven, moet een item worden weergegeven in alle verzamelingen die aan deze functie zijn doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam weergegeven in het resultaat.
intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<collection1>, <collection2> | Ja | matrix of object, maar niet beide | De verzamelingen waarvan u alleen de algemene items wilt |
Retourwaarde | Type | Description |
---|---|---|
<common-items> | matrix of object, respectievelijk | Een verzameling met alleen de algemene items in de opgegeven verzamelingen |
Voorbeeld
In dit voorbeeld worden de algemene items in de volgende matrices gevonden:
intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))
En retourneert een matrix met alleen de items [1, 2].
isArray
Retourneert true
als een opgegeven invoer een matrix is.
isArray('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Retourneert true als een opgegeven invoer een matrix is of als deze false geen matrix is. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de invoer een matrix is:
isArray('hello')
isArray(createArray('hello', 'world'))
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
false
. - De invoer is een matrix, dus de functie retourneert
true
.
is Booleaanse waarde
Retourneert true
als een bepaalde invoer een Booleaanse waarde is.
isBoolean('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Retourneert true als een opgegeven invoer een Booleaanse waarde is of retourneert false als deze geen Booleaanse waarde is. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de invoer een Booleaanse waarde is:
isBoolean('hello')
isBoolean(32 > 16)
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
false
. - De invoer is een Booleaanse waarde, dus de functie retourneert
true
.
isDate
Retourneert true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar een geldige datum. Geldige datums bevatten de maand en dayOfMonth, of bevatten de dayOfWeek.
isDate('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het timexProperty-invoerobject of een Timex-expressietekenreeks. |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Retourneer true als de invoer verwijst naar een geldige datum of retourneert false als de datum ongeldig is. |
Voorbeelden
Deze voorbeelden controleren of de volgende invoer geldige datums zijn:
isDate('2020-12')
isDate('xxxx-12-21')
En retourneer de volgende resultaten:
false
true
isDateRange
Retourneert true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar een geldig datumbereik.
isDateRange('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het invoerobject TimexProperty een Timex-expressietekenreeks. |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Als true de invoer verwijst naar een geldig datumbereik of retourneert false als het geen geldig datumbereik is. |
Voorbeelden
In deze voorbeelden wordt gecontroleerd of de volgende invoer een geldig datumbereik is:
isDateRange('PT30M')
isDateRange('2012-02')
En retourneer de volgende resultaten:
false
true
isDateTime
Retourneert true
als een bepaalde invoer een UTC ISO-indeling (JJJJ-MM-DDTHH:mm:ss.fffZ) tijdstempeltekenreeks is.
isDateTime('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Retourneert true als een opgegeven invoer een tijdstempeltekenreeks voor DE ISO-indeling UTC is of als false deze geen tijdstempeltekenreeks voor UTC ISO-notatie is. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de invoer een UTC ISO-indelingstekenreeks is:
isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
false
. - De invoer is een UTC ISO-indelingstekenreeks, dus de functie retourneert
true
.
isDefinite
Retourneert true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar een geldige datum. Geldige datums bevatten het jaar, de maand en de dagVanMonth.
isDefinite('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het invoerobject TimexProperty een Timex-expressietekenreeks. |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Retourneer true als de opgegeven invoer verwijst naar een geldige volledige datum of retourneert false als deze niet verwijst naar een geldige volledige datum. |
Voorbeelden
Stel dat er een TimexProperty-object validFullDate = new TimexProperty("2020-02-20") is en dat de Now
eigenschap is ingesteld op true
. In de volgende voorbeelden wordt gecontroleerd of het object verwijst naar een geldige volledige datum:
isDefinite('xxxx-12-21')
isDefinite(validFullDate)
En retourneert respectievelijk de volgende resultaten:
false
true
isDuration
Retourneer true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar een geldige duur.
isDuration('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het invoerobject TimexProperty een Timex-expressietekenreeks. |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Retourneer true als de invoer verwijst naar een geldige duur of retourneert false als de invoer niet verwijst naar een geldige duur. |
Voorbeelden
In de onderstaande voorbeelden wordt gecontroleerd of de volgende invoer verwijst naar een geldige duur:
isDuration('PT30M')
isDuration('2012-02')
En retourneert respectievelijk de volgende resultaten:
true
false
isFloat
Retourneren true
als een bepaalde invoer een drijvendekommagetal is. Vanwege de uitlijning tussen C#en JavaScript wordt een getal met een niet-nulresidu van de modulo 1 behandeld als een drijvendekommagetal.
isFloat('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Geef als resultaat true als een bepaalde invoer een drijvendekommagetal is of als false de invoer geen drijvendekommagetal is. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de invoer een drijvendekommagetal is:
isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
false
. - De invoer heeft een modulo die gelijk is aan 0, dus de functie retourneert
false
. - De invoer is een drijvendekommagetal, dus de functie retourneert
true
.
isInteger
Retourneert true
als een bepaalde invoer een geheel getal is. Vanwege de uitlijning tussen C# en JavaScript wordt een getal met een nulresidu van de modulo 1 behandeld als een geheel getal.
isInteger('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Is de invoer een geheel getal |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de invoer een geheel getal is:
isInteger('hello world!')
isInteger(1.0)
isInteger(12)
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
false
. - De invoer heeft een modulo die gelijk is aan 0, dus de functie retourneert
true
. - De invoer is een geheel getal, dus de functie retourneert
true
.
isMatch
Retourneert true
als een bepaalde tekenreeks overeenkomt met een opgegeven reguliere expressiepatroon.
isMatch('<target**string>', '<pattern>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<target**string> | Ja | tekenreeks | De tekenreeks die moet worden vergeleken |
<patroon> | Ja | tekenreeks | Een patroon voor reguliere expressies |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Retourneert true als een bepaalde tekenreeks overeenkomt met een gemeenschappelijk reguliere expressiepatroon of retourneert false als deze niet overeenkomt met het patroon. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de invoer overeenkomt met het opgegeven reguliere expressiepatroon:
isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')
En hetzelfde resultaat true
retourneren.
isObject
Retourneert true
als een bepaalde invoer een complex object is of retourneert false
als het een primitief object is. Primitieve objecten bevatten tekenreeksen, getallen en Booleaanse waarden; complexe typen, zoals klassen, bevatten eigenschappen.
isObject('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Retourneert true als een bepaalde invoer een complex object is of retourneert false als het een primitief object is. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de opgegeven invoer een object is:
isObject('hello world!')
isObject({userName: "Sam"})
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
false
. - De invoer is een object, dus de functie retourneert
true
.
isPresent
Retourneer true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar het heden.
isPresent('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het timexProperty-invoerobject een Timex-expressietekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Geef als resultaat true als de invoer naar het heden verwijst of onwaar retourneert als deze niet naar het heden verwijst. |
Voorbeelden : we hebben een TimexProperty-object validNow = new TimexProperty() { Now = true } en stel de Now
eigenschap in op true
. In de onderstaande voorbeelden wordt gecontroleerd of de volgende invoer verwijst naar het huidige:
isPresent('PT30M')
isPresent(validNow)
En retourneert respectievelijk de volgende resultaten:
false
true
isString
Retourneert true
als een bepaalde invoer een tekenreeks is.
isString('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | willekeurige | De invoer die moet worden getest |
Retourwaarde | Type | Description |
---|---|---|
<Booleaanse resultaten> | Booleaanse waarde | Retourneert true als een bepaalde invoer een tekenreeks is of retourneert false als er geen tekenreeks is. |
Voorbeelden
In de volgende voorbeelden wordt gecontroleerd of de opgegeven invoer een tekenreeks is:
isString('hello world!')
isString(3.14)
En retourneert respectievelijk de volgende resultaten:
- De invoer is een tekenreeks, dus de functie retourneert
true
. - De invoer is een float, dus de functie retourneert
false
.
isTime
Retourneer true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar een geldige tijd. Geldige tijd bevat uren, minuten en seconden.
isTime('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het timexProperty-invoerobject een Timex-expressietekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Retourneer true als de invoer verwijst naar een geldige tijd of retourneert false als deze niet verwijst naar een geldige tijd.. |
Voorbeelden
Deze voorbeelden controleren of de volgende invoer verwijst naar een geldig tijdstip:
isTime('PT30M')
isTime('2012-02-21T12:30:45')
En retourneert respectievelijk de volgende resultaten:
false
true
isTimeRange
Retourneert true
als een bepaalde TimexProperty- of Timex-expressie verwijst naar een geldig tijdsbereik Geldige tijdsbereiken partOfDay bevatten.
isTime('<input>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<invoer> | Ja | object of tekenreeks | Het invoerobject TimexProperty een Timex-expressietekenreeks. |
Retourwaarde | Type | Description |
---|---|---|
<Booleaans resultaat> | Booleaanse waarde | Retourneer true als de invoer verwijst naar een geldig tijdsbereik of retourneert false als deze niet verwijst naar een geldig tijdsbereik. |
Voorbeelden
Stel dat we een TimexProperty-object validTimeRange = new TimexProperty() { PartOfDay = "morning" } hebben en de Now
eigenschap instellen op true
. Deze voorbeelden controleren of de volgende invoer geldige tijdsbereiken zijn:
isTimeRange('PT30M')
isTimeRange(validTimeRange)
En retourneert respectievelijk de volgende resultaten:
false
true
join
Retourneert een tekenreeks met alle items uit een matrix, waarbij elk teken wordt gescheiden door een scheidingsteken.
join([<collection>], '<delimiter>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | matrix | De matrix waaraan de items moeten worden gekoppeld |
<scheidingsteken> | Ja | tekenreeks | Het scheidingsteken dat tussen elk teken in de resulterende tekenreeks wordt weergegeven |
Retourwaarde | Type | Description |
---|---|---|
<char1><scheidingsteken teken2><scheidingsteken...><> | tekenreeks | De resulterende tekenreeks die is gemaakt op basis van alle items in de opgegeven matrix |
Voorbeeld
In dit voorbeeld wordt een tekenreeks gemaakt van alle items in deze matrix met het opgegeven teken . Als scheidingsteken:
join(createArray('a', 'b', 'c'), '.')
En retourneert het resultaat a.b.c.
jPath
Controleer JSON of een JSON-tekenreeks voor knooppunten of waarden die overeenkomen met een padexpressie en retourneer de overeenkomende knooppunten.
jPath(<json>, '<path>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<json> | Ja | willekeurige | Het JSON-object of de tekenreeks om te zoeken naar knooppunten of waarden die overeenkomen met de waarde van de padexpressie |
<path> | Ja | willekeurige | De padexpressie die wordt gebruikt om overeenkomende JSON-knooppunten of -waarden te vinden |
Retourwaarde | Type | Description |
---|---|---|
[ <json-node>] | matrix | Een lijst met JSON-knooppunten of -waarden die overeenkomen met de opgegeven padexpressie |
C#-voorbeeld
Stel dat u de volgende JSON hebt:
{
"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
}
]
}
]
}
De padexpressie is $.. Producten[?( @. Prijs >= 50)]. Naam
jPath(jsonStr, path)
En het retourneert het resultaat ["Anvil", "Elbow Grease"].
Voorbeeld van JavaScript
Stel dat u de volgende JSON hebt:
{
"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
}
]
}
De padexpressie is .automobiles{.maker === "Honda" && .year > 2009}.model.
jPath(jsonStr, path)
En retourneert het resultaat ['Jazz', 'Accord'].
json
Retourneert de JSON-typewaarde (JavaScript Object Notation) of het object van een tekenreeks of XML.
json('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks of XML | De tekenreeks of XML die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<JSON-result> | tekenreeks | Het resulterende JSON-object dat is gemaakt op basis van de opgegeven tekenreeks of XML. |
Voorbeeld 1
In dit voorbeeld wordt een tekenreeks geconverteerd naar JSON:
json('{"fullName": "Sophia Owen"}')
En retourneert het resultaat:
{
"fullName": "Sophia Owen"
}
Voorbeeld 2
In dit voorbeeld wordt XML geconverteerd naar JSON:
json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))
En retourneert het resultaat:
{
"?xml": { "@version": "1.0" },
"root": {
"person": [ {
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
} ]
}
}
jsonStringify
Retourneert de JSON-tekenreeks van een waarde.
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | object | Het object dat moet worden geconverteerd naar een JSON-tekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<JSON-result> | tekenreeks | De resulterende JSON-tekenreeks. |
Voorbeelden
In deze voorbeelden worden objecten weergegeven die zijn geconverteerd naar JSON-tekenreeksen:
jsonStringify(null)
jsonStringify({a:'b'})
En retourneert respectievelijk de volgende tekenreeksresultaten:
- nul
- {"a":"b"}
Laatste
Retourneer het laatste item uit een verzameling.
last('<collection>')
last([<collection>])
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks of matrix | De verzameling waarin het laatste item wordt gevonden |
Retourwaarde | Type | Description |
---|---|---|
<last-collection-item> | tekenreeks of matrix, respectievelijk | Het laatste item in de verzameling |
Voorbeeld
In deze voorbeelden vindt u het laatste item in deze verzamelingen:
last('abcd')
last(createArray(0, 1, 2, 3))
En retourneert respectievelijk de volgende resultaten:
- d
- 3
lastIndexOf
Retourneert de beginpositie of indexwaarde van het laatste exemplaar van een subtekenreeks. Deze functie is niet hoofdlettergevoelig en indexen beginnen met het getal 0.
lastIndexOf('<text>', '<searchText>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks of matrix | De tekenreeks met de subtekenreeks die moet worden gevonden |
<searchText> | Ja | tekenreeks | De subtekenreeks om te zoeken |
Retourwaarde | Type | Description |
---|---|---|
<end-index-value> | geheel getal | De beginpositie of indexwaarde van het laatste exemplaar van de opgegeven subtekenreeks. Als de tekenreeks niet wordt gevonden, geeft u het getal -1 als resultaat. |
Voorbeeld 1
In dit voorbeeld wordt de beginindexwaarde gevonden van het laatste exemplaar van de subtekenreeks in de hello world-tekenreeks :
lastIndexOf('hello world', 'world')
En retourneert het resultaat 6.
Voorbeeld 2
In dit voorbeeld wordt de beginindexwaarde gevonden van het laatste exemplaar van subtekenreeksdef in de matrix ['abc', 'def', 'ghi', 'def'].
lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')
En retourneert het resultaat 3.
length
Hiermee wordt de lengte van een tekenreeks geretourneerd.
length('<str>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Str> | Ja | tekenreeks | De tekenreeks die moet worden berekend voor lengte |
Retourwaarde | Type | Description |
---|---|---|
<length> | geheel getal | De lengte van deze tekenreeks |
Voorbeelden
Deze voorbeelden krijgen de lengte van tekenreeksen:
length('hello')
length('hello world')
En retourneert respectievelijk de volgende resultaten:
- 5
- 11
less
Controleer of de eerste waarde kleiner is dan de tweede waarde. Geef als resultaat true
als de eerste waarde kleiner is of als false
de eerste waarde meer is.
less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | geheel getal, float of tekenreeks | De eerste waarde om te controleren of kleiner is dan de tweede waarde |
<compareTo> | Ja | geheel getal, float of tekenreeks, respectievelijk | Het vergelijkingsitem |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneert true als de eerste waarde kleiner is dan de tweede waarde. Geef als resultaat false als de eerste waarde gelijk is aan of groter is dan de tweede waarde. |
Voorbeelden
In deze voorbeelden wordt gecontroleerd of de eerste waarde kleiner is dan de tweede waarde.
less(5, 10)
less('banana', 'apple')
En retourneert respectievelijk de volgende resultaten:
true
false
lessOrEquals
Controleer of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Geef als resultaat true
als de eerste waarde kleiner is dan of gelijk is aan, of als false
de eerste waarde groter is.
lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | geheel getal, float of tekenreeks | De eerste waarde om te controleren of kleiner dan of gelijk is aan de tweede waarde |
<compareTo> | Ja | geheel getal, float of tekenreeks, respectievelijk | Het vergelijkingsitem |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Als true de eerste waarde kleiner is dan of gelijk is aan de tweede waarde. Retourneert false als de eerste waarde groter is dan de tweede waarde. |
Voorbeeld
In deze voorbeelden wordt gecontroleerd of de eerste waarde kleiner is dan of gelijk is aan de tweede waarde.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
En retourneert respectievelijk de volgende resultaten:
true
false
max
Retourneert de hoogste waarde uit een lijst of matrix. De lijst of matrix is inclusief aan beide uiteinden.
max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal1>, <getal2>, ... | Ja | Nummer | De set getallen waarvan u de hoogste waarde wilt berekenen |
[<getal1>, <getal2>, ...] | Ja | matrix van getallen | De matrix met getallen waaruit u de hoogste waarde wilt berekenen |
Retourwaarde | Type | Description |
---|---|---|
<max-value> | Nummer | De hoogste waarde in de opgegeven matrix of set getallen |
Voorbeelden
In deze voorbeelden wordt de hoogste waarde opgehaald uit de set getallen en de matrix:
max(1, 2, 3)
max(createArray(1, 2, 3))
En retourneer het resultaat 3.
samenvoegen
Hiermee worden meerdere JSON-objecten of een matrix met objecten samengevoegd.
merge(<json1>, <json2>, ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<json1>, <json2>, ... | Ja | objecten of matrix | De set JSON-objecten of -matrix die u samenvoegt. |
Retourwaarde | Type | Omschrijving |
---|---|---|
<resultaat> | object | Het gecombineerde JSON-object of gecombineerde matrixobjecten. |
Voorbeelden
Stel dat u de volgende JSON-objecten hebt:
json1 = @"{
'FirstName': 'John',
'LastName': 'Smith',
'Enabled': false,
'Roles': [ 'User' ]
}"
json2 =@"{
'Enabled': true,
'Roles': [ 'User', 'Admin' ]
}"
In dit voorbeeld worden de JSON-objecten samengevoegd:
string(merge(json(json1), json(json2)))
En retourneert het resulterende object {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Admin"]}.
Stel dat u objecten en een lijst met objecten wilt combineren. In het volgende voorbeeld worden JSON-objecten en een matrix met objecten gecombineerd:
merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})
En retourneert het object { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.
min.
Retourneert de laagste waarde uit een set getallen of een matrix.
min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal1>, <getal2>, ... | Ja | Nummer | De set getallen waaruit u de laagste waarde wilt berekenen |
[<getal1>, <getal2>, ...] | Ja | matrix van getallen | De matrix met getallen waaruit u de laagste waarde wilt berekenen |
Retourwaarde | Type | Description |
---|---|---|
<min-waarde> | Nummer | De laagste waarde in de opgegeven matrix of set getallen |
Voorbeelden
Deze voorbeelden krijgen de laagste waarde in de set getallen en de matrix:
min(1, 2, 3)
min(createArray(1, 2, 3))
En retourneer het resultaat 1.
mod
Retourneert de rest van het delen van twee getallen. Zie div()om het resultaat van het gehele getal op te halen.
mod(<dividend>, <divisor>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<dividend> | Ja | Nummer | Het getal dat moet worden gedeeld door de deler |
<deler> | Ja | Nummer | Het getal dat het dividend deelt. Kan niet 0 zijn. |
Retourwaarde | Type | Description |
---|---|---|
<modulo-result> | Nummer | Het restgetal van het delen van het eerste getal door het tweede getal |
Voorbeeld
In dit voorbeeld wordt het eerste getal gedeeld door het tweede getal:
mod(3, 2)
En retourneert het resultaat 1.
maand
Retourneer de maand van de opgegeven tijdstempel.
month('<timestamp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<aantal maanden> | geheel getal | Het aantal maanden in de opgegeven tijdstempel |
Voorbeeld
month('2018-03-15T13:01:00.000Z')
En retourneert het resultaat 3.
mul
Retourneer het product van het vermenigvuldigen van twee getallen.
mul(<multiplicand1>, <multiplicand2>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<vermenigvuldigd1> | Ja | geheel getal of float | Het getal dat moet worden vermenigvuldigd met vermenigvuldiging2 |
<vermenigvuldigd2> | Ja | geheel getal of float | Het getal dat veelvouden vermenigvuldigd1 |
Retourwaarde | Type | Description |
---|---|---|
<productresultaat> | geheel getal of float | Het product van het vermenigvuldigen van het eerste getal met het tweede getal |
Voorbeelden
In deze voorbeelden wordt het eerste getal met het tweede getal vermenigvuldigd:
mul(1, 2)
mul(1.5, 2)
En retourneert respectievelijk de volgende resultaten:
- 2
- 3
newGuid
Hiermee wordt een nieuwe GUID-tekenreeks geretourneerd.
newGuid()
Retourwaarde | Type | Description |
---|---|---|
<Guid-string> | tekenreeks | Een nieuwe Guid-tekenreeks, lengte is 36 en lijkt op xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx |
Voorbeeld
newGuid()
En het retourneert een resultaat dat de indeling xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx volgt.
not
Controleer of een expressie onwaar is. Retourneer true
als de expressie onwaar is of retourneer false
indien waar.
not(<expression>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<uitdrukking> | Ja | Booleaanse waarde | De expressie die moet worden gecontroleerd |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als de expressie onwaar is. Retourneer false als de expressie waar is. |
Voorbeeld 1
Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:
not(false)
not(true)
En retourneert respectievelijk de volgende resultaten:
- De expressie is onwaar, dus de functie retourneert
true
. - De expressie is waar, dus de functie retourneert
false
.
Voorbeeld 2
Deze voorbeelden controleren of de opgegeven expressies onwaar zijn:
not(equals(1, 2))
not(equals(1, 1))
En retourneert respectievelijk de volgende resultaten:
- De expressie is onwaar, dus de functie retourneert
true
. - De expressie is waar, dus de functie retourneert
false
.
or
Controleer of ten minste één expressie waar is. Retourneer true
als ten minste één expressie waar is of als false
alle expressies onwaar zijn.
or(<expression1>, <expression2>, ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<expressie1>, <expressie2>, ... | Ja | Booleaanse waarde | De expressies die moeten worden gecontroleerd |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als ten minste één expressie waar is. Retourneer false als alle expressies onwaar zijn. |
Voorbeeld 1
In deze voorbeelden wordt gecontroleerd of ten minste één expressie waar is:
or(true, false)
or(false, false)
En retourneert respectievelijk de volgende resultaten:
- Ten minste één expressie is waar, dus de functie retourneert
true
. - Beide expressies zijn onwaar, dus de functie retourneert
false
.
Voorbeeld 2
In deze voorbeelden wordt gecontroleerd of ten minste één expressie waar is:
or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
En retourneert respectievelijk de volgende resultaten:
- Ten minste één expressie is waar, dus de functie retourneert
true
. - Beide expressies zijn onwaar, dus de functie retourneert
false
.
rand
Retourneert een willekeurig geheel getal uit een opgegeven bereik. Dit is alleen inclusief aan het begineinde.
rand(<minValue>, <maxValue>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<minValue> | Ja | geheel getal | Het laagste gehele getal in het bereik |
<maxValue> | Ja | geheel getal | Het gehele getal dat volgt op het hoogste gehele getal in het bereik dat door de functie kan worden geretourneerd |
Retourwaarde | Type | Description |
---|---|---|
<willekeurig resultaat> | geheel getal | Het willekeurige gehele getal dat wordt geretourneerd uit het opgegeven bereik |
Voorbeeld
In dit voorbeeld wordt een willekeurig geheel getal opgehaald uit het opgegeven bereik, met uitzondering van de maximumwaarde:
rand(1, 5)
En retourneert 1, 2, 3 of 4 als resultaat.
range
Retourneert een matrix met gehele getallen die begint met een opgegeven geheel getal.
range(<startIndex>, <count>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<startIndex> | Ja | geheel getal | Een geheel getal dat de matrix start als het eerste item |
<count> | Ja | geheel getal | Het aantal gehele getallen in de matrix |
Retourwaarde | Type | Description |
---|---|---|
<bereikresultaat> | geheel getal | De matrix met gehele getallen die beginnen met de opgegeven index |
Voorbeeld
In dit voorbeeld wordt een matrix met gehele getallen gemaakt die begint met de opgegeven index 1 en het opgegeven aantal gehele getallen heeft als 4:
range(1, 4)
En retourneert het resultaat [1, 2, 3, 4].
removeProperty
Verwijder een eigenschap uit een object en retourneer het bijgewerkte object.
removeProperty(<object>, '<property>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<object> | Ja | object | Het JSON-object waarin u een eigenschap wilt verwijderen |
<eigenschap> | Ja | tekenreeks | De naam van de eigenschap die u wilt verwijderen |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkt-object> | object | Het bijgewerkte JSON-object zonder de opgegeven eigenschap |
Voorbeeld
In dit voorbeeld wordt de accountLocation
eigenschap verwijderd uit een customerProfile
object, dat wordt geconverteerd naar JSON met de functie json() en wordt het bijgewerkte object geretourneerd:
removeProperty(json('customerProfile'), 'accountLocation')
replace
Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de resultaattekenreeks. Deze functie is hoofdlettergevoelig.
replace('<text>', '<oldText>', '<newText>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks met de subtekenreeks die moet worden vervangen |
<oldText> | Ja | tekenreeks | De subtekenreeks die moet worden vervangen |
<newText> | Ja | tekenreeks | De vervangende tekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tekst> | tekenreeks | De bijgewerkte tekenreeks na het vervangen van de subtekenreeks. Als de subtekenreeks niet wordt gevonden, retourneert de functie de oorspronkelijke tekenreeks. |
Voorbeeld 1
In dit voorbeeld wordt de subtekenreeks in de oude tekenreeks gevonden en wordt deze vervangen door nieuw:
replace('the old string', 'old', 'new')
Het resultaat is de tekenreeks van de nieuwe tekenreeks.
Voorbeeld 2
Wanneer u te maken hebt met escapetekens, verwerkt de expressie-engine de on-scape voor u. Deze functie vervangt tekenreeksen door escapetekens.
replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"
En retourneert respectievelijk de volgende resultaten:
- hallo\n
- Hallo\\
- @"hallo\\"
- @"hallo\\"
replaceIgnoreCase
Vervang een subtekenreeks door de opgegeven tekenreeks en retourneer de resultaattekenreeks. Deze functie is niet hoofdlettergevoelig.
replaceIgnoreCase('<text>', '<oldText>', '<newText>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks met de subtekenreeks die moet worden vervangen |
<oldText> | Ja | tekenreeks | De subtekenreeks die moet worden vervangen |
<newText> | Ja | tekenreeks | De vervangende tekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tekst> | tekenreeks | De bijgewerkte tekenreeks na het vervangen van de subtekenreeks. Als de subtekenreeks niet wordt gevonden, retourneert u de oorspronkelijke tekenreeks. |
Voorbeeld
In dit voorbeeld wordt de subtekenreeks van de oude tekenreeks in de tekenreeks door de oude tekenreeks gevonden en wordt deze vervangen door nieuw:
replace('the old string', 'old', 'new')
En retourneert het resultaat de nieuwe tekenreeks.
oplossen
Retourtekenreeks van een bepaalde TimexProperty- of Timex-expressie als deze verwijst naar een geldig tijdstip. Geldige tijd bevat uren, minuten en seconden.
resolve('<timestamp')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat. |
Retourwaarde | Type | Description |
---|---|---|
<terugkeren> | tekenreeks | Een tekenreeks van de geëvalueerde TimexProperty- of Timex-expressie. |
Voorbeelden
Deze voorbeelden geven aan of de opgegeven tekenreeksen naar een geldig tijdstip verwijzen:
resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)
En retourneert respectievelijk de volgende resultaten:
- 14:00:00
- 2020-12-20
- 2020-12-20 14:20:00
reverse
De volgorde van de elementen in een tekenreeks of matrix omkeren.
reverse(<value>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks of matrix | De tekenreeks naar matrix om te keren. |
Retourwaarde | Type | Description |
---|---|---|
<terugkeren> | tekenreeks of matrix | De omgekeerde elementen van een tekenreeks of matrix. |
Voorbeelden
In deze voorbeelden worden de elementen van een tekenreeks of matrix omgekeerd:
reverse(hello)
reverse(concat(hello,world))
En retourneert respectievelijk de volgende waarden:
-De tekenreeks olleh. -De tekenreeks dlrowollh.
round
Rond een waarde af op het dichtstbijzijnde gehele getal of op het opgegeven aantal fractionele cijfers.
round('<number>', '<precision-digits>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | Nummer | Een invoernummer |
<precisiecijferige cijfers> | Nee | geheel getal | Een opgegeven aantal fractionele cijfers. De standaardwaarde is 0. |
Retourwaarde | Type | Description |
---|---|---|
<retourwaarde> | Nummer | De retourwaarde van de invoer die is afgerond op een opgegeven aantal fractionele cijfers |
Voorbeeld 1
In dit voorbeeld wordt het getal 10,333 afgerond:
round(10.333)
En retourneert het getal 10.
Voorbeeld 2
In dit voorbeeld wordt het getal 10,3313 afgerond op 2 fractionele cijfers:
round(10.3313, 2)
En retourneert het getal 10,33.
Selecteer
Gebruik elk element en retourneer de nieuwe verzameling getransformeerde elementen.
select([<collection/instance>], <iteratorName>, <function>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<verzameling/exemplaar> | Ja | matrix | De verzameling met de items |
<iteratorName> | Ja | iteratornaam | Het sleutelitem |
<functie> | Ja | uitdrukking | Th, functie die kan bevatten iteratorName |
Retourwaarde | Type | Description |
---|---|---|
<nieuwe verzameling> | matrix | De nieuwe verzameling waarin elk element is geëvalueerd met de functie |
Voorbeeld 1
In dit voorbeeld wordt een nieuwe verzameling gegenereerd:
select(createArray(0, 1, 2, 3), x, x + 1)
En retourneert het resultaat [1, 2, 3, 4].
Voorbeeld 2
Deze voorbeelden genereren een nieuwe verzameling:
select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))
En retourneer het resultaat ['name:jack', 'age:15']. De tweede expressie is een lambda-expressie, die beter leesbaar is.
zinscase
De eerste letter van het eerste woord in een tekenreeks in een optionele landinstelling in hoofdletters plaatsen.
sentenceCase('<text>', '<locale>'?)
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De oorspronkelijke tekenreeks |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
resultaattekenreeks | tekenreeks | Retourneert het resultaat van de zinscase |
Voorbeeld 1
In deze voorbeelden wordt de eerste letter in een tekenreeks met hoofdletters geschreven:
sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')
En retourneert respectievelijk de volgende resultaten:
- A
- Abc def
- Abc def
Voorbeeld 2
In deze voorbeelden wordt de eerste letter in een tekenreeks in de opgegeven landinstellingsindeling hoofdletters gemaakt:
sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')
En retourneert respectievelijk de volgende resultaten:
- A
- ABC
- ABC
setPathToValue
Haal de waarde van de opgegeven eigenschap op uit het JSON-object.
setPathToValue(<path>, <value>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<Pad> | Ja | object | Het pad dat u wilt instellen |
<value> | Ja | object | De waarde die u wilt instellen op het pad |
Retourwaarde | Type | Description |
---|---|---|
waarde | object | De waarde die moet worden ingesteld |
Voorbeeld 1
In het onderstaande voorbeeld wordt de waarde 1 ingesteld op het pad:
setPathToValue(path.x, 1)
En retourneert het resultaat 1. path.x
is ingesteld op 1.
Voorbeeld 2
In dit voorbeeld hieronder wordt de waarde ingesteld:
setPathToValue(path.array[0], 7) + path.array[0]
En retourneert het resultaat 14.
setProperty
Stel de waarde van de eigenschap van een object in en retourneer het bijgewerkte object. Als u een nieuwe eigenschap wilt toevoegen, gebruikt u deze functie of de functie addProperty().
setProperty(<object>, '<property>', <value>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<object> | Ja | object | Het JSON-object waarin u een eigenschap wilt instellen |
<eigenschap> | Ja | tekenreeks | De naam van de eigenschap die moet worden ingesteld |
<value> | Ja | willekeurige | De waarde die moet worden ingesteld voor de opgegeven eigenschap |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkt-object> | object | Het bijgewerkte JSON-object waarvan u de eigenschap hebt ingesteld |
Voorbeeld
In dit voorbeeld wordt de accountNumber
eigenschap ingesteld op een customerProfile
object, dat wordt geconverteerd naar JSON met de functie json(). De functie wijst een waarde toe die is gegenereerd door de functie newGuid() en retourneert het bijgewerkte JSON-object:
setProperty(json('customerProfile'), 'accountNumber', newGuid())
skip
Verwijder items aan de voorzijde van een verzameling en retourneer alle andere items.
skip([<collection>], <count>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | matrix | De verzameling waarvan u de items wilt verwijderen |
<count> | Ja | geheel getal | Een positief geheel getal voor het aantal items dat aan de voorzijde moet worden verwijderd |
Retourwaarde | Type | Description |
---|---|---|
<updatedCollection> | matrix | De bijgewerkte verzameling na het verwijderen van de opgegeven items |
Voorbeeld
In dit voorbeeld wordt één item, het getal 1, verwijderd van de voorzijde van de opgegeven matrix:
skip(createArray(0, 1, 2, 3), 1)
En retourneert een matrix met de resterende items: [1,2,3].
sortBy
Sorteer elementen in de verzameling in oplopende volgorde en retourneer de gesorteerde verzameling.
sortBy([<collection>], '<property>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks of matrix | De verzameling die moet worden gesorteerd |
<eigenschap> | Nee | tekenreeks | Sorteren op deze specifieke eigenschap van het objectelement in de verzameling indien ingesteld |
Retourwaarde | Type | Description |
---|---|---|
<nieuwe verzameling> | matrix | De nieuwe verzameling waarvan de elementen zijn gesorteerd |
Voorbeeld 1
In dit voorbeeld wordt de volgende verzameling gesorteerd:
sortBy(createArray(1, 2, 0, 3))
En retourneer het resultaat [0, 1, 2, 3].
Voorbeeld 2
Stel dat u de volgende verzameling hebt:
{
'nestedItems': [
{'x': 2},
{'x': 1},
{'x': 3}
]
}
In dit voorbeeld wordt een nieuwe gesorteerde verzameling gegenereerd op basis van de eigenschap x-object
sortBy(nestedItems, 'x')
En retourneert het resultaat:
{
'nestedItems': [
{'x': 1},
{'x': 2},
{'x': 3}
]
}
sortByDescending
Sorteer elementen in de verzameling in aflopende volgorde en retourneer de gesorteerde verzameling.
sortBy([<collection>], '<property>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks of matrix | De verzameling die moet worden gesorteerd |
<eigenschap> | Nee | tekenreeks | Sorteren op deze specifieke eigenschap van het objectelement in de verzameling indien ingesteld |
Retourwaarde | Type | Description |
---|---|---|
<nieuwe verzameling> | matrix | De nieuwe verzameling waarvan de elementen zijn gesorteerd |
Voorbeeld 1
In dit voorbeeld wordt een nieuwe gesorteerde verzameling gegenereerd:
sortByDescending(createArray(1, 2, 0, 3))
En retourneert het resultaat [3, 2, 1, 0].
Voorbeeld 2
Stel dat u de volgende verzameling hebt:
{
'nestedItems': [
{'x': 2},
{'x': 1},
{'x': 3}
]
}
In dit voorbeeld wordt een nieuwe gesorteerde verzameling gegenereerd op basis van de eigenschap x-object :
sortByDescending(nestedItems, 'x')
En retourneert dit resultaat:
{
'nestedItems': [
{'x': 3},
{'x': 2},
{'x': 1}
]
}
split
Retourneert een matrix die subtekenreeksen bevat, gescheiden door komma's, op basis van het opgegeven scheidingsteken in de oorspronkelijke tekenreeks.
split('<text>', '<delimiter>'?)
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks die moet worden gescheiden in subtekenreeksen op basis van het opgegeven scheidingsteken in de oorspronkelijke tekenreeks. Als de tekst een null-waarde is, wordt deze als een lege tekenreeks genomen. |
<scheidingsteken> | Nee | tekenreeks | Het teken in de oorspronkelijke tekenreeks dat moet worden gebruikt als scheidingsteken. Als er geen scheidingsteken is opgegeven of als het scheidingsteken een null-waarde is, is de standaardwaarde een lege tekenreeks. |
Retourwaarde | Type | Description |
---|---|---|
[<subtekenreeks1,subtekenreeks2><>,...] | matrix | Een matrix die subtekenreeksen van de oorspronkelijke tekenreeks bevat, gescheiden door komma's |
Voorbeelden
Deze voorbeelden maken een matrix met subtekenreeksen van de opgegeven tekenreeks op basis van het opgegeven scheidingsteken:
split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')
En retourneert de volgende matrices als resultaat:
- ["a", "b", "c"]
- ["h", "e", "l", "l", "o"]
- [""], [ ]
- ["h", "e", "l", "l", "o"]
Sqrt
Retourneert de vierkantswortel van een opgegeven getal.
sqrt(<number>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<getal> | Ja | Nummer | Getal om de vierkantswortel van van |
Retourwaarde | Type | Omschrijving |
---|---|---|
<resultaat> | Nummer | Het resultaat van het berekenen van de vierkantswortel. |
Voorbeelden
In deze voorbeelden wordt de vierkantswortel van de opgegeven getallen berekend:
sqrt(9)
sqrt(0)
En retourneert respectievelijk de volgende resultaten:
- 3
- 0
startOfDay
Retourneert het begin van de dag voor een tijdstempel in een optionele landinstellingsindeling.
startOfDay('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
'<bijgewerkte tijdstempel>' | tekenreeks | Het opgegeven tijdstempel beginnend bij de nuluurmarkering voor de dag |
Voorbeeld 1
In dit voorbeeld wordt het begin van de dag gevonden:
startOfDay('2018-03-15T13:30:30.000Z')
En retourneert het resultaat 2018-03-15T00:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt het begin van de dag gevonden met de landinstelling fr-FR:
startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')
En retourneert het resultaat 15-03-2018 00:00:00.
startOfHour
Retourneert het begin van het uur voor een tijdstempel in een optionele landinstellingsindeling.
startOfHour('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
'<bijgewerkte tijdstempel>' | tekenreeks | De opgegeven tijdstempel beginnend bij de markering van nul minuten voor de dag |
Voorbeeld 1
In dit voorbeeld wordt het begin van het uur gevonden:
startOfHour('2018-03-15T13:30:30.000Z')
En retourneert het resultaat 2018-03-15T13:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt het begin van het uur gevonden met de landinstelling fr-FR:
startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')
En retourneert het resultaat 15-03-2018 13:00:00.
startOfMonth
Retourneert het begin van de maand voor een tijdstempel in een optionele landinstellingsindeling.
startOfMonth('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
'<bijgewerkte tijdstempel>' | tekenreeks | De opgegeven tijdstempel die begint op de eerste dag van de maand bij de markering nuluur |
Voorbeeld 1
In dit voorbeeld wordt het begin van de maand gevonden:
startOfMonth('2018-03-15T13:30:30.000Z')
En retourneert het resultaat 2018-03-01T00:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt het begin van de maand gevonden met de landinstelling fr-FR:
startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')
En retourneert het resultaat 01/03/2018 00:00:00.
startsWith
Controleer of een tekenreeks begint met een specifieke subtekenreeks. Retourneer true
als de subtekenreeks is gevonden of als de false
subtekenreeks niet wordt gevonden. Deze functie is niet hoofdlettergevoelig.
startsWith('<text>', '<searchText>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks die moet worden gecontroleerd |
<searchText> | Ja | tekenreeks | De eerste subtekenreeks om te zoeken |
Retourwaarde | Type | Description |
---|---|---|
waar of onwaar | Booleaanse waarde | Retourneer true als de beginsubtekenreeks wordt gevonden. Retourneren false als deze niet is gevonden |
Voorbeeld 1
In dit voorbeeld wordt gecontroleerd of de hallo wereld van de tekenreeks begint met de tekenreeks hello:
startsWith('hello world', 'hello')
En retourneert het resultaat true
.
Voorbeeld 2
In dit voorbeeld wordt gecontroleerd of de hallo wereld van de tekenreeks begint met de tekenreeksgroet:
startsWith('hello world', 'greeting')
En retourneert het resultaat false
.
tekenreeks
Retourneert de tekenreeksversie van een waarde in een optionele landinstellingsindeling.
string(<value>, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | willekeurige | De waarde die moet worden geconverteerd |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<tekenreekswaarde> | tekenreeks | De tekenreeksversie van de opgegeven waarde |
Voorbeeld 1
In dit voorbeeld wordt de tekenreeksversie van het getal 10 gemaakt:
string(10)
En retourneert het tekenreeksresultaat 10.
Voorbeeld 2
In dit voorbeeld wordt een tekenreeks gemaakt voor het opgegeven JSON-object en wordt het backslash-teken\\ gebruikt, als escapeteken voor het teken met dubbele aanhalingstekens, '.
string( { "name": "Sophie Owen" } )
En retourneert het resultaat { "name": "Sophie Owen" }
Voorbeeld 3
In dit voorbeeld wordt een tekenreeksversie van het getal 10 gemaakt in een specifieke landinstelling:
string(100.1, 'fr-FR')
string(100.1, 'en-US')
En retourneert respectievelijk de volgende tekenreeksen:
- 100,1
- 100.1
stringOrValue
Wrap string interpolation to get the real value. Retourneert bijvoorbeeld stringOrValue('${1}')
het getal 1, terwijl stringOrValue('${1} item')
de tekenreeks '1 item' wordt geretourneerd.
stringOrValue(<string>)
Parameter | Vereist | Type | Omschrijving |
---|---|---|---|
<snaar> | Ja | tekenreeks | De tekenreeks waaruit de werkelijke waarde moet worden opgehaald. |
Retourwaarde | Type | Omschrijving |
---|---|---|
<resultaat> | willekeurige | Het resultaat van het ophalen van de werkelijke waarde van de opgegeven tekenreeks. |
Voorbeelden
In deze voorbeelden wordt de werkelijke waarde opgehaald uit de tekenreeks:
stringOrValue('${one}')
stringOrValue('${one} item')
En retourneert respectievelijk de volgende resultaten:
- Het getal 1,0.
- Het item tekenreeks 1.
sub
Retourneert het resultaat van het aftrekken van het tweede getal van het eerste getal.
sub(<minuend>, <subtrahend>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<minuend> | Ja | Nummer | Het getal van waaruit het aftrekken moet worden afgetrokken |
<aftrekken> | Ja | Nummer | Het getal dat moet worden afgetrokken van de minuend |
Retourwaarde | Type | Omschrijving |
---|---|---|
<resultaat> | Nummer | Het resultaat van het aftrekken van het tweede getal van het eerste getal |
Voorbeeld
In dit voorbeeld wordt het tweede getal afgetrokken van het eerste getal:
sub(10.3, .3)
En retourneert het resultaat 10.
submaarray
Retourneert een submaarray van opgegeven begin- en eindposities. Indexwaarden beginnen met het getal 0.
subArray(<Array>, <startIndex>, <endIndex>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<array> | Ja | matrix | De matrix waaruit de submatrix moet worden gemaakt |
<startIndex> | Ja | geheel getal | Een positief getal dat gelijk is aan of groter is dan 0 om te gebruiken als de beginpositie of indexwaarde |
<endIndex> | Ja | geheel getal | Een positief getal dat gelijk is aan of groter is dan 0 om te gebruiken als de eindpositie of indexwaarde |
Retourwaarde | Type | Description |
---|---|---|
<submaarray-resultaat> | matrix | Een submaarray met het opgegeven aantal items, beginnend bij de opgegeven indexpositie in de brontekenreeks |
Voorbeeld
In dit voorbeeld wordt een submatrix gemaakt op basis van de opgegeven matrix:
subArray(createArray('H','e','l','l','o'), 2, 5)
En retourneert het resultaat ["l", "l", "o"].
Subtekenreeks
Retourneert tekens uit een tekenreeks, beginnend vanaf de opgegeven positie of index. Indexwaarden beginnen met het getal 0.
substring('<text>', <startIndex>, <length>)
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks waaruit de subtekenreeks moet worden gemaakt |
<startIndex> | Ja | geheel getal | Een positief getal dat gelijk is aan of groter is dan 0 submaarray die moet worden gebruikt als de beginpositie of indexwaarde |
<length> | Ja | geheel getal | Een positief aantal tekens submaarray in de subtekenreeks |
Retourwaarde | Type | Description |
---|---|---|
<subtekenreeksresultaat> | tekenreeks | Een subtekenreeks met het opgegeven aantal tekens, beginnend bij de opgegeven indexpositie in de brontekenreeks |
Voorbeeld
In dit voorbeeld wordt een subtekenreeks van vijf tekens gemaakt op basis van de opgegeven tekenreeks, te beginnen met de indexwaarde 6:
substring('hello world', 6, 5)
En retourneert de resultaatwereld.
aftrekkenFromTime
Trek een aantal tijdseenheden af van een tijdstempel in een optionele landinstellingsindeling. Zie ook getPastTime().
subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
<interval> | Ja | geheel getal | Het aantal opgegeven tijdseenheden dat moet worden afgetrokken |
<timeUnit> | Ja | tekenreeks | De tijdseenheid die moet worden gebruikt met interval. Mogelijke eenheden zijn 'Second', 'Minute', 'Hour', 'Day', 'Week', 'Month' en 'Year'. |
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<bijgewerkte tijdstempel> | tekenreeks | Het tijdstempel minus het opgegeven aantal tijdseenheden |
Voorbeeld 1
In dit voorbeeld wordt één dag afgetrokken van een volgende tijdstempel:
subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')
En retourneert het resultaat 2018-01-01T00:00:00.000Z.
Voorbeeld 2
In dit voorbeeld wordt één dag afgetrokken van een tijdstempel met behulp van de D-indeling :
subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')
En retourneert het resultaat maandag, 1 januari 2018.
Voorbeeld 3
In dit voorbeeld wordt 1 uur afgetrokken van een tijdstempel in de landinstelling de-DE:
subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')
En retourneert het resultaat 15.03.18 12:00:00.
som
Retourneert het resultaat van het optellen van getallen in een lijst.
sum([<list of numbers>])
Parameter | Vereist | Type | Description |
---|---|---|---|
[<lijst met getallen>] | Ja | matrix van getallen | De getallen die moeten worden toegevoegd |
Retourwaarde | Type | Description |
---|---|---|
<result-sum> | Nummer | Het resultaat van het toevoegen van de opgegeven getallen |
Voorbeeld
In dit voorbeeld worden de opgegeven getallen toegevoegd:
sum(createArray(1, 1.5))
En retourneert het resultaat 2,5.
take
Items retourneren van de voorzijde van een verzameling.
take('<collection>', <count>)
take([<collection>], <count>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | tekenreeks of matrix | De verzameling waarvan u de gewenste items wilt |
<count> | Ja | geheel getal | Een positief geheel getal voor het gewenste aantal items vanaf de voorzijde |
Retourwaarde | Type | Description |
---|---|---|
<subset> of [<subset>] | Tekenreeks of matrix, respectievelijk | Een tekenreeks of matrix met het opgegeven aantal items dat afkomstig is van de voorzijde van de oorspronkelijke verzameling |
Voorbeeld
In deze voorbeelden ziet u het opgegeven aantal items aan de voorzijde van deze verzamelingen:
take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)
En retourneert respectievelijk de volgende resultaten:
- ABC
- [0, 1, 2]
Teken
Retourneert de waarde van de maatstreepjeseigenschap van een opgegeven tijdstempel. Een maatstreepje is een interval van 100 nanoseconden.
ticks('<timestamp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks voor een tijdstempel |
Retourwaarde | Type | Description |
---|---|---|
<maatstreepjes-getal> | geheel getal (bigint in JavaScript) | Het aantal tikken sinds de opgegeven tijdstempel |
Voorbeeld
In dit voorbeeld wordt een tijdstempel geconverteerd naar de tekeneigenschap:
ticks('2018-01-01T08:00:00.000Z')
En retourneert het resultaat 636503904000000000.
ticksToDays
Converteer een maatstreepje eigenschapswaarde naar het aantal dagen.
ticksToDays('ticks')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Teken> | Ja | geheel getal | De waarde van de ticks-eigenschap die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<aantal dagen> | Nummer | Het aantal dagen dat is geconverteerd op basis van de waarde van de maatstreepjeseigenschap |
Voorbeeld
In dit voorbeeld wordt de waarde van een maatstreepje-eigenschap geconverteerd naar een aantal dagen:
ticksToDays(2193385800000000)
En retourneert het getal 2538,64097222.
ticksToHours
Converteer een tekeneigenschapswaarde naar het aantal uren.
ticksToHours('ticks')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Teken> | Ja | Geheel getal | De waarde van de ticks-eigenschap die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<aantal uren> | Nummer | Het aantal uren dat is geconverteerd op basis van de waarde van de maatstreepjeseigenschap |
Voorbeeld
In dit voorbeeld wordt de eigenschapswaarde ticks geconverteerd naar een aantal uren:
ticksToHours(2193385800000000)
En retourneert het getal 60927,3833333331.
ticksToMinutes
Converteer een tekeneigenschapswaarde naar het aantal minuten.
ticksToMinutes('ticks')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Teken> | Ja | geheel getal | De waarde van de ticks-eigenschap die moet worden geconverteerd |
Retourwaarde | Type | Description |
---|---|---|
<aantal minuten> | Nummer | Het aantal minuten dat is geconverteerd van de waarde van de ticks-eigenschap |
Voorbeeld
In dit voorbeeld wordt de eigenschapswaarde ticks geconverteerd naar een aantal minuten:
ticksToMinutes(2193385800000000)
En retourneert het getal 3655643,0185.
titleCase
Gebruik de eerste letter van elk woord in een tekenreeks in een optionele lokale notatie.
titleCase('<text>', '<locale>'?)
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De oorspronkelijke tekenreeks |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
resultaattekenreeks | tekenreeks | Het resultaat van de titelcase |
Voorbeeld 1
In deze voorbeelden wordt de eerste letter van elk woord in een tekenreeks met hoofdletters geschreven:
titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')
En retourneert respectievelijk de volgende resultaten:
- A
- Abc Def
- Abc Def
Voorbeeld 2
In deze voorbeelden wordt de eerste letter in een tekenreeks in de en-US-indeling als hoofdletter gebruikt:
titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')
En retourneert respectievelijk de volgende resultaten:
- A
- Abc Def
toLower
Retourneert een tekenreeks in kleine letters in een optionele landinstellingsindeling. Als een teken in de tekenreeks geen kleine letterversie heeft, blijft dat teken ongewijzigd in de geretourneerde tekenreeks.
toLower('<text>', '<locale>'?)
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks die moet worden geretourneerd in kleine letters |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<kleine letters> | tekenreeks | De oorspronkelijke tekenreeks in kleine letters |
Voorbeeld 1
In dit voorbeeld wordt een tekenreeks geconverteerd naar kleine letters:
toLower('Hello World')
En retourneert de resultaat hallo wereld.
Voorbeeld 2
In dit voorbeeld wordt een tekenreeks geconverteerd naar kleine letters in de fr-FR-indeling :
toUpper('Hello World', 'fr-FR')
En retourneert de resultaat hallo wereld.
toUpper
Retourneert een tekenreeks in hoofdletters in een optionele landinstellingsindeling. Als een teken in de tekenreeks geen hoofdletterversie heeft, blijft dat teken ongewijzigd in de geretourneerde tekenreeks.
toUpper('<text>', '<locale>'?)
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks die moet worden geretourneerd in hoofdletters |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<hoofdletters/tekst> | tekenreeks | De oorspronkelijke tekenreeks in hoofdletters |
Voorbeeld 1
In dit voorbeeld wordt een tekenreeks geconverteerd naar hoofdletters:
toUpper('Hello World')
En retourneert het resultaat HELLO WORLD.
Voorbeeld 2
In dit voorbeeld wordt een tekenreeks geconverteerd naar hoofdletters in de fr-FR-indeling :
toUpper('Hello World', 'fr-FR')
En retourneert het resultaat HELLO WORLD.
trim
Verwijder voorloop- en volgspaties uit een tekenreeks en retourneer de bijgewerkte tekenreeks.
trim('<text>')
Parameter | Vereist | Type | Beschrijving |
---|---|---|---|
<tekst> | Ja | tekenreeks | De tekenreeks met de voorloop- en volgspaties die u wilt verwijderen |
Retourwaarde | Type | Description |
---|---|---|
<updatedText> | tekenreeks | Een bijgewerkte versie voor de oorspronkelijke tekenreeks zonder voorloop- of volgspaties |
Voorbeeld
In dit voorbeeld wordt de voorloop- en volgspaties verwijderd uit de tekenreeks " Hallo wereld ":
trim(' Hello World ')
En retourneert het bijgesneden resultaat Hallo wereld.
union
Hiermee wordt een verzameling geretourneerd die alle items uit de opgegeven verzamelingen bevat. Als u het resultaat wilt weergeven, kan een item worden weergegeven in elke verzameling die aan deze functie is doorgegeven. Als een of meer items dezelfde naam hebben, wordt het laatste item met die naam weergegeven in het resultaat.
union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parameter | Vereist | Type | Description |
---|---|---|---|
<collection1>, <collection2>, ... | Ja | matrix of object, maar niet beide | De verzamelingen van waaruit u alle items wilt |
Retourwaarde | Type | Description |
---|---|---|
<updatedCollection> | matrix of object, respectievelijk | Een verzameling met alle items uit de opgegeven verzamelingen. Er zijn geen duplicaten toegevoegd. |
Voorbeeld
In dit voorbeeld worden alle items uit de volgende verzamelingen opgehaald:
union(createArray(1, 2, 3), createArray(1, 2, 10, 101))
En retourneert het resultaat [1, 2, 3, 10, 101].
uniek
Verwijder alle duplicaten uit een matrix.
unique([<collection>])
Parameter | Vereist | Type | Description |
---|---|---|---|
<collectie> | Ja | matrix | De verzameling die moet worden gewijzigd |
Retourwaarde | Type | Description |
---|---|---|
<nieuwe verzameling> | matrix | Nieuwe verzameling met dubbele elementen verwijderd |
Voorbeeld 1
In dit voorbeeld worden dubbele elementen uit de volgende matrix verwijderd:
unique(createArray(1, 2, 1))
En retourneert het resultaat [1, 2].
uriComponent
Retourneert de binaire versie van een URI-onderdeel (Uniform Resource Identifier).
uriComponent('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks die moet worden geconverteerd naar een URI-gecodeerde indeling |
Retourwaarde | Type | Description |
---|---|---|
<gecodeerde-URI> | tekenreeks | De tekenreeks met URI-codering met escapetekens |
Voorbeeld
In dit voorbeeld wordt een URI-gecodeerde versie van een tekenreeks gemaakt:
uriComponent('https://contoso.com')
En retourneert het resultaat http%3A%2F%2Fcontoso.com.
uriComponentToString
Retourneert de tekenreeksversie van een URI-gecodeerde tekenreeks (Uniform Resource Identifier), waardoor de URI-gecodeerde tekenreeks effectief wordt gedecodeerd.
uriComponentToString('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks met URI-codering om te decoderen |
Retourwaarde | Type | Description |
---|---|---|
<binary-for-encoded-uri> | tekenreeks | De gedecodeerde versie voor de URI-gecodeerde tekenreeks |
Voorbeeld
In dit voorbeeld wordt de gedecodeerde tekenreeksversie van een URI-gecodeerde tekenreeks gemaakt:
uriComponentToString('http%3A%2F%2Fcontoso.com')
En retourneert het resultaat https://contoso.com
.
uriHost
Retourneert de hostwaarde van een geïntegreerde resource-id (URI).
uriHost('<uri>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Uri> | Ja | tekenreeks | De URI waarvan u de hostwaarde wilt |
Retourwaarde | Type | Description |
---|---|---|
<hostwaarde> | tekenreeks | De hostwaarde van de opgegeven URI |
Voorbeeld
In dit voorbeeld wordt de hostwaarde van de volgende URI gevonden:
uriHost('https://www.localhost.com:8080')
En retourneert het resultaat www.localhost.com
.
URIPath
Retourneert de padwaarde van een geïntegreerde resource-id (URI).
uriPath('<uri>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Uri> | Ja | tekenreeks | De URI waarvan u de padwaarde wilt bepalen |
Retourwaarde | Type | Description |
---|---|---|
<padwaarde> | tekenreeks | De padwaarde van de opgegeven URI |
Voorbeeld
In dit voorbeeld wordt de padwaarde van de volgende URI gevonden:
uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')
En retourneert het resultaat /catalog/shownew.htm.
uriPathAndQuery
Retourneert het pad en de querywaarde van een geïntegreerde resource-id (URI).
uriPathAndQuery('<uri>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Uri> | Ja | tekenreeks | De URI waarvan u het pad en de querywaarde wilt bepalen |
Retourwaarde | Type | Description |
---|---|---|
<path-query-value> | tekenreeks | Het pad en de querywaarde van de opgegeven URI |
Voorbeeld
In dit voorbeeld wordt het pad en de querywaarde van de volgende URI gevonden:
uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')
En retourneert het resultaat /catalog/shownew.htm?date=today.
uriPort
Retourneert de poortwaarde van een geïntegreerde resource-id (URI).
uriPort('<uri>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Uri> | Ja | tekenreeks | De URI waarvan u de padwaarde wilt bepalen |
Retourwaarde | Type | Description |
---|---|---|
<poortwaarde> | tekenreeks | De poortwaarde van de opgegeven URI |
Voorbeeld
In dit voorbeeld wordt de poortwaarde van de volgende URI gevonden:
uriPort('http://www.localhost:8080')
En retourneert het resultaat 8080.
uriQuery
Retourneert de querywaarde van een geïntegreerde resource-id (URI).
uriQuery('<uri>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Uri> | Ja | tekenreeks | De URI waarvan u de querywaarde wilt bepalen |
Retourwaarde | Type | Description |
---|---|---|
<querywaarde> | tekenreeks | De querywaarde van de opgegeven URI |
Voorbeeld
In dit voorbeeld wordt de querywaarde van de volgende URI gevonden:
uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')
En retourneert het resultaat ?date=today.
uriScheme
Retourneert de schemawaarde van een geïntegreerde resource-id (URI).
uriScheme('<uri>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<Uri> | Ja | tekenreeks | De URI waarvan u de querywaarde wilt bepalen |
Retourwaarde | Type | Description |
---|---|---|
<scheme-value> | tekenreeks | De schemawaarde van de opgegeven URI |
Voorbeeld
In dit voorbeeld wordt de schemawaarde van de volgende URI gevonden:
uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')
En retourneert het resultaat http.
utcNow
Retourneert de huidige tijdstempel in een optionele landinstellingnotatie als een tekenreeks.
utcNow('<format>', '<locale>'?)
U kunt desgewenst een andere indeling opgeven met de <notatieparameter>.
Parameter | Vereist | Type | Description |
---|---|---|---|
<format> | Nee | tekenreeks | Een aangepast opmaakpatroon. De standaardindeling voor de tijdstempel is UTC ISO-indeling, JJJJ-MM-DDTHH:mm:ss.fffZ, die voldoet aan ISO 8601. |
<locale> | Nee | tekenreeks | Een optionele landinstelling van cultuurinformatie |
Retourwaarde | Type | Description |
---|---|---|
<current-timestamp> | tekenreeks | De huidige datum en tijd |
Voorbeeld 1
Stel dat de datum 15 april 2018 is om 13:00:00 uur. In dit voorbeeld wordt het tijdstempel opgehaald:
utcNow()
En retourneert het resultaat 2018-04-15T13:00:00.000Z.
Voorbeeld 2
Stel dat de datum 15 april 2018 is om 13:00:00 uur. In dit voorbeeld wordt de huidige tijdstempel opgehaald met behulp van de optionele D-indeling :
utcNow('D')
En retourneert het resultaat zondag 15 april 2018.
Voorbeeld 3
Stel dat de datum 15 april 2018 is om 13:00:00 uur. In dit voorbeeld wordt de huidige tijdstempel opgehaald met behulp van de landinstelling de-DE:
utcNow('', 'de-DE')
En retourneert het resultaat 15.04.18 13:00:00.
waar
Filter op elk element en retourneer de nieuwe verzameling gefilterde elementen die overeenkomen met een specifieke voorwaarde.
where([<collection/instance>], <iteratorName>, <function>)
Parameter | Vereist | Type | Description |
---|---|---|---|
<verzameling/exemplaar> | Ja | matrix | De verzameling met de items |
<iteratorName> | Ja | iteratornaam | Het sleutelitem |
<functie> | Ja | uitdrukking | Voorwaardefunctie die wordt gebruikt om items te filteren |
Retourwaarde | Type | Description |
---|---|---|
<new-collection/new-object> | matrix/object | De nieuwe verzameling die elk element is gefilterd met de functie |
Voorbeeld 1
In dit voorbeeld wordt een nieuwe verzameling gegenereerd:
where(createArray(0, 1, 2, 3), x, x > 1)
En retourneert het resultaat [2, 3].
Voorbeeld 2
Deze voorbeelden genereren een nieuwe verzameling:
where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')
En retourneer het resultaat ['name:jack', 'age:15']. De tweede expressie is een lambda-expressie, die beter leesbaar is.
xml
Retourneert de XML-versie van een tekenreeks die een JSON-object bevat.
xml('<value>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<value> | Ja | tekenreeks | De tekenreeks met het JSON-object dat moet worden geconverteerd. Het JSON-object mag slechts één hoofdeigenschap hebben. Dit kan geen matrix zijn. Gebruik \ dit als escapeteken voor het dubbele aanhalingsteken ("). |
Retourwaarde | Type | Description |
---|---|---|
<xml-version> | object | De gecodeerde XML voor de opgegeven tekenreeks of JSON-object |
Voorbeeld 1
In dit voorbeeld wordt de XML-versie voor een tekenreeks gemaakt, die een JSON-object bevat:
xml(json('{ \"name\": \"Sophia Owen\" }'))
En retourneert de xml van het resultaat:
<name>Sophia Owen</name>
Voorbeeld 2
Stel dat u een person
JSON-object hebt, zie hieronder:
{
"person": {
"name": "Sophia Owen",
"city": "Seattle"
}
}
In dit voorbeeld wordt een XML gemaakt van een tekenreeks die dit JSON-object bevat:
xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))
En retourneert de xml van het resultaat:
<person>
<name>Sophia Owen</name>
<city>Seattle</city>
<person
xPath
Controleer XML op knooppunten of waarden die overeenkomen met een XPath-expressie (XML Path Language) en retourneer de overeenkomende knooppunten of waarden. Een XPath-expressie (ook wel XPath genoemd) helpt u bij het navigeren in een XML-documentstructuur, zodat u knooppunten of rekenwaarden in de XML-inhoud kunt selecteren.
xPath('<xml>', '<xpath>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<xml> | Ja | willekeurige | De XML-tekenreeks om te zoeken naar knooppunten of waarden die overeenkomen met een XPath-expressiewaarde |
<xPath> | Ja | willekeurige | De XPath-expressie die wordt gebruikt om overeenkomende XML-knooppunten of -waarden te vinden |
Retourwaarde | Type | Description |
---|---|---|
<xml-node> | XML | Een XML-knooppunt wanneer slechts één knooppunt overeenkomt met de opgegeven XPath-expressie |
<value> | willekeurige | De waarde van een XML-knooppunt wanneer slechts één waarde overeenkomt met de opgegeven XPath-expressie |
<[<xml-node1>, <xml-node2>, ...] -or- [<waarde1>, <waarde2>, ...]> | matrix | Een matrix met XML-knooppunten of -waarden die overeenkomen met de opgegeven XPath-expressie |
Voorbeeld 1
In dit voorbeeld worden knooppunten gevonden die overeenkomen met het <name></name>
knooppunt in de opgegeven argumenten en wordt een matrix geretourneerd met deze knooppuntwaarden:
xPath(items, '/produce/item/name')
De argumenten bevatten de tekenreeks items , die deze XML bevat:
"<?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>"
Dit is de resulterende matrix met de knooppunten die overeenkomen <name></name>
:
[ <name>Gala</name>, <name>Honeycrisp</name> ]
Voorbeeld 2
In het volgende voorbeeld 1 vindt u in dit voorbeeld knooppunten die overeenkomen met het <count></count>
knooppunt en voegt u deze knooppuntwaarden toe met de functie sum():
xPath(xml(parameters('items')), 'sum(/produce/item/count)')
En retourneert het resultaat 30.
jaar
Retourneer het jaar van de opgegeven tijdstempel.
year('<timestamp>')
Parameter | Vereist | Type | Description |
---|---|---|---|
<tijdstempel> | Ja | tekenreeks | De tekenreeks die de tijdstempel bevat |
Retourwaarde | Type | Description |
---|---|---|
<jaar> | geheel getal | Het jaar in de opgegeven tijdstempel |
Voorbeeld
In dit voorbeeld wordt de tijdstempel voor het jaar geëvalueerd:
year('2018-03-15T00:00:00.000Z')
En het resultaat 2018 wordt geretourneerd.