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:
- Zet koordwaarden in numeriek, booleaanse, of datumtypes ( toInteger , toDecimal , toBool ) om
- Transformeer data en tijden tussen verschillende formaten en vertegenwoordiging ( toDateTime , toDateTimeOnly , toDateOnly )
- Gegoten numerieke waarden tussen geheel en decimale types ( toInteger , toDecimal )
- Zet waarden in koordformaat ( toString ) of duur ( toDuration ) om
- Zorg voor typecompatibiliteit voor vergelijkingen en bewerkingen
- Gegevens verwerken uit externe bronnen met verschillende typen opmaak
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
toBool(<parameter>)- decimaal
- boolean
- string
- integer
toBool(<decimal>)
toBool(<boolean>)
toBool(<string>)
toBool(<integer>)
Retourneer een booleaanse waarde.
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 .
toDateOnly(<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 |
toDateOnly(<dateTime>)
toDateOnly(<dateTimeOnly>)
toDateOnly(<string>)
toDateOnly(<integer>, <integer>, <integer>)
Retourneert een waarde van het type dateOnly.
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.
toDateTime(<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 |
toDateTime(<string>)
toDateTime(<stringified time zone id>, <dateTimeOnly>)
toDateTime(<integer>)
Keer a dateTime terug.
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
toDateTimeOnly toDateTimeOnly
Zet een argumentwaarde in een waarde van de datumtijd slechts om.
toDateTimeOnly(<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 |
toDateTimeOnly(<dateTime>)
toDateTimeOnly(<string>)
Retourneer een datetime zonder rekening te houden met tijdzone.
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.
toDecimal(<parameter>)| 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) |
toDecimal(<integer>)
toDecimal(<decimal>)
toDecimal(<string>)
toDecimal(<boolean>)
Retourneer een decimaal.
toDecimal("4.0")
Retourneert 4.0.
toDuration toDuration
Zet een argumentwaarde in een duur om. Voor meer informatie over gegevenstypes, verwijs naar deze pagina .
toDuration(<parameter>)| 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.
toDuration(<string>)
toDuration(<integer>)
Retourneert een duur.
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.
toInteger(<parameter>)| 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) |
toInteger(<dateTime>)
toInteger(<decimal>)
toInteger(<integer>)
toInteger(<string>)
toInteger(<boolean>)
Retourneer een geheel getal.
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 .
toString(<parameter>)| 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) |
toString(<dateTimeOnly>)
toString(<dateTime>)
toString(<duration>)
toString(<boolean>)
toString(<integer>)
toString(<decimal>)
Retourneer een tekenreeks.
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".