Funciones de cadena string
Aprenda a utilizar las funciones de cadena en el editor de personalización.
Camel Case camelCase
La función camelCase pone en mayúscula la primera letra de cada palabra de una cadena.
Sintaxis
{%= camelCase(string)%}
Ejemplo
La siguiente función pone en mayúscula la primera letra de la dirección del perfil.
{%= camelCase(profile.homeAddress.street) %}
Código Char en char-code-at
La función charCodeAt devuelve el valor ASCII de un carácter, como la función charCodeAt de JavaScript. Toma una cadena y un entero (que define la posición del carácter) como argumentos de entrada y devuelve su valor ASCII correspondiente.
Sintaxis
{%= charCodeAt(string,int) %}: int
Ejemplo
La siguiente función devuelve el valor ASCII o, es decir 111.
{%= charCodeAt("some", 1)%}
Concat concate
La función concat combina dos cadenas en una.
Sintaxis
{%= concat(string,string) %}
Ejemplo
La siguiente función combinará ciudad y país de perfil en una sola cadena.
{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}
Contiene contains
La función contains se usa para determinar si una cadena contiene una subcadena especificada.
Sintaxis
{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
STRING_1STRING_2CASE_SENSITIVEEjemplos
-
La siguiente función comprobará si el nombre del perfil contiene la letra A (en mayúsculas o minúsculas). Si este es el caso, devuelve "true"; de lo contrario, devuelve "false".
code language-sql {%= contains(profile.person.name.firstName, "A", false) %} -
La siguiente consulta determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona contiene la cadena "2010@gm".
code language-sql {%= contains(profile.person.emailAddress,"2010@gm") %}
No contiene doesNotContain
La función doesNotContain se usa para determinar si una cadena no contiene una subcadena especificada.
Sintaxis
{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
STRING_1STRING_2CASE_SENSITIVEEjemplo
La siguiente consulta determina, con distinción de mayúsculas y minúsculas, si la dirección de correo electrónico de la persona no contiene la cadena "2010@gm".
{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}
No termina por doesNotEndWith
La función doesNotEndWith se usa para determinar si una cadena no termina con una subcadena especificada.
Sintaxis
{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Ejemplo
La siguiente consulta determina, con distinción entre mayúsculas y minúsculas, si la dirección de correo electrónico de la persona no termina con ".com".
doesNotEndWith(person.emailAddress,".com")
No empieza por doesNotStartWith
La función doesNotStartWith se usa para determinar si una cadena no comienza con una subcadena especificada.
Sintaxis
{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Ejemplo
La siguiente consulta determina, con distinción entre mayúsculas y minúsculas, si el nombre de la persona no comienza con "Joe".
{%= doesNotStartWith(person.name,"Joe")%}
Codificar 64 encode64
La función encode64 se usa para codificar una cadena para conservar la información personal (PI) si se va a incluir, por ejemplo, en una dirección URL.
Sintaxis
{%= encode64(string) %}
Termina por endsWith
La función endsWith se usa para determinar si una cadena termina con una subcadena especificada.
Sintaxis
{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Ejemplo
La siguiente consulta determina, con distinción entre mayúsculas y minúsculas, si la dirección de correo electrónico de la persona termina con ".com".
{%= endsWith(person.emailAddress,".com") %}
Es igual a equals
La función equals se usa para determinar si una cadena es igual a la cadena especificada, con distinción entre mayúsculas y minúsculas.
Sintaxis
{%= equals(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Ejemplo
La siguiente consulta determina, con distinción entre mayúsculas y minúsculas, si el nombre de la persona es "John".
{%=equals(profile.person.name,"John") %}
Ignorar mayúsculas y minúsculas equalsIgnoreCase
La función equalsIgnoreCase se usa para determinar si una cadena es igual a la cadena especificada, sin distinción de mayúsculas y minúsculas.
Sintaxis
{%= equalsIgnoreCase(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Ejemplo
La siguiente consulta determina, sin distinción entre mayúsculas y minúsculas, si el nombre de la persona es "John".
{%= equalsIgnoreCase(profile.person.name,"John") %}
Extraer dominio de correo electrónico extractEmailDomain
La función extractEmailDomain se usa para extraer el dominio de una dirección de correo electrónico.
Sintaxis
{%= extractEmailDomain(string) %}
Ejemplo
La siguiente consulta extrae el dominio de correo electrónico de la dirección de correo electrónico personal.
{%= extractEmailDomain(profile.personalEmail.address) %}
Formato de moneda format-currency
La función formatCurrency se usa para convertir cualquier número en su correspondiente representación de moneda con distinción de idioma, en función de la configuración regional pasada como cadena en el segundo argumento.
Sintaxis
{%= formatCurrency(number/double,string) %}: string
Ejemplo
Esta consulta devuelve 56 £
{%= formatCurrency(56L,"en_GB") %}
Obtener host de URL get-url-host
La función getUrlHost se usa para recuperar el nombre de host de una dirección URL.
Sintaxis
{%= getUrlHost(string) %}: string
Ejemplo
{%= getUrlHost("https://www.myurl.com/contact") %}
Devuelve "www.myurl.com"
Obtener ruta de URL get-url-path
La función getUrlPath se usa para recuperar la ruta de acceso después del nombre de dominio de una dirección URL.
Sintaxis
{%= getUrlPath(string) %}: string
Ejemplo
{%= getUrlPath("https://www.myurl.com/contact.html") %}
Devuelve "/contact.html"
Obtener protocolo de URL get-url-protocol
La función getUrlProtocol se usa para recuperar el protocolo de una dirección URL.
Sintaxis
{%= getUrlProtocol(string) %}: string
Ejemplo
{%= getUrlProtocol("https://www.myurl.com/contact.html") %}
Devuelve "http"
Índice De index-of
La función indexOf se usa para devolver la posición (en el primer argumento) de la primera aparición del segundo parámetro. Devuelve -1 si no hay ninguna coincidencia.
Sintaxis
{%= indexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Ejemplo
{%= indexOf("hello world","world" ) %}
Devuelve 6.
Está vacío isEmpty
La función isEmpty se usa para determinar si una cadena está vacía.
Sintaxis
{%= isEmpty(string) %}
Ejemplo
La siguiente función devuelve "true" si el número de teléfono móvil del perfil está vacío. De lo contrario, devolverá "false".
{%= isEmpty(profile.mobilePhone.number) %}
Is Not Empty is-not-empty
La función isNotEmpty se usa para determinar si una cadena no está vacía.
Sintaxis
{= isNotEmpty(string) %}: boolean
Ejemplo
La siguiente función devuelve "true" si el número de teléfono móvil del perfil no está vacío. De lo contrario, devolverá "false".
{%= isNotEmpty(profile.mobilePhone.number) %}
Último Índice De last-index-of
La función lastIndexOf se usa para devolver la posición (en el primer argumento) de la última aparición del segundo parámetro. Devuelve -1 si no hay ninguna coincidencia.
Sintaxis
{= lastIndexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Ejemplo
{%= lastIndexOf("hello world","o" ) %}
Devuelve 7.
Guarnecido izquierdo leftTrim
La función leftTrim se usa para quitar espacios en blanco del principio de una cadena.
Sintaxis
{%= leftTrim(string) %}
Longitud length
La función length se usa para obtener el número de caracteres de una cadena o expresión.
Sintaxis
{%= length(string) %}
Ejemplo
La siguiente función devuelve la longitud del nombre de ciudad del perfil.
{%= length(profile.homeAddress.city) %}
Como like
La función like se usa para determinar si una cadena coincide con un patrón especificado.
Sintaxis
{%= like(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}La expresión que debe coincidir con la primera cadena. Existen dos caracteres especiales admitidos para crear una expresión: % y _.
%se usa para representar cero o más caracteres._se usa para representar exactamente un carácter.
Ejemplo
La siguiente consulta recupera todas las ciudades en las que residen los perfiles que contienen el patrón "es".
{%= like(profile.homeAddress.city, "%es%")%}
Minúsculas lower
La función lowerCase convierte una cadena en letras minúsculas.
Sintaxis
{%= lowerCase(string) %}
Ejemplo
Esta función convierte el nombre del perfil en letras minúsculas.
{%= lowerCase(profile.person.name.firstName) %}
Coincide matches
La función matches se usa para determinar si una cadena coincide con una expresión regular específica. Consulte este documento para obtener más información sobre los patrones coincidentes en las expresiones regulares.
Sintaxis
{%= matches(STRING_1, STRING_2) %}
Ejemplo
La siguiente consulta determina, sin distinción entre mayúsculas y minúsculas, si el nombre de la persona comienza por "John".
{%= matches(person.name.,"(?i)^John") %}
Máscara mask
La función Mask se usa para reemplazar una parte de una cadena con caracteres "X".
Sintaxis
{%= mask(string,integer,integer) %}
Ejemplo
La siguiente consulta reemplaza la cadena "123456789" por los caracteres "X", excepto para los dos primeros y los últimos caracteres.
{%= mask("123456789",1,2) %}
La consulta devuelve 1XXXXXX89.
MD5 md5
La función md5 se usa para calcular y devolver el hash md5 de una cadena.
Sintaxis
{%= md5(string) %}: string
Ejemplo
{%= md5("hello world") %}
Devuelve "5eb63bbbe01eeed093cb22bb8f5acdc3"
No igual a notEqualTo
La función notEqualTo se usa para determinar si una cadena no es igual a la cadena especificada.
Sintaxis
{%= notEqualTo(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Ejemplo
La siguiente consulta determina, con distinción entre mayúsculas y minúsculas, si el nombre de la persona no es "John".
{%= notEqualTo(profile.person.name,"John") %}
No Igual Con Ignorar Mayúsculas y Minúsculas not-equal-with-ignore-case
La función notEqualWithIgnoreCase se usa para comparar dos cadenas ignorando mayúsculas y minúsculas.
Sintaxis
{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
{STRING_1}{STRING_2}Ejemplo
La siguiente consulta determina si el nombre de la persona no es "john", sin distinción de mayúsculas y minúsculas.
{%= notEqualTo(profile.person.name,"john") %}
Grupo de expresiones regulares regexGroup
La función Group se usa para extraer información específica, basada en la expresión regular proporcionada.
Sintaxis
{%= regexGroup(STRING, EXPRESSION, GROUP) %}
{STRING}{EXPRESSION}{GROUP}Ejemplo
La siguiente consulta se utiliza para extraer el nombre de dominio de una dirección de correo electrónico.
{%= regexGroup(emailAddress,"@(\\w+)", 1) %}
Reemplazar replace
La función replace se usa para reemplazar una subcadena determinada de una cadena con otra subcadena.
Sintaxis
{%= replace(STRING_1,STRING_2,STRING_3) %}:string
{STRING_1}{STRING_2}{STRING_3}Ejemplo
{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}
Devuelve "Hola Mark, aquí tienes tu newsletter mensual".
Reemplazar todo replaceAll
La función replaceAll se usa para reemplazar todas las subcadenas de un texto que coincide con la expresión "regex" con la cadena "replace" literal especificada. Regex tiene un manejo especial de "" y "+" y todas las expresiones regex siguen la estrategia de escape de PQL. La sustitución se realiza desde el principio de la cadena hasta el final, por ejemplo, si se sustituye "a" por "b" en la cadena "aaa", el resultado será "ba" en lugar de "ab".
Sintaxis
{%= replaceAll(string,string,string) %}
//). Los caracteres regex especiales son: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]Guarnecido derecho rightTrim
La función rightTrim elimina los espacios en blanco del final de una cadena.
Sintaxis
{%= rightTrim(string) %}
SHA256 sha256
La función SHA256 calcula y devuelve el hash sha256 de una cadena.
Sintaxis
{%= sha256(string) %} : string
Ejemplo
{%= sha256("Eliechxh")%}
devuelve: 0b0b207880b999adaad6231026abf87caa30760b6f326b21727b61139332257d
División split
La función split se usa para dividir una cadena entre un carácter determinado.
Sintaxis
{%= split(string,string) %}
Comienza por startsWith
La función startsWith se usa para determinar si una cadena empieza con una subcadena especificada.
Sintaxis
{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Ejemplo
La siguiente consulta determina, con distinción entre mayúsculas y minúsculas, si el nombre de la persona empieza por "Joe".
{%= startsWith(person.name,"Joe") %}
Cadena a fecha string-to-date
La función stringToDate convierte un valor de cadena en un valor de fecha y hora. Se necesitan dos argumentos: la representación de cadena de una fecha y hora y la representación de cadena del formateador.
Sintaxis
{= stringToDate("date-time value","formatter" %}
Ejemplo
{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}
Cadena a entero string-to-integer
La función string_to_integer se usa para convertir un valor de cadena en un valor entero.
Sintaxis
{= string_to_integer(string) %}: int
Cadena a número string-to-number
La función stringToNumber se usa para convertir una cadena en número. Devuelve la misma cadena como salida para la entrada no válida.
Sintaxis
{%= stringToNumber(string) %}: double
Subcadena sub-string
La función Count string se usa para devolver la subcadena de la expresión de cadena entre el índice inicial y el índice final.
Sintaxis
{= substr(string, integer, integer) %}: string
Caso de título titleCase
La función titleCase se usa para poner en mayúsculas las primeras letras de cada palabra de una cadena.
Sintaxis
{%= titleCase(string) %}
Ejemplo
Si la persona vive en Washington High Street, esta función devolverá Washington High Street.
{%= titleCase(profile.person.location.Street) %}
A Bool to-bool
La función toBool se usa para convertir un valor de argumento en un valor booleano, según su tipo.
Sintaxis
{= toBool(string) %}: boolean
A Fecha Hora to-date-time
La función toDateTime se usa para convertir la cadena a fecha. Devuelve la fecha epoch como salida para una entrada no válida.
Sintaxis
{%= toDateTime(string, string) %}: date-time
A Fecha Hora Solamente to-date-time-only
La función toDateTimeOnly se usa para convertir un valor de argumento en un valor de solo fecha y hora. Devuelve la fecha epoch como salida para una entrada no válida. Esta función acepta tipos de campo string, date, long e int.
Sintaxis
{%= toDateTimeOnly(string/date/long/int) %}: date-time
Recortar trim
La función trim elimina todos los espacios en blanco del principio y del final de una cadena.
Sintaxis
{%= trim(string) %}
Mayúsculas upper
La función upperCase convierte una cadena en letras mayúsculas.
Sintaxis
{%= upperCase(string) %}
Ejemplo
Esta función convierte los apellidos del perfil en letras mayúsculas.
{%= upperCase(profile.person.name.lastName) %}
Descodificación de URL url-decode
La función urlDecode se usa para descodificar una cadena con codificación URL.
Sintaxis
{%= urlDecode(string) %}: string
Codificación de URL url-encode
La función Count only null se usa para codificar una cadena mediante URL.
Sintaxis
{%= urlEncode(string) %}: string