字符串函数 string

了解如何在个性化编辑器中使用字符串函数。

驼峰式大小写 camelCase

camelCase函数将字符串中每个单词的第一个字母变为大写。

语法

{%= camelCase(string)%}

示例

以下函数会将用户档案的街道地址中的第一个单词变为大写。

{%= camelCase(profile.homeAddress.street) %}

字符代码位于 char-code-at

charCodeAt函数返回字符的ASCII值，如JavaScript中的charCodeAt函数。 它采用字符串和整数（定义字符的位置）作为输入参数，并返回相应的ASCII值。

语法

{%= charCodeAt(string,int) %}: int

示例

以下函数返回o的ASCII值，即111。

{%= charCodeAt("some", 1)%}

Concat concate

concat函数将两个字符串合并为一个。

语法

{%= concat(string,string) %}

示例

以下函数将用户档案城市和国家/地区组合在一个字符串中。

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

Contains contains

contains函数用于确定一个字符串是否包含指定的子字符串。

语法

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

示例

不包含 doesNotContain

doesNotContain函数用于确定一个字符串是否不包含指定的子字符串。

语法

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

示例

以下查询区分大小写确定人员的电子邮件地址是否不包含字符串“2010@gm”。

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

Does not end with doesNotEndWith

doesNotEndWith函数用于确定一个字符串是否不以指定的子字符串结尾。

语法

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

示例

以下查询区分大小写确定人员的电子邮件地址是否不以“.com”结尾。

doesNotEndWith(person.emailAddress,".com")

Does not start with doesNotStartWith

doesNotStartWith函数用于确定一个字符串是否不以指定的子字符串开头。

语法

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

示例

以下查询区分大小写确定人员的姓名是否不以“Joe”开头。

{%= doesNotStartWith(person.name,"Joe")%}

编码64 encode64

encode64函数用于对字符串进行编码，以保留个人信息(PI)（例如，如果包含在URL中）。

语法

{%= encode64(string) %}

结束于 endsWith

endsWith函数用于确定一个字符串是否以指定的子字符串结尾。

语法

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

示例

以下查询区分大小写确定人员的电子邮件地址是否以“.com”结尾。

{%= endsWith(person.emailAddress,".com") %}

等于 equals

equals函数用于确定一个字符串是否等于指定的字符串（区分大小写）。

语法

{%= equals(STRING_1, STRING_2) %}

示例

以下查询区分大小写确定人员姓名是否为“John”。

{%=equals(profile.person.name,"John") %}

Equals Ignore Case equalsIgnoreCase

equalsIgnoreCase函数用于确定一个字符串是否等于指定的字符串，不区分大小写。

语法

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

示例

以下查询在不区分大小写的情况下确定人员姓名是否为“John”。

{%= equalsIgnoreCase(profile.person.name,"John") %}

提取电子邮件域 extractEmailDomain

extractEmailDomain函数用于提取电子邮件地址的域。

语法

{%= extractEmailDomain(string) %}

示例

以下查询提取个人电子邮件地址的电子邮件域。

{%= extractEmailDomain(profile.personalEmail.address) %}

设置货币格式 format-currency

formatCurrency函数用于根据第二个参数中作为字符串传递的区域设置，将任意数字转换为相应的语言敏感货币表示形式。

语法

{%= formatCurrency(number/double,string) %}: string

示例

此查询返回56.00英镑

{%= formatCurrency(56L,"en_GB") %}

Get url host get-url-host

getUrlHost函数用于检索URL的主机名。

语法

{%= getUrlHost(string) %}: string

示例

{%= getUrlHost("https://www.myurl.com/contact") %}

返回“www.myurl.com”

Get url path get-url-path

getUrlPath函数用于检索URL的域名之后的路径。

语法

{%= getUrlPath(string) %}: string

示例

{%= getUrlPath("https://www.myurl.com/contact.html") %}

返回“/contact.html”

Get url protocol get-url-protocol

getUrlProtocol函数用于检索URL的协议。

语法

{%= getUrlProtocol(string) %}: string

示例

{%= getUrlProtocol("https://www.myurl.com/contact.html") %}

返回“http”

Index Of index-of

indexOf函数用于返回第二个参数在第一个参数中第一次出现的位置。 如果没有匹配项，则返回–1。

语法

{%= indexOf(STRING_1, STRING_2) %}: integer

示例

{%= indexOf("hello world","world" ) %}

返回6。

为空 isEmpty

isEmpty函数用于确定一个字符串是否为空。

语法

{%= isEmpty(string) %}

示例

如果个人资料的手机号码为空，则以下函数返回“true”。 否则，将返回“false”。

{%= isEmpty(profile.mobilePhone.number) %}

Is Not Empty is-not-empty

isNotEmpty函数用于确定一个字符串是否不为空。

语法

{= isNotEmpty(string) %}: boolean

示例

如果个人资料的手机号码不为空，则以下函数返回“true”。 否则，将返回“false”。

{%= isNotEmpty(profile.mobilePhone.number) %}

Last Index Of last-index-of

lastIndexOf函数用于返回第二个参数在第一个参数中最后一次出现的位置。 如果没有匹配项，则返回–1。

语法

{= lastIndexOf(STRING_1, STRING_2) %}: integer

示例

{%= lastIndexOf("hello world","o" ) %}

返回7。

Left trim leftTrim

leftTrim函数用于从字符串的开头删除空格。

语法

{%= leftTrim(string) %}

Length length

length函数用于获取字符串或表达式中的字符数。

语法

{%= length(string) %}

示例

以下函数返回用户档案的城市名称的长度。

{%= length(profile.homeAddress.city) %}

喜欢 like

like函数用于确定一个字符串是否与指定的模式匹配。

语法

{%= like(STRING_1, STRING_2) %}

示例

以下查询检索用户档案所在的所有城市，其中包含“es”模式。

{%= like(profile.homeAddress.city, "%es%")%}

小写 lower

lowerCase函数将字符串转换为小写字母。

语法

{%= lowerCase(string) %}

示例

此函数将用户档案的名字转换为小写字母。

{%= lowerCase(profile.person.name.firstName) %}

Matches matches

matches函数用于确定一个字符串是否与特定的正则表达式匹配。 有关正则表达式中匹配模式的详细信息，请参阅本文档。

语法

{%= matches(STRING_1, STRING_2) %}

示例

以下查询在不区分大小写的情况下确定人员的姓名是否以“John”开头。

{%= matches(person.name.,"(?i)^John") %}

掩码 mask

Mask函数用于将字符串的一部分替换为“X”字符。

语法

{%= mask(string,integer,integer) %}

示例

以下查询将“123456789”字符串替换为“X”字符，但前两个字符和后两个字符除外。

{%= mask("123456789",1,2) %}

查询返回1XXXXXX89。

MD5 md5

md5函数用于计算并返回字符串的md5哈希。

语法

{%= md5(string) %}: string

示例

{%= md5("hello world") %}

返回“5eb63bbe01eeed093cb22bb8f5acdc3”

不等于 notEqualTo

notEqualTo函数用于确定一个字符串是否不等于指定的字符串。

语法

{%= notEqualTo(STRING_1, STRING_2) %}

示例

以下查询区分大小写确定人员姓名是否为“John”。

{%= notEqualTo(profile.person.name,"John") %}

Not Equal With Ignore Case not-equal-with-ignore-case

notEqualWithIgnoreCase函数用于比较两个字符串（忽略大小写）。

语法

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

示例

以下查询确定人员姓名是否为“john”，不区分大小写。

{%= notEqualTo(profile.person.name,"john") %}

正则表达式组 regexGroup

Group函数用于根据提供的正则表达式提取特定信息。

语法

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

示例

以下查询用于从电子邮件地址中提取域名。

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

更换 replace

replace函数用于将字符串中的给定子字符串替换为另一个子字符串。

语法

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

示例

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

返回“Hello Mark，这是您每月的新闻稿！”

Replace All replaceAll

replaceAll函数用于将匹配“regex”表达式的文本的所有子字符串替换为指定的文本“replacement”字符串。 正则表达式对“\”和“+”具有特殊处理，并且所有正则表达式都遵循PQL转义策略。 例如，替换操作从字符串的开头到结尾进行，将字符串“aaa”中的“aa”替换为“b”将导致“ba”而不是“ab”。

语法

{%= replaceAll(string,string,string) %}

Right trim rightTrim

rightTrim函数用于删除字符串末尾的空格。

语法

{%= rightTrim(string) %}

拆分 split

split函数用于按给定字符拆分字符串。

语法

{%= split(string,string) %}

开始于 startsWith

startsWith函数用于确定一个字符串是否以指定的子字符串开头。

语法

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

示例

以下查询区分大小写确定人员的姓名是否以“Joe”开头。

{%= startsWith(person.name,"Joe") %}

String to date string-to-date

stringToDate函数将一个字符串值转换为日期时间值。 它采用两个参数：日期时间的字符串表示和格式化器的字符串表示。

语法

{= stringToDate("date-time value","formatter" %}

示例

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

String to integer string-to-integer

string_to_integer函数用于将字符串值转换为整数值。

语法

{= string_to_integer(string) %}: int

String to number string-to-number

stringToNumber函数用于将字符串转换为数字。 对于无效的输入，它返回相同的字符串作为输出。

语法

{%= stringToNumber(string) %}: double

Sub string sub-string

Count string函数用于返回字符串表达式在开始索引和结束索引之间的子字符串。
语法

{= substr(string, integer, integer) %}: string

字首大写 titleCase

titleCase ​函数用于将字符串中每个单词的首字母大写。

语法

{%= titleCase(string) %}

示例

如果该人住在华盛顿高街，则此函数将返回华盛顿高街。

{%= titleCase(profile.person.location.Street) %}

To Bool to-bool

toBool函数用于将参数值转换为布尔值，具体取决于其类型。

语法

{= toBool(string) %}: boolean

To Date Time to-date-time

toDateTime函数用于将字符串转换为日期。 对于无效的输入，它返回纪元日期作为输出。

语法

{%= toDateTime(string, string) %}: date-time

To Date Time Only to-date-time-only

toDateTimeOnly函数用于将参数值转换为仅日期时间值。 对于无效的输入，它返回纪元日期作为输出。 此函数接受字符串、日期、长整型和int字段类型。

语法

{%= toDateTimeOnly(string/date/long/int) %}: date-time

Trim trim

trim ​函数删除字符串开始和结束位置的所有空格。

语法

{%= trim(string) %}

大写 upper

upperCase ​函数将字符串转换为大写字母。

语法

{%= upperCase(string) %}

示例

此函数将用户档案的姓氏转换为大写字母。

{%= upperCase(profile.person.name.lastName) %}

Url decode url-decode

urlDecode函数用于解码url编码的字符串。

语法

{%= urlDecode(string) %}: string

Url encode url-encode

Count only null函数用于对字符串进行url编码。

语法

{%= urlEncode(string) %}: string