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

Funciones de colección

Funciones de comparación lógica

Funciones de conversión

Funciones matemáticas

Funciones de fecha y hora

Funciones Timex

Funciones de análisis de URI

Funciones de construcción y manipulación de objetos

Funciones de expresiones regulares

Funciones de comprobación de tipos

Funciones precompiladas ordenadas alfabéticamente

abs

Devuelve el valor absoluto del número especificado.

abs(<number>)

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>, ...)

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>'?)

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>'?)

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>'?)

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>)

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)

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>'?)

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>'?)

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>)

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>, ...)

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>)

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>)

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>')

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>')

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>')

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>')

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>)

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>')

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>, ...)

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>', ...)

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

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>])

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>')

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>'?)

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>'?)

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>', ...)

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>)

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>])

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>')

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()

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>')

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)

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)

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>])

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>')

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>')

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>')

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>)

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>'?)

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>'?)

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>'?)

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>'?)

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>'?)

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>?)

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>?)

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>'?)

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>?)

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>?)

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>')

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>')

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:

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

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>')

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>')

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>)

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>')

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>')

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>')

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>', ...)

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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>')

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.

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>])

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>')

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>')

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>')

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>')

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>, ...])

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>, ...)

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>, ...])

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>)

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>')

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>)

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()

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>)

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>, ...)

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>)

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>)

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>')

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>')

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>')

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')

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>)

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>')

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>)

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>'?)

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>)

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>)

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>)

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>')

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>')

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>'?)

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>)

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>'?)

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>'?)

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>'?)

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>')

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>'?)

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>)

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>)

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>)

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>)

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>'?)

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>])

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>)

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>')

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')

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')

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')

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>'?)

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>'?)

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>'?)

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>')

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>], ...)

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([<collection>])

unique(createArray(1, 2, 1))

uriComponent

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

uriComponent('<value>')

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>')