Funciones precompiladas de expresiones adaptadas

SE APLICA A: SDK v4

En este artículo se enumeran las funciones precompiladas disponibles ordenadas por su uso general. Para obtener información sobre los operadores usados en las funciones precompiladas y la sintaxis de expresiones, consulta Operadores.

Las expresiones precompiladas se dividen en los tipos de función siguientes:

• String
• Colección
• Comparación lógica
• Conversión
• Matemáticas
• Date
• Timex
• Análisis URI
• Construcción y manipulación de objetos
• Expresión regular
• Comprobación de tipos

También puede ver la lista en orden alfabético.

Funciones de cadena

Función	Explicación
length	Devuelve la longitud de una cadena.
replace	Reemplaza una subcadena por la cadena especificada y devuelve la cadena actualizada. Esta función distingue mayúsculas de minúsculas.
replaceIgnoreCase	Reemplaza una subcadena por la cadena especificada y devuelve la cadena actualizada. Esta función no distingue entre mayúsculas y minúsculas.
split	Devuelve una matriz que contiene subcadenas basadas en el delimitador especificado.
substring	Devuelve los caracteres de una cadena.
toLower	Devuelve una cadena en minúsculas en un formato de configuración regional opcional.
toUpper	Devuelve una cadena en mayúsculas en un formato de configuración regional opcional.
trim	Quita los espacios en blanco iniciales y finales de una cadena.
addOrdinal	Devuelve el número ordinal del número de entrada.
endsWith	Comprueba si una cadena termina con una subcadena especificada. Devuelve true si se encuentra la subcadena o devuelve false si no se encuentra. Esta función no distingue entre mayúsculas y minúsculas.
startsWith	Comprueba si una cadena comienza con una subcadena especificada. Devuelve true si se encuentra la subcadena o devuelve false si no se encuentra. Esta función no distingue entre mayúsculas y minúsculas.
countWord	Devuelve el número de palabras de la cadena especificada.
concat	Combina dos o más cadenas y devuelve la cadena resultante.
newGuid	Devuelve una nueva cadena GUID.
indexOf	Devuelve la posición inicial o el valor de índice de una subcadena o busca el objeto especificado y devuelve el índice de base cero de la primera aparición en toda la lista. Esta función distingue entre mayúsculas y minúsculas y los índices comienzan por el número 0.
lastIndexOf	Devuelve la posición inicial o el valor de índice de la última aparición de una subcadena o busca el objeto especificado y devuelve el índice de base cero de la última aparición en el intervalo de elementos de la lista. Esta función no distingue entre mayúsculas y minúsculas y los índices comienzan con el número 0.
sentenceCase	Pon en mayúscula la primera letra de la primera palabra en una cadena en un formato local opcional.
titleCase	Capitaliza la primera letra de cada palabra en una cadena en un formato de configuración regional opcional.
reverse	Invierte el orden de los elementos de una cadena o matriz.

Funciones de colección

Función	Explicación
contains	Sirve para buscar un elemento en una cadena, buscar un elemento en una matriz o buscar un parámetro en un objeto complejo. Ejemplos: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
first	Devuelve el primer elemento de la colección.
join	Devuelve una cadena que tiene todos los elementos de una matriz y tiene cada carácter separado por un delimitador. Ejemplo: join(createArray('a','b'), '.') = "a.b"
last	Devuelve el último elemento de la colección.
count	Devuelve el número de elementos de la colección.
foreach	Funciona en cada elemento y devuelven la colección nueva.
union	Devuelve una colección que tiene todos los elementos de las colecciones especificadas.
skip	Quita elementos del principio de una colección y devuelve los demás elementos.
take	Devuelve elementos del principio de una colección.
intersection	Devuelve una colección que tiene solo los elementos comunes en las colecciones especificadas.
subArray	Devuelve una submatriz a partir de la posición inicial y final especificada. Los valores de índice comienzan desde el número 0.
select	Opera en cada elemento y devuelve la nueva colección de elementos transformados.
where	Filtra en cada elemento y devuelve la nueva colección de elementos filtrados que coinciden con la condición específica.
sortBy	Ordena los elementos de la colección en orden ascendente y devuelve la colección ordenada.
sortByDescending	Ordena los elementos de la colección en orden descendente y devuelve la colección ordenada.
indicesAndValues	Convierte una matriz u objeto en una matriz de objetos con la propiedad index y value.
aplanar	Aplana matrices en una matriz con valores que no son de matriz.
unique	Quita todos los duplicados de una matriz.
cualquiera	Determina si algunos de los elementos de una secuencia cumplen una condición.
all	Determina si todos los elementos de una secuencia satisfacen una condición.
reverse	Invierte el orden de los elementos de una cadena o matriz.
merge	Combina varios objetos o elementos JSON en una matriz.

Funciones de comparación lógica

Función	Explicación
and	Operador lógico and. Devuelve true si todas las expresiones especificadas se evalúan como true.
equals	Operador equal de comparación. Devuelve true si los valores especificados son iguales.
empty	Comprueba si el destino está vacío.
greater	Operador de comparación mayor que. Devuelve true si el primer valor es mayor o devuelve false si es menor.
greaterOrEquals	Operador de comparación mayor o igual que. Devuelve true si el primer valor es mayor o igual o devuelve false si el primer valor es menor.
if	Comprueba si una expresión es true o false. En función del resultado, devuelve un valor especificado.
less	Operador de comparación menor que. Devuelve true si el primer valor es menor o devuelve false si el primer valor es mayor.
lessOrEquals	Operador de comparación menor o igual que. Devuelve true si el primer valor es menor o igual o devuelve false si el primer valor es mayor.
not	Operador no lógico. Devuelve true si la expresión es false o devuelve false si es true.
or	Operador OR lógico. Devuelve true si al menos una expresión es true o devuelve false si todas son false.
exists	Evalúa la veracidad de una expresión.

Funciones de conversión

Función	Explicación
float	Devuelve la representación de número de punto flotante de la cadena especificada.
int	Devuelve la representación entera de la cadena especificada.
string	Devuelve la versión de cadena del valor especificado en un formato de configuración regional opcional.
bool	Devuelve la representación booleana de la cadena especificada.
createArray	Crea una matriz a partir de varias entradas.
json	Devuelve el valor o el objeto de tipo Notación de objetos JavaScript (JSON) de una cadena o XML.
base64	Devuelve la versión codificada en base64 de una cadena o una matriz de bytes.
base64ToBinary	Devuelve la versión binaria de una cadena codificada en base64.
base64ToString	Devuelve la versión de cadena de una cadena codificada en base64.
binary	Devuelve la versión binaria de un valor de entrada.
dataUri	Devuelve el URI de un valor de entrada.
dataUriToBinary	Devuelve la versión binaria de un URI de datos.
dataUriToString	Devuelve la versión de cadena de un URI de datos.
uriComponent	Devuelve la versión codificada con el URI de un valor de entrada mediante la sustitución de los caracteres no seguros de la dirección URL por caracteres de escape.
uriComponentToString	Devuelve la versión de cadena de una cadena codificada con el URI.
xml	Devuelve la versión XML de una cadena.
formatNumber	Dar formato a un valor al número más cercano al número especificado de dígitos fraccionarios y una configuración regional especificada opcional.
jsonStringify	Devuelve la versión de cadena JSON de un valor.
stringOrValue Wrap string interpolation para obtener el valor real. Por ejemplo, stringOrValue('${1}') devuelve el número 1, mientras stringOrValue('${1} item') que devuelve la cadena "1 elemento".

Funciones matemáticas

Función	Explicación
abs	Devuelve el valor absoluto de un número especificado.
agregar	Operador matemático de adición. Devuelve el resultado de sumar dos números (caso de número puro) o concatenar dos o más cadenas.
div	Operador matemático de división. Devuelve el resultado entero de dividir dos números.
max	Devuelve el valor mayor de una colección.
min	Devuelve el valor menor de una colección.
mod	Devuelve el resto de dividir dos números.
mul	Operador matemático de multiplicación. Devuelve el producto de multiplicar dos números.
rand	Devuelve un número aleatorio entre los valores mínimo y máximo especificados.
sqrt	Devuelve la raíz cuadrada de un número especificado.
sub	Operador matemático de resta. Devuelve el resultado de restar el segundo número del primero.
sum	Devuelve la suma de los números de una matriz.
range	Devuelve una matriz de enteros que comienza en un entero especificado.
exp	Devuelve la exponenciación de un número a otro.
average	Devuelve el número promedio de una matriz numérica.
floor	Devuelve el mayor valor integral menor o igual que el número especificado.
ceiling	Devuelve el menor valor integral mayor o igual que el número especificado.
round	Redondea un valor al entero más próximo o al número especificado de dígitos fraccionarios.

Funciones de fecha y hora

Función	Explicación
addDays	Agrega un número específico de días a una marca de tiempo en un formato local opcional.
addHours	Agrega un número específico de horas a una marca de tiempo en un formato local opcional.
addMinutes	Agrega un número específico de minutos a una marca de tiempo determinada en un formato local opcional.
addSeconds	Agrega un número especificado de segundos a una marca de tiempo determinada.
dayOfMonth	Devuelve el día de un mes para una marca de tiempo o una expresión Timex determinada.
dayOfWeek	Devuelve el día de la semana de una marca de tiempo determinada.
dayOfYear	Devuelve el día del año de una marca de tiempo determinada.
formatDateTime	Devuelve una marca de tiempo en un formato de configuración regional opcional.
formatEpoch	Devuelve una marca de tiempo en un formato local opcional de la hora Epoch de UNIX (hora UNIX, hora POSIX).
formatTicks	Devuelve una marca de tiempo en un formato de configuración regional opcional a partir de tics.
subtractFromTime	Resta un número de unidades de tiempo de una marca de tiempo en un formato local opcional.
utcNow	Devuelve la marca de tiempo actual como cadena en formato local opcional.
dateReadBack	Usa la biblioteca de fecha y hora para proporcionar una lectura de la fecha.
month	Devuelve el mes de la marca de tiempo determinada.
date	Devuelve la fecha de una marca de tiempo determinada.
year	Devuelve el año de la marca de tiempo especificada.
getTimeOfDay	Devuelve la hora del día de una marca de tiempo determinada.
getFutureTime	Devuelve la marca de tiempo actual en un formato local opcional más las unidades de tiempo especificadas.
getPastTime	Devuelve la marca de tiempo actual en un formato local opcional menos las unidades de tiempo especificadas.
addToTime	Agrega un número de unidades de tiempo a una marca de tiempo en un formato de configuración regional opcional.
convertFromUTC	Convierte una marca de tiempo en un formato de configuración local opcional de la hora universal coordinada (UTC).
convertToUTC	Convierte una marca de tiempo en un formato de configuración local opcional a Hora universal coordinada (UTC).
startOfDay	Devuelve el inicio del día para una marca de tiempo en un formato de configuración regional opcional.
startOfHour	Devuelve el inicio de la hora para una marca de tiempo en un formato de configuración regional opcional.
startOfMonth	Devuelve el inicio del mes de una marca de tiempo en un formato local opcional.
ticks	Devuelve el valor de la propiedad ticks de una marca de tiempo determinada.
ticksToDays	Convierte un valor de propiedad ticks en el número de días.
ticksToHours	Convierte un valor de propiedad ticks en el número de horas.
ticksToMinutes	Convierte un valor de propiedad ticks en el número de minutos.
dateTimeDiff	Devuelve la diferencia en tics entre dos marcas de tiempo.
getPreviousViableDate	Devuelve la fecha viable anterior de una expresión Timex basada en la fecha actual y una zona horaria especificada opcionalmente.
getNextViableDate	Devuelve la siguiente fecha viable de una expresión Timex basada en la fecha actual y una zona horaria especificada opcionalmente.
getPreviousViableTime	Devuelve la hora viable anterior de una expresión Timex basada en la hora actual y una zona horaria especificada opcionalmente.
getNextViableTime	Devuelve la siguiente hora viable de una expresión Timex basada en la hora actual y una zona horaria especificada opcionalmente.

Funciones Timex

Función	Explicación
isPresent	Devuelve true si la expresión TimexProperty o Timex hace referencia al presente.
isDuration	Devuelve true si la expresión TimexProperty o Timex hace referencia a una duración.
isTime	Devuelve true si la expresión TimexProperty o Timex hace referencia a una hora.
isDate	Devuelve true si la expresión TimexProperty o Timex hace referencia a una fecha.
isTimeRange	Devuelve true si la expresión TimexProperty o Timex hace referencia a un intervalo de tiempo.
isDateRange	Devuelve true si la expresión TimexProperty o Timex hace referencia a un intervalo de fechas.
isDefinite	Devuelve true si la expresión TimexProperty o Timex hace referencia a un día definitivo.
Resolución	Devuelve una cadena de una expresión TimexProperty o Timex determinada si hace referencia a una hora válida. La hora válida contiene horas, minutos y segundos.

Funciones de análisis de URI

Función	Explicación
uriHost	Devuelve el valor de host de un identificador uniforme de recursos (URI).
uriPath	Devuelve el valor de ruta de acceso de un identificador uniforme de recursos (identificador URI).
uriPathAndQuery	Devuelve los valores de ruta de acceso y consulta de un identificador uniforme de recursos (URI).
uriPort	Devuelve el valor de puerto de un identificador uniforme de recursos (URI).
uriQuery	Devuelve el valor de consulta de un identificador uniforme de recursos (identificador URI).
uriScheme	Devuelve el valor de esquema de un identificador uniforme de recursos (URI).

Funciones de construcción y manipulación de objetos

Función	Explicación
addProperty	Agrega una propiedad y su valor o un par nombre-valor a un objeto JSON y devuelve el objeto actualizado.
removeProperty	Quita una propiedad de un objeto JSON y devuelve el objeto actualizado.
setProperty	Establece el valor de propiedad de un objeto JSON y devuelve el objeto actualizado.
getProperty	Devuelve el valor de una propiedad o propiedad raíz especificada de un objeto JSON.
coalesce	Devuelve el primer valor distinto de null de uno o más parámetros.
xPath	Comprueba el código XML de los nodos o valores que coinciden con una expresión XPath (XML Path Language) y devuelve los nodos o valores coincidentes.
jPath	Comprueba JSON o una cadena JSON para ver los nodos o el valor que coinciden con una expresión de ruta de acceso y devuelve los nodos coincidentes.
setPathToValue	Establece el valor de una ruta de acceso específica y devuelve el valor.

Funciones de expresiones regulares

Función	Explicación
isMatch	Devuelve true si una cadena coincide con un patrón de expresión regular común.

Funciones de comprobación de tipos

Función	Explicación
EOL	Devuelve el texto de la secuencia final de la línea (EOL).
isInteger	Devuelve true si la entrada especificada es un número entero
isFloat	Devuelve true si la entrada especificada es un número de punto flotante
isBoolean	Devuelve true si la entrada especificada es un valor booleano.
isArray	Devuelve true si la entrada especificada es una matriz.
isObject	Devuelve true si la entrada especificada es un objeto.
isDateTime	Devuelve true si la entrada especificada es una marca de tiempo con formato UTC ISO.
isString	Devuelve true si la entrada especificada es una cadena.

Funciones precompiladas ordenadas alfabéticamente

abs

Devuelve el valor absoluto del número especificado.

abs(<number>)

Parámetro	Obligatorio	Type	Description
<number>	Sí	number	Número para obtener el valor absoluto de

Valor devuelto	Tipo	Descripción
<result>	number	Resultado de calcular el valor absoluto.

Ejemplos

En estos ejemplos se calcula el valor absoluto:

abs(3.12134)
abs(-3.12134)

Y ambos devuelven el resultado 3.12134.

add

Devuelve el resultado de sumar dos o más números (caso de número puro) o concatenar dos o más cadenas (otro caso).

add(<item1>, <item2>, ...)

Parámetro	Obligatorio	Type	Descripción
<item1>, <item2>,...	Sí	cualquiera	items

Valor devuelto	Tipo	Descripción
<resultado-de-la-suma>	número o cadena	Resultado de sumar los números especificados o concatenar el resultado.

Ejemplo

Este ejemplo suma los números especificados:

add(1, 1.5)

Y devuelve el resultado 2,5.

En este ejemplo se concatenan los elementos especificados:

add('hello',null)
add('hello','world')

Y devuelve los resultados.

• hello
• helloworld

addDays

Agrega un número de días a una marca de tiempo en un formato de configuración regional opcional.

addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo, que debe ser el formato UTC ISO estándar AAAA-MM-DDTHH:mm:ss.fffZ
<días>	Sí	integer	Número positivo o negativo de días que desea agregar
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo más el número de días especificado

Ejemplo 1

Este ejemplo agrega 10 días a la marca de tiempo especificada:

addDays('2018-03-15T13:00:00.000Z', 10)

Y devuelve el resultado 2018-03-25T00:00:00.000Z.

Ejemplo 2

Este ejemplo resta cinco días a la marca de tiempo especificada:

addDays('2018-03-15T00:00:00.000Z', -5)

Y devuelve el resultado 2018-03-10T00:00:00.000Z.

Ejemplo 3

En este ejemplo se agrega 1 día a la marca de tiempo especificada en la configuración regional de-DE:

addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')

Y devuelve el resultado 16.03.18 13:00:00.

addHours

Agrega una serie de horas a una marca de tiempo en un formato de configuración regional opcional.

addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<horas>	Sí	integer	Número positivo o negativo de horas que desea agregar
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo más el número de horas especificado

Ejemplo 1

Este ejemplo agrega 10 horas a la marca de tiempo especificada:

addHours('2018-03-15T00:00:00.000Z', 10)

Y devuelve el resultado 2018-03-15T10:00:00.000Z.

Ejemplo 2

Este ejemplo resta cinco horas a la marca de tiempo especificada:

addHours('2018-03-15T15:00:00.000Z', -5)

Y devuelve el resultado 2018-03-15T10:00:00.000Z.

Ejemplo 3

Este ejemplo agrega 2 horas a la marca de tiempo especificada en la configuración regional de-DE:

addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')

Y devuelve el resultado 15.03.18 15:00:00.

addMinutes

Agrega un número de minutos a una marca de tiempo en un formato de configuración regional opcional.

addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<minutos>	Sí	integer	Número positivo o negativo de minutos que desea agregar
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo más el número de minutos especificado

Ejemplo 1

Este ejemplo agrega 10 minutos a la marca de tiempo especificada:

addMinutes('2018-03-15T00:10:00.000Z', 10)

Y devuelve el resultado 2018-03-15T00:20:00.000Z.

Ejemplo 2

Este ejemplo resta cinco minutos a la marca de tiempo especificada:

addMinutes('2018-03-15T00:20:00.000Z', -5)

Y devuelve el resultado 2018-03-15T00:15:00.000Z.

Ejemplo 3

Este ejemplo agrega 30 minutos a la marca de tiempo especificada en la configuración regional de-DE:

addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')

Y devuelve el resultado 15.03.18 13:30:00.

addOrdinal

Devuelve el número ordinal del número de entrada.

addOrdinal(<number>)

Parámetro	Obligatorio	Type	Description
<number>	Sí	integer	Números que se van a convertir en un número ordinal

Valor devuelto	Tipo	Descripción
<result>	string	Número ordinal convertido a partir del número de entrada

Ejemplo

addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)

Y, respectivamente, devuelve estos resultados:

• 11°
• 12°
• 13°
• 21°
• 22°
• 23°

addProperty

Agrega una propiedad y su valor o un par de nombre y valor a un objeto JSON y devuelve el objeto actualizado. Si el objeto ya existe en tiempo de ejecución, la función genera un error.

addProperty('<object>', '<property>', value)

Parámetro	Obligatorio	Type	Description
<objeto>	Sí	objeto	Objeto JSON al que desea agregar una propiedad
<propiedad>	Sí	string	Nombre de la propiedad que se va a agregar
<value>	Sí	cualquiera	El valor de la propiedad.

Valor devuelto	Tipo	Descripción
<objeto-actualizado>	objeto	Objeto JSON actualizado después de agregar una nueva propiedad

Ejemplo

En este ejemplo se agrega la propiedad accountNumber al objeto customerProfile, que se convierte en JSON con la función json(). La función asigna un valor generado por la función newGuid() y devuelve el objeto actualizado:

addProperty(json('customerProfile'), 'accountNumber', newGuid())

addSeconds

Agrega un número de segundos a una marca de tiempo.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<segundos>	Sí	integer	Número positivo o negativo de segundos que desea agregar
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo más el número de segundos especificado

Ejemplo 1

Este ejemplo agrega 10 segundos a la marca de tiempo especificada:

addSeconds('2018-03-15T00:00:00.000Z', 10)

Y devuelve el resultado 2018-03-15T00:00:10.000Z.

Ejemplo 2

Este ejemplo resta cinco segundos a la marca de tiempo especificada:

addSeconds('2018-03-15T00:00:30.000Z', -5)

Y devuelve el resultado 2018-03-15T00:00:25.000Z.

addToTime

Agrega un número de unidades de tiempo a una marca de tiempo en un formato de configuración regional opcional. Consulte también getFutureTime().

addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<intervalo>	Sí	integer	Número de unidades de tiempo especificadas que se va a agregar
<unidad_de_tiempo>	Sí	string	Unidad de tiempo que se usará con intervalo. Las unidades posibles son "Second", "Minute", "Hour", "Day", "Week", "Month" y "Year".
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo más el número de unidades de tiempo especificadas con el formato determinado.

Ejemplo 1

Este ejemplo agrega un día a la marca de tiempo determinada.

addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')

Y devuelve el resultado 2018-01-02T00:00:00.000Z.

Ejemplo 2

Este ejemplo agrega dos semanas a la marca de tiempo especificada.

addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')

Y devuelve el resultado con el formato "MM-DD-AA" como 01-15-18.

all

Determina si todos los elementos de una secuencia satisfacen una condición.

all(<sequence>, <item>, <condition>)

Parámetro	Obligatorio	Type	Descripción
<secuencia>	Sí	objeto	Secuencia que se va a evaluar.
<item>	Sí	string	Hace referencia a los elementos que se van a evaluar en la secuencia.
<condition>	Sí	expresión	La expresión para evaluar la condición.

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si todos los elementos cumplen una condición. Devuelve false si al menos uno no lo hace.

Ejemplos

Estos ejemplos determinan si todos los elementos de una secuencia satisfacen una condición:

all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))

Y devuelven los resultados siguientes, respectivamente:

• false, porque ambos elementos de la secuencia no son enteros.
• true, porque ambos elementos de la secuencia son enteros.

y

Comprueba si todas las expresiones son true. Devuelve true si todas las expresiones son true o devuelve false si al menos una expresión es false.

and(<expression1>, <expression2>, ...)

Parámetro	Obligatorio	Type	Descripción
<expression1>, <expression2>, ...	Sí	Boolean	Expresiones que se van a comprobar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si todas las expresiones son true. Devuelve false si al menos una expresión es false.

Ejemplo 1

Estos ejemplos comprueban si los valores booleanos especificados son todos verdaderos:

and(true, true)
and(false, true)
and(false, false)

Y, respectivamente, devuelve estos resultados:

• Ambas expresiones son true, por lo que las funciones devuelven true.
• Una expresión es falsa, por lo que la función devuelve false.
• ambas expresiones son falsas, por lo que la función devuelve false.

Ejemplo 2

Estos ejemplos comprueban si las expresiones especificadas son todas verdaderas:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

Y, respectivamente, devuelve estos resultados:

• Ambas expresiones son true, por lo que las funciones devuelven true.
• Una expresión es falsa, por lo que la función devuelve false.
• Ambas expresiones son falsas, por lo que la función devuelve false.

cualquiera

Determina si algunos de los elementos de una secuencia cumplen una condición.

all(<sequence>, <item>, <condition>)

Parámetro	Obligatorio	Type	Descripción
<secuencia>	Sí	objeto	Secuencia que se va a evaluar.
<item>	Sí	string	Hace referencia a los elementos que se van a evaluar en la secuencia.
<condition>	Sí	expresión	La expresión para evaluar la condición.

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si todos los elementos cumplen la condición. Devuelve false si al menos uno no lo hace.

Ejemplos

Estos ejemplos determinan si todos los elementos de una secuencia satisfacen una condición:

any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))

Y devuelven los resultados siguientes, respectivamente:

• true, porque al menos un elemento de la secuencia es un entero.
• false, porque ninguno de los elementos de la secuencia es un entero.

average

Devuelve el número promedio de una matriz numérica.

average(<numericArray>)

Parámetro	Obligatorio	Type	Descripción
<numericArray>	Sí	matriz de número	Matriz de entrada para calcular el promedio

Valor devuelto	Tipo	Descripción
<average-of-array>	number	Valor promedio de la matriz determinada

Ejemplo

En este ejemplo se calcula el promedio de la matriz en createArray():

average(createArray(1,2,3))

Y devuelve el resultado 2.

base64

Devuelve la versión codificada en base64 de una cadena o una matriz de bytes.

base64('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	cadena o matriz de bytes	Cadena de entrada

Valor devuelto	Tipo	Descripción
<cadena-en-base64>	string	Versión codificada en base64 de la cadena de entrada

Ejemplo 1

Este ejemplo convierte la cadena hello en una cadena codificada en base64:

base64('hello')

Y devuelve el resultado "aGVsbG8=".

Ejemplo 2

En este ejemplo se toma byteArr, que es igual a new byte[] { 3, 5, 1, 12 }:

base64('byteArr')

Y devuelve el resultado "AwUBDA==".

base64ToBinary

Devuelve la matriz binaria de una cadena codificada en base64.

base64ToBinary('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena con codificación base64 que se va a convertir

Valor devuelto	Tipo	Descripción
<binario-de-cadena-en-base64>	byte array	Versión binaria de la cadena codificada en base64

Ejemplo

Este ejemplo convierte la cadena codificada en base64 AwUBDA== en una cadena binaria:

base64ToBinary('AwUBDA==')

Y devuelve el resultado new byte[] { 3, 5, 1, 12 }.

base64ToString

Devuelve la versión de cadena de una cadena codificada en base64, descodificando dicha cadena en base64.

base64ToString('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena con codificación base64 que se va a decodificar

Valor devuelto	Tipo	Descripción
<cadena-base64-decodificada>	string	Versión de cadena de una cadena codificada en base64

Ejemplo

Este ejemplo convierte la cadena codificada en base64 aGVsbG8= en una cadena descodificada:

base64ToString('aGVsbG8=')

Y devuelve el resultado hello.

binary

Devuelve la versión binaria de una cadena.

binary('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena que se va a convertir

Valor devuelto	Tipo	Descripción
<binario-del-valor-de-entrada>	byte array	Versión binaria de la cadena especificada

Ejemplo

Este ejemplo convierte la cadena hello en una cadena binaria:

binary('hello')

Y devuelve el resultado new byte[] { 104, 101, 108, 108, 111 }.

bool

Devuelve la versión booleana de un valor.

bool(<value>)

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	cualquiera	Valor que se va a convertir

Valor devuelto	Tipo	Descripción
true o false	Booleano	Versión booleana del valor especificado

Ejemplo

Estos ejemplos convierten los valores especificados en valores booleanos:

bool(1)
bool(0)

Y, respectivamente, devuelve estos resultados:

• true
• false

ceiling

Devuelve el mayor valor integral menor o igual que el número especificado.

ceiling('<number>')

Parámetro	Obligatorio	Type	Description
<number>	Sí	number	Un número de entrada

Valor devuelto	Tipo	Descripción
<integer-value>	integer	El número entero más grande mayor o igual que el número introducido

Ejemplo

Este ejemplo devuelve el número integral más grande menor o igual que el número 10.333:

ceiling(10.333)

Y devuelve el número entero 11.

coalesce

Devuelve el primer valor distinto de null de uno o más parámetros. Las cadenas vacías, las matrices vacías y los objetos vacíos no son nulos.

coalesce(<object**1>, <object**2>, ...)

Parámetro	Obligatorio	Type	Descripción
<object**1>, <object**2>, ...	Sí	cualquiera (se aceptan tipos mixtos)	Uno o más elementos para comprobar si hay valores NULL

Valor devuelto	Tipo	Descripción
<primer-elemento-no-NULL>	cualquiera	Primer elemento o valor que no sea NULL. Si todos los parámetros son NULL, esta función devuelve NULL.

Ejemplo

Estos ejemplos devuelven el primer valor distinto de NULL de los valores especificados o NULL cuando todos los valores son NULL:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

Y respectivamente devuelven:

• true
• hello
• nulo

concat

Combina dos o más objetos y devuelve la cadena combinada de objetos en una lista o cadena.

concat('<text1>', '<text2>', ...)

Parámetro	Obligatorio	Type	Descripción
<object1>, <object2>, ...	Sí	cualquiera	Al menos dos objetos para concat.

Valor devuelto	Tipo	Descripción
<object1object2...>	Cadena o lista	Cadena o lista combinada. Se omiten los valores null.

Valores devueltos esperados:

• Si todos los elementos son listas, se devolverá una lista.
• Si existe un elemento que no es una lista, se devolverá una cadena.
• Si un valor es NULL, se omite y no se concatena.

Ejemplo

Este ejemplo combina las cadenas Hello y World:

concat('Hello', 'World')

Y devuelve el resultado HelloWorld.

Ejemplo 2

En este ejemplo se combinan las listas [1,2] y [3,4]:

concat([1,2],[3,4])

Y devuelve el resultado [1,2,3,4].

Ejemplo 3

Estos ejemplos combinan objetos de diferentes tipos:

concat('a', 'b', 1, 2)
concat('a', [1,2])

Y devuelven los resultados siguientes, respectivamente:

• Cadena ab12.
• El objeto aSystem.Collections.Generic.List 1[System.Object]. Esto es ilegible y es mejor evitarlo.

Ejemplo 4

Estos ejemplos combinan objetos null:

concat([1,2], null)
concat('a', 1, null)

Y devuelven los resultados siguientes, respectivamente:

• Lista [1,2].
• Cadena a1.

contains

Comprueba si una colección contiene un elemento específico. Devuelve true si se encuentra el elemento o devuelve false si no se encuentra. Esta función distingue mayúsculas de minúsculas.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Esta función funciona en los tipos de colección siguientes:

• Una cadena para buscar una subcadena
• Una matriz para buscar un valor
• Un diccionario para buscar una clave

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena, matriz o diccionario	Colección que se va a comprobar
<value>	Sí	cadena, matriz o diccionario, respectivamente	Elemento que se va a buscar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si se encuentra el elemento. Devuelve false si no se encuentra.

Ejemplo 1

Este ejemplo comprueba la cadena hello world para buscar la subcadena world:

contains('hello world', 'world')

Y devuelve el resultado true.

Ejemplo 2

Este ejemplo devuelve la cadena hello world para la subcadena universe:

contains('hello world', 'universe')

Y devuelve el resultado false.

count

Devuelve el número de elementos de una colección.

count('<collection>')
count([<collection>])

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena o matriz	Colección con los elementos que se van a contar

Valor devuelto	Tipo	Descripción
<length-or-count>	integer	Número de elementos de la colección

Ejemplos:

Estos ejemplos cuentan el número de elementos de estas colecciones:

count('abcd')
count(createArray(0, 1, 2, 3))

Y ambos devuelven el resultado 4.

countWord

Devuelve el número de palabras de una cadena

countWord('<text>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que se va a contar

Valor devuelto	Tipo	Descripción
<recuento>	integer	Número de palabras en la cadena

Ejemplo

Este ejemplo cuenta el número de palabras de la cadena hello world:

countWord("hello word")

Y devuelve el resultado 2.

convertFromUTC

Convierte una marca de tiempo en un formato local opcional de Hora Universal Coordinada (UTC) a una zona horaria de destino.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<zona_horaria_de_destino>	Sí	string	Nombre de la zona horaria de destino. Compatible con las zonas horarias de Windows y IANA.
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato "o", yyyy-MM-ddTHH:mm:ss.fffffffK, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-convertida>	string	Marca de tiempo convertida a la zona horaria de destino

Ejemplos:

Estos ejemplos convierten de la hora UTC a la hora estándar del Pacífico:

convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')

Y devuelven estos resultados, respectivamente:

• 02-01-18
• 2018-01-01T18:00:00.0000000

Ejemplo 2

En este ejemplo se convierte una marca de tiempo en la configuración regional en-US de UTC a hora estándar del Pacífico:

convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')

Y devuelve el resultado el lunes 1 de enero de 2018.

convertToUTC

Convierte una marca de tiempo en un formato local opcional de hora universal coordinada (UTC) desde la zona horaria de origen.

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<zona_horaria_de_origen>	Sí	string	Nombre de la zona horaria de destino. Compatible con las zonas horarias de Windows y IANA.
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-convertida>	string	Marca de tiempo convertida a la zona horaria de destino

Ejemplo

En este ejemplo se convierte una marca de tiempo a UTC de la hora estándar del Pacífico

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')

Y devuelve el resultado 2018-01-01T08:00:00.000Z.

Ejemplo 2

En este ejemplo se convierte una marca de tiempo en la configuración regional de-DE de UTC a hora estándar del Pacífico:

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')

Y devuelve el resultado 01.01.18 08:00:00.

createArray

Devuelve una matriz a partir de varias entradas.

createArray('<object1>', '<object2>', ...)

Parámetro	Obligatorio	Type	Descripción
<object1>, <object2>, ...	Sí	cualquiera, pero no mixtos	Al menos dos elementos para crear la matriz

Valor devuelto	Tipo	Descripción
[<object1>, <object2>, ...]	array	Matriz creada a partir de todos los elementos de entrada

Ejemplo

Este ejemplo crea una matriz a partir de estas entradas:

createArray('h', 'e', 'l', 'l', 'o')

Y devuelve el resultado [h ,e, l, l, o].

dataUri

Devuelve un identificador uniforme de recursos (URI) de datos de una cadena.

dataUri('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena que se va a convertir

Valor devuelto	Tipo	Descripción
[<date-uri>]	string	Identificador URI de datos de la cadena de entrada

Ejemplo

dataUri('hello')

Devuelve el resultado data:text/plain;charset=utf-8;base64,aGVsbG8=.

dataUriToBinary

Devuelve la versión binaria de un identificador uniforme de recursos (URI) de datos.

dataUriToBinary('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Identificador URI de datos que se va a convertir

Valor devuelto	Tipo	Descripción
[<binary-for-data-uri>]	byte array	Versión binaria del identificador URI de datos

Ejemplo

Este ejemplo crea una versión binaria del identificador URI de datos siguiente:

dataUriToBinary('aGVsbG8=')

Y devuelve el resultado new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }.

dataUriToString

Devuelve la versión de cadena de un identificador uniforme de recursos (URI) de datos.

dataUriToString('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Identificador URI de datos que se va a convertir

Valor devuelto	Tipo	Descripción
[<string-for-data-uri>]	string	Versión de cadena del identificador URI de datos

Ejemplo

Este ejemplo crea una cadena a partir del URI de datos siguiente:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Y devuelve el resultado hello.

date

Devuelve la fecha de una marca de tiempo especificada en formato m/dd/aaaa.

date('<timestramp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo

Valor devuelto	Tipo	Descripción
<date>	string	Fecha de la marca de tiempo especificada

date('2018-03-15T13:00:00.000Z')

Devuelve el resultado 3-15-2018.

dateReadBack

Usa la biblioteca de fecha y hora para proporcionar una lectura de la fecha.

dateReadBack('<currentDate>', '<targetDate>')

Parámetro	Obligatorio	Type	Descripción
<currentDate>	Sí	string	Cadena que contiene la fecha actual
<targetDate>	Sí	string	Cadena que contiene la fecha de destino

Valor devuelto	Tipo	Descripción
<date-readback>	string	Lectura entre la fecha actual y la fecha de destino

Ejemplo 1

dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')

Devuelve el resultado tomorrow.

dateTimeDiff

Devuelve la diferencia en tics entre dos marcas de tiempo.

dateTimeDiff('<timestamp1>', '<timestamp2>')

Parámetro	Obligatorio	Type	Descripción
<timestamp1>	Sí	string	Primera cadena de marca de tiempo que se va a comparar
<timestamp2>	Sí	string	Segunda cadena de marca de tiempo que se va a comparar

Valor devuelto	Tipo	Descripción
<ticks>	number	La diferencia en tics entre dos marcas de tiempo

Ejemplo 1

En este ejemplo se devuelve la diferencia entre dos marcas de tiempo:

dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')

Y devuelve el número 315360000000000.

Ejemplo 2

En este ejemplo se devuelve la diferencia entre dos marcas de tiempo:

dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')

Devuelve el resultado -315360000000000. El valor es un número negativo.

dayOfMonth

Devuelve el día del mes de una marca de tiempo.

dayOfMonth('<timestamp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo

Valor devuelto	Tipo	Descripción
<día-del-mes>	integer	Día del mes de la marca de tiempo especificada

Ejemplo

Este ejemplo devuelve el número del día del mes de la marca de tiempo siguiente:

dayOfMonth('2018-03-15T13:27:36Z')

Y devuelve el resultado 15.

dayOfWeek

Devuelve el día de la semana de una marca de tiempo.

dayOfWeek('<timestamp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo

Valor devuelto	Tipo	Descripción
<día-de-la-semana>	integer	Día de la semana de la marca de tiempo especificada. El valor del domingo es 0, el del lunes es 1 y así sucesivamente.

Ejemplo

Este ejemplo devuelve el número del día de la semana de la marca de tiempo siguiente:

dayOfWeek('2018-03-15T13:27:36Z')

Y devuelve el resultado 3.

dayOfYear

Devuelve el día del año de una marca de tiempo.

dayOfYear('<timestamp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo

Valor devuelto	Tipo	Descripción
<día-del-año>	integer	Día del año de la marca de tiempo especificada

Ejemplo

Este ejemplo devuelve el número del día del año de la marca de tiempo siguiente:

dayOfYear('2018-03-15T13:27:36Z')

Y devuelve el resultado 74.

div

Devuelve el resultado entero de dividir dos números. Para devolver el resto, consulte mod().

div(<dividend>, <divisor>)

Parámetro	Obligatorio	Type	Descripción
<dividend>	Sí	number	Número que se va a dividir entre el divisor.
<divisor>	Sí	number	Número que divide el dividendo. No puede ser 0.

Valor devuelto	Tipo	Descripción
<resultado-cociente>	number	Resultado de dividir el primer número entre el segundo número

Ejemplo

Ambos ejemplos dividen el primer número entre el segundo número:

div(10, 5)
div(11, 5)

Y devuelve el resultado 2.

Existe cierta diferencia entre Javascript y el SDK de .NET. Por ejemplo, la expresión siguiente devolverá resultados diferentes en Javascript y el SDK de .NET:

Si uno de los parámetros es un valor float, el resultado también será FLOAT con .NET SDK.

Ejemplo

div(11.2, 2)

Devuelve el resultado 5.6.

Si uno de los parámetros es un valor float, el resultado será un INT con el SDK de Javascript.

Ejemplo

div(11.2, 2)

Devuelve el resultado 5.

La solución alternativa para Javascript para mantener un número determinado de posiciones decimales en los resultados es usar dicha expresión. Por ejemplo, para mantener 3 posiciones decimales:

float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))

empty

Comprueba si una instancia está vacía. Devuelve true si la entrada está vacía. Vacío significa:

• La entrada es NULL o no está definida.
• La entrada es una cadena NULL o vacía.
• La entrada es una colección de tamaño cero.
• La entrada es un objeto sin propiedades.

empty('<instance>')
empty([<instance>])

Parámetro	Obligatorio	Type	Descripción
<instance>	Sí	cualquiera	Instancia que se va a comprobar.

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true cuando la instancia está vacía.

Ejemplo

En estos ejemplos, se comprueba si la instancia especificada está vacía:

empty('')
empty('abc')
empty([1])
empty(null)

Y devuelven estos resultados, respectivamente:

• pasa una cadena vacía, por lo que la función devuelve true.
• pasa la cadena abc, por lo que la función devuelve false.
• Pasa la colección con un elemento, por lo que la función devuelve false.
• Pasa el objeto NULL, por lo que la función devuelve true.

endsWith

Comprueba si una cadena termina con una subcadena especificada. Devuelve true si se encuentra la subcadena o devuelve false si no se encuentra. Esta función no distingue entre mayúsculas y minúsculas.

endsWith('<text>', '<searchText>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que se va a comprobar
<texto_a_buscar>	Sí	string	Subcadena final que se va a buscar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true cuando se encuentra la subcadena final. Devuelve false si no se encuentra.

Ejemplo 1

Este ejemplo comprueba si la cadena hello world termina con la cadena world:

endsWith('hello world', 'world')

Y devuelve el resultado true.

Ejemplo 2

Este ejemplo comprueba si la cadena hello world termina con la cadena universe:

endsWith('hello world', 'universe')

Y devuelve el resultado false.

EOL

Devuelve el texto de la secuencia final de la línea (EOL).

EOL()

Valor devuelto	Tipo	Descripción
<IsOSPlatform>	string	Devuelve \r\n en Windows y \n en Mac y Linux.

Ejemplo

En este ejemplo se comprueba el final del texto de la secuencia de líneas:

EOL()

Y devuelve las cadenas siguientes:

• Windows: \r\n
• Mac or Linux: \n

equals

Comprueba si los valores, expresiones u objetos son equivalentes. Devuelve true si ambos son equivalentes o devuelve false si no lo son.

equals('<object1>', '<object2>')

Parámetro	Obligatorio	Type	Descripción
<object1>, <object2>	Sí	cualquiera	Valores, expresiones u objetos que se van a comparar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true cuando ambos son equivalentes. Devuelve false si no son equivalentes.

Ejemplo

Estos ejemplos comprueban si las entradas especificadas son equivalentes:

equals(true, 1)
equals('abc', 'abcd')

Y devuelve estos resultados, respectivamente:

• ambos valores son equivalentes, por lo que la función devuelve true.
• ambos valores no son equivalentes, por lo que la función devuelve false.

exists

Evalúa la veracidad de una expresión.

exists(expression)

Parámetro	Obligatorio	Type	Descripción
expression	Sí	expresión	Expresión para evaluar la veracidad

Valor devuelto	Tipo	Descripción
<true o false>	Booleano	Resultado de la evaluación de la expresión

Ejemplo

Este ejemplo evalúa la veracidad de foo = {"bar":"value"}:

exists(foo.bar)
exists(foo.bar2)

Y devuelven estos resultados, respectivamente:

• true
• false

exp

Devuelve la exponenciación de un número a otro.

exp(realNumber, exponentNumber)

Parámetro	Obligatorio	Type	Descripción
realNumber	Sí	number	Número real para calcular el exponente de
exponentNumber	Sí	number	Número de exponente

Valor devuelto	Tipo	Descripción
<result-exp>	number	Resultado de calcular el exponente de realNumber

Ejemplo

Este ejemplo se calcula el exponente:

exp(2, 2)

Y devuelve el resultado 4.

first

Devuelve el primer elemento de una cadena o una matriz.

first('<collection>')
first([<collection>])

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena o matriz	Colección en la que buscar el primer elemento

Valor devuelto	Tipo	Descripción
<primer-elemento-de-la-colección>	cualquiera	Primer elemento de la colección

Ejemplo

Estos ejemplos buscan el primer elemento de las colecciones siguientes:

first('hello')
first(createArray(0, 1, 2))

Y devuelven estos resultados, respectivamente:

• h
• 0

aplanar

Aplanar una matriz en valores que no son de matriz. Opcionalmente, puede establecer la profundidad máxima a la que se va a aplanar.

flatten([<collection>], '<depth>')

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	array	Colección que se va a aplanar
<depth>	No	number	Profundidad máxima a la que se va a aplanar. El valor predeterminado es infinito.

Valor devuelto	Tipo	Descripción
<new-collection>	array	Colección nueva cuyos elementos se han aplanado a una profundidad especificada que no es de matriz

Ejemplo 1

Este ejemplo aplana la matriz siguiente:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))

Y devuelve el resultado [1, 2, 3, 4, 5, 6].

Ejemplo 2

Este ejemplo aplana la matriz a una profundidad de 1:

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)

Y devuelve el resultado [1, 2, [3, 4], [5, 6]].

flotante

Convierte la versión de cadena de un número de punto flotante en un número de punto flotante. Solo se puede usar esta función al pasar parámetros personalizados a una aplicación, como una aplicación lógica. Se lanzará una excepción si la cadena no se puede convertir a FLOAT.

float('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena que contiene un número de punto flotante válido al que se va a convertir

Valor devuelto	Tipo	Descripción
<valor-de-tipo-float>	flotante	Número de punto flotante de la cadena especificada

Ejemplo

En este ejemplo se convierte la versión float de una cadena:

float('10.333')

Y devuelve el valor float 10,333.

floor

Devuelve el mayor valor integral menor o igual que el número especificado.

floor('<number>')

Parámetro	Obligatorio	Type	Description
<number>	Sí	number	Un número de entrada

Valor devuelto	Tipo	Descripción
<integer-value>	integer	El mayor valor integral que es menor o igual que el número introducido

Ejemplo

En este ejemplo se calcula el valor de piso del número 10,333:

floor(10.333)

Y devuelve el valor entero 10.

foreach

Funciona en cada elemento y devuelven la colección nueva.

foreach([<collection/instance>], <iteratorName>, <function>)

Parámetro	Obligatorio	Type	Descripción
<collection/instance>	Sí	matriz u objeto	Colección con los elementos
<iteratorName>	Sí	nombre de iterador	Elemento clave de la función de flecha
<function>	Sí	expresión	Función que contiene iteratorName

Valor devuelto	Tipo	Descripción
<new-collection>	array	Colección nueva en la que la función ha evaluado cada elemento

Ejemplo 1

Este ejemplo genera una colección nueva:

foreach(createArray(0, 1, 2, 3), x, x + 1)

Y devuelve el resultado [1, 2, 3, 4].

Ejemplo 2

Estos ejemplos generan una colección nueva:

foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

Y devuelve el resultado ['name:jack', 'age:15']. Tenga en cuenta que la segunda expresión es una expresión lambda, que algunas encuentran más legibles.

formatDateTime

Devuelve una marca de tiempo en un formato de configuración regional opcional.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-con-nuevo-formato>	string	Marca de tiempo actualizada en el formato especificado

Ejemplo 1

Este ejemplo convierte una marca de tiempo al formato especificado:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

Y devuelve el resultado 2018-03-15T12:00:00.

Ejemplo 2

En este ejemplo se convierte una marca de tiempo en la configuración regional de-DE:

formatDateTime('2018-03-15', '', 'de-DE')

Y devuelve el resultado 15.03.18 00:00:00.

formatEpoch

Devuelve una marca de tiempo en un formato local opcional en el formato especificado de hora UNIX (también conocido como hora Epoch, hora POSIX u hora Epoch de UNIX).

formatEpoch('<epoch>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<epoch>	Sí	number	Número Epoch.
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-con-nuevo-formato>	string	Marca de tiempo actualizada en el formato especificado

Ejemplo

Este ejemplo convierte una marca de tiempo Unix al formato especificado:

formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'

Y devuelve el resultado 2018-03-15T12:00:00.000 Z.

Ejemplo

En este ejemplo se convierte una marca de tiempo de Unix en la configuración regional de-DE:

formatEpoch(1521118800, '', 'de-DE')

Y devuelve el resultado 15.03.18 13:00:00.

formatNumber

Dar formato a un valor al número especificado de dígitos fraccionarios y una configuración regional especificada opcional.

formatNumber('<number>', '<precision-digits>', '<locale>'?)

Parámetro	Obligatorio	Type	Description
<number>	Sí	number	Un número de entrada
<dígitos de precisión>	Sí	integer	Número especificado de dígitos fraccionarios
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<return-value>	number	Valor devuelto de la entrada con formato en un número especificado de dígitos fraccionarios y una configuración regional especificada

Ejemplo 1

En este ejemplo se da formato al número de 10,333 a 2 dígitos fraccionarios:

formatNumber(10.333, 2)

Y devuelve la cadena 10.33.

Ejemplo 2

Estos ejemplos da formato a números a un número especificado de dígitos en la configuración regional en-US:

formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')

Y devuelven los resultados siguientes, respectivamente:

• 12.12
• 1.55
• 12.1230

formatTicks

Devuelve una marca de tiempo en un formato local opcional en el formato especificado a partir de los tics.

formatTicks('<ticks>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<epoch>	Sí	número (o bigint en Javascript)	El número de tics.
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-con-nuevo-formato>	string	Marca de tiempo actualizada en el formato especificado

Ejemplo 1

En este ejemplo, los tics se convierten al formato especificado:

formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')

Y devuelve el resultado 2020-05-06T11:47:00.000 Z.

Ejemplo 2

En este ejemplo, los tics se convierten al formato especificado en la configuración regional de-DE:

formatTicks(637243624200000000, '', 'de-DE')

Y devuelve el resultado 06.05.20 11:47:00.

getFutureTime

Devuelve la marca de tiempo actual en un formato local opcional más las unidades de tiempo especificadas.

getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<intervalo>	Sí	integer	Número de unidades de tiempo específicas que se van a sumar
<unidad_de_tiempo>	Sí	string	Unidad de tiempo que se usará con intervalo. Las unidades posibles son "Second", "Minute", "Hour", "Day", "Week", "Month" y "Year".
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo actual más el número de unidades de tiempo especificado

Ejemplo 1

Imagine que la marca de tiempo actual es 2019-03-01T00:00:00.000Z. El ejemplo siguiente suma cinco días a esa marca de tiempo:

getFutureTime(2, 'Week')

Y devuelve el resultado 2019-03-15T00:00:00.000Z.

Ejemplo 2

Imagine que la marca de tiempo actual es 2018-03-01T00:00:00.000Z. El ejemplo siguiente suma cinco días a la marca de tiempo y convierte el resultado en formato MM-DD-AA:

getFutureTime(5, 'Day', 'MM-DD-YY')

Y devuelve el resultado 03-06-18.

Ejemplo 3

Supongamos que la marca de tiempo actual es 2020-05-01T00:00:00.000Z y la configuración regional es de-DE. El ejemplo siguiente suma 1 día a esa marca de tiempo:

getFutureTime(1,'Day', '', 'de-DE')

Y devuelve el resultado 02.05.20 00:00:00.

getNextViableDate

Devuelve la siguiente fecha viable de una expresión Timex basada en la fecha actual y una zona horaria especificada opcionalmente.

getNextViableDate(<timexString>, <timezone>?)

Parámetro	Obligatorio	Type	Descripción
<timexString>	Sí	string	Cadena Timex de la fecha que se va a evaluar.
<timezone>	No	string	Zona horaria opcional.

Valor devuelto	Tipo	Descripción
<nextViableTime>	string	La siguiente fecha viable.

Ejemplos

Supongamos que la fecha es 2020-06-12 y la hora actual es 15:42:21.

En estos ejemplos se evalúa la cadena Timex para la siguiente fecha viable en función de la fecha y hora anteriores:

getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")

Y devuelve las siguientes cadenas respectivamente:

• 2020-12-20
• 2024-02-29

getNextViableTime

Devuelve la siguiente hora viable de una expresión Timex basada en la hora actual y una zona horaria especificada opcionalmente.

getNextViableTime(<timexString>, <timezone>?)

Parámetro	Obligatorio	Type	Descripción
<timexString>	Sí	string	Cadena Timex de la hora que se va a evaluar.
<timezone>	No	string	Zona horaria opcional.

Valor devuelto	Tipo	Descripción
<nextViableTime>	string	La próxima vez viable.

Ejemplos

Supongamos que la fecha es 2020-06-12 y la hora actual es 15:42:21.

En estos ejemplos se evalúa una cadena Timex para la próxima hora viable en función de la fecha y hora anteriores:

getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")

Y devuelve las siguientes cadenas respectivamente:

• T16:12:14
• T15:52:14

getPastTime

Devuelve la marca de tiempo actual menos las unidades de tiempo especificadas.

getPastTime(<interval>, <timeUnit>, '<format>'?)

Parámetro	Obligatorio	Type	Descripción
<intervalo>	Sí	integer	Número de unidades de tiempo especificadas que se va a sustraer
<unidad_de_tiempo>	Sí	string	Unidad de tiempo que se usará con intervalo. Las unidades posibles son "Second", "Minute", "Hour", "Day", "Week", "Month" y "Year".
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo actual menos el número de unidades de tiempo especificado

Ejemplo 1

Imagine que la marca de tiempo actual es 2018-02-01T00:00:00.000Z. Este ejemplo resta cinco días a esa marca de tiempo:

getPastTime(5, 'Day')

Y devuelve el resultado 2019-01-27T00:00:00.000Z.

Ejemplo 2

Imagine que la marca de tiempo actual es 2018-03-01T00:00:00.000Z. En este ejemplo se restan cinco días a la marca de tiempo en el formato MM-DD-AAA:

getPastTime(5, 'Day', 'MM-DD-YY')

Y devuelve el resultado 02-26-18.

Ejemplo 3

Supongamos que la marca de tiempo actual es 2020-05-01T00:00:00.000Z y la configuración regional es de-DE. En el ejemplo siguiente se resta 1 día de la marca de tiempo:

getPastTime(1,'Day', '', 'de-DE')

Y devuelve el resultado 31.04.20 00:00:00.

getPreviousViableDate

Devuelve la fecha viable anterior de una expresión Timex basada en la fecha actual y una zona horaria especificada opcionalmente.

getPreviousViableDate(<timexString>, <timezone>?)

Parámetro	Obligatorio	Type	Descripción
<timexString>	Sí	string	Cadena Timex de la fecha que se va a evaluar.
<timezone>	No	string	Zona horaria opcional.

Valor devuelto	Tipo	Descripción
<previousViableDate>	string	Fecha viable anterior.

Ejemplos

Supongamos que la fecha es 2020-06-12 y la hora actual es 15:42:21.

En estos ejemplos se evalúa una cadena Timex para la fecha viable anterior en función de la fecha y hora anteriores:

getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")

Y devuelve las siguientes cadenas respectivamente:

• 2019-12-20
• 2020-02-29

getPreviousViableTime

Devuelve la hora viable anterior de una expresión Timex basada en la fecha actual y una zona horaria especificada opcionalmente.

getPreviousViableTime(<timexString>, <timezone>?)

Parámetro	Obligatorio	Type	Descripción
<timexString>	Sí	string	Cadena Timex de la hora que se va a evaluar.
<timezone>	No	string	Zona horaria opcional.

Valor devuelto	Tipo	Descripción
<previousViableTime>	string	Hora viable anterior.

Ejemplos

Supongamos que la fecha es 2020-06-12 y la hora actual es 15:42:21.

Estos ejemplos evalúan una cadena Timex para la hora viable anterior en función de la fecha y hora anteriores:

getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')

Y devuelve las siguientes cadenas respectivamente:

• T14:52:14
• T15:12:14

getProperty

Devuelve el valor de una propiedad especificada o la propiedad raíz de un objeto JSON.

Devuelve el valor de una propiedad especificada

getProperty(<JSONObject>, '<propertyName>')

Parámetro	Obligatorio	Type	Descripción
<JSONObject>	Sí	objeto	El objeto JSON contiene la propiedad y los valores.
<propertyName>	No	string	Nombre de la propiedad opcional desde la que se va a acceder a los valores.

Valor devuelto	Tipo	Descripción
value	string	Valor de la propiedad especificada en el objeto JSON.

Ejemplo

Digamos que tienes el siguiente objeto JSON:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

Este ejemplo recupera una propiedad especificada del anteriormente mencionado objeto JSON:

getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')

Y devuelve las siguientes cadenas respectivamente:

• a:b value
• d key

Devolver la propiedad raíz

getProperty('<propertyName>')

Parámetro	Obligatorio	Type	Descripción
<propertyName>	Sí	string	Nombre de la propiedad opcional para tener acceso a los valores desde el ámbito de memoria raíz.

Valor devuelto	Tipo	Descripción
value	string	Valor de la propiedad raíz en un objeto JSON.

Ejemplo

Digamos que tienes el siguiente objeto JSON:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

En este ejemplo se recupera la propiedad raíz del objeto JSON anterior:

getProperty("a:b")

Y devuelve la cadena a:b value.

getTimeOfDay

Devuelve la hora del día de una marca de tiempo determinada.

getTimeOfDay('<timestamp>')

La hora devuelta es una de las cadenas siguientes:

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo especificada

Valor devuelto	Tipo	Descripción
<time-of-day>	string	Hora del día de la marca de tiempo especificada

A continuación se enumeran las cadenas asociadas a la hora del día:

Hora del día	Marca de tiempo
midnight	12:00 a.m.
morning (por la mañana)	12:01 a.m. a 11:59 p.m.
afternoon	12:00 p.m.
evening	06:00 p.m. a 10:00 p.m.
noche	10:01 p.m. a 11:59 p.m.

Ejemplo

getTimeOfDay('2018-03-15T08:00:00.000Z')

Devuelve el resultado morning.

greater

Comprueba si el primer valor es mayor que el segundo. Devuelve true si el primer valor es mayor o devuelve false si es menor.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	Integer, Float o String	Primer valor para comprobar si es mayor que el segundo valor
<compareTo>	Sí	Integer, Float o String, respectivamente	Valor de comparación

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si el primer valor es mayor que el segundo. Devuelve false si el primer valor es igual o menor que el segundo.

Ejemplo

Estos ejemplos comprueban si el primer valor es mayor que el segundo:

greater(10, 5)
greater('apple', 'banana')

Y devuelven los resultados siguientes, respectivamente:

• true
• false

greaterOrEquals

Comprueba si el primer valor es mayor o igual que el segundo. Devuelve true cuando el primer valor es mayor o igual o devuelve false si el primer valor es menor.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	Integer, Float o String	Primer valor para comprobar si es mayor o igual que el segundo valor
<compareTo>	Sí	Integer, Float o String, respectivamente	Valor de comparación

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si el primer valor es mayor o igual que el segundo. Devuelve false si el primer valor es menor que el segundo.

Ejemplo

Estos ejemplos comprueban si el primer valor es mayor o igual que el segundo:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Y devuelven los resultados siguientes, respectivamente:

• true
• false

if

Comprueba si una expresión es true o false. En función del resultado, devuelve un valor especificado.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Parámetro	Obligatorio	Type	Descripción
<expression>	Sí	Boolean	Expresión que se va a evaluar
<valor_si_es_true>	Sí	cualquiera	Valor que se devuelve si la expresión es true
<valor_si_es_false>	Sí	cualquiera	Valor que se devuelve si la expresión es false

Valor devuelto	Tipo	Descripción
<valor-a-devolver-especificado>	cualquiera	Valor especificado que se devuelve en función de si la expresión es true o false

Ejemplo

Este ejemplo evalúa si equals(1,1) es true:

if(equals(1, 1), 'yes', 'no')

Y devuelve yes porque la expresión especificada devuelve true. En caso contrario, el ejemplo devuelve no.

indexOf

Devuelve la posición de inicio o valor de índice de una subcadena. Esta función distingue entre mayúsculas y minúsculas y los índices comienzan por el número 0.

indexOf('<text>', '<searchText>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	cadena o matriz	Cadena que contiene la subcadena que se va a buscar
<texto_a_buscar>	Sí	string	Subcadena que se va a buscar

Valor devuelto	Tipo	Descripción
<valor-de-índice>	integer	Posición de inicio o valor de índice de la subcadena especificada.
Si no se encuentra la cadena, devuelve el número -1.

Ejemplo 1

Este ejemplo busca el valor del índice de inicio de la subcadena world en la cadena hello world:

indexOf('hello world', 'world')

Y devuelve el resultado 6.

Ejemplo 2

Este ejemplo busca el valor del índice de inicio de la subcadena def en la matriz ['abc', 'def', 'ghi']:

indexOf(createArray('abc', 'def', 'ghi'), 'def')

Y devuelve el resultado 1.

indicesAndValues

Convierte una matriz u objeto en una matriz de objetos con la propiedad index (índice actual) y value. En el caso de las matrices, el índice es la posición en la matriz. En el caso de los objetos, es la clave para el valor.

indicesAndValues('<collection or object>')

Parámetro	Obligatorio	Type	Descripción
<colección u objeto>	Sí	matriz u objeto	Matriz u objeto original

Valor devuelto	Tipo	Descripción
<colección>	array	Nueva matriz. Cada elemento tiene dos propiedades: el índice con la posición en una matriz o la clave de un objeto y el valor correspondiente.

Ejemplo 1

Supongamos que tiene una lista { items: ["zero", "one", "two"] }. La función siguiente toma esa lista:

indicesAndValues(items)

Y devuelve una lista nueva:

[
  {
    index: 0,
    value: 'zero'
  },
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Ejemplo 2

Supongamos que tiene una lista { items: ["zero", "one", "two"] }. La función siguiente toma esa lista:

where(indicesAndValues(items), elt, elt.index >= 1)

Y devuelve una lista nueva:

[
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Ejemplo 3

Supongamos que tiene una lista { items: ["zero", "one", "two"] }. La función siguiente toma esa lista:

join(foreach(indicesAndValues(items), item, item.value), ',')

Y devuelve el resultado zero,one,two. Esta expresión tiene el mismo efecto que join(items, ',').

Ejemplo 4

Supongamos que tienes un objeto { user: {name: 'jack', age: 20} }. La función siguiente toma ese objeto:

indicesAndValues(user)

Y devuelve un objeto nuevo:

[
  {
    index: 'name',
    value: 'jack'
  },
  {
    index: 'age',
    value: 20
  }
]

int

Devuelve la versión como número entero de una cadena. Se producirá una excepción si la cadena no se puede convertir en un entero.

int('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena que se va a convertir

Valor devuelto	Tipo	Descripción
<resultado-de-número-entero>	integer	Versión como número entero de la cadena especificada

Ejemplo

Este ejemplo crea una versión como número entero de la cadena 10:

int('10')

Y devuelve el resultado como el número entero 10.

intersection

Devuelve una colección que tiene solo los elementos comunes en las colecciones especificadas. Para que aparezca en el resultado, un elemento debe aparecer en todas las colecciones que se pasan a esta función. Si uno o más elementos tienen el mismo nombre, el último elemento con ese nombre aparece en el resultado.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Parámetro	Obligatorio	Type	Descripción
<collection1>, <collection2>	Sí	matriz u objeto, pero no ambos	Colecciones de las que desea solo los elementos comunes

Valor devuelto	Tipo	Descripción
<elementos-comunes>	matriz u objeto, respectivamente	Colección que tiene solo los elementos comunes en las colecciones especificadas

Ejemplo

Este ejemplo busca los elementos comunes en las matrices siguientes:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Y devuelve una matriz con solo los elementos [1, 2].

isArray

Devuelve true si una entrada determinada es una matriz.

isArray('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una entrada determinada es una matriz o devuelve false si no lo es.

Ejemplos

Los ejemplos siguientes comprueban si la entrada es una matriz:

isArray('hello')
isArray(createArray('hello', 'world'))

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve false.
• La entrada es una matriz, por lo que la función devuelve true.

isBoolean

Devuelve true si una entrada determinada es un valor booleano.

isBoolean('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una entrada determinada es un valor booleano o devuelve false si no lo es.

Ejemplos

Los ejemplos siguientes comprueban si la entrada es un valor booleano:

isBoolean('hello')
isBoolean(32 > 16)

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve false.
• La entrada es un valor booleano, por lo que la función devuelve true.

isDate

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia a una fecha válida. Las fechas válidas contienen los valores month y dayOfMonth o contienen el valor dayOfWeek.

isDate('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex.

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada hace referencia a una fecha válida o devuelve false si la fecha no es válida.

Ejemplos

Estos ejemplos comprueban si las entradas siguientes son fechas válidas:

isDate('2020-12')
isDate('xxxx-12-21')

Y devuelven los resultados siguientes:

• false
• true

isDateRange

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia a un intervalo de fechas válido.

isDateRange('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex.

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada dada hace referencia a un intervalo de fechas válido o devuelve false si no lo es.

Ejemplos

Estos ejemplos comprueban si la entrada siguiente es un intervalo de fechas válido:

isDateRange('PT30M')
isDateRange('2012-02')

Y devuelven los resultados siguientes:

• false
• true

isDateTime

Devuelve true de una cadena de marca de tiempo con formato UTC ISO (AAAA-MM-DDTHH:mm:ss.fffZ).

isDateTime('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una entrada determinada es una cadena de marca de tiempo con formato UTC ISO o devuelve false si no lo es.

Ejemplos

Los ejemplos siguientes comprueban si la entrada es una cadena de formato UTC ISO:

isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve false.
• La entrada es una cadena de formato ISO UTC, por lo que la función devuelve true.

isDefinite

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia a una fecha válida. Las fechas válidas contienen los valores year, month y dayOfMonth.

isDefinite('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex.

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada determinada hace referencia a una fecha completa válida o devuelve false si no lo hace.

Ejemplos

Supongamos que hay un objeto TimexProperty validFullDate = new TimexProperty("2020-02-20") y la propiedad Now está establecida en true. Los ejemplos siguientes comprueban si el objeto hace referencia a una fecha completa válida:

isDefinite('xxxx-12-21')
isDefinite(validFullDate)

Y devuelven los resultados siguientes, respectivamente:

• false
• true

isDuration

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia a una duración válida.

isDuration('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex.

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada hace referencia a una duración válida o devuelve false si no lo hace.

Ejemplos

Los ejemplos siguientes comprueban si la entrada siguiente hace referencia a una duración válida:

isDuration('PT30M')
isDuration('2012-02')

Y devuelven los resultados siguientes, respectivamente:

• true
• false

isFloat

Devuelve true si una entrada determinada es un número de punto flotante. Debido a la alineación entre C# y JavaScript, un número con un residuo distinto de cero de su módulo 1 se tratará como un número de punto flotante.

isFloat('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una entrada determinada es un número de punto flotante o devuelve false si no lo es.

Ejemplos

Los ejemplos siguientes comprueban si la entrada es un número de punto flotante:

isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve false.
• La entrada tiene un módulo que es igual a 0, por lo que la función devuelve false.
• La entrada es un número de punto flotante, por lo que la función devuelve true.

isInteger

Devuelve true si una entrada especificada es un número entero. Debido a la alineación entre C# y JavaScript, un número con un residuo de cero de su módulo 1 se tratará como un número entero.

isInteger('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Si la entrada es un número entero

Ejemplos

Los ejemplos siguientes comprueban si la entrada es un entero:

isInteger('hello world!')
isInteger(1.0)
isInteger(12)

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve false.
• La entrada tiene un módulo que es igual a 0, por lo que la función devuelve true.
• La entrada es un entero, por lo que la función devuelve true.

isMatch

Devuelve true si una cadena determinada coincide con un patrón de expresión regular especificado.

isMatch('<target**string>', '<pattern>')

Parámetro	Obligatorio	Type	Descripción
<target**string>	Sí	string	Cadena con la que se va a establecer la coincidencia
<pattern>	Sí	string	Patrón de expresión regular

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una cadena determinada coincide con un patrón de expresión regular común o devuelve false si no lo hace.

Ejemplos

Los ejemplos siguientes comprueban si la entrada coincide con el patrón de expresión regular especificado:

isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')

Y devuelven el mismo resultado true.

isObject

Devuelve true si una entrada determinada es un objeto complejo o devuelve false si es un objeto primitivo. Los objetos primitivos incluyen cadenas, números y valores booleanos; los tipos complejos, como las clases, contienen propiedades.

isObject('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una entrada determinada es un objeto complejo o devuelve false si es un objeto primitivo.

Ejemplos

Los ejemplos siguientes comprueban si la entrada dada es un objeto:

isObject('hello world!')
isObject({userName: "Sam"})

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve false.
• La entrada es un objeto, por lo que la función devuelve true.

isPresent

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia al presente.

isPresent('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada hace referencia al presente o devuelve false si no lo hace.

Ejemplos Supongamos que tenemos un objeto TimexProperty validNow = new TimexProperty() { Now = true } y establecemos la propiedad Now en true. Los ejemplos siguientes comprueban si la entrada siguiente hace referencia al presente:

isPresent('PT30M')
isPresent(validNow)

Y devuelven los resultados siguientes, respectivamente:

• false
• true

isString

Devuelve true si una entrada determinada es una cadena.

isString('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	cualquiera	Entrada que se va a probar

Valor devuelto	Tipo	Descripción
<Boolean-result>	Booleano	Devuelve true si una entrada determinada es una cadena o devuelve false si no lo es.

Ejemplos

Los ejemplos siguientes comprueban si la entrada dada es una cadena:

isString('hello world!')
isString(3.14)

Y devuelven los resultados siguientes, respectivamente:

• La entrada es una cadena, por lo que la función devuelve true.
• La entrada es un valor float, por lo que la función devuelve false.

isTime

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia a una hora válida. La hora válida contiene horas, minutos y segundos.

isTime('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada hace referencia a una hora válida o devuelve false si no lo hace.

Ejemplos

Estos ejemplos comprueban si la entrada siguiente hace referencia a una hora válida:

isTime('PT30M')
isTime('2012-02-21T12:30:45')

Y devuelven los resultados siguientes, respectivamente:

• false
• true

isTimeRange

Devuelve true si una expresión TimexProperty o Timex determinada hace referencia a un intervalo de tiempo válido. Los intervalos de tiempo válidos contienen partOfDay.

isTime('<input>')

Parámetro	Obligatorio	Type	Descripción
<input>	Sí	objeto o cadena	Objeto TimexProperty de entrada o una cadena de expresión Timex.

Valor devuelto	Tipo	Descripción
<boolean-result>	Booleano	Devuelve true si la entrada hace referencia a un intervalo de tiempo válido o devuelve false si no lo hace.

Ejemplos

Supongamos que tenemos un objeto TimexProperty validTimeRange = new TimexProperty() { PartOfDay = "morning" } y establecemos la propiedad Now en true. Estos ejemplos comprueban si las entradas siguientes son intervalos de tiempo válidos:

isTimeRange('PT30M')
isTimeRange(validTimeRange)

Y devuelven los resultados siguientes, respectivamente:

• false
• true

join

Devuelve una cadena que tiene todos los elementos de una matriz, con cada carácter separado por un delimitador.

join([<collection>], '<delimiter>')

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	array	Matriz que tiene los elementos que se van a unir
<delimitador>	Sí	string	Separador que aparece entre cada carácter de la cadena resultante

Valor devuelto	Tipo	Descripción
<char1><delimiter><char2><delimiter>...	string	Cadena resultante creada a partir de todos los elementos de la matriz especificada

Ejemplo

Este ejemplo crea una cadena a partir de todos los elementos de esta matriz con el carácter . especificado como delimitador:

join(createArray('a', 'b', 'c'), '.')

Y devuelve el resultado a.b.c.

jPath

Comprueba JSON o una cadena JSON para ver los nodos o los valores que coinciden con una expresión de ruta de acceso y devuelve los nodos coincidentes.

jPath(<json>, '<path>')

Parámetro	Obligatorio	Type	Descripción
<json>	Sí	cualquiera	Objeto JSON o cadena donde se van a buscar los nodos o valores que coinciden con el valor de la expresión de ruta de acceso
<path>	Sí	cualquiera	Expresión de ruta de acceso utilizada para buscar valores o nodos JSON coincidentes

Valor devuelto	Tipo	Descripción
[ <json-node>]	array	Lista de nodos JSON o valor que coincide con la expresión de ruta de acceso especificada

Ejemplo de C#

Digamos que tiene el JSON siguiente:

{
    "Stores": [
        "Lambton Quay",
        "Willis Street"
    ],
    "Manufacturers": [
        {
            "Name": "Acme Co",
            "Products": [
                {
                    "Name": "Anvil",
                    "Price": 50
                }
            ]
        },
        {
            "Name": "Contoso",
            "Products": [
                {
                    "Name": "Elbow Grease",
                    "Price": 99.95
                },
                {
                    "Name": "Headlight Fluid",
                    "Price": 4
                }
            ]
        }
    ]
}

La expresión de ruta de acceso es $..Products[?(@.Price >= 50)].Name

jPath(jsonStr, path)

Y devuelve el resultado ["Anvil", "Elbow Grease"].

Ejemplo de JavaScript

Digamos que tiene el JSON siguiente:

{
    "automobiles": [
        {
            "maker": "Nissan",
            "model": "Teana",
            "year": 2011
        },
        {
            "maker": "Honda",
            "model": "Jazz",
            "year": 2010
        },
        {
            "maker": "Honda",
            "model": "Civic",
            "year": 2007
        },
        {
            "maker": "Toyota",
            "model": "Yaris",
            "year": 2008
        },
        {
            "maker": "Honda",
            "model": "Accord",
            "year": 2011
        }
    ],
    "motorcycles": [
        {
            "maker": "Honda",
            "model": "ST1300",
            "year": 2012
        }
    ]
}

La expresión path es .automobiles{.maker === "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

Y devuelve el resultado ['Jazz', 'Accord'].

json

Devuelve el valor o el objeto de tipo Notación de objetos JavaScript (JSON) de una cadena o XML.

json('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	cadena o XML	Cadena o XML que se va a convertir

Valor devuelto	Tipo	Descripción
<resultado-JSON>	string	Objeto JSON resultante creado a partir de la cadena especificada o XML.

Ejemplo 1

Este ejemplo convierte una cadena en JSON:

json('{"fullName": "Sophia Owen"}')

Y devuelve el resultado:

{
  "fullName": "Sophia Owen"
}

Ejemplo 2

Este ejemplo convierte el XML en JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

Y devuelve el resultado:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

jsonStringify

Devuelve la versión de cadena JSON de un valor.

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	objeto	El objeto que se va a convertir en una cadena de JSON

Valor devuelto	Tipo	Descripción
<resultado-JSON>	string	La cadena JSON resultante.

Ejemplos

En estos ejemplos se muestran los objetos convertidos en cadenas JSON:

jsonStringify(null)
jsonStringify({a:'b'})

Y devuelven los resultados de cadena siguientes, respectivamente:

• nulo
• {"a": "b"}

last

Devuelve el último elemento de una colección.

last('<collection>')
last([<collection>])

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena o matriz	Colección en la que buscar el último elemento

Valor devuelto	Tipo	Descripción
<último-elemento-de-la-colección>	cadena o matriz, respectivamente	Último elemento de la colección

Ejemplo

Estos ejemplos buscan el último elemento de estas colecciones:

last('abcd')
last(createArray(0, 1, 2, 3))

Y devuelven los resultados siguientes, respectivamente:

• d
• 3

lastIndexOf

Devuelve la posición inicial o el valor de índice de la última repetición de una subcadena. Esta función distingue entre mayúsculas y minúsculas y los índices comienzan por el número 0.

lastIndexOf('<text>', '<searchText>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	cadena o matriz	Cadena que contiene la subcadena que se va a buscar
<texto_a_buscar>	Sí	string	Subcadena que se va a buscar

Valor devuelto	Tipo	Descripción
<valor-de-índice-final>	integer	Posición inicial o valor de índice de la última repetición de la subcadena especificada. Si no se encuentra la cadena, devuelve el número -1.

Ejemplo 1

Este ejemplo busca el valor de índice de inicio de la última repetición de la subcadena world en la cadena hello world:

lastIndexOf('hello world', 'world')

Y devuelve el resultado 6.

Ejemplo 2

Este ejemplo busca el valor de índice de inicio de la última aparición de la subcadena def en la matriz ['abc', 'def', 'ghi', 'def'].

lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')

Y devuelve el resultado 3.

length

Devuelve la longitud de una cadena.

length('<str>')

Parámetro	Obligatorio	Type	Descripción
<str>	Sí	string	Cadena cuya longitud se va a calcular

Valor devuelto	Tipo	Descripción
<length>	integer	Longitud de esta cadena

Ejemplos

Estos ejemplos obtienen la longitud de las cadenas:

length('hello')
length('hello world')

Y devuelven los resultados siguientes, respectivamente:

• 5
• 11

less

Comprueba si el primer valor es menor que el segundo. Devuelve true si el primer valor es menor o devuelve false si el primer valor es mayor.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	Integer, Float o String	Primer valor para comprobar si es menor que el segundo valor
<compareTo>	Sí	Integer, Float o String, respectivamente	Elemento de comparación

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si el primer valor es menor que el segundo. Devuelve false si el primer valor es igual o mayor que el segundo.

Ejemplos

En estos ejemplos se comprueba si el primer valor es menor que el segundo valor.

less(5, 10)
less('banana', 'apple')

Y devuelven los resultados siguientes, respectivamente:

• true
• false

lessOrEquals

Compruebe si el primer valor es menor o igual que el segundo valor. Devuelve true si el primer valor es menor o igual o devuelve false si el primer valor es mayor.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	Integer, Float o String	Primer valor que se va a comprobar si es menor o igual que el segundo valor.
<compareTo>	Sí	Integer, Float o String, respectivamente	Elemento de comparación

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si el primer valor es menor o igual que el segundo. Devuelve false si el primer valor es mayor que el segundo.

Ejemplo

Estos ejemplos comprueban si el primer valor es menor o igual que el segundo.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Y devuelven los resultados siguientes, respectivamente:

• true
• false

max

Devuelve el valor más alto de una lista o una matriz. La lista o matriz incluye ambos extremos.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Parámetro	Obligatorio	Type	Descripción
<number1>, <number2>, ...	Sí	number	Conjunto de números del que se desea obtener el valor más alto
[<number1>, <number2>, ...]	Sí	matriz de números	Matriz de números de la cual quiere obtener el valor más alto

Valor devuelto	Tipo	Descripción
<max-value>	number	Valor más alto en la matriz o conjunto de números especificados

Ejemplos

Estos ejemplos obtienen el valor más alto del conjunto de números y la matriz:

max(1, 2, 3)
max(createArray(1, 2, 3))

Y devuelven el resultado 3.

merge

Combina varios objetos JSON o una matriz de objetos juntos.

merge(<json1>, <json2>, ...)

Parámetro	Obligatorio	Type	Descripción
<json1>, <json2>, ...	Sí	objetos o matriz	Conjunto de objetos JSON o matriz que se va a combinar.

Valor devuelto	Tipo	Descripción
<result>	objeto	Objeto JSON combinado o objetos de matriz combinada.

Ejemplos

Digamos que tienes los siguientes objetos JSON:

json1 = @"{
            'FirstName': 'John',
            'LastName': 'Smith',
            'Enabled': false,
            'Roles': [ 'User' ]
          }"
json2 =@"{
            'Enabled': true,
            'Roles': [ 'User', 'Admin' ]
          }"

En este ejemplo se combinan los objetos JSON:

string(merge(json(json1), json(json2)))

Y devuelve el objeto resultante {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Administración"]}.

Supongamos que desea combinar objetos y una lista de objetos. En el ejemplo siguiente se combina el objeto JSON y una matriz de objetos:

merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})

Y devuelve el objeto { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.

min

Devuelve el valor más bajo de un conjunto de números o una matriz.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Parámetro	Obligatorio	Type	Descripción
<number1>, <number2>, ...	Sí	number	Conjunto de números del que se desea obtener el valor más bajo
[<number1>, <number2>, ...]	Sí	matriz de números	Matriz de números de la que se desea obtener el valor más bajo

Valor devuelto	Tipo	Descripción
<min-value>	number	Valor más bajo en la matriz o conjunto de números especificados

Ejemplos

Estos ejemplos obtienen el valor más bajo del conjunto de números y la matriz:

min(1, 2, 3)
min(createArray(1, 2, 3))

Y devuelven el resultado 1.

mod

Devuelve el resto de dividir dos números. Para obtener el resultado de número entero, consulte div().

mod(<dividend>, <divisor>)

Parámetro	Obligatorio	Type	Descripción
<dividend>	Sí	number	Número que se va a dividir entre el divisor.
<divisor>	Sí	number	Número que divide el dividendo. No puede ser 0.

Valor devuelto	Tipo	Descripción
<modulo-result>	number	Resto de dividir el primer número entre el segundo número

Ejemplo

En este ejemplo se divide el primer número por el segundo número:

mod(3, 2)

Y devuelve el resultado 1.

mes

Devuelve el mes de la marca de tiempo especificada.

month('<timestamp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo

Valor devuelto	Tipo	Descripción
<number-of-month>	integer	Número del mes de la marca de tiempo especificada

Ejemplo

month('2018-03-15T13:01:00.000Z')

Y devuelve el resultado 3.

mul

Devuelve el producto de multiplicar dos números.

mul(<multiplicand1>, <multiplicand2>)

Parámetro	Obligatorio	Type	Descripción
<multiplicand1>	Sí	integer o float	Número que se va a multiplicar por el multiplicando2
<multiplicand2>	Sí	integer o float	Número que multiplica al multiplicando1

Valor devuelto	Tipo	Descripción
<product-result>	integer o float	Producto de multiplicar el primer número por el segundo número

Ejemplos

Estos ejemplos multiplican el primer número por el segundo número:

mul(1, 2)
mul(1.5, 2)

Y devuelven los resultados siguientes, respectivamente:

• 2
• 3

newGuid

Devuelve una nueva cadena GUID.

newGuid()

Valor devuelto	Tipo	Descripción
<Guid-string>	string	Una cadena GUID nueva, longitud de 36 y con el aspecto siguiente xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

Ejemplo

newGuid()

Y devuelve un resultado que sigue el formato xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.

not

Comprueba si una expresión es false. Devuelve true si la expresión es false o devuelve false si es true.

not(<expression>)

Parámetro	Obligatorio	Type	Descripción
<expression>	Sí	Boolean	Expresión que se va a evaluar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si la expresión es false. Devuelve false si la expresión es true.

Ejemplo 1

Estos ejemplos comprueban si las expresiones especificadas son falsas:

not(false)
not(true)

Y devuelven los resultados siguientes, respectivamente:

• la expresión es falsa, por lo que la función devuelve true.
• la expresión es verdadera, por lo que la función devuelve false.

Ejemplo 2

Estos ejemplos comprueban si las expresiones especificadas son falsas:

not(equals(1, 2))
not(equals(1, 1))

Y devuelven los resultados siguientes, respectivamente:

• la expresión es falsa, por lo que la función devuelve true.
• la expresión es verdadera, por lo que la función devuelve false.

o

Comprueba si al menos una expresión es true. Devuelve true si al menos una expresión es true o devuelve false si todas son false.

or(<expression1>, <expression2>, ...)

Parámetro	Obligatorio	Type	Descripción
<expression1>, <expression2>, ...	Sí	Boolean	Expresiones que se van a comprobar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si al menos una expresión es true. Devuelve false si todas las expresiones son false.

Ejemplo 1

Estos ejemplos comprueban si al menos una expresión es verdadera:

or(true, false)
or(false, false)

Y devuelven los resultados siguientes, respectivamente:

• al menos una expresión es verdadera, por lo que la función devuelve true.
• ambas expresiones son falsas, por lo que la función devuelve false.

Ejemplo 2

Estos ejemplos comprueban si al menos una expresión es verdadera:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Y devuelven los resultados siguientes, respectivamente:

• al menos una expresión es verdadera, por lo que la función devuelve true.
• ambas expresiones son falsas, por lo que la función devuelve false.

rand

Devuelve un entero aleatorio de un intervalo especificado, que incluye solo el extremo inicial.

rand(<minValue>, <maxValue>)

Parámetro	Obligatorio	Type	Descripción
<valor_mínimo>	Sí	integer	Entero más bajo del intervalo
<valor_maximo>	Sí	integer	Entero que sigue al entero más alto del intervalo que puede devolver la función

Valor devuelto	Tipo	Descripción
<random-result>	integer	Entero aleatorio devuelto del intervalo especificado

Ejemplo

Este ejemplo obtiene un entero aleatorio del intervalo especificado, sin incluir el valor máximo:

rand(1, 5)

Y devuelve 1, 2, 3 o 4 como resultado.

range

Devuelve una matriz de enteros que comienza en un entero especificado.

range(<startIndex>, <count>)

Parámetro	Obligatorio	Type	Descripción
<startIndex>	Sí	integer	Valor entero que inicia la matriz como el primer elemento
<recuento>	Sí	integer	Número de enteros de la matriz

Valor devuelto	Tipo	Descripción
<range-result>	integer	Matriz de enteros comenzando a partir del índice especificado

Ejemplo

Este ejemplo crea una matriz de enteros que comienza en el índice especificado 1 y tiene el número especificado de enteros como 4:

range(1, 4)

Y devuelve el resultado [1, 2, 3, 4].

removeProperty

Elimina una propiedad de un objeto y devuelve el objeto actualizado.

removeProperty(<object>, '<property>')

Parámetro	Obligatorio	Type	Description
<objeto>	Sí	objeto	Objeto JSON donde quiere quitar una propiedad
<property>	Sí	string	Nombre de la propiedad que se quitará

Valor devuelto	Tipo	Descripción
<objeto-actualizado>	objeto	Objeto JSON actualizado sin la propiedad especificada

Ejemplo

Este ejemplo quita la propiedad accountLocation de un objeto customerProfile, que se convierte en JSON con la función json() y devuelve el objeto actualizado:

removeProperty(json('customerProfile'), 'accountLocation')

replace

Reemplaza una subcadena por la cadena especificada y devuelve la cadena resultante. Esta función distingue mayúsculas de minúsculas.

replace('<text>', '<oldText>', '<newText>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que contiene la subcadena que se va a reemplazar
<oldText>	Sí	string	Subcadena que se va a reemplazar.
<newText>	Sí	string	Cadena que se va a reemplazar

Valor devuelto	Tipo	Descripción
<updated-text>	string	Cadena actualizada después de reemplazar la subcadena. Si no se encuentra la subcadena, la función devuelve la cadena original.

Ejemplo 1

Este ejemplo busca la subcadena old en the old string y reemplaza old por new:

replace('the old string', 'old', 'new')

El resultado es la cadena the new string.

Ejemplo 2

Cuando se trabaja con caracteres de escape, el motor de expresiones controla la eliminación del escape. Esta función reemplaza las cadenas por caracteres de escape.

replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"

Y devuelven los resultados siguientes, respectivamente:

• hello\n
• hello\\
• @"hello\\"
• @"hello\\"

replaceIgnoreCase

Reemplaza una subcadena por la cadena especificada y devuelve la cadena resultante. Esta función no distingue entre mayúsculas y minúsculas.

replaceIgnoreCase('<text>', '<oldText>', '<newText>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que contiene la subcadena que se va a reemplazar
<oldText>	Sí	string	Subcadena que se va a reemplazar.
<newText>	Sí	string	Cadena que se va a reemplazar

Valor devuelto	Tipo	Descripción
<updated-text>	string	Cadena actualizada después de reemplazar la subcadena. Si no se encuentra la subcadena, devuelve la cadena original.

Ejemplo

Este ejemplo busca la subcadena old en la cadena the old string y reemplaza old por new:

replace('the old string', 'old', 'new')

Y devuelve el resultado the new string.

Resolución

Devuelve la cadena si una expresión TimexProperty o Timex determinada hace referencia a una hora válida. La hora válida contiene horas, minutos y segundos.

resolve('<timestamp')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo.

Valor devuelto	Tipo	Descripción
<return>	string	Una cadena de la expresión TimexProperty o Timex evaluada.

Ejemplos

Estos ejemplos muestran si las cadenas especificadas hacen referencia a una hora válida:

resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)

Y devuelven los resultados siguientes, respectivamente:

• 14:00:00
• 2020-12-20
• 2020-12-20 14:20:00

reverse

Invierte el orden de los elementos de una cadena o matriz.

reverse(<value>)

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	cadena o matriz	Cadena a la que se va a invertir.

Valor devuelto	Tipo	Descripción
<return>	cadena o matriz	Elementos invertidos de una cadena o matriz.

Ejemplos

Estos ejemplos invierten los elementos de una cadena o matriz:

reverse(hello)
reverse(concat(hello,world))

Y devuelve los siguientes valores respectivamente:

-La cadena olleh. -La cadena dlrowolleh.

round

Redondea un valor al entero más próximo o al número especificado de dígitos fraccionarios.

round('<number>', '<precision-digits>')

Parámetro	Obligatorio	Type	Description
<number>	Sí	number	Un número de entrada
<dígitos de precisión>	No	integer	Número especificado de dígitos fraccionarios. El valor predeterminado es 0.

Valor devuelto	Tipo	Descripción
<return-value>	number	Valor devuelto de la entrada redondeada en un número especificado de dígitos fraccionarios

Ejemplo 1

En este ejemplo se redondea el número 10.333:

round(10.333)

Y devuelve el número 10.

Ejemplo 2

En este ejemplo se redondea el número 10,3313 a 2 dígitos fraccionarios:

round(10.3313, 2)

Y devuelve el número 10,33.

select

Opera en cada elemento y devuelve la nueva colección de elementos transformados.

select([<collection/instance>], <iteratorName>, <function>)

Parámetro	Obligatorio	Type	Descripción
<collection/instance>	Sí	array	Colección con los elementos
<iteratorName>	Sí	nombre de iterador	Elemento clave
<function>	Sí	expresión	Función que puede contener iteratorName

Valor devuelto	Tipo	Descripción
<new-collection>	array	Colección nueva en la que la función ha evaluado cada elemento

Ejemplo 1

Este ejemplo genera una colección nueva:

select(createArray(0, 1, 2, 3), x, x + 1)

Y devuelve el resultado [1, 2, 3, 4].

Ejemplo 2

Estos ejemplos generan una colección nueva:

select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

Y devuelve el resultado ['name:jack', 'age:15']. Tenga en cuenta que la segunda expresión es una expresión lambda, que algunas encuentran más legibles.

sentenceCase

Pon en mayúscula la primera letra de la primera palabra en una cadena en un formato de configuración regional opcional.

sentenceCase('<text>', '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena original
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
Cadena de resultado	string	Devuelve el resultado del caso de oración

Ejemplo 1

Estos ejemplos ponen en mayúsculas la primera letra de una cadena:

sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')

Y devuelven los resultados siguientes, respectivamente:

• A
• Abc def
• Abc def

Ejemplo 2

En estos ejemplos se escribe en mayúsculas la primera letra de una cadena en el formato de configuración regional especificado:

sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')

Y devuelven los resultados siguientes, respectivamente:

• A
• Abc
• Abc

setPathToValue

Recupera el valor de la propiedad especificada del objeto JSON.

setPathToValue(<path>, <value>)

Parámetro	Obligatorio	Type	Descripción
<Path>	Sí	objeto	Ruta de acceso que quiere establecer
<value>	Sí	objeto	Valor que se quiere establecer en la ruta de acceso

Valor devuelto	Tipo	Descripción
value	objeto	Valor que se va a establecer

Ejemplo 1

El ejemplo siguiente establece el valor 1 en la ruta de acceso:

setPathToValue(path.x, 1)

Y devuelve el resultado 1. path.x se establece en 1.

Ejemplo 2

Este ejemplo establece el valor:

setPathToValue(path.array[0], 7) + path.array[0]

Y devuelve el resultado 14.

setProperty

Establece el valor de una propiedad de un objeto y devuelve el objeto actualizado. Para agregar una nueva propiedad, use esta función o la función addProperty().

setProperty(<object>, '<property>', <value>)

Parámetro	Obligatorio	Type	Description
<objeto>	Sí	objeto	Objeto JSON donde quiere establecer una propiedad
<property>	Sí	string	Nombre de la propiedad que se va a establecer
<value>	Sí	cualquiera	Valor que se va a establecer para la propiedad especificada

Valor devuelto	Tipo	Descripción
<objeto-actualizado>	objeto	Objeto JSON actualizado cuya propiedad se ha establecido

Ejemplo

Este ejemplo establece la propiedad accountNumber del objeto customerProfile, que se convierte en JSON con la función json(). La función asigna un valor generado por la función newGuid() y devuelve el objeto JSON actualizado:

setProperty(json('customerProfile'), 'accountNumber', newGuid())

skip

Quita elementos del principio de una colección y devuelve todos los demás elementos.

skip([<collection>], <count>)

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	array	Colección cuyos elementos desea eliminar
<recuento>	Sí	integer	Entero positivo para el número de elementos a eliminar al principio

Valor devuelto	Tipo	Descripción
<colección_actualizada>	array	Colección actualizada después de eliminar los elementos especificados

Ejemplo

Este ejemplo elimina un elemento, el número 1, del principio de la matriz especificada:

skip(createArray(0, 1, 2, 3), 1)

Y devuelve una matriz con los elementos restantes: [1,2,3].

sortBy

Ordena los elementos de la colección en orden ascendente y devuelve la colección ordenada.

sortBy([<collection>], '<property>')

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena o matriz	Colección que se va a ordenar
<property>	No	string	Ordena por esta propiedad específica del elemento de objeto de la colección si se establece

Valor devuelto	Tipo	Descripción
<new-collection>	array	Colección nueva cuyos elementos se han ordenado

Ejemplo 1

Este ejemplo genera y ordena la colección siguiente:

sortBy(createArray(1, 2, 0, 3))

Y devuelve el resultado [0, 1, 2, 3].

Ejemplo 2

Supongamos que tiene la colección siguiente:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Este ejemplo genera una colección ordenada nueva basada en la propiedad de objeto x

sortBy(nestedItems, 'x')

Y devuelve el resultado:

{
  'nestedItems': [
    {'x': 1},
    {'x': 2},
    {'x': 3}
  ]
}

sortByDescending

Ordena los elementos de la colección en orden descendente y devuelve la colección ordenada.

sortBy([<collection>], '<property>')

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena o matriz	Colección que se va a ordenar
<property>	No	string	Ordena por esta propiedad específica del elemento de objeto de la colección si se establece

Valor devuelto	Tipo	Descripción
<new-collection>	array	Colección nueva cuyos elementos se han ordenado

Ejemplo 1

Este ejemplo genera una colección ordenada nueva:

sortByDescending(createArray(1, 2, 0, 3))

Y devuelve el resultado [3, 2, 1, 0].

Ejemplo 2

Supongamos que tiene la colección siguiente:

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

Este ejemplo genera una colección nueva ordenada basada en la propiedad de objeto x:

sortByDescending(nestedItems, 'x')

Y devuelve este resultado:

{
  'nestedItems': [
    {'x': 3},
    {'x': 2},
    {'x': 1}
  ]
}

split

Devuelve una matriz que contiene subcadenas, separadas por comas, en función de un carácter delimitador especificado en la cadena original.

split('<text>', '<delimiter>'?)

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena para separar en subcadenas según el delimitador especificado en la cadena original. Si el texto es un valor NULL, se tomará como una cadena vacía.
<delimitador>	No	string	Carácter de la cadena original que se usará como delimitador. Si no se proporciona ningún delimitador o el delimitador es un valor NULL, el valor predeterminado será una cadena vacía.

Valor devuelto	Tipo	Descripción
[<substring1>,<substring2>,...]	array	Una matriz que contiene subcadenas de la cadena original, separadas por comas

Ejemplos

Estos ejemplos crean una matriz con las subcadenas de la cadena especificada según el carácter delimitador especificado:

split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')

Y devuelven las matrices siguientes, respectivamente:

• ["a", "b", "c"]
• ["h", "e", "l", "l", "o"]
• [""], [ ]
• ["h", "e", "l", "l", "o"]

sqrt

Devuelve la raíz cuadrada de un número especificado.

sqrt(<number>)

Parámetro	Obligatorio	Type	Description
<number>	Sí	number	Número para obtener la raíz cuadrada de de

Valor devuelto	Tipo	Descripción
<result>	number	Resultado de calcular la raíz cuadrada.

Ejemplos

Estos ejemplos calculan la raíz cuadrada de los números especificados:

sqrt(9)
sqrt(0)

Y devuelven los resultados siguientes, respectivamente:

• 3
• 0

startOfDay

Devuelve el inicio del día para una marca de tiempo en un formato de configuración regional opcional.

startOfDay('<timestamp>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
'<marca-de-tiempo-actualizada>'	string	Marca de tiempo especificada a partir de la marca de hora cero del día

Ejemplo 1

Este ejemplo busca el inicio del día:

startOfDay('2018-03-15T13:30:30.000Z')

Y devuelve el resultado 2018-03-15T00:00:00.000Z.

Ejemplo 2

En este ejemplo se busca el inicio del día con la configuración regional fr-FR:

startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Y devuelve el resultado 15/03/2018 00:00:00.

startOfHour

Devuelve el inicio de la hora para una marca de tiempo en un formato de configuración regional opcional.

startOfHour('<timestamp>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
'<marca-de-tiempo-actualizada>'	string	Marca de tiempo especificada a partir de la marca de minuto cero del día

Ejemplo 1

Este ejemplo busca el inicio de la hora:

startOfHour('2018-03-15T13:30:30.000Z')

Y devuelve el resultado 2018-03-15T13:00:00.000Z.

Ejemplo 2

En este ejemplo se busca el inicio de la hora con la configuración regional fr-FR:

startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Y devuelve el resultado 15/03/2018 13:00:00.

startOfMonth

Devuelve el inicio del mes de una marca de tiempo en un formato local opcional.

startOfMonth('<timestamp>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
'<marca-de-tiempo-actualizada>'	string	Marca de tiempo especificada a partir del primer día del mes en la marca de hora cero

Ejemplo 1

Este ejemplo busca el inicio del mes:

startOfMonth('2018-03-15T13:30:30.000Z')

Y devuelve el resultado 2018-03-01T00:00:00.000Z.

Ejemplo 2

Este ejemplo busca el inicio del mes con la configuración regional fr-FR:

startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')

Y devuelve el resultado 01/03/2018 00:00:00.

startsWith

Comprueba si una cadena comienza con una subcadena especificada. Devuelve true si se encuentra la subcadena o devuelve false si no se encuentra. Esta función no distingue entre mayúsculas y minúsculas.

startsWith('<text>', '<searchText>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que se va a comprobar
<texto_a_buscar>	Sí	string	Subcadena inicial que se va a buscar

Valor devuelto	Tipo	Descripción
true o false	Booleano	Devuelve true si se encuentra la subcadena inicial. Devuelve false si no se encuentra.

Ejemplo 1

Este ejemplo comprueba si la cadena hello world comienza con la cadena hello:

startsWith('hello world', 'hello')

Y devuelve el resultado true.

Ejemplo 2

Este ejemplo comprueba si la cadena hello world comienza con la cadena greeting:

startsWith('hello world', 'greeting')

Y devuelve el resultado false.

string

Devuelve la versión de cadena de un valor en un formato de configuración regional opcional.

string(<value>, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	cualquiera	Valor que se va a convertir
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<valor-de-cadena>	string	Versión de cadena del valor especificado

Ejemplo 1

Este ejemplo crea la versión de cadena del número 10:

string(10)

Y devuelve el resultado de cadena 10.

Ejemplo 2

Este ejemplo crea una cadena a partir del objeto JSON especificado y usa el carácter de barra diagonal inversa,\\, como carácter de escape para la marca de comillas dobles, ".

string( { "name": "Sophie Owen" } )

Y devuelve el resultado { "name": "Sophie Owen" }

Ejemplo 3

En este ejemplo se crea una versión de cadena del número 10 en una configuración regional específica:

string(100.1, 'fr-FR')
string(100.1, 'en-US')

Y devuelve las siguientes cadenas respectivamente:

• 100,1
• 100,1

stringOrValue

Ajusta la interpolación de cadenas para obtener el valor real. Por ejemplo, stringOrValue('${1}') devuelve el número 1, mientras stringOrValue('${1} item') que devuelve la cadena "1 elemento".

stringOrValue(<string>)

Parámetro	Obligatorio	Type	Description
<string>	Sí	string	Cadena de la que se va a obtener el valor real.

Valor devuelto	Tipo	Descripción
<result>	cualquiera	Resultado de obtener el valor real de la cadena especificada.

Ejemplos

Estos ejemplos obtienen el valor real de la cadena:

stringOrValue('${one}')
stringOrValue('${one} item')

Y devuelven los resultados siguientes, respectivamente:

• Número 1.0.
• El elemento de cadena 1.

sub

Devuelve el resultado de restar el segundo número del primero.

sub(<minuend>, <subtrahend>)

Parámetro	Obligatorio	Type	Descripción
<minuendo>	Sí	number	Número del que se resta el sustraendo
<sustraendo>	Sí	number	Número que se resta del minuendo

Valor devuelto	Tipo	Descripción
<result>	number	Resultado de restar el segundo número del primero

Ejemplo

Este ejemplo resta el segundo número del primer número:

sub(10.3, .3)

Y devuelve el resultado 10.

subArray

Devuelve una submatriz a partir de la posición inicial y final especificada. Los valores de índice comienzan desde el número 0.

subArray(<Array>, <startIndex>, <endIndex>)

Parámetro	Obligatorio	Type	Descripción
<array>	Sí	array	Matriz de la que se va a crear la submatriz
<startIndex>	Sí	integer	Un número positivo igual o mayor que 0 que se va a usar como el valor de índice o la posición inicial
<endIndex>	Sí	integer	Un número positivo igual o mayor que 0 que se va a usar como el valor de índice o la posición final

Valor devuelto	Tipo	Descripción
<subarray-result>	array	Submatriz con el número especificado de elementos, empezando en la posición de índice especificada de la cadena de origen

Ejemplo

Este ejemplo crea una submatriz a partir de la matriz especificada:

subArray(createArray('H','e','l','l','o'), 2, 5)

Y devuelve el resultado ["l", "l", "o"].

substring

Devuelve caracteres de una cadena a partir de la posición especificada o índice. Los valores de índice comienzan desde el número 0.

substring('<text>', <startIndex>, <length>)

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena de la que se va a crear la subcadena
<startIndex>	Sí	integer	Un número positivo igual o mayor que 0 de submatriz que se va a usar como el valor de índice o la posición inicial
<length>	Sí	integer	Número positivo de caracteres de submatriz en la subcadena

Valor devuelto	Tipo	Descripción
<subcadena-resultante>	string	Subcadena con el número especificado de caracteres, empezando en la posición de índice especificada de la cadena de origen

Ejemplo

Este ejemplo crea una subcadena de cinco caracteres a partir de la cadena especificada, empezando en el valor de índice 6:

substring('hello world', 6, 5)

Y devuelve el resultado world.

subtractFromTime

Resta un número de unidades de tiempo de una marca de tiempo en un formato local opcional. Consulte también getPastTime().

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo
<intervalo>	Sí	integer	Número de unidades de tiempo especificadas que se va a sustraer
<unidad_de_tiempo>	Sí	string	Unidad de tiempo que se usará con intervalo. Las unidades posibles son "Second", "Minute", "Hour", "Day", "Week", "Month" y "Year".
<format>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actualizada>	string	Marca de tiempo menos el número de unidades de tiempo especificado

Ejemplo 1

Este ejemplo resta un día de la marca de tiempo siguiente:

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')

Y devuelve el resultado 2018-01-01T00:00:00.000Z.

Ejemplo 2

Este ejemplo resta un día de la marca de tiempo que usa el formato D:

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')

Y devuelve el resultado el lunes, 1 de enero de 2018.

Ejemplo 3

En este ejemplo se resta 1 hora de una marca de tiempo en la configuración regional de de-DE:

subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')

Y devuelve el resultado 15.03.18 12:00:00.

Sum

Devuelve el resultado de agregar números a una lista.

sum([<list of numbers>])

Parámetro	Obligatorio	Type	Descripción
[<lista de números>]	Sí	matriz de números	Números que se van a sumar

Valor devuelto	Tipo	Descripción
<resultado-de-la-suma>	number	Resultado de sumar los números especificados

Ejemplo

Este ejemplo suma los números especificados:

sum(createArray(1, 1.5))

Y devuelve el resultado 2,5.

take

Devuelve elementos del principio de una colección.

take('<collection>', <count>)
take([<collection>], <count>)

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	cadena o matriz	Colección cuyos elementos desea tomar
<recuento>	Sí	integer	Entero positivo para el número de elementos a tomar desde el principio

Valor devuelto	Tipo	Descripción
<subset> o [<subset>]	Cadena o matriz, respectivamente	Cadena o matriz que tiene el número especificado de elementos tomados desde el principio de la colección original

Ejemplo

Estos ejemplos obtienen el número especificado de elementos desde el principio de estas colecciones:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Y devuelven los resultados siguientes, respectivamente:

• abc
• [0, 1, 2]

ticks

Devuelve el valor de la propiedad ticks de una marca de tiempo determinada. Un tick es un intervalo de 100 nanosegundos.

ticks('<timestamp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena de una marca de tiempo

Valor devuelto	Tipo	Descripción
<número-de-ticks>	entero (bigint en Javascript)	Número de ticks desde la marca de tiempo especificada

Ejemplo

El ejemplo convierte una marca de tiempo en su propiedad tics:

ticks('2018-01-01T08:00:00.000Z')

Y devuelve el resultado 636503904000000000.

ticksToDays

Convierte un valor de propiedad ticks en el número de días.

ticksToDays('ticks')

Parámetro	Obligatorio	Type	Descripción
<ticks>	Sí	integer	Valor de la propiedad ticks que se va a convertir

Valor devuelto	Tipo	Descripción
<number-of-days>	number	Número de días convertidos del valor de la propiedad ticks

Ejemplo

En este ejemplo se convierte un valor de propiedad ticks en un número de días:

ticksToDays(2193385800000000)

Y devuelve el número 2538.64097222.

ticksToHours

Convierte un valor de propiedad ticks en el número de horas.

ticksToHours('ticks')

Parámetro	Obligatorio	Type	Descripción
<ticks>	Sí	Entero	Valor de la propiedad ticks que se va a convertir

Valor devuelto	Tipo	Descripción
<number-of-hours>	number	Número de horas convertidas del valor de la propiedad ticks

Ejemplo

En este ejemplo se convierte un valor de propiedad ticks en una serie de horas:

ticksToHours(2193385800000000)

Y devuelve el número 60927.383333333331.

ticksToMinutes

Convierte un valor de propiedad ticks en el número de minutos.

ticksToMinutes('ticks')

Parámetro	Obligatorio	Type	Descripción
<ticks>	Sí	integer	Valor de la propiedad ticks que se va a convertir

Valor devuelto	Tipo	Descripción
<number-of-minutes>	number	Número de minutos convertidos del valor de la propiedad ticks

Ejemplo

En este ejemplo se convierte un valor de propiedad ticks en un número de minutos:

ticksToMinutes(2193385800000000)

Y devuelve el número 3655643.0185.

titleCase

Pon en mayúsculas la primera letra de cada palabra de una cadena en un formato local opcional.

titleCase('<text>', '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena original
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
Cadena de resultado	string	Resultado del caso de título

Ejemplo 1

Estos ejemplos ponen en mayúsculas la primera letra de cada palabra de una cadena:

titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')

Y devuelven los resultados siguientes, respectivamente:

• A
• Abc Def
• Abc Def

Ejemplo 2

Estos ejemplos ponen en mayúsculas la primera letra de una cadena en formato en-US:

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

Y devuelven los resultados siguientes, respectivamente:

• A
• Abc Def

toLower

Devuelve una cadena en minúsculas en un formato de configuración regional opcional. Si un carácter de la cadena no tiene un equivalente en minúsculas, se incluye sin cambios en la cadena devuelta.

toLower('<text>', '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que se devuelve en formato de minúsculas
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<texto-en-minúsculas>	string	Cadena original en minúsculas

Ejemplo 1

Este ejemplo convierte una cadena en minúsculas:

toLower('Hello World')

Y devuelve el resultado hello world.

Ejemplo 2

En este ejemplo se convierte una cadena en minúsculas en el formato fr-FR:

toUpper('Hello World', 'fr-FR')

Y devuelve el resultado hello world.

toUpper

Devuelve una cadena en mayúsculas en un formato de configuración regional opcional. Si un carácter de la cadena no tiene un equivalente en mayúsculas, se incluye sin cambios en la cadena devuelta.

toUpper('<text>', '<locale>'?)

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que se devuelve en formato de mayúsculas
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<texto-en-mayúsculas>	string	Cadena original en mayúsculas

Ejemplo 1

Este ejemplo convierte una cadena en mayúsculas:

toUpper('Hello World')

Y devuelve el resultado HELLO WORLD.

Ejemplo 2

En este ejemplo se convierte una cadena en mayúsculas en el formato fr-FR:

toUpper('Hello World', 'fr-FR')

Y devuelve el resultado HELLO WORLD.

trim

Quita el espacio en blanco inicial y final de una cadena y devuelve la cadena actualizada.

trim('<text>')

Parámetro	Obligatorio	Type	Descripción
<texto>	Sí	string	Cadena que contiene los espacios en blanco iniciales y finales que se van a eliminar

Valor devuelto	Tipo	Descripción
<texto_actualizado>	string	Versión actualizada de la cadena original sin espacios en blanco iniciales o finales

Ejemplo

Este ejemplo quita el espacio en blanco inicial y final de la cadena " Hello World ":

trim(' Hello World  ')

Y devuelve el resultado recortado Hello World.

union

Devuelve una colección que tiene todos los elementos de las colecciones especificadas. Para que aparezca en el resultado, un elemento debe aparecer en alguna de las colecciones que se pasan a esta función. Si uno o más elementos tienen el mismo nombre, el último elemento con ese nombre aparece en el resultado.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Parámetro	Obligatorio	Type	Descripción
<collection1>, <collection2>, ...	Sí	matriz u objeto, pero no ambos	Colecciones de las que desean todos los elementos

Valor devuelto	Tipo	Descripción
<colección_actualizada>	matriz u objeto, respectivamente	Colección con todos los elementos de las colecciones especificadas. Sin duplicados agregados.

Ejemplo

Este ejemplo obtiene todos los elementos de las colecciones siguientes:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Y devuelve el resultado [1, 2, 3, 10, 101].

unique

Quita todos los duplicados de una matriz.

unique([<collection>])

Parámetro	Obligatorio	Type	Descripción
<colección>	Sí	array	Colección que se va a modificar

Valor devuelto	Tipo	Descripción
<new-collection>	array	Colección nueva con elementos duplicados quitados

Ejemplo 1

Este ejemplo quita los elementos duplicados de la matriz siguiente:

unique(createArray(1, 2, 1))

Y devuelve el resultado [1, 2].

uriComponent

Devuelve la versión binaria de un componente de un identificador uniforme de recursos (URI).

uriComponent('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena que se va a convertir en formato codificado de URI

Valor devuelto	Tipo	Descripción
<uri-codificado>	string	Cadena codificada en formato URI con caracteres de escape

Ejemplo

Este ejemplo crea una versión codificada en formato URI de una cadena:

uriComponent('https://contoso.com')

Y devuelve el resultado http%3A%2F%2Fcontoso.com.

uriComponentToString

Devuelve la versión de cadena de una cadena codificada en formato de identificador uniforme de recursos (URI), descodificando dicha cadena.

uriComponentToString('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena con codificación URI que se va a decodificar

Valor devuelto	Tipo	Descripción
<binario-de-codificado-uri>	string	Versión decodificada de la cadena con codificación URI

Ejemplo

Este ejemplo crea la versión de cadena descodificada de una cadena con codificación URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

Y devuelve el resultado https://contoso.com.

uriHost

Devuelve el valor de host de un identificador unificado de recursos (URI).

uriHost('<uri>')

Parámetro	Obligatorio	Type	Descripción
<uri>	Sí	string	Identificador URI cuyo valor de host desea

Valor devuelto	Tipo	Descripción
<valor-host>	string	Valor de host del identificador URI especificado

Ejemplo

Este ejemplo busca el valor de host del identificador URI siguiente:

uriHost('https://www.localhost.com:8080')

Y devuelve el resultado www.localhost.com.

uriPath

Devuelve el valor de ruta de acceso de un identificador unificado de recursos (URI).

uriPath('<uri>')

Parámetro	Obligatorio	Type	Descripción
<uri>	Sí	string	Identificador URI cuyo valor de ruta de acceso desea

Valor devuelto	Tipo	Descripción
<valor-path>	string	Valor de ruta de acceso del identificador URI especificado

Ejemplo

Este ejemplo busca el valor de ruta de acceso del identificador URI siguiente:

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

Y devuelve el resultado /catalog/shownew.htm.

uriPathAndQuery

Devuelve el valor de ruta de acceso y consulta de un identificador unificado de recursos (URI).

uriPathAndQuery('<uri>')

Parámetro	Obligatorio	Type	Descripción
<uri>	Sí	string	Identificador URI cuyo valor de ruta de acceso y consulta desea

Valor devuelto	Tipo	Descripción
<valores-path-y-query>	string	Valor de ruta de acceso y consulta del identificador URI especificado

Ejemplo

Este ejemplo busca el valor de ruta de acceso y consulta del identificador URI siguiente:

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Y devuelve el resultado /catalog/shownew.htm?date=today.

uriPort

Devuelve el valor de puerto de un identificador unificado de recursos (URI).

uriPort('<uri>')

Parámetro	Obligatorio	Type	Descripción
<uri>	Sí	string	Identificador URI cuyo valor de ruta de acceso desea

Valor devuelto	Tipo	Descripción
<valor-port>	string	Valor de puerto del identificador URI especificado

Ejemplo

Este ejemplo busca el valor de puerto del identificador URI siguiente:

uriPort('http://www.localhost:8080')

Y devuelve el resultado 8080.

uriQuery

Devuelve el valor de consulta de un identificador unificado de recursos (URI).

uriQuery('<uri>')

Parámetro	Obligatorio	Type	Descripción
<uri>	Sí	string	Identificador URI cuyo valor de consulta desea

Valor devuelto	Tipo	Descripción
<valor-query>	string	Valor de consulta del identificador URI especificado

Ejemplo

Este ejemplo busca el valor de consulta del identificador URI siguiente:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Y devuelve el resultado ?date=today.

UriScheme

Devuelve el valor de esquema de un identificador unificado de recursos (URI).

uriScheme('<uri>')

Parámetro	Obligatorio	Type	Descripción
<uri>	Sí	string	Identificador URI cuyo valor de consulta desea

Valor devuelto	Tipo	Descripción
<valor-scheme>	string	Valor de esquema del identificador URI especificado

Ejemplo

Este ejemplo busca el valor de esquema del identificador URI siguiente:

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

Y devuelve el resultado http.

utcNow

Devuelve la marca de tiempo actual como cadena en formato local opcional.

utcNow('<format>', '<locale>'?)

De forma opcional, puede especificar otro formato con el parámetro <format>.

Parámetro	Obligatorio	Type	Descripción
<formato>	No	string	Un patrón de formato personalizado. El formato predeterminado de la marca de tiempo es el formato UTC ISO, AAAA-MM-DDTHH:mm:ss.fffZ, que cumple con el estándar ISO 8601.
<locale>	No	string	Una localidad opcional de información cultural

Valor devuelto	Tipo	Descripción
<marca-de-tiempo-actual>	string	Fecha y hora actuales

Ejemplo 1

Supongamos que la fecha es 15 de abril de 2018 a las 1:00:00 p.m. Este ejemplo obtiene la marca de tiempo:

utcNow()

Y devuelve el resultado 2018-04-15T13:00:00.000Z.

Ejemplo 2

Supongamos que la fecha es 15 de abril de 2018 a las 1:00:00 p.m. Este ejemplo obtiene la marca de tiempo actual con el formato D opcional:

utcNow('D')

Y devuelve el resultado Domingo, 15 de abril de 2018.

Ejemplo 3

Supongamos que la fecha es 15 de abril de 2018 a las 1:00:00 p.m. Este ejemplo obtiene la marca de tiempo actual que usa la configuración regional de-DE:

utcNow('', 'de-DE')

Y devuelve el resultado 15.04.18 13:00:00.

where

Filtra en cada elemento y devuelve la colección nueva de elementos filtrados que coinciden con una condición específica.

where([<collection/instance>], <iteratorName>, <function>)

Parámetro	Obligatorio	Type	Descripción
<collection/instance>	Sí	array	Colección con los elementos
<iteratorName>	Sí	nombre de iterador	Elemento clave
<function>	Sí	expresión	Función de condición que se usa para filtrar elementos

Valor devuelto	Tipo	Descripción
<new-collection/new-object>	matriz/objeto	Colección nueva en la que la función ha filtrado cada elemento

Ejemplo 1

Este ejemplo genera una colección nueva:

where(createArray(0, 1, 2, 3), x, x > 1)

Y devuelve el resultado [2, 3].

Ejemplo 2

Estos ejemplos generan una colección nueva:

where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')

Y devuelve el resultado ['name:jack', 'age:15']. Tenga en cuenta que la segunda expresión es una expresión lambda, que algunas encuentran más legibles.

Xml

Devuelve la versión XML de una cadena que contiene un objeto JSON.

xml('<value>')

Parámetro	Obligatorio	Type	Descripción
<value>	Sí	string	Cadena con el objeto JSON que se va a convertir. El objeto JSON debe tener solo una propiedad raíz, que no puede ser una matriz. Use \ como carácter de escape para las comillas dobles (").

Valor devuelto	Tipo	Descripción
<versión-xml>	objeto	XML codificado de la cadena u objeto JSON especificados

Ejemplo 1

Este ejemplo crea la versión XML de una cadena, que contiene un objeto JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

Y devuelve el XML de resultado:

<name>Sophia Owen</name>

Ejemplo 2

Supongamos que tiene un objeto JSON person, que se muestra a continuación:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Este ejemplo crea código XML de una cadena que contiene este objeto JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

Y devuelve el XML de resultado:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person

xPath

Comprueba el código XML de los nodos o valores que coinciden con una expresión XPath (XML Path Language) y devuelve los nodos o valores coincidentes. Una expresión XPath (que se conoce como XPath) lo ayuda a recorrer una estructura de documento XML para que pueda seleccionar nodos o valores de proceso del contenido XML.

xPath('<xml>', '<xpath>')

Parámetro	Obligatorio	Type	Descripción
<xml>	Sí	cualquiera	Cadena XML en la que buscar nodos o valores que coincidan con un valor de la expresión XPath
<xPath>	Sí	cualquiera	Expresión XPath utilizada para buscar nodos XML o valores coincidentes

Valor devuelto	Tipo	Descripción
<nodo-xml>	XML	Nodo XML si solo un nodo coincide con la expresión XPath especificada
<value>	cualquiera	Valor de un nodo XML si solo un valor coincide con la expresión XPath especificada
<[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]>	array	Matriz con los nodos XML o valores que coinciden con la expresión XPath especificada

Ejemplo 1

Este ejemplo busca los nodos que coinciden con el nodo <name></name> de los argumentos especificados y devuelve una matriz con los valores de nodo:

xPath(items, '/produce/item/name')

Los argumentos incluyen la cadena items, que contiene este XML:

"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"

Esta es la matriz resultante con los nodos que coinciden con <name></name>:

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Ejemplo 2

Siguiendo el ejemplo 1, este ejemplo busca nodos que coincidan con el nodo <count></count> y agrega los valores de nodo con la función sum():

xPath(xml(parameters('items')), 'sum(/produce/item/count)')

Y devuelve el resultado 30.

year

Devuelve el año de la marca de tiempo especificada.

year('<timestamp>')

Parámetro	Obligatorio	Type	Descripción
<marca_de_tiempo>	Sí	string	Cadena que contiene la marca de tiempo

Valor devuelto	Tipo	Descripción
<year>	integer	Año de la marca de tiempo especificada

Ejemplo

Este ejemplo evalúa la marca de tiempo del año:

year('2018-03-15T00:00:00.000Z')

Y devuelve el resultado 2018.