Referencia de funciones de flujo de trabajo
Estos tipos de funciones están disponibles para transformar tus datos en Live Query. El tipo de datos determina las funciones que puedes utilizar.
Consulta Tipos de datos admitidos para obtener más información.
Usa esta guía para consultar rápidamente las funciones que puedes usar en el Editor de expresiones en Live Query. Si necesitas más información y ejemplos, visita las páginas específicas de cada categoría que se vinculan en cada sección.
Condicional
Las funciones condicionales te permiten realizar una acción o un cálculo mediante una instrucción IF. Para obtener parámetros y ejemplos, ve a Funciones condicionales de flujo de trabajo.
IF condition THEN t ELSE f ENDIF
IF c THEN t ELSE f ENDIF: devuelve “t” si la condición “c” es verdadera, de lo contrario devuelve “f”.
IF c THEN t1 ELSEIF c2 THEN t2 ELSE f ENDIF
IF c THEN t1 ELSEIF c2 THEN t2 ELSE f ENDIFIF c THEN t ELSE f ENDIF: devuelve t1 si c es verdadera; de lo contrario, devuelve t2 si la condición c2 es verdadera; de lo contrario, devuelve f.
IIF
IIF(bool, x, y): devuelve x si bool es verdadero; si no, devuelve y.
Switch
Switch(Value,Default,Case1,Result1,…,CaseN,ResultN): compara un valor con una lista de casos y devuelve el resultado correspondiente.
Conversión
Las funciones de conversión convierten números en cadenas o cadenas en números. Para obtener parámetros y ejemplos, ve a Funciones de conversión de flujo de trabajo.
CharFromInt
CharFromInt(x): devuelve el carácter Unicode® que coincida con el número x ingresado.
Nota
This function isn't available for Live Query for Databricks.
ToDegrees
ToDegrees(x): convierte un valor numérico radián (x) en grados mediante el cálculo (x)rad × 180/π. Ten en cuenta que x debe ser un valor numérico y no puede incluir ningún símbolo de radián (rad).
ToNumber
ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]): convierte una cadena (x) en un número.
ToRadians
ToRadians(x): convierte un valor numérico de grado (x) en radianes mediante el cálculo (x)° × π/180. Ten en cuenta que x debe ser un valor numérico y no puede incluir el símbolo de grado (°).
ToString
ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]): convierte un parámetro numérico (x) a una cadena usando los lugares decimales numDec. La selección predeterminada utiliza un punto como separador decimal.
Fecha y hora
Las funciones de fecha y hora te permiten realizar una acción o un cálculo en un valor de fecha y hora. Para obtener parámetros y ejemplos, ve a Funciones de fecha y hora de flujo de trabajo.
DateTimeAdd
DateTimeAdd(dt,i,u): agrega un intervalo específico a un valor de fecha y hora.
DateTimeDay
DateTimeDay(dt): devuelve el valor numérico correspondiente al día del mes en un valor fecha y hora.
DateTimeDiff
DateTimeDiff(dt1,dt2,u): resta el segundo argumento del primero y lo devuelve como diferencia en número entero. La duración se devuelve como un número, no una cadena, en las unidades de tiempo especificadas.
DateTimeFirstOfMonth
DateTimeFirstOfMonth(): devuelve el primer día del mes, a la medianoche.
DateTimeFormat
DateTimeFormat(dt, f): convierte datos de fecha y hora en (df) en otro formato especificado en (f).
Nota
This function isn't available for Live Query for Databricks.
DateTimeHour
DateTimeHour(dt): devuelve la porción de horas en un valor fecha y hora.
DateTimeLastOfMonth
DateTimeLastOfMonth(): devuelve el último día del mes actual, con el reloj configurado un segundo antes del final del día (23:59:59).
DateTimeMinutes
DateTimeMinutes(dt): devuelve la porción de los minutos de la hora en un valor fecha y hora.
DateTimeMonth
DateTimeMonth(dt): devuelve el valor numérico correspondiente al mes en un valor fecha y hora.
DateTimeNow
DateTimeNow(): devuelve la fecha y hora del sistema actual.
DateTimeParse
DateTimeParse(dt, f): convierte una cadena de fecha con el formato y el idioma especificados al formato ISO estándar (yyyy-mm-dd HH:MM:SS).
Nota
This function isn't available for Live Query for Databricks.
DateTimeQuarter
DateTimeQuarter(dt,[Q1Start]): devuelve el valor numérico correspondiente al trimestre del año en el que cae un valor fecha y hora (AAAA-MM-DD). Utiliza el parámetro numérico opcional para indicar el mes de inicio del primer trimestre (Q1).
DateTimeSeconds
DateTimeSeconds(dt): devuelve la porción de los segundos de la hora en un valor fecha y hora.
DateTimeToday
DateTimeToday(): devuelve la fecha de hoy.
DateTimeTrim
DateTimeTrim(dt, f): quita las partes no deseadas de un valor fecha y hora, y devuelve el valor fecha y hora modificado.
Nota
This function isn't available for Live Query for Databricks.
DateTimeYear
DateTimeYear(dt): devuelve el valor numérico correspondiente al año en un valor de fecha y hora.
ToDate
ToDate(x): convierte una cadena, un número o una fecha y hora en una fecha.
ToDateTime
DateTimeTrim(ToDateTime(x), t): convierte una cadena, un número o un valor fecha en una fecha y hora.
Finanzas
Una función de finanzas aplica algoritmos financieros o cálculos matemáticos. Para obtener más información, ve a Funciones de finanzas de flujo de trabajo.
FinanceCAGR
FinanceCAGR(BeginningValue, EndingValue, NumYears): calcula la tasa de crecimiento anual compuesta: la tasa media geométrica de crecimiento según una base anualizada.
FinanceEffectiveRate
FinanceEffectiveRate(NominalRate, PaymentsPerYear): calcula la tasa de interés anual efectiva: la tasa de interés de un préstamo o producto financiero reexpresada a partir de la tasa de interés nominal como una tasa de interés con interés compuesto anual pagadero en mora.
FinanceFV
FinanceFV(Rate, NumPayments, PaymentAmount, PresentValue, PayAtPeriodBegin): calcula el valor futuro de una inversión: el valor de un activo en un momento determinado en el futuro, y supone una determinada tasa de interés o tasa de rentabilidad.
FinanceIRR
FinanceIRR(Value1, Value2): calcula la tasa interna de rentabilidad, la cual es la tasa de interés a la que los costos de la inversión dan lugar a los beneficios de la inversión. Esto significa que todos los beneficios de la inversión son inherentes al valor de tiempo del dinero y que la inversión tiene un valor presente neto de cero con esta tasa de interés.
Nota
This function isn't available for Live Query for Databricks.
FinanceNominalRate
FinanceNominalRate(EffectiveRate, PaymentsPerYear): calcula la tasa de interés anual nominal: una tasa de interés se denomina nominal si la frecuencia de la composición (como un mes) no es idéntica a la unidad de tiempo básica (normalmente un año).
FinanceNPER
FinanceNPER(Rate, PaymentAmount, PresentValue, FutureValue, PayAtPeriodBegin): calcula la cantidad de períodos para una inversión o un préstamo.
FinancePMT
FinancePMT(Rate, NumPayments, PresentValue, FutureValue, PayAtPeriodBegin): calcula los pagos de un préstamo.
FinancePV
FinancePV(Rate, NumPayments, PaymentAmount, FutureValue, PayAtPeriodBegin): calcula el valor actual de una inversión: el valor de un pago futuro en una fecha dada, o una serie de pagos futuros, descontado para reflejar el valor temporal del dinero y otros factores como el riesgo de inversión.
FinanceXIRR
FinanceXIRR(Value1, Date1, Value2, Date2): calcula la tasa interna de rentabilidad de una inversión con fechas.
Nota
This function isn't available for Live Query for Databricks.
FinanceXNPV
FinanceXNPV(Rate, Value1, Date1, Value2, Date2): calcula el valor neto actual de una inversión con fechas.
Matemática
Una función matemática realiza cálculos matemáticos. Para obtener parámetros y ejemplos, ve a Funciones matemáticas de flujo de trabajo.
ABS
ABS(x): devuelve el valor absoluto de x. Es la distancia entre 0 y un número. El valor siempre es positivo.
ACOS
ACOS(x): devuelve el arcocoseno, o coseno inverso, de un número. El arcocoseno es el ángulo cuyo coseno es (x).
ASIN
ASIN(x): devuelve el arcoseno, o seno inverso, de un número (x). El arcoseno es el ángulo cuyo seno es (x).
ATAN
ATAN(x): devuelve la arcotangente, o tangente inversa, de un número. La arcotangente es el ángulo cuya tangente es (x). El ángulo devuelto se expresa en radianes en el rango -pi/2 a pi/2.
ATAN2
ATAN2(y, x): devuelve la arcotangente, o tangente inversa, de “y” y “x” (arcotangente de (y/x)).
Promedio
Average(n1, …): devuelve el promedio de una lista de números. Los valores NULL se tratan como 0 y se tienen en cuenta en el cálculo del valor promedio.
AverageNonNull
AverageNonNull(n1, ...): devuelve el promedio de una lista de números. Los valores nulos se excluyen del cálculo. El cálculo solo funciona con tipos de datos numéricos.
CEIL
.CEIL(x, [mult]): devuelve un valor numérico (x) elevado al múltiplo más bajo de (mult.) que sea mayor o igual que x. El parámetro (mult.) debe ser un número mayor que 0. Si (mult.) no se especifica, la función devuelve el entero más pequeño que es mayor o igual que (x).
COS
COS(x): devuelve el coseno de un ángulo determinado (x). x debe estar en radianes.
EXP
EXP(x): devuelve e elevado a la potencia x.
FLOOR
FLOOR(x, [mult]): devuelve un valor numérico (x) reducido al múltiplo más alto de (mult.) que es menor o igual que x. El parámetro (mult.) debe ser un número mayor que 0. Si (mult.) no se especifica, la función devuelve el entero más grande que es menor o igual que (x), como se muestra en el primer ejemplo a continuación.
LOG
LOG(x): devuelve el logaritmo natural de un número (x). x debe ser un número positivo.
LOG10
LOG10(x): devuelve el logaritmo en base 10 de un número (x). x debe ser un número positivo.
Median
Median(…): calcula la mediana de 1 o más valores (posiblemente no ordenados).
Nota
This function isn't available for Live Query for Databricks.
Mod
Mod(n,d): módulo de un número (n) dividido por un número (d) (operación con enteros).
PI
PI(): devuelve el valor de la constante PI con hasta 15 dígitos de exactitud.
POW
POW(x, e): devuelve un número (x) elevado a la potencia (e).
RAND
RAND(): devuelve un número aleatorio mayor o igual que 0 y menor que 1.
RandInt
RandInt(n): devuelve un entero aleatorio entre 0 y el parámetro especificado (n).
Round
Round(x, mult): devuelve x redondeado al múltiplo más cercano al número especificado en mult.
SIN
SIN(x): devuelve el seno de un ángulo determinado (x). x debe estar en radianes.
SmartRound
SmartRound(x): devuelve un número (x) redondeado al múltiplo más cercano a un valor que se determina en forma dinámica en función del tamaño de (x).
SQRT
SQRT(x): devuelve la raíz cuadrada de un número (x).
TAN
TAN(x): devuelve la tangente de un ángulo determinado (x). x debe estar en radianes.
TANH
TANH(x): devuelve la tangente hiperbólica de un número (x).
Mín./Máx.
Una función mínima o máxima encuentra el valor más pequeño y más grande de un conjunto de valores. Para obtener más información, ve a Funciones Mín./Máx. de flujo de trabajo.
Entre
BETWEEN(x, min, max): prueba si un valor (x) está entre 2 otros valores (min y max), incluidos min y max. Devuelve TRUE si x está entre min y max. Devuelve FALSE si x no está entre min y max.
Bound
Bound(x, min, max): si (x < min) devuelve el valor de min, de lo contrario (x > max) devuelve el valor de max, de lo contrario devuelve el valor de (x).
Max
Max(v0, v1,…, vn): devuelve el valor máximo de la lista.
Min
Min(v0, v1, …, vn): devuelve el valor mínimo de la lista.
Operadores
Un operador es un carácter que representa una acción. Utiliza un operador aritmético para realizar cálculos matemáticos o un operador booleano para trabajar con valores verdaderos/falsos. Para obtener más información, ve a Operadores de flujo de trabajo.
Suma
+: suma.
Booleano AND - Palabra clave
AND: combina dos valores booleanos. El resultado es verdadero si ambos valores combinados son verdaderos; falso si alguno de ellos es falso, pero no nulo; y nulo si alguno de ellos es nulo.
Booleano AND
&&: combina dos valores booleanos. El resultado es verdadero si ambos valores combinados son verdaderos; falso si alguno de ellos es falso, pero no nulo; y nulo si alguno de ellos es nulo.
NOT - Palabra clave (booleano NOT)
NOT: acepta una entrada. Si esa entrada es verdadera, devuelve falso. Si esa entrada es falsa, devuelve verdadero. Si esa entrada es nula, devuelve nulo.
Booleano NOT
!: acepta una entrada. Si esa entrada es verdadera, devuelve falso. Si esa entrada es falsa, devuelve verdadero. Si esa entrada es nula, devuelve nulo.
OR - Palabra clave (booleano OR)
OR: combina dos valores booleanos. El resultado es verdadero si cualquiera de los dos valores (o ambos) es verdadero. Devuelve nulo si alguno de los valores es nulo.
Booleano OR
||: combina dos valores booleanos. El resultado es verdadero si cualquiera de los dos valores (o ambos) es verdadero. Devuelve nulo si alguno de los valores es nulo.
División
/: división.
Es igual a
=: es igual que.
Mayor que
>: mayor que.
Mayor o igual que
>=: mayor o igual que.
Menor que
<: menor que.
Menor o igual que
<=: menor o igual que.
Multiplicación
*: multiplicación.
No es igual a
!=: no es igual a
Resta
-: resta.
Valor IN (…)
IN: probar si un valor está en la lista.
Valor NOT IN (...)
NOT IN: probar si un valor no está en la lista.
Especializado
Estas funciones realizan una variedad de acciones especializadas y se pueden utilizar con todos los tipos de datos. Para obtener parámetros y ejemplos, ve a Funciones especializadas de flujo de trabajo.
NULL
NULL(): devuelve un valor NULL.
Cadena
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. Para obtener parámetros y ejemplos, ve a Funciones de cadena de flujo de trabajo.
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.
CountWords
CountWords(string): devuelve el 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.
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.
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.
FindString
FindString(String,Target): busca la ocurrencia de una cadena (Target) dentro de otra 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.
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.
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).
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.
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.
Left
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.
Longitud
Length(String): devuelve la longitud de la cadena (String).
LowerCase
LowerCase(String): convierte una cadena en minúsculas.
PadLeft
PadLeft (String, len, char): rellena la cadena hacia la izquierda con el carácter especificado a la longitud especificada. Si el relleno definido (char) es más de 1 carácter, solo se usa el primer carácter.
PadRight
PadRight (String, len, char): rellena la cadena hacia la derecha con el carácter especificado a la longitud especificada. Si el relleno definido (char) es más de 1 carácter, solo se usa el primer carácter.
REGEX_CountMatches
REGEX_CountMatches(String,pattern,icase): devuelve el conteo de coincidencias con el patrón dentro de la cadena.
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.
Nota
This function isn't available for Live Query for Databricks.
REGEX_Replace
REGEX_Replace(String, pattern, replace, icase): devuelve la cadena resultante del patrón de búsqueda de RegEx y reemplaza la cadena.
Nota
This function isn't available for Live Query for Databricks.
Replace
Replace(String, Target, Replacement): devuelve la cadena (String) después de reemplazar cada ocurrencia de la cadena (Target) por la cadena (Replacement).
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).
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).
ReverseString
ReverseString(String): invierte todos los caracteres de la cadena.
Nota
This function isn't available for Live Query for Databricks.
Right
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.
StartsWith
StartsWith(String, Target, CaseInsensitive=1): comprueba si una cadena comienza con una cadena determinada. Devuelve True si la cadena comienza con el objetivo determinado; si no, devuelve False.
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).
StripQuotes
StripQuotes(String): elimina un conjunto coincidente de comillas o apóstrofos de los extremos de la cadena.
STRSPN
STRSPN(String, y): devuelve la longitud del segmento inicial de la cadena (String) que consta de caracteres en la cadena (y).
Substring
Substring(String, start, length): devuelve la subcadena de la cadena (String) comenzando en (start) y parando después de (length), si se proporciona.
TitleCase
TitleCase(String): convierte la primera letra de cada palabra de la cadena en mayúscula.
Trim
Trim(String, y): elimina los caracteres de (y) de los extremos de la cadena (String). (y) es opcional y, de forma predeterminada, recorta los 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.
TrimLeft
TrimLeft(String, y): elimina caracteres en la cadena (y) del principio de la cadena (String). (y) es opcional y, de forma predeterminada, recorta los espacios en blanco.
TrimRight
TrimRight(String, y): elimina caracteres en la cadena (y) del final de la cadena (String). (y) es opcional y, de forma predeterminada, recorta los espacios en blanco.
Uppercase
Uppercase(String): convierte una cadena a mayúsculas.
Prueba
Una función de prueba realiza comparaciones de datos. Utiliza una función de prueba para identificar el tipo de dato de un valor o determinar si existe un valor. Para obtener parámetros y ejemplos, ve a Funciones de prueba de flujo de trabajo.
CompareDigits
CompareDigits(a, b, nNumDigits): compara 2 números y determina si son iguales a la cantidad dada de dígitos (nNumDigits).
CompareEpsilon
CompareEpsilon(a, b, epsilon): compara 2 números de punto flotante y devuelve verdadero si están dentro de epsilon.
EqualStrings
EqualStrings(a,b): Compara la cadena (a) con la cadena (b) para determinar si son una coincidencia exacta. La función devuelve verdadero si todos los caracteres de las cadenas a y b son idénticos, y falso si uno o más caracteres no son idénticos.
IsEmpty
IsEmpty(v): prueba si v es NULO o igual a "".
IsInteger
IsInteger(v): prueba si (v) contiene un valor que se puede convertir en un número entero. Si es así, devuelve verdadero.
IsLowerCase
IsLowerCase(String): devuelve verdadero si todos los caracteres alfabéticos (uno o más) de una cadena están en minúsculas y falso si uno o más caracteres alfabéticos están en mayúsculas. La función ignora los caracteres no alfabéticos. Ten en cuenta que esta función solo se aplica a los caracteres en los que se distingue la mayúscula de la minúscula y puede que no se aplique a los caracteres de todos los idiomas.
IsNull
IsNull(v): prueba si (v) es nulo. Devuelve verdadero si (v) es nulo; de lo contrario, devuelve falso.
IsNumber
IsNumber(v): prueba si el tipo de campo del valor (v) es un número o no.
IsString
IsString(v): prueba si el tipo de campo del valor (v) es una cadena o no.
IsUpperCase
IsUpperCase(String): devuelve verdadero si todos los caracteres alfabéticos (uno o más) de una cadena están en mayúsculas y falso si uno o más caracteres alfabéticos están en minúsculas. La función ignora los caracteres no alfabéticos. Ten en cuenta que esta función solo se aplica a los caracteres en los que se distingue la mayúscula de la minúscula y puede que no se aplique a los caracteres de todos los idiomas.