Conversiefuncties conversion-functions

Met conversiefuncties kunt u gegevens van het ene naar het andere type transformeren binnen de expressies. Deze functies zijn essentieel voor het waarborgen van gegevenscompatibiliteit en een juiste manier van omgaan wanneer u met verschillende gegevensbronnen en -bewerkingen werkt.

Gebruik conversiefuncties wanneer dat nodig is:

Elke omzettingsfunctie behandelt type-specifieke regels en randgevallen automatisch, die gegevenstransformatie betrouwbaarder en voorspelbaarder in uw reisuitdrukkingen maken.

toBool toBool

Zet een argumentwaarde in een booleaanse waarde om, afhankelijk van het type.

  • Van tekenreeks: probeer de tekenreekswaarde om te zetten als een booleaanse waarde, van "true" als de tekenreekswaarde "true" is, anders false
  • Uit numeriek: true wanneer de numerieke waarde niet gelijk is aan 0, anders false
Syntaxis
toBool(<parameter>)
Parameters
  • decimaal
  • boolean
  • string
  • integer
Handtekeningen en geretourneerde typen

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Retourneer een booleaanse waarde.

Voorbeelden

toBool("true")

toBool(1)

Retourneert true.

toBool("this is not a boolean")

Retourneert false.

toDateOnly toDateOnly

Zet een argument in een dateOnly typewaarde om. Meer over gegevenstypes leren, verwijs naar deze ​ sectie ​.

Syntaxis
toDateOnly(<parameters>)
Parameters
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parameter Type
Tekenreeksrepresentatie van een datum als "YYYY-MM-DD" (XDM-indeling). Ook steunt formaat ISO-8601: slechts volledig-datum deel wordt overwogen (verwijs naar ​ RFC 3339, sectie 5.6 ​ string
datumtijd dateTime
datumtijd zonder tijdzone dateTimeOnly
geheel-getalwaarde van een tijdperk in milliseconden integer
Handtekeningen en geretourneerde typen

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

toDateOnly(<integer>, <integer>, <integer>)

Retourneert een waarde van het type dateOnly.

Voorbeelden

toDateOnly("2023-08-18")

toDateOnly("2023-08-18T00:00:00.000Z")

toDateOnly("2023-08-18T00:00:00")

retourneren alle objecten dateOnly die 2023-08-18 vertegenwoordigen.

toDateOnly(#{ExperiencePlatform.ProfileFieldGroup.person.birthDate})

Retourneert alleen date.

toDateTime toDateTime

Zet parameters om in een datumtijdwaarde, afhankelijk van hun types.

Syntaxis
toDateTime(<parameters>)
Parameters
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parameter Type
datumtijd in ISO-8601-indeling string
tijdzone-id string
datumtijd zonder tijdzone dateTimeOnly
geheel-getalwaarde van een tijdperk in milliseconden integer
Handtekeningen en geretourneerde typen

toDateTime(<string>)

toDateTime(<stringified time zone id>, <dateTimeOnly>)

toDateTime(<integer>)

Keer a dateTime terug.

Voorbeelden

toDateTime ("2023-08-18T23:17:59.123Z")

Keert 2023-08-18T23 :17: 59.123Z terug

toDateTime(toDateTimeOnly("UTC", "2023-08-18T23:17:59.123"))

Keert 2023-08-18T23 :17: 59.123Z terug

toDateTime(1560762190189)

Keert 2023-06-17T09 :03: 10.189Z terug

NOTE
Tijdzone-id moet een tekenreeksconstante zijn. Het kan geen veldverwijzing of expressie zijn. Voor meer informatie over gegevenstypes, verwijs naar ​ deze pagina ​.

toDateTimeOnly toDateTimeOnly

Zet een argumentwaarde in een waarde van de datumtijd slechts om.

Syntaxis
toDateTimeOnly(<parameters>)
Parameters
table 0-row-2 1-row-2 2-row-2
Parameter Type
datumtijd in de notatie ISO-8601 of "JJJ-MM-DD" (XDM-datumnotatie) string
datumtijd dateTime
Handtekeningen en geretourneerde typen

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Retourneer een datetime zonder rekening te houden met tijdzone.

Voorbeelden

toDateTimeOnly ("2023-08-18")

keert dateTime terug die 2023-08-18T00 :00: 00.000 vertegenwoordigt

toDateTimeOnly(now())

toDecimal toDecimal

Zet een argumentwaarde in een decimale waarde om, afhankelijk van het type.

Syntaxis
toDecimal(<parameter>)
Parameters
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parameter Beschrijving
string converteert de tekenreekswaarde als een decimaal
dateTime zet de datum om als aantal milliseconden (epoch milliseconds)
boolean Zet de booleaanse waarde om als 1 indien waar (true), 0 indien onwaar (false)
integer wordt omgezet in decimaal (voorbeeld.: 1 wordt 1,0)
Handtekeningen en geretourneerde typen

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Retourneer een decimaal.

Voorbeelden

toDecimal("4.0")

Retourneert 4.0.

toDuration toDuration

Zet een argumentwaarde in een duur om. Voor meer informatie over gegevenstypes, verwijs naar ​ deze pagina ​.

Syntaxis
toDuration(<parameter>)
Parameters
table 0-row-2 1-row-2 2-row-2
Parameter Beschrijving
string formaten die gebaseerd zijn op de ISO-8601-duurnotatie PnDTnHnMn.nS met dagen waarvan wordt aangenomen dat ze precies 24 uur zijn
integer aantal milliseconden

Als tekenreeksexpressie: geaccepteerde notaties zijn gebaseerd op de ISO-8601-duurnotatie PnDTnHnMn.nS met dagen die worden beschouwd als precies 24 uur.

De tekenreeks begint met een optioneel teken, aangeduid met het negatieve of positieve ASCII-symbool. Indien negatief, wordt de hele periode genegeerd. De ASCII-letter "P" staat vervolgens in hoofdletters of kleine letters. Er zijn dan vier secties, elk bestaande uit een getal en een achtervoegsel. De secties hebben achtervoegsels in ASCII van "D", "H", "M" en "S" gedurende dagen, uren, minuten en seconden, die in hoofdletters of in kleine letters worden geaccepteerd. De achtervoegsels moeten op volgorde voorkomen. De ASCII-letter "T" moet vóór het eerste exemplaar van een uur-, minuut- of tweede sectie plaatsvinden, indien aanwezig. Ten minste één van de vier delen moet aanwezig zijn en indien "T" aanwezig is, moet er ten minste één deel na "T" aanwezig zijn. Het nummerdeel van elke sectie moet uit een of meer ASCII-cijfers bestaan. Het getal kan worden voorafgegaan door het negatieve of positieve ASCII-symbool. Het aantal dagen, uren en minuten moet worden geparseerd. Het aantal seconden moet samen met de optionele breuk parseren. Het decimale punt kan een punt of een komma zijn. Het fractionele deel kan van nul tot 9 cijfers hebben.

Handtekeningen en type geretourneerd

toDuration(<string>)

toDuration(<integer>)

Retourneert een duur.

Voorbeelden

toDuration("PT10H")

Geeft een duur van 10 uur.

toDuration("PT4S")

Retourneert de duur van 4s.

toDuration(4000)

Retourneert de duur van 4s.

toInteger toInteger

Zet een argumentwaarde in een geheel getal om.

Syntaxis
toInteger(<parameter>)
Parameters
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parameter Beschrijving
string converteert de tekenreekswaarde als een geheel getal
dateTime zet de datum om als aantal milliseconden (epoch milliseconds)
decimaal converteert naar geheel getal door het decimale gedeelte te verwijderen (1,5 wordt bijvoorbeeld 1).
boolean Zet de booleaanse waarde om als 1 indien waar (true), 0 indien onwaar (false)
Handtekeningen en type geretourneerd

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Retourneer een geheel getal.

Voorbeelden

toInteger("4")

Retourneert 4.

toString toString

Zet een argumentwaarde in een koordwaarde om, afhankelijk van zijn type. Voor meer informatie over gegevenstypes, verwijs naar ​ deze pagina ​.

Syntaxis
toString(<parameter>)
Parameters
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Parameter Beschrijving
dateTime converteert de datum in UTC-datumnotatie
dateTimeOnly converteert de datum in UTC-datumnotatie
duur converteren naar het overeenkomstige aantal milliseconden als een tekenreeks
integer converteert naar tekenreeksrepresentatie van de waarde (1 wordt "1")
decimaal converteert naar tekenreeksrepresentatie van de waarde (1,5 wordt "1,5")
boolean Zet de booleaanse waarde om als 'true' (waar), 'false' (onwaar)
Handtekeningen en type geretourneerd

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Retourneer een tekenreeks.

Voorbeelden

toString(4)

Retourneert "4".

toString(#{ExperiencePlatform.test_date.person.birthDate}))

Retourneert de tekenreeksrepresentatie van het opgegeven veld dateOnly (XDM Date-veld), bijvoorbeeld "2023-08-18".

toString(toDuration(1520))

Retourneert "PT1.52S".

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76