Funciones de cadena de flujo de trabajo
Una función de cadena realiza operaciones en datos de texto. Utiliza una función de cadena para limpiar datos, convertir datos a un formato diferente, cambiar mayúsculas y minúsculas, calcular métricas sobre los datos o realizar otras manipulaciones. Una función de cadena sólo se puede utilizar con tipos de datos de cadena.
Contains
Contains (String, Target, CaseInsensitive = 1): busca la ocurrencia de una cadena especifica dentro de una cadena. Devuelve verdadero si la cadena (String) contiene el objetivo (Target); si no, devuelve falso.
Ejemplo
Contains('123ABC', 'ABC') devuelve verdadero.
Contains('123ABC', 'abc') devuelve verdadero.
Contains('123ABC', 'abc', 0) devuelve falso.
CountWords
CountWords(string): devuelve un conteo de las palabras en una cadena especificada. Las palabras son definidas por caracteres separados por un espacio.
Nota
This function isn't available for Live Query for Databricks.
Ejemplo
CountWords("Basic Variables Households")devuelve 3.
CountWords("Basic Variables Age:Female (Pop)Age 1") devuelve 5.
EndsWith
EndsWith(String, Target, CaseInsensitive=1): verifica si una cadena termina con una cadena determinada. Devuelve True (verdadero) si la cadena (String) termina con el objetivo (Target), de lo contrario devuelve False (falso). De manera predeterminada, no distingue entre mayúsculas y minúsculas.
Ejemplo
EndsWith('123ABC', 'ABC')devuelve verdadero.
EndsWith('123ABC', 'abc')devuelve verdadero.
EndsWith('123ABC', 'abc', 0)devuelve falso.
FindNth
FindNth(Initial String, Target, Instance): encuentra la instancia (ocurrencia enésima) de una cadena objetivo en la cadena inicial y genera la posición de la instancia con índice 0. La función distingue entre mayúsculas y minúsculas, y no acepta parámetros negativos.
Importante
En el modo nativo de Cloud, el objetivo y la instancia deben ser valores literales estáticos.
Ejemplo
FindNth("Hello World","o",2)devuelve 7. La función encuentra la segunda instancia de “o” en la cadena proporcionada y devuelve la posición con índice 0, que en este caso es 7.
FindNth("Hello World","World",1)devuelve 6. La función encuentra la primera instancia de “World” en la cadena proporcionada y devuelve la posición con índice 0 del primer carácter, que en este caso es 6.
FindNth("Hello World","o",1.8)devuelve 7. La función encuentra la segunda instancia (redondea 1,8 al entero más cercano) de “o” en la cadena proporcionada y devuelve la posición con índice 0 del segundo carácter, que en este caso es 7.
FindNth("Hello World","world",1)devuelve -1. La función encuentra la primera instancia de “world” en la cadena proporcionada y devuelve la posición con índice 0 del primer carácter, que en este caso es -1 (no se encuentra la coincidencia debido a que se distingue entre mayúsculas y minúsculas).
FindNth("Hello World","l",0)devuelve -1. La función encuentra la instancia 0 de “l” en la cadena proporcionada y devuelve la posición con índice 0, que en este caso es -1 (no se encuentra, ya que la posición 0 no existe).
FindNth("Hello World","l",-1)devuelve -1. Los parámetros negativos no son aplicables, por lo que la función devuelve -1 (no se encuentra).
FindNth("Hello World", Null(), 1) devuelve -1. No se encuentran valores nulos y vacíos.
FindNth(Hello world, "l", 1)devuelve un error. La función requiere que los dos primeros parámetros sean cadenas.
FindString
La función FindString distingue entre mayúsculas y minúsculas.
FindString(String,Target): busca la ocurrencia de un objetivo (Target) dentro de una cadena (String) y devuelve la posición numérica del objetivo dentro de la cadena.
Devuelve el índice de base 0 de la primera ocurrencia del objetivo (Target) en la cadena (String). Devuelve -1 si no hay ocurrencia.
Ejemplo
FindString([Name], "John") devuelve 0 cuando la cadena comienza con John y devuelve -1 cuando la cadena no comienza con John.
IF (FINDSTRING([Name], "John") =0) THEN "John Smith" ELSE "Other" ENDIF devuelve John Smith cuando la cadena contiene John y devuelve Otro cuando la cadena no lo contiene.
GetLeft
GetLeft(String, Delimiter): devuelve la parte izquierda de la cadena (String) proporcionada antes de la primera instancia de uno o más delimitadores (Delimiter) especificados. En el modo nativo de Cloud, el delimitador debe ser un valor literal estático.
Nota
El operador Delimiter distingue entre mayúsculas y minúsculas. Si especificas "a" como delimitador, la función solo utiliza "a" como delimitador, no "A".
Ejemplo
GetLeft("Automated Analytics for All", " ") devuelve "Automated".
GetLeft("Enable fast, confident decisions across the enterprise.", ",") devuelve "Enable fast".
GetPart
GetPart(String, Delimiter, Index): utiliza un único delimitador (Delimiter) especificado o más para dividir la cadena (String) en subcadenas y devuelve la subcadena especificada en el índice (Index). En el modo nativo de Cloud, el delimitador debe ser un valor literal estático.
Esta función utiliza un índice basado en 0. Por ejemplo, si Index es 2, la función devuelve la cadena a partir de la posición en el índice 2, que es la tercera subcadena.
Nota
El operador Delimiter distingue entre mayúsculas y minúsculas. Si especificas "a" como delimitador, la función solo utiliza "a" como delimitador, no "A".
Ejemplo
GetPart("Automated Analytics for All", " ", 1) devuelve "Analytics".
GetPart("Automated Analytics for All", " ", 0) devuelve "Automated".
GetPart("Enable fast, confident decisions across the enterprise.", ", ", 5) devuelve "across". Ten en cuenta que este ejemplo utiliza 2 delimitadores: una coma y un espacio. La función divide la cadena cuando encuentra cualquiera de estos delimitadores.
GetPart("January 1, 2023", " ", 2) devuelve "2023".
GetRight
GetRight(String, Delimiter): devuelve la parte derecha de la cadena (String) proporcionada después de la primera instancia de uno o más delimitadores (Delimiter) especificados. En el modo nativo de Cloud, el delimitador debe ser un valor literal estático.
Nota
El operador Delimiter distingue entre mayúsculas y minúsculas. Si especificas "a" como delimitador, la función solo utiliza "a" como delimitador, no "A".
Ejemplo
GetRight("Automated Analytics for All", " ")devuelve "Analytics for All".
GetRight("Enable fast, confident decisions across the enterprise.", ",") devuelve " confident decisions across the enterprise". (ten en cuenta el espacio antes de confident en la devolución).
GetWord
GetWord(string, n): devuelve la enésima palabra (basado en 0) de la cadena. Las palabras se definen como una colección de caracteres separados por un espacio. Índice de base 0, significa que la primera palabra está en la posición 0.
Ejemplo
GetWord("Basic Variables Households", 0)devuelve "Basic".
GetWord("Basic Variables Households", 1)devuelve "Variables".
Izquierda
Left(String, len): devuelve los primeros caracteres (len) en la cadena (String). Si len es menor que 0 o mayor que la longitud de la cadena, la cadena permanece intacta.
Ejemplo
Left("92688", 3) devuelve un valor de “926”.
Duración
Length(String): devuelve la longitud de la cadena (String).
Ejemplo
Length("92688") devuelve un valor de 5.
LowerCase
LowerCase(String): convierte una cadena en minúsculas.
Ejemplo
LowerCase("M1P 1G6")devuelve "m1p 1g6".
PadLeft
PadLeft(String, len, char): rellena la cadena hacia la izquierda con el carácter especificado hasta la longitud especificada. Si el relleno definido (char) es más de 1 carácter, solo se usa el primer carácter.
Ejemplo
PadLeft("M", 4, "x")devuelve "xxxM".
PadRight
PadRight(String, len, char): rellena la cadena hacia la derecha con el carácter especificado hasta la longitud especificada. Si el relleno definido (char) es más de 1 carácter, solo se usa el primer carácter.
Ejemplo
PadRight("M", 4, "x")devuelve "Mxxx".
REGEX_CountMatches
REGEX_CountMatches(String,pattern,icase): devuelve el conteo de coincidencias con el patrón dentro de la cadena.
icase es un parámetro opcional. Cuando se especifica, distingue mayúsculas y minúsculas. De manera predeterminada, icase = 1, lo cual significa que no se distingue entre mayúsculas y minúsculas. Si se establece en 0, distingue mayúsculas y minúsculas.
Nota
This function isn't available for Live Query for Databricks.
REGEX_Match
REGEX_Match(String,pattern,icase): busca la ocurrencia de una expresión regular en una cadena.
Indica si la cadena coincide con el patrón desde el primer carácter hasta el final.
Para buscar algo que no necesariamente comience al principio de la cadena, comienza el patrón con '.*'.
Para buscar algo que no necesariamente va hasta el final de la cadena, termina el patrón con '.*'.
Consulta la página Sintaxis de expresiones regulares Boost RegEx Perl para obtener más información sobre cómo construir correctamente una expresión regular.
icase es un parámetro opcional. Cuando se especifica, distingue mayúsculas y minúsculas. De manera predeterminada, icase = 1, significando que no distingue mayúsculas y minúsculas. Si se establece en 0, distingue mayúsculas y minúsculas.
Nota
This function isn't available for Live Query for Databricks.
Ejemplo
REGEX_Match("123-45-6789", "\d{3}-\d{2}-\d{4}")devuelve -1 (verdadero).
REGEX_Replace
REGEX_Replace(String, pattern, replace, icase): devuelve la cadena resultante del patrón de búsqueda de RegEx y reemplaza la cadena.
El parámetro “replace” puede ser un valor especificado, como se muestra a continuación, o un grupo marcado, como “$1”. Asegúrate de que los grupos marcados estén entre comillas dobles.
icase es un parámetro opcional. Cuando se especifica, distingue mayúsculas y minúsculas.
De manera predeterminada, icase=1, que significa que no distingue mayúsculas y minúsculas.
Si se establece en 0, distingue mayúsculas y minúsculas.
Nota
This function isn't available for Live Query for Databricks.
Ejemplo
REGEX_Replace("Don't reveal your Social Security number, 123-45-6789","\d{3}-\d{2}-\d{4}", "CLASSIFIED") devuelve "Don't reveal your Social Security number, CLASSIFIED".
REGEX_Replace("Change all domain names from alteryx@Alteryx.com","@.*\.", "@extendthereach.") devuelve "Change all domain names from alteryx@extendthereach.com".
REGEX_Replace("25 test","(\d+)\s.*","$1") devuelve 25.
Replace
Replace(String, Target, Replacement): devuelve la cadena (String) después de reemplazar cada ocurrencia de la cadena (Target) por la cadena (Replacement).
Ejemplo
Replace("El buen juicio viene de la experiencia", "experiencia", "conciencia") devuelve “El buen juicio viene de la conciencia”
ReplaceChar
ReplaceChar(String, y, z): devuelve la cadena (String) después de reemplazar cada ocurrencia del carácter (y) por el carácter (z). Si el carácter de reemplazo (z) es una cadena con más de 1 carácter, solo se utiliza el primer carácter. Si (z) está vacío, se elimina cualquier carácter de la cadena (String) que coincida con cualquier carácter (y).
Ejemplo
ReplaceChar("abcdefb", "b", "_")devuelve "a_cdef_".
ReplaceChar("@a#b%c", "@,#,%", "_")devuelve "_a_b_c".
ReplaceFirst
ReplaceFirst(String, Target, Replacement): devuelve la cadena (String) después de reemplazar la primera ocurrencia del objetivo (Target) por la cadena de reemplazo (Replacement).
Ejemplo
ReplaceFirst("abcdefb", "b", "_")devuelve "a_cdefb".
ReverseString
ReverseString(String): invierte todos los caracteres de la cadena.
Nota
This function isn't available for Live Query for Databricks.
Ejemplo
ReverseString("abcdefb") devuelve "bfedcba".
Derecha
Right(String, len): devuelve los últimos caracteres (len) de la cadena. Si len es menor que 0 o mayor que la longitud de la cadena, la cadena permanece intacta.
Ejemplo
Right("92688", 3) devuelve un valor de “688”.
StartsWith
StartsWith(String, Target, CaseInsensitive=1): comprueba si una cadena comienza con una cadena determinada. Devuelve verdadero si la cadena (String) comienza con el objetivo (Target) determinado; si no, devuelve falso.
Ejemplo
StartsWith('ABC123', 'ABC') devuelve verdadero.
StartsWith('ABC123', 'abc') devuelve verdadero.
StartsWith('ABC123', 'abc', 0) devuelve falso.
STRCSPN
STRCSPN(String, y): devuelve la longitud del segmento inicial de la cadena (String) que consiste en caracteres que no están en la cadena (y).
Ejemplo
STRCSPN("Bob's Amaco", "~!@#$%^&*'()") devuelve 3. Esta es una prueba útil para asegurarse de que no hay puntuación en la cadena.
StripQuotes
StripQuotes(String): elimina un conjunto coincidente de comillas o apóstrofos de los extremos de la cadena.
Ejemplo
StripQuotes("Hello there")devuelve Hello there.StripQuotes("'Hello there,' she said.")devuelve 'Hello there,' she said.StripQuotes('"Hello there," she said.')devuelve "Hello there," she said.
STRSPN
STRSPN(String, y): devuelve la longitud del segmento inicial de la cadena (String) que consta de caracteres en la cadena (y).
Ejemplo
STRSPN("3034408896x105", "0123456789") devuelve 10. Esta es una prueba útil para asegurarse de que una cadena tiene de un conjunto de caracteres.
Substring
Substring(String, start, length): devuelve la subcadena de la cadena (String) comenzando en (start) y parando después de (length), si se proporciona.
Ejemplo
Substring("949-222-4356", 4, 8) devuelve “222-4356”.
Substring("949-222-4356", 4, 6) devuelve “222-43”.
Substring("949-222-4356", 4) devuelve “222-4356”.
TitleCase
TitleCase(String): convierte la primera letra de cada palabra de la cadena en mayúscula.
Ejemplo
TitleCase("john smith")devuelve "John Smith".
Trim
Trim(String, y): elimina los caracteres de (y) de los extremos de la cadena (String). (y) es opcional y predeterminado a recortar espacios en blanco. Nota que en los ejemplos de la función Trim, los caracteres especificados se recortan. No importa en qué orden estén los caracteres.
Ejemplo
Trim("!ver instrucciones!!!", "!") devuelve “ver instrucciones”.
Trim(" Test123 ") devuelve “Test123”.
TrimLeft
TrimLeft(String, y): elimina el carácter en la cadena (y) del principio de la cadena (String). (y) es opcional y predeterminado a recortar espacios en blanco.
Ejemplo
TrimLeft("** special invitation ", " *") devuelve "special invitation ".
TrimRight
TrimRight(String, y): elimina el carácter en la cadena (y) del final de la cadena (String). (y) es opcional y predeterminado a recortar espacios en blanco.
Ejemplo
TrimRight("John Smith ")devuelve "John Smith".
TrimRight("John Smith**","*")devuelve "John Smith".
Aunque tú quieras recortar caracteres de una cadena en un conjunto en orden, la función TRIM no respeta el orden de los caracteres y trata la cadena como una simple lista. Por lo tanto, recorta TODOS los caracteres especificados en la lista. Si quieres reemplazar una cadena, utiliza una función Replace o una función RegEx en la expresión.
Uppercase
Uppercase(String): convierte una cadena a mayúsculas.
Ejemplo
Uppercase("Juan Pérez") devuelve “JUAN PÉREZ”.