Skip to main content

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.