Fórmulas en Consultas

Arrays

Estas funciones son especiales ya que manejan arrays o conjuntos ordenados de datos como argumentos. Se usan principalmente para manejar los resultados de las subconsultas o listas de valores de filtros.

Funciones

Contiene el valor

Sintaxis: contains(Array, value)

Comprueba si value está contenido en el conjunto de elementos en forma de Array, como por ejemplo sucede con el resultado de una subconsulta. Devuelve true si la expresión forma parte del conjunto o false en caso contrario.

Ejemplos:

Elemento del array

Sintaxis: elementAt(Array, index)

Devuelve el valor o elemento del array situado en la posición ""index"". Tener en cuenta que un array de N elementos tiene índices desde 0 hasta N-1, si el índice es mayor que N-1 se devuelve vacío.

Ejemplos:

Posición del valor

Sintaxis: indexOfArray(Array, value)

Comprueba si value está contenido en el conjunto de elementos en forma de Array, como por ejemplo sucede con el resultado de una subconsulta. Devuelve el número igual al índice del elemento igual a value si la expresión forma parte del conjunto o -1 en caso contrario. Tener en cuenta que un array de N elementos tiene índices desde 0 hasta N-1

Ejemplos:

Tamaño del array

Sintaxis: size(Array)

Devuelve un valor numérico igual al número de elementos o tamaño de Array. Los elementos del array deben de tener todos el mismo tipo.

Ejemplos:

Comparación (igualdad)

Funciones

Comparación

Sintaxis: cmp(value1, value2)

Compara el tipo y el valor de los dos argumentos:

• Si los tipos son iguales devuelve 1 si el primer valor es mayor que el segundo, -1 si es menor y 0 si son iguales.
• Si los tipos son diferentes se sigue el criterio de orden de menor a mayor: nulo, número, texto, array, booleano (true, false) y fecha.

Igual

Sintaxis: eq(value1, value2)

Compara dos valores entre sí, y devuelve true si los dos valores y sus tipos son iguales, y false en caso contrario.

Ejemplos:

No igual

Sintaxis: ne(value1, value2)

Compara dos valores entre sí, y devuelve true si los dos valores o sus tipos son diferentes, y false en caso contrario.

Ejemplos:

Comparación (mayor/menor)

Funciones

Mayor o igual

Sintaxis: gte(value1, value2)

Compara dos valores entre si, y devuelve true si el primer valor es mayor o igual al segundo y sus tipos son iguales, y false en caso contrario.

Ejemplos:

Mayor

Sintaxis: gt(value1, value2)

Compara dos valores entre si, y devuelve true si el primer valor es mayor que el segundo y sus tipos son iguales, y false en caso contrario.

Ejemplos:

Menor o igual

Sintaxis: lte(value1, value2)

Compara dos valores entre si, y devuelve true si el primer valor es menor o igual al segundo y sus tipos son iguales, y false en caso contrario.

Ejemplos:

Menor

Sintaxis: lt(value1, value2)

Compara dos valores entre si, y devuelve true si el primer valor es menor que el segundo y sus tipos son iguales, y false en caso contrario.

Ejemplos:

Condicionales

Las funciones condicionales, de uso muy frecuente, permiten cambiar establecer condiciones para la transformación de los campos originales. Son las siguientes:

Funciones:

Condicional simple

Sintaxis: cond(boolean, value1, value2)

El primer argumento es un booleano (true o false), por ejemplo el resultado de una función de comparación. Si boolean es igual a true la función devuelve value1, y en caso contrario Value2. Además, value1 y value2 deben de tener obligatoriamente el mismo tipo de dato.

Ejemplos:

Condicional múltiple

Sintaxis: switch(boolean1, value1; boolean2, value2; ...; value)

La función recibe parejas de valores (boolean, value) separadas por "";"". Si boolean1 es igual a true la función devuelve value1, y sino se pasa a la siguiente pareja; si boolean2 es igual a true la función devuelve value2, y sino se pasa a la siguiente pareja; este proceso se repite tantas veces como parejas (boolean, value) se indiquen; finalmente, si todos los boolean son false, se devuelve value. Particularidades:

• Hay que definir como mínimo 2 condiciones, de lo contrario se debe usar la función condicional simple.
• El valor por defecto no es obligatorio, se devuelve un valor nulo en caso de no estar definido.

Ejemplos:

Si es nulo

Sintaxis: ifNull(value, replacement)

La función ifNull permite reemplazar los valores null de una columna por otro valor. Si value tiene valor null la función devuelve el valor replacement, y en caso contrario value. Es obligatorio que replacement tenga el mismo tipo de dato que value.

Ejemplos:

Conversión

Las funciones de conversión permiten cambiar el tipo de un campo. Este proceso es, por lo general, delicado, especialmente cuando cuando hay decimales, signos de puntuación o formatos especiales. Es recomendable hacer un test y validar que todo funciona correctamente al usar estas funciones.

Funciones:

Número a Texto

Sintaxis: toString(number)

Convierte el valor number en un texto. Los números enteros se devuelven sin decimales, y los números con decimales se devuelven con un máximo de 5 decimales. Además, a partir de 10 dígitos enteros se da formato exponencial al número.

Ejemplos:

Texto a Número

Sintaxis: toNumber(text)

Convierte la cadena text en un número, siempre que esto sea posible.

Ejemplos:

Fechas (partes)

Estas funciones permiten obtener información de las diferentes partes de una fecha.

Funciones:

Año

Sintaxis: year(date [, boolean])

La función extrae el año del valor date. Si se indica el booleano true como segundo argumento el retorno de la función es numérico, mientras que en caso contrario o cuando solo se proporciona el primer argumento el retorno es de tipo texto.

Ejemplos:

Mes

Sintaxis: month(date [, boolean])

La función extrae el mes del valor date. Si se indica el booleano true como segundo argumento el retorno de la función es numérico (1-12), mientras que en caso contrario o cuando solo se proporciona el primer argumento el retorno es de tipo texto (01-12).

Ejemplos:

Nombre del mes

Sintaxis: monthName(date [, language])

La función extrae el mes del valor date y devuelve el nombre del mes (""January"", ""February"", ...). El idioma del texto se determina de acuerdo al siguiente criterio de prioridad: idioma en el que se consume la aplicación (multilingüe) si está definido, idioma por defecto de la aplicación (multilingüe) si no se ha indicado ningún idioma específico, idioma por defecto del usuario en Vision (aplicación no multilingüe), idioma por defecto del navegador donde se consume la aplicación (no multilingüe).

Opcionalmente recibe un segundo parámetro que indica el idioma utilizado si este se quiere fijar. Para cambiar el idioma se debe pasar el parámetro utilizando el código ISO de dos letras relativo al idioma (""en"", ""pt"", ""es"").

Ejemplos:

Día del mes

Sintaxis: day(date [, boolean])

La función extrae el día del mes del valor date. Si se indica el booleano true como segundo argumento el retorno de la función es numérico (1-31), mientras que en caso contrario o cuando solo se proporciona el primer argumento el retorno es de tipo texto (01-31).

Ejemplos:

Nombre del día de la semana

Sintaxis: dayName(date [, language])

La función extrae el día de la semana del valor date y devuelve su nombre ("Monday", "Tuesday", ...). El idioma del texto se determina de acuerdo al siguiente criterio de prioridad: idioma en el que se consume la aplicación (multilingüe) si está definido, idioma por defecto de la aplicación (multilingüe) si no se ha indicado ningún idioma específico, idioma por defecto del usuario en Vision (aplicación no multilingüe), idioma por defecto del navegador donde se consume la aplicación (no multilingüe).

Opcionalmente recibe un segundo parámetro que indica el idioma utilizado si este se quiere fijar. Para cambiar el idioma se debe pasar el parámetro utilizando el código ISO de dos letras relativo al idioma ("en", "pt", "es").

Ejemplos:

Trimestre

Sintaxis: quarter(date [, prefix])

La función extrae el trimestre del año del valor date (1-4), y lo devuelve como texto. Opcionalmente puede recibir un un texto entre comillas como segundo parámetro, que se usará como prefijo.

Ejemplos:

Fechas (completas)

Estas funciones permiten crear, transformar o convertir campos de naturaleza temporal.

Funciones:

Fecha a texto

Sintaxis: dateToString(date, format)

Convierte la fecha a texto con el formato indicado.

Opciones de formato.

Ejemplos:

Fecha desde texto

Sintaxis: dateFromString(text)

Devuelve una fecha a partir del valor indicado en la cadena text, que se ha de construir con el formato "YYYY-MM-DD H24:MI:SS.sss". Se han de proporcionar el año y el mes obligatoriamente, el resto de formato es opcional.

Ejemplos:

Fecha por componentes

Sintaxis: dateFromParts(YYYY[, MM, DD, H24, MI, SS, sss])

Devuelve una fecha compuesta a partir de sus partes: año, mes, día, hora (formato 24h), minuto, segundos y milisegundos. Es obligatorio indicar al menos el año.

Ejemplos:

Lógicas

Las funciones lógicas realizan una operación lógica con sus argumentos, de tipo booleano. Su retorno es a su vez de tipo booleano (true/false), por lo que no se usan directamente como resultado de una fórmula, sino como variables en otras funciones que precisan booleanos como variables.

Funciones:

Función "O"

Sintaxis: or(boolean1, boolean2, ...)

Devuelve true si alguno de los argumentos es true, y false en caso contrario.

Ejemplos:

Función "No"

Sintaxis: not(boolean)

Realiza la operación "negación": si el argumento es true devuelve false, y si es false devuevle true.

Ejemplos:

Función "Y"

Sintaxis: and(boolean1, boolean2, ...)

Devuelve true si todos los argumentos son true, y false en caso contrario.

Ejemplos:

Matemáticas (aproximación)

Estas funciones matemáticas devuelven un valor aproximado de un número.

Funciones:

Entero superior

Sintaxis: ceil(number)

Devuelve el entero más pequeño que sea mayor o igual al número dado.

Ejemplos:

Entero inferior

Sintaxis: floor(number)

Devuelve el entero más grande que sea menor o igual al número dado.

Ejemplos:

Parte entera

Sintaxis: trunc(number)

Trunca el número dado a su valor entero: el entero inferior si es positivo y el superior si es negativo.

Ejemplos:

Redondear decimales

Sintaxis: round(number[, precision])

Redondea number a la precisión (accuracy) decimal indicada, y si no se indica ésta explícitamente se entiende como 0. Cuando redondea a valores enteros, el valor X.5 lo redondea a X si X es par, y a X+1 si X es impar, mientras que cuando se redondea a uno o más decimales, el valor X.Y5 lo redondea siempre a X.Y (cuestiones de precisión en la representación de los valores numéricos decimales).

Ejemplos:

Matemáticas (generales)

Funciones matemáticas de uso común, aplican únicamente a valores numéricos y devuelven un número.

Funciones:

Raíz cuadrada

Sintaxis: sqrt(number)

Calcula la raíz cuadrada de number.

Ejemplos:

Valor Absoluto

Sintaxis: abs(number)

Devuelve el valor absoluto de number.

Ejemplos:

Matemáticas (exponencial y logaritmo)

Estas funciones matemáticas permiten obtener exponenciales y logaritmos.

Funciones:

Exponencial

Sintaxis: exp(number)

Eleva el número e al exponente number (e^number).

Ejemplos:

Logaritmo

Sintaxis: log(number, base)

Calcula el Logaritmo de number en la base indicada.

Ejemplos:

Logaritmo natural

Sintaxis: ln(number)

Calcula el logaritmo natural de number.

Ejemplos:

Operadores

Los operadores aplican unicamente cuando se sitúan entre números. No tienen una sintaxis de función con argumentos, simplemente el operador va en medio de los 2 números o componentes.

Funciones:

Suma (+)

Sintaxis: addend1 + addend2

Calcula la suma de dos números o de un número y una fecha. Si una de las expresiones es de tipo fecha la otra expresión se trata como el número de milisegundos a añadir a la fecha.

El tipo de retorno de la fórmula es numérico si los sumandos son números, o una fecha si uno de los sumandos es de tipo fecha.

Ejemplos:

Resta (-)

Sintaxis: minuend - subtrahend

Calcula la resta de dos números, de una fecha menos un número, o de dos fechas. Cuando se resta un número de una fecha el número se interpreta en milisegundos, y cuando resta 2 fechas ambas se convierten a milisegundos para proceder a una resta numérica.

El tipo de retorno de la fórmula es numérico si minuend y subtrahend son números, es una fecha si minuend es una fecha y subtrahend un número, y un número igual a la diferencia en milisegundos si minuend y subtrahend son ambos fechas.

Ejemplos:

Multiplicación (*)

Sintaxis: factor1 * factor2

Calcula la multiplicación de dos números, retornando a su vez un número.

Ejemplos

División (/)

Sintaxis: dividend / divisor

Calcula la división de dos números, retornando a su vez un número. Cuando divisor toma el valor 0 el resultado es null, al igual que cuando o dividend o divisor sean nulo.

Ejemplos:

Potencia (^)

Sintaxis: base ^ power

Eleva el número base al exponente numérico power especificado, retornando a su vez un número base power.

Ejemplos:

Resto de la división (%)

Sintaxis: dividend % divisor

Permite calcular el resto de la división de dos números, retornando a su vez un número. Cuando divisor toma el valor 0 el resultado es null, al igual que cuando o dividend o divisor sean nulo.

Ejemplos:

Texto (general)

Estas funciones permiten la manipulación de cadenas de texto. Son las siguientes:

Funciones

Comparación de cadenas

Sintaxis: strCaseCmp(text1, text2)

Dados dos argumentos de tipo texto se realiza una comparación alfanumérica e ignorando las mayúsculas. El retorno es numérico:

• 1 si text1 es mayor que text2.
• 0 si ambos textos son iguales.
• -1 si text2 es mayor text1.

Ejemplos:

Concatenación

Sintaxis: concat(text1, text2, ...)

Concatena dos o más cadenas de texto.

Ejemplos:

Longitud

Sintaxis: strLen(text)

Devuelve el número de caracteres (estrictamente el número de UTF-8 code points) de la cadena text.

Ejemplos:

Posición

Sintaxis: indexOf(text, string [, from, to])

Esta función devuelve la posición de la primera coincidencia de string en text, donde la posición comienza con el valor 0 y termina con el valor L-1, siendo L el número de caracteres de text (strLen(text)). En caso de no haber coincidencia devuelve el valor -1.

Opcionalmente, se puede acotar el intervalo de búsqueda, esto es, buscar la coincidencia solo en el intervalo [from, to] de caracteres de text, desechando cualquier coincidencia fuera de ese rango.

Ejemplos:

Separar texto

Sintaxis: split(text, sep)

Separa la cadena text usando el separador sep, y devuelve un array con tantos elementos como divisiones se obtienen.

Ejemplos:

Texto (modificar)

Estas funciones permiten la transformación y conversión de de cadenas de texto. Son las siguientes:

Funciones

Mayúsculas

Sintaxis: toUpper(text)

Convierte todas las letras de text en mayúsculas. Aplica la conversión solo a caracteres ASCII.

Ejemplos:

Minúsculas

Sintaxis: toLower(text)

Convierte todas las letras de text en minúsculas. Aplica la conversión solo a caracteres ASCII.

Ejemplos:

Recortar

Sintaxis: trim(text, [string])

Elimina todos los caracteres "espacio" al inicio y final de text. En caso de pasar un segundo argumento string elimina todos los caracteres que formen parte de string.

Ejemplos:

Subcadena

Sintaxis: substr(text, from, length)

Obtiene la subcadena de text desde la posición from tomando length caracteres, teniendo en cuenta que las posiciones comienzan a contarse por el 0.

Ejemplos:

Trigonométricas (generales)

Las funciones trigonométricas son funciones matemáticas especificas para su uso con medidas relacionadas con ángulos. Son las siguientes:

Funciones:

Grados a Radianes

Sintaxis: degreesToRadians(number)

Hace la conversión de number grados a radianes: 1° × ?/180 = 0.0174533... rad.

Ejemplos:

Radianes a Grados

Sintaxis: radiansToDegrees(number)

Hace la conversión de number radianes a grados: 1 rad × 180/? = 57.2958...°.

Ejemplos:

Seno

Sintaxis: sin(number)

Obtiene el seno de number, entendiendo el valor en radianes.

Ejemplos:

Coseno

Sintaxis: cos(number)

Obtiene el coseno de number, entendiendo el valor en radianes.

Ejemplos:

Tangente

Sintaxis: tan(number)

Obtiene la tangente de number, entendiendo el valor en radianes.

Ejemplos:

Trigonométricas (arcoseno)

Funciones:

Arcoseno

Sintaxis: asin(number)

Obtiene el arcoseno de number, siempre que éste sea un número mayor o igual que -1 y menor o igual que 1. Retorna un valor en radianes.

Ejemplos:

Arcoseno Hiperbólico

Sintaxis: asinh(number)

Obtiene el arcoseno hiperbólico de number.

Ejemplos:

Trigonométricas (arcocoseno)

Funciones:

Arcocoseno

Sintaxis: acos(number)

Obtiene el arcocoseno de number, siempre que éste sea un número mayor o igual que -1 y menor o igual que 1. Retorna un valor en radianes.

Ejemplos:

Arcocoseno Hiperbólico

Sintaxis: acosh(number)

Obtiene el arcocoseno hiperbólico de number, siempre que éste sea un número mayor o igual que 1.

Ejemplos:

Trigonométricas (arcotangente)

Funciones:

Arcotangente

Sintaxis: atan(number)

Obtiene el arcotangente de number, retornando un valor en radianes.

Ejemplos:

Arcotangente de 2 Parámetros

Sintaxis: atan2(number1, number2)

Obtiene el arcotangente de 2 parámetros number1 y number2, esto es, el arcotangente de number1/number2.

Ejemplos:

Arcotangente Hiperbólico

Sintaxis: atanh(number)

Obtiene el arcotangente hiperbólico de number, siempre que éste sea un número mayor que -1 y menor que 1.

Ejemplos: