Expressões e funções para o Data Factory no Microsoft Fabric

2025-03-27

Este artigo fornece detalhes sobre expressões e funções suportadas pelo Data Factory no Microsoft Fabric.

Expressões

Os valores de expressão na definição podem ser literais ou expressões que são avaliadas em tempo de execução. Por exemplo:

"value"

"@pipeline().parameters.password"

As expressões podem aparecer em qualquer lugar em um valor de cadeia de caracteres e sempre resultar em outro valor de cadeia de caracteres. Se um valor for uma expressão, o corpo da expressão será extraído removendo o sinal (@). Se for necessária uma cadeia de caracteres literal que comece com @, ela deverá ser escapada usando @@. Os exemplos a seguir mostram como as expressões são avaliadas.

Valor da expressão	Resultado
"parâmetros"	Os caracteres 'parâmetros' são retornados.
"parâmetros[1]"	Os caracteres 'parameters[1]' são retornados.
"@@"	Uma cadeia de caracteres de 1 caractere que contém '@' é retornada.
" @"	Uma cadeia de 2 caracteres que contém ' @' é retornada.

As expressões também podem aparecer dentro de cadeias de caracteres, usando um recurso chamado interpolação de cadeias de caracteres onde as expressões são encapsuladas em @{ ... }. Por exemplo: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Usando interpolação de cadeia de caracteres, o resultado é sempre uma cadeia de caracteres. Digamos que eu defini myNumber como 42 e myString como foo:

Valor da expressão	Resultado
"@pipeline().parameters.myString"	Retorna `foo` como uma cadeia de caracteres.
"@{pipeline().parameters.myString}"	Retorna `foo` como uma cadeia de caracteres.
"@pipeline().parameters.myNumber"	Retorna `42` como um número .
"@{pipeline().parameters.myNumber}"	Retorna `42` como uma cadeia de caracteres .
"A resposta é: @{pipeline().parameters.myNumber}"	Retorna a cadeia de caracteres `Answer is: 42`.
"@concat('A resposta é: ', string(pipeline().parameters.myNumber))"	Retorna a cadeia de caracteres `Answer is: 42`
"A resposta é: @@{pipeline().parameters.myNumber}"	Retorna a cadeia de caracteres `Answer is: @{pipeline().parameters.myNumber}`.

Nas atividades de fluxo de controle como a atividade ForEach, você pode fornecer uma matriz a ser iterada para os itens de propriedade e usar @item() para iterar sobre uma única enumeração na atividade ForEach. Por exemplo, se items for uma matriz: [1, 2, 3], @item() retornará 1 na primeira iteração, 2 na segunda iteração e 3 na terceira iteração. Você também pode usar @range(0,10) como expressão para iterar 10 vezes, começando com 0 e terminando com 9.

Você pode usar @activity('nome da atividade') para capturar a saída da atividade e tomar decisões. Considere uma atividade da Web chamada Web1. Para colocar a saída da primeira atividade no corpo da segunda, a expressão geralmente se parece com: @activity('Web1').output ou @activity('Web1').output.data ou algo semelhante, dependendo de como é a saída da primeira atividade.

Exemplos

Exemplo de expressão complexa

O exemplo abaixo mostra um exemplo complexo que faz referência a um subcampo profundo da saída da atividade. Para fazer referência a um parâmetro de pipeline que é avaliado para um subcampo, use a sintaxe [] em vez do operador dot(.) (como no caso do subcampo1 e subcampo2), como parte de uma saída de atividade.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Criar arquivos dinamicamente e nomeá-los é um padrão comum. Vamos explorar alguns exemplos de nomenclatura de arquivos dinâmicos.

Acrescentar data a um nome de arquivo: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Acrescentar a data e hora no fuso horário do cliente: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Acrescentar tempo de gatilho: @concat('Test_', pipeline().TriggerTime)
Gerar um nome de ficheiro personalizado num fluxo de dados de mapeamento ao exportar para um único ficheiro com data: 'Test_' + toString(currentDate()) + '.csv'

Nos casos acima, quatro nomes de arquivos dinâmicos são criados começando com Test_.

Editor de conteúdo dinâmico

O editor de conteúdo dinâmico escapa automaticamente dos caracteres do seu conteúdo quando você termina de editar. Por exemplo, o conteúdo a seguir no editor de conteúdo é uma interpolação de cadeia de caracteres com uma função de expressão.

"@{toUpper('myData')}"

O editor de conteúdo dinâmico converte o conteúdo acima para a expressão "@{toUpper('myData')}". O resultado dessa expressão é a cadeia de caracteres formatada mostrada abaixo.

"MYDATA"

Substituindo caracteres especiais

O editor de conteúdo dinâmico escapa automaticamente de caracteres como aspas duplas, barra invertida em seu conteúdo quando você termina de editar. Isso causa problemas se você quiser substituir o feed de linha ou guia usando \n, \t na função replace(). Você pode editar seu conteúdo dinâmico na visualização de código para remover o \ extra na expressão, ou você pode seguir as etapas abaixo para substituir caracteres especiais usando a linguagem de expressão:

Codificação de URL em relação ao valor da cadeia de caracteres original
Substitua a cadeia de caracteres codificada por URL, por exemplo, alimentação de linha (%0A), retorno de carro(%0D), tabulação horizontal(%09).
Descodificação de URL

Por exemplo, a variável companyName com um caractere de nova linha em seu valor, expressão @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) pode remover o caractere de nova linha.

Contoso- Corporation

Escapando do caractere de aspas simples

As funções de expressão usam aspas simples para parâmetros de valor de cadeia de caracteres. Use duas aspas simples para escapar de um caractere ' em funções de cadeia de caracteres. Por exemplo, a expressão @concat('Baba', '''s ', 'book store') retornará abaixo do resultado.

Baba's book store

Variáveis de escopo do pipeline

Essas variáveis de sistema podem ser referenciadas em qualquer lugar do pipeline.

Nome da variável	Descrição
@pipeline().DataFactory	Nome dos dados ou do espaço de trabalho Synapse onde o pipeline está em execução
@pipeline().Pipeline	Nome do gasoduto
@pipeline().RunId	ID da execução específica do pipeline
@pipeline().TriggerId	ID do gatilho que invocou o pipeline
@pipeline().TriggerName	Nome do gatilho que invocou o pipeline
@pipeline().TriggerTime	Momento da execução do gatilho que invocou o pipeline. Este é o momento em que o gatilho realmente acionado para invocar a execução do pipeline, e pode diferir ligeiramente do tempo agendado do gatilho.
@pipeline().GroupId	Identificação do grupo ao qual pertence a execução do pipeline.
@pipeline()?. TriggeredByPipelineName	Nome do pipeline que aciona a execução do mesmo. Aplicável quando a execução do pipeline é acionada por uma atividade ExecutePipeline. Avalie para Nulo quando usado em outras circunstâncias. Observe o ponto de interrogação após @pipeline()
@pipeline()?. TriggeredByPipelineRunId	ID de execução do pipeline que o inicia. Aplicável quando a execução do pipeline é acionada por uma atividade ExecutePipeline. Avalie para Null quando usado em outras circunstâncias. Observe o ponto de interrogação após @pipeline()

Observação

As variáveis de sistema de data/hora relacionadas com o gatilho (tanto no âmbito do pipeline como do gatilho) retornam datas em UTC no formato ISO 8601, por exemplo, 2017-06-01T22:20:00.4061448Z.

Funções

Você pode chamar funções dentro de expressões. As seções a seguir fornecem informações sobre as funções que podem ser usadas em uma expressão.

Funções de data

Função de data ou hora	Tarefa
adicionarDias	Adicione um número de dias a um carimbo de data/hora.
addHours	Adicione um número de horas a um registo de hora.
adicionarMinutos	Adicione um determinado número de minutos a um carimbo de data/hora.
adicionarSegundos	Adicione um número de segundos a um timestamp.
addToTime	Adicione um número de unidades de tempo a um timestamp. Consulte também o comando getFutureTime.
convertFromUtc	Converta um carimbo de data/hora do Tempo Universal Coordenado (UTC) para o fuso horário de destino.
convertTimeZone	Converta um timestamp do fuso horário de origem para o fuso horário de destino.
convertToUtc	Converta um carimbo de data/hora do fuso horário de origem em Universal Time Coordinated (UTC).
dia do mês	Retorne o componente do dia do mês de um timestamp.
diaDaSemana	Obter o componente dia da semana de um timestamp.
diaDoAno	Retornar o componente dia do ano de um carimbo de data/hora.
formatarDataHora	Retorne o carimbo de data/hora como uma cadeia de caracteres no formato opcional.
getFutureTime	Devolva o timestamp atual mais as unidades de tempo especificadas. Consulte também addToTime.
getPastTime	Devolva o timestamp atual subtraindo das unidades de tempo especificadas. Consulte também subtractFromTime.
inícioDoDia	Retorne o início do dia para um carimbo de data/hora.
inícioDaHora	Retorne o início da hora para um carimbo de data/hora.
inícioDoMês	Retorne o início do mês para um carimbo de data/hora.
subtrairDoTempo	Subtraia um número de unidades de tempo de uma data/hora. Consulte também getPastTime.
carrapatos	Retorne o valor da propriedade `ticks` para um carimbo de data/hora especificado.
utc Agora	Retorne o carimbo de data/hora atual como uma cadeia de caracteres.

Funções de cadeia de caracteres

Para trabalhar com cadeias de caracteres, você pode usar essas funções de cadeia de caracteres e também algumas funções de coleta de . As funções de cadeia de caracteres funcionam apenas em cadeias de caracteres.

Função String	Tarefa
concat	Combine duas ou mais cadeias de caracteres e retorne a cadeia combinada.
termina com	Verifique se uma cadeia de caracteres termina com a subcadeia especificada.
guid	Gere um identificador global exclusivo (GUID) como uma cadeia de caracteres.
indexOf	Retorne a posição inicial da substring.
últimaPosiçãoDe	Retorne a posição inicial para a última ocorrência de uma substring.
substituir	Substitua uma substring pela string especificada e retorne a string atualizada.
dividir	Retorna uma matriz que contém substrings, separadas por vírgulas, de uma cadeia de caracteres maior com base em um caractere delimitador especificado na cadeia de caracteres original.
começaCom	Verifique se uma cadeia de caracteres começa com uma subcadeia de caracteres específica.
substring	Retorna caracteres de uma cadeia de caracteres, começando a partir da posição especificada.
toLower	Retornar uma cadeia de caracteres em formato minúsculo.
toUpper	Retornar uma cadeia de caracteres em formato maiúsculo.
aparar	Remova o espaço em branco à esquerda e à direita de uma cadeia de caracteres e retorne a cadeia de caracteres atualizada.

Funções de recolha

Para trabalhar com coleções, geralmente matrizes, cadeias de caracteres e, às vezes, dicionários, você pode usar essas funções de coleção.

Função de recolha	Tarefa
contém	Verifique se uma coleção tem um item específico.
vazio	Verifique se uma coleção está vazia.
primeira	Retornar o primeiro item de uma coleção.
cruzamento	Retornar uma coleção que tenha apenas os itens comuns nas coleções especificadas.
junte-se a	Retorna uma cadeia de caracteres que contém todos os itens de um array, separados pelo caractere especificado.
últimos	Retornar o último item de uma coleção.
comprimento	Retornar o número de itens em uma cadeia de caracteres ou matriz.
pular	Remova itens da frente de uma coleção e retorne todos os outros itens.
tomar	Devolver itens da parte inicial de uma coleção.
sindicato	Retornar uma coleção que tenha todos os itens das coleções especificadas.

Funções lógicas

Estas funções são úteis dentro das condições, elas podem ser usadas para avaliar qualquer tipo de lógica.

Função de comparação lógica	Tarefa
e	Verifique se todas as expressões são verdadeiras.
é igual a	Verifique se ambos os valores são equivalentes.
maior	Verifique se o primeiro valor é maior que o segundo.
maior ou igual a	Verifique se o primeiro valor é maior ou igual ao segundo valor.
se	Verifique se uma expressão é verdadeira ou falsa. Com base no resultado, retorne um valor especificado.
menos	Verifique se o primeiro valor é menor que o segundo.
menorOuIgual	Verifique se o primeiro valor é menor ou igual ao segundo valor.
não	Verifique se uma expressão é falsa.
ou	Verifique se pelo menos uma expressão é verdadeira.

Funções de conversão

Essas funções são usadas para converter entre cada um dos tipos nativos na linguagem:

string
inteiro
flutuar
Booleano
matrizes
dicionários

Função de conversão	Tarefa
matriz	Retornar uma matriz de uma única entrada especificada. Para várias entradas, consulte createArray.
base64	Retorne a versão codificada em base64 para uma cadeia de caracteres.
base64ToBinary	Retorne a versão binária para uma cadeia de caracteres codificada em base64.
base64ToString	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64.
binário	Retornar a versão binária para um valor de entrada.
bool	Retorne a versão booleana para um valor fornecido.
coalescem	Retorna o primeiro valor não nulo de um ou mais parâmetros.
createArray	Retornar uma matriz de várias entradas.
dataUri	Retornar o URI de dados para um valor de entrada.
dataUriToBinary	Retornar a forma binária de um URI de dados.
dataUriToString	Retornar a versão em string de um URI de dados.
decodeBase64	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64.
decodeDataUri	Devolver a versão binária de um URI de dados.
decodeUriComponent	Retorna uma cadeia de caracteres que substitui caracteres de escape por versões decodificadas.
encodeUriComponent	Retorna uma cadeia de caracteres que substitui caracteres não seguros de URL por caracteres de escape.
flutuar	Retorna um número de ponto flutuante para um valor de entrada.
int	Devolve a versão inteira de uma string.
string	Devolva a representação em forma de cadeia de caracteres de um valor de entrada.
uriComponent	Retorne a versão codificada por URI para um valor de entrada substituindo caracteres não seguros de URL por caracteres de escape.
uriComponentToBinary	Retorne a versão binária para uma cadeia de caracteres codificada por URI.
uriComponentToString	Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada por URI.
xml	Retornar a versão XML de uma string.
xpath	Verifique se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e retorne os nós ou valores correspondentes.

Funções matemáticas

Essas funções podem ser usadas para ambos os tipos de números: inteiros e flutuantes.

Função matemática	Tarefa
adicionar	Retornar o resultado da adição de dois números.
div	Retornar o resultado da divisão de dois números.
máximo	Retornar o valor mais alto de um conjunto de números ou de uma matriz.
min	Retornar o menor valor de um conjunto de números ou de uma matriz.
mod	Retorne o restante da divisão de dois números.
mul	Devolva o produto da multiplicação de dois números.
rand	Retornar um inteiro aleatório de um intervalo especificado.
gama	Retornar uma matriz inteira que começa a partir de um inteiro especificado.
sub	Retornar o resultado subtraindo o segundo número do primeiro número.

Referência de função

Esta seção lista todas as funções disponíveis em ordem alfabética.

adicionar

Retornar o resultado da adição de dois números.

add(<summand_1>, <summand_2>)

Parâmetro	Necessário	Tipo	Descrição
< summand_1>, <summand_2>	Sim	Inteiro, Flutuante ou misto	Os números a adicionar

Valor de retorno	Tipo	Descrição
< soma dos resultados>	Inteiro ou flutuador	O resultado da adição dos números especificados

Exemplo

Este exemplo adiciona os números especificados:

add(1, 1.5)

E devolve este resultado: 2.5

addDias

Adicione um número de dias a um carimbo de data/hora.

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

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	Corda	A cadeia de caracteres que contém o carimbo de data/hora
< dias>	Sim	Inteiro	O número positivo ou negativo de dias a adicionar
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	corda	A data e hora mais o número especificado de dias

Exemplo 1

Este exemplo adiciona 10 dias ao timestamp especificado:

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

E devolve este resultado: "2018-03-25T00:00:0000000Z"

Exemplo 2

Este exemplo subtrai cinco dias do carimbo de data/hora especificado:

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

E devolve este resultado: "2018-03-10T00:00:0000000Z"

adicionarHoras

Adicione um número de horas a um carimbo de data e hora.

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

Parâmetro	Necessário	Tipo	Descrição
< timestamp>	Sim	cadeia de caracteres	A string que contém a marca temporal
< horas>	Sim	Inteiro	O número positivo ou negativo de horas a adicionar
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	Cadeia	A marca temporal mais o número especificado de horas

Exemplo 1

Este exemplo adiciona 10 horas ao carimbo de data/hora especificado:

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

E devolve este resultado: "2018-03-15T10:00:0000000Z"

Exemplo 2

Este exemplo subtrai cinco horas do carimbo de data/hora especificado:

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

E devolve este resultado: "2018-03-15T10:00:0000000Z"

adicionarMinutos

Adicione um número de minutos a um carimbo de data/hora.

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

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	String	A sequência de caracteres que contém o carimbo de data/hora
< minutos>	Sim	Inteiro	O número positivo ou negativo de minutos a adicionar
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	String	A marca temporal mais o número especificado de minutos

Exemplo 1

Este exemplo adiciona 10 minutos à marca temporal especificada.

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

E devolve este resultado: "2018-03-15T00:20:00.0000000Z"

Exemplo 2

Este exemplo subtrai cinco minutos do timestamp especificado.

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

E devolve este resultado: "2018-03-15T00:15:00.0000000Z"

adicionarSegundos

Adicione um número de segundos a um carimbo de data/hora.

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

Parâmetro	Necessário	Tipo	Descrição
< timestamp> carimbo de data/hora	Sim	Cadeia	A string que contém o timestamp
< segundos>	Sim	Inteiro	O número positivo ou negativo de segundos a adicionar
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	String	A marca temporal mais o número especificado de segundos

Exemplo 1

Este exemplo adiciona 10 segundos ao carimbo de data/hora especificado:

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

E devolve este resultado: "2018-03-15T00:00:10.0000000Z"

Exemplo 2

Este exemplo subtrai cinco segundos do timestamp especificado:

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

E devolve este resultado: "2018-03-15T00:00:25.0000000Z"

adicionarAoTempo

Adicione um certo número de unidades de tempo a um timestamp. Consulte também getFutureTime().

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

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	Cadeia	A sequência de caracteres que contém o timestamp
< intervalo>	Sim	Inteiro	O número de unidades de tempo especificadas a serem adicionadas
< unidade de tempo>	Sim	Cordão	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	String	A data/hora somada ao número especificado de unidades de tempo

Exemplo 1

Este exemplo adiciona um dia ao timestamp especificado:

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

E devolve este resultado: "2018-01-02T00:00:00.0000000Z"

Exemplo 2

Este exemplo adiciona um dia ao timestamp especificado.

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

E retorna o resultado usando o formato "D" opcional: "Tuesday, January 2, 2018"

e ainda

Verifique se ambas as expressões são verdadeiras. Retorne verdadeiro quando ambas as expressões forem verdadeiras ou retorne falso quando pelo menos uma expressão for falsa.

and(<expression1>, <expression2>)

Parâmetro	Necessário	Tipo	Descrição
< expression1>, <expression2>	Sim	Booleano	As expressões a verificar

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne verdadeiro quando ambas as expressões forem verdadeiras. Devolva falso quando pelo menos uma expressão esteja falsa.

Exemplo 1

Estes exemplos verificam se os valores booleanos especificados são verdadeiros:

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

E devolve estes resultados:

Primeiro exemplo: Ambas as expressões são verdadeiras, portanto, retorna true.
Segundo exemplo: Uma expressão é falsa, portanto retorna false.
Terceiro exemplo: Ambas as expressões são falsas, portanto, retorna false.

Exemplo 2

Estes exemplos verificam se as expressões especificadas são verdadeiras:

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

E devolve estes resultados:

Primeiro exemplo: Ambas as expressões são verdadeiras, portanto, retorna true.
Segundo exemplo: Uma expressão é falsa, portanto retorna false.
Terceiro exemplo: Ambas as expressões são falsas, portanto, retorna false.

matriz

Retornar uma matriz de uma única entrada especificada. Para várias entradas, consulte createArray().

array('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres para criar uma matriz

Valor de retorno	Tipo	Descrição
[<valor>]	Array	Uma matriz que contém a única entrada especificada

Exemplo

Este exemplo cria uma matriz a partir da cadeia de caracteres "hello":

array('hello')

E devolve este resultado: ["hello"]

base64

Retorne a versão codificada em base64 para uma cadeia de caracteres.

base64('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres de entrada

Valor de retorno	Tipo	Descrição
< > string base64	Corda	A versão codificada em base64 para a cadeia de caracteres de entrada

Exemplo

Este exemplo converte a string "hello" em uma string codificada em base64:

base64('hello')

E devolve este resultado: "aGVsbG8="

base64ToBinary

Retorne a versão binária para uma cadeia de caracteres codificada em base64.

base64ToBinary('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres codificada em base64 para converter

Valor de retorno	Tipo	Descrição
< > binário-para-cadeia-base64	Corda	A versão binária para a cadeia de caracteres codificada em base64

Exemplo

Este exemplo converte a cadeia de caracteres codificada em "aGVsbG8=" base64 em uma cadeia binária:

base64ToBinary('aGVsbG8=')

E devolve este resultado:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64, decodificando efetivamente a cadeia de caracteres base64. Use esta função em vez de decodeBase64(). Embora ambas as funções funcionem da mesma maneira, base64ToString() é preferível.

base64ToString('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres codificada em base64 para descodificar

Valor de retorno	Tipo	Descrição
< cadeia decodificada base64>	Cadeia	A versão de string para uma sequência codificada em base64

Exemplo

Este exemplo converte a string codificada em "aGVsbG8=" base64 em apenas uma string:

base64ToString('aGVsbG8=')

E devolve este resultado: "hello"

binário

Devolve a versão binária de uma cadeia de caracteres.

binary('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres a ser convertida

Valor de retorno	Tipo	Descrição
< binário para valor de entrada>	Corda	A versão binária para a cadeia de caracteres especificada

Exemplo

Este exemplo converte a cadeia de caracteres "hello" em uma string binária:

binary('hello')

E devolve este resultado:

"0110100001100101011011000110110001101111"

Bool

Retorne a versão booleana para obter um valor.

bool(<value>)

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Qualquer	O valor a ser convertido

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	A versão booleana para o valor especificado

Exemplo

Estes exemplos convertem os valores especificados em valores booleanos:

bool(1)
bool(0)

E devolve estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

coalescer

Retorna o primeiro valor não nulo de um ou mais parâmetros. Cadeias de caracteres vazias, matrizes vazias e objetos vazios não são nulos.

coalesce(<object_1>, <object_2>, ...)

Parâmetro	Necessário	Tipo	Descrição
< object_1>, <object_2>, ...	Sim	Qualquer um pode misturar tipos	Um ou mais itens para verificar se são nulos

Valor de retorno	Tipo	Descrição
< primeiro-item-não-nulo>	Qualquer	O primeiro item ou valor que não é nulo. Se todos os parâmetros forem nulos, essa função retornará null.

Exemplo

Estes exemplos retornam o primeiro valor não nulo dos valores especificados ou null quando todos os valores são nulos:

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

E devolve estes resultados:

Primeiro exemplo: true
Segundo exemplo: "hello"
Terceiro exemplo: null

concat

Combine duas ou mais cadeias de caracteres e retorne a cadeia combinada.

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

Parâmetro	Necessário	Tipo	Descrição
< text1>, <text2>, ...	Sim	String	Pelo menos duas cadeias de caracteres para combinar

Valor de retorno	Tipo	Descrição
< text1text2...>	String	A cadeia de caracteres criada a partir das cadeias de caracteres de entrada combinadas

Exemplo

Este exemplo combina as cadeias de caracteres "Hello" e "World":

concat('Hello', 'World')

E devolve este resultado: "HelloWorld"

contém:

Verifique se uma coleção tem um item específico. Retorne true quando o item for encontrado ou retorne false quando não for encontrado. Esta função diferencia maiúsculas de minúsculas.

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

Especificamente, essa função funciona nestes tipos de coleção:

Uma cadeia de caracteres para encontrar uma subcadeia de
Uma matriz para encontrar um valor
Um dicionário para encontrar uma chave

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	String, matriz ou dicionário	A coleção a verificar
< valor>	Sim	String, Array ou Dictionary, respectivamente	O item a ser encontrado

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne verdadeiro quando o item for encontrado. Devolver falso quando não encontrado.

Exemplo 1

Este exemplo verifica a string "hello world" para a substring "world" e retorna true:

contains('hello world', 'world')

Exemplo 2

Este exemplo verifica a string "hello world" para a substring "universe" e retorna false:

contains('hello world', 'universe')

convertFromUtc

Converta um carimbo de data e hora do Tempo Universal Coordenado (UTC) para o fuso horário de destino.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Parâmetro	Necessário	Tipo	Descrição
carimbo de data/hora <>	Sim	Cadeia	A sequência que contém o timestamp
< fusoHorárioDestino>	Sim	Cadeia	O nome do fuso horário de destino. Para nomes de fuso horário, consulte Valores de Fuso Horário da Microsoft, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< > de carimbo de data/hora convertido	Corda	O carimbo de tempo convertido para o fuso horário de destino

Exemplo 1

Este exemplo converte um carimbo de data/hora para o fuso horário especificado:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

E devolve este resultado: "2018-01-01T00:00:00Z"

Exemplo 2

Este exemplo converte um carimbo de data/hora para o fuso horário e formato especificados.

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

E devolve este resultado: "Monday, January 1, 2018"

convertTimeZone

Converta uma marcação temporal do fuso horário de origem para o fuso horário de destino.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Parâmetro	Necessário	Tipo	Descrição
< > marca temporal	Sim	String	A cadeia de caracteres que contém o timestamp
< fuso horário de origem>	Sim	String	O nome do fuso horário de origem. Para nomes de fuso horário, consulte Valores de Fuso Horário da Microsoft, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< fuso horário de destino>	Sim	String	O nome do fuso horário de destino. Para nomes de fuso horário, consulte Valores de Fuso Horário da Microsoft, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< formato>	Não	cadeia de caracteres	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora convertido>	String	A marca temporal convertida para o fuso horário de destino

Exemplo 1

Este exemplo converte o fuso horário de origem no fuso horário de destino:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

E devolve este resultado: "2018-01-01T00:00:00.0000000"

Exemplo 2

Este exemplo converte um fuso horário para o fuso horário e formato especificados:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

E devolve este resultado: "Monday, January 1, 2018"

convertToUtc

Converta um carimbo de data/hora do fuso horário de origem para o Tempo Universal Coordenado (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	String	A string que contém o timestamp
< fuso horário de origem>	Sim	String	O nome do fuso horário de origem. Para nomes de fuso horário, consulte Valores de Fuso Horário da Microsoft, mas talvez seja necessário remover qualquer pontuação do nome de fuso horário.
< formato>	Não	Corda	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora convertido>	String	O carimbo de data/hora convertido em UTC

Exemplo 1

Este exemplo converte um carimbo de data e hora para UTC:

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

E devolve este resultado: "2018-01-01T08:00:00.0000000Z"

Exemplo 2

Este exemplo converte um carimbo de data/hora em UTC:

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

E devolve este resultado: "Monday, January 1, 2018"

createArray

Retornar uma matriz de várias entradas. Para matrizes de entrada única, consulte array().

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

Parâmetro	Necessário	Tipo	Descrição
< object1>, <object2>, ...	Sim	Qualquer, mas não misturado	Pelo menos dois itens para criar a matriz

Valor de retorno	Tipo	Descrição
[<object1>, <object2>, ...]	Matriz	A matriz criada a partir de todos os itens de entrada

Exemplo

Este exemplo cria uma matriz a partir destas entradas:

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

E devolve este resultado: ["h", "e", "l", "l", "o"]

dataUri

Retorne um identificador uniforme de recursos (URI) de dados a partir de uma cadeia de caracteres.

dataUri('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Cadeia	A cadeia de caracteres a ser convertida

Valor de retorno	Tipo	Descrição
< data-uri>	Corda	O URI de dados para a cadeia de caracteres de entrada

Exemplo

Este exemplo cria um URI de dados para a cadeia de caracteres "hello":

dataUri('hello')

E devolve este resultado: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Retornar a versão binária para um URI (identificador de recurso uniforme de dados). Use esta função em vez de decodeDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriBinary() é preferível.

dataUriToBinary('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	O URI dos dados a converter

Valor de retorno	Tipo	Descrição
< binário para uri de dados>	String	A versão binária para o URI de dados

Exemplo

Este exemplo cria uma versão binária para este URI de dados:

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

E devolve este resultado:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Retornar a versão da cadeia de caracteres para um URI (identificador de recurso uniforme de dados).

dataUriToString('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	O URI de dados que deve ser convertido

Valor de retorno	Tipo	Descrição
< string-for-data-uri>	String	A versão da cadeia de caracteres para o URI de dados

Exemplo

Este exemplo cria uma cadeia de caracteres para este URI de dados:

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

E devolve este resultado: "hello"

diaDoMês

Retorne o dia do mês a partir de uma data e hora.

dayOfMonth('<timestamp>')

Parâmetro	Necessário	Tipo	Descrição
< > carimbo de data/hora	Sim	String	A sequência de caracteres que contém o carimbo de data/hora

Valor de retorno	Tipo	Descrição
< dia do mês>	Inteiro	O dia do mês a partir do timestamp especificado

Exemplo

Este exemplo retorna o número do dia do mês deste timestamp:

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

E devolve este resultado: 15

dia da semana

Devolva o dia da semana a partir de um timestamp.

dayOfWeek('<timestamp>')

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	Corda	A cadeia de caracteres que contém o carimbo de data/hora

Valor de retorno	Tipo	Descrição
< dia da semana>	Inteiro	O dia da semana a partir do timestamp especificado, onde domingo é 0, segunda-feira é 1 e assim por diante

Exemplo

Este exemplo retorna o número correspondente ao dia da semana a partir desta marca temporal:

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

E devolve este resultado: 3

dia do ano

Obtenha o dia do ano a partir de um timestamp.

dayOfYear('<timestamp>')

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	Cadeia	A sequência que contém a marcação temporal

Valor de retorno	Tipo	Descrição
< dia do ano>	Inteiro	O dia do ano a partir do timestamp especificado

Exemplo

Este exemplo retorna o número do dia do ano a partir deste carimbo de data/hora.

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

E devolve este resultado: 74

decodeBase64

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada em base64, decodificando efetivamente a cadeia de caracteres base64. Considere usar base64ToString() em vez de decodeBase64(). Embora ambas as funções funcionem da mesma maneira, base64ToString() é preferível.

decodeBase64('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Cadeia	A cadeia de caracteres codificada em base64 para decodificar

Valor de retorno	Tipo	Descrição
< > cadeia de caracteres descodificada em base64	String	A versão em formato texto para uma cadeia codificada em base64

Exemplo

Este exemplo cria uma cadeia de caracteres para uma cadeia de caracteres codificada em base64:

decodeBase64('aGVsbG8=')

E devolve este resultado: "hello"

decodeDataUri

Retornar a versão binária para um URI (identificador de recurso uniforme de dados). Considere usar dataUriToBinary(), em vez de decodeDataUri(). Embora ambas as funções funcionem da mesma maneira, dataUriToBinary() é preferível.

decodeDataUri('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Corda	A cadeia de caracteres de URI de dados a ser decodificada

Valor de retorno	Tipo	Descrição
< binário para uri de dados>	String	A versão binária de uma string URI de dados

Exemplo

Este exemplo retorna a versão binária para este URI de dados:

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

E devolve este resultado:

decodeUriComponent

Retorna uma cadeia de caracteres que substitui caracteres de escape por versões decodificadas.

decodeUriComponent('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Sequência de caracteres	A cadeia de caracteres com os caracteres de escape para decodificar

Valor de retorno	Tipo	Descrição
< > decodificado-uri	Corda	A cadeia de caracteres atualizada com os caracteres de escape decodificados

Exemplo

Este exemplo substitui os caracteres de escape nesta cadeia de caracteres por versões decodificadas:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

E devolve este resultado: "https://contoso.com"

div

Retornar o resultado inteiro da divisão de dois números. Para obter o resultado restante, consulte mod().

div(<dividend>, <divisor>)

Parâmetro	Necessário	Tipo	Descrição
< dividendos>	Sim	Inteiro ou flutuador	O número que será dividido pelo divisor
< divisor>	Sim	Inteiro ou flutuador	O número que divide o dividendo , mas não pode ser 0

Valor de retorno	Tipo	Descrição
< resultado do quociente>	Inteiro	O número inteiro resulta da divisão do primeiro número pelo segundo número

Exemplo

Ambos os exemplos dividem o primeiro número pelo segundo número:

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

E devolva este resultado: 2

encodeUriComponent

Retorna uma versão codificada de URI (identificador de recurso uniforme) para uma cadeia de caracteres substituindo caracteres não seguros de URL por caracteres de escape. Considere usar uriComponent(), em vez de encodeUriComponent(). Embora ambas as funções funcionem da mesma maneira, uriComponent() é preferível.

encodeUriComponent('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres a ser convertida para o formato codificado por URI

Valor de retorno	Tipo	Descrição
< uri codificado>	Cadeia	A cadeia de caracteres codificada por URI com caracteres de escape

Exemplo

Este exemplo cria uma versão codificada por URI para esta cadeia de caracteres:

encodeUriComponent('https://contoso.com')

E devolve este resultado: "http%3A%2F%2Fcontoso.com"

vazio

Verifique se uma coleção está vazia. Retorne true quando a coleção estiver vazia ou retorne false quando não estiver vazio.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	String, matriz ou objeto	A coleção a verificar

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne true quando a coleção estiver vazia. Retornar false quando não estiver vazio.

Exemplo

Estes exemplos verificam se as coleções especificadas estão vazias:

empty('')
empty('abc')

E devolve estes resultados:

Primeiro exemplo: Passa uma cadeia de caracteres vazia, para que a função retorne true.
Segundo exemplo: Passa a string "abc", para que a função retorne false.

termina com

Verifique se uma cadeia de caracteres termina com uma subcadeia específica. Retorne verdadeiro quando a substring for encontrada ou retorne falso quando não for encontrada. Esta função não diferencia maiúsculas de minúsculas.

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

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	Cadeia	A cadeia de caracteres a ser verificada
< texto de pesquisa>	Sim	String	A subsequência final para encontrar

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne verdadeiro quando a substring final for encontrada. Devolve falso quando não encontrado.

Exemplo 1

Este exemplo verifica se a cadeia de caracteres "hello world" termina com a string "world":

endsWith('hello world', 'world')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se a string "hello world" termina com a string "universe":

endsWith('hello world', 'universe')

E devolve este resultado: false

igual a

Verifique se ambos os valores, expressões ou objetos são equivalentes. Retorne true quando ambos forem equivalentes, ou retorne false quando não forem equivalentes.

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

Parâmetro	Necessário	Tipo	Descrição
< object1>, <object2>	Sim	Vários	Os valores, expressões ou objetos a serem comparados

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne verdadeiro quando ambos forem equivalentes. Devolver falso quando não for equivalente.

Exemplo

Estes exemplos verificam se as entradas especificadas são equivalentes.

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

E devolve estes resultados:

Primeiro exemplo: Ambos os valores são equivalentes, portanto, a função retorna true.
Segundo exemplo: Ambos os valores não são equivalentes, portanto, a função retorna false.

primeiro

Retornar o primeiro item de uma cadeia de caracteres ou matriz.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	String ou matriz	A coleção onde encontrar o primeiro item

Valor de retorno	Tipo	Descrição
< primeiro-item-de-coleção>	Qualquer	O primeiro item da coleção

Exemplo

Estes exemplos encontram o primeiro item destas coleções:

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

Então devolva estes resultados:

Primeiro exemplo: "h"
Segundo exemplo: 0

flutuar

Converter uma versão de cadeia de caracteres para um número de ponto flutuante em um número de ponto flutuante real.

float('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A sequência de caracteres que tem um número de ponto flutuante válido para converter

Valor de retorno	Tipo	Descrição
< de valor flutuante>	Flutuar	O número de ponto flutuante para a cadeia de caracteres especificada

Exemplo

Este exemplo cria uma versão de cadeia de caracteres para esse número de vírgula flutuante:

float('10.333')

E devolve este resultado: 10.333

formatDateTime

Retornar um carimbo de data/hora no formato especificado.

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

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	Corda	A string que contém o timestamp
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora reformatado>	String	O carimbo de data/hora atualizado de acordo com o formato especificado

Exemplo

Este exemplo converte um timestamp para o formato especificado:

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

E devolve este resultado: "2018-03-15T12:00:00"

getFutureTime

Retorne o timestamp atual adicionado às unidades de tempo especificadas.

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

Parâmetro	Necessário	Tipo	Descrição
< intervalo>	Sim	Inteiro	O número de unidades de tempo especificadas a serem adicionadas
< unidade de tempo>	Sim	Cadeia	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	Não	Cadeia	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	cadeia de caracteres	A data e hora atuais mais o número especificado de unidades de tempo

Exemplo 1

Suponha que o carimbo de data/hora atual seja "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias a esse carimbo de data/hora:

getFutureTime(5, 'Day')

E devolve este resultado: "2018-03-06T00:00:00.0000000Z"

Exemplo 2

Suponha que a data e hora atual seja "2018-03-01T00:00:00.0000000Z". Este exemplo adiciona cinco dias e converte o resultado para o formato "D":

getFutureTime(5, 'Day', 'D')

E devolve este resultado: "Tuesday, March 6, 2018"

obterTempoPassado

Retorne a data e hora atual menos as unidades de tempo especificadas.

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

Parâmetro	Necessário	Tipo	Descrição
< intervalo>	Sim	Inteiro	O número de unidades de tempo especificadas para subtrair
< unidade de tempo>	Sim	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	String	A data/hora atual menos o número especificado de unidades de tempo

Exemplo 1

Suponha que a data/hora corrente seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias desse timestamp.

getPastTime(5, 'Day')

E devolve este resultado: "2018-01-27T00:00:00.0000000Z"

Exemplo 2

Suponha que o carimbo de data/hora atual seja "2018-02-01T00:00:00.0000000Z". Este exemplo subtrai cinco dias e converte o resultado para o formato "D":

getPastTime(5, 'Day', 'D')

E devolve este resultado: "Saturday, January 27, 2018"

maior

Verifique se o primeiro valor é maior que o segundo. Retorne true quando o primeiro valor for mais ou retorne false quando for menor.

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

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Inteiro, Ponto Flutuante ou String	O primeiro valor para verificar se é maior que o segundo valor
< compararCom>	Sim	Inteiro, Ponto Flutuante ou String, respectivamente	O valor de comparação

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne true quando o primeiro valor for maior que o segundo. Retorne false quando o primeiro valor for igual ou menor que o segundo valor.

Exemplo

Estes exemplos verificam se o primeiro valor é maior do que o segundo:

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

E retorne estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

greaterOrEquals

Verifique se o primeiro valor é maior ou igual ao segundo valor. Retorne true quando o primeiro valor for maior ou igual, ou retorne false quando o primeiro valor for menor.

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

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Inteiro, Número de Ponto Flutuante ou String	O primeiro valor para verificar se maior ou igual ao segundo valor
< compararCom>	Sim	Inteiro, Ponto flutuante ou String, respectivamente	O valor de comparação

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorna true quando o primeiro valor é maior ou igual ao segundo valor. Retorna false quando o primeiro valor é menor que o segundo valor.

Exemplo

Estes exemplos verificam se o primeiro valor é maior ou igual ao segundo valor:

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

E devolva estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

GUID (Identificador Globalmente Único)

Gere um identificador global exclusivo (GUID) como uma cadeia de caracteres, por exemplo, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Além disso, você pode especificar um formato diferente para o GUID diferente do formato padrão, "D", que é de 32 dígitos separados por hífenes.

guid('<format>')

Parâmetro	Necessário	Tipo	Descrição
< formato>	Não	String	Um único especificador de formato para o GUID retornado. Por padrão, o formato é "D", mas você pode usar "N", "D", "B", "P" ou "X".

Valor de retorno	Tipo	Descrição
< > valor GUID	Cadeia	Um GUID gerado aleatoriamente

Exemplo

Este exemplo gera o mesmo GUID, mas como 32 dígitos, separados por hífenes e entre parênteses:

guid('P')

E devolve este resultado: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

se

Verifique se uma expressão é verdadeira ou falsa. Com base no resultado, retorne um valor especificado.

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

Parâmetro	Necessário	Tipo	Descrição
< expressão>	Sim	Booleano	A expressão a verificar
< valorSeVerdadeiro>	Sim	Qualquer	O valor a ser retornado quando a expressão for verdadeira
< valueIfFalse>	Sim	Qualquer	O valor a retornar quando a expressão for falsa

Valor de retorno	Tipo	Descrição
< valor de retorno especificado>	Qualquer	O valor especificado que retorna com base em se a expressão é true ou false

Exemplo

Este exemplo retorna "yes" porque a expressão especificada retorna true. Caso contrário, o exemplo retorna "no":

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

indexOf

Retornar a posição inicial ou o valor do índice para uma substring. Essa função não diferencia maiúsculas de minúsculas e os índices começam com o número 0.

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

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	String	A cadeia de caracteres que tem a substring para localizar
< textoPesquisa>	Sim	cadeia de caracteres	A substring a ser localizada

Valor de retorno	Tipo	Descrição
< valor de índice>	Inteiro	A posição inicial ou o valor do índice para a subcadeia de caracteres especificada. Se a cadeia de caracteres não for encontrada, retorne o número -1.

Exemplo

Este exemplo localiza o valor de índice inicial para a substring "world" na string "hello world":

indexOf('hello world', 'world')

E devolve este resultado: 6

Int

Retorne o valor inteiro de uma string.

int('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres a ser convertida

Valor de retorno	Tipo	Descrição
< resultado inteiro>	Inteiro	A versão inteira para a cadeia de caracteres especificada

Exemplo

Este exemplo cria uma versão inteira para a cadeia de caracteres "10":

int('10')

E devolve este resultado: 10

Json

Retorne o valor ou objeto do tipo JSON (JavaScript Object Notation) para uma cadeia de caracteres ou XML.

json('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String ou XML	A cadeia de caracteres ou XML a ser convertido

Valor de retorno	Tipo	Descrição
< resultado JSON>	Tipo ou objeto nativo JSON	O valor ou objeto do tipo nativo JSON para a cadeia de caracteres ou XML especificado. Se a cadeia de caracteres for null, a função retornará um objeto vazio.

Exemplo 1

Este exemplo converte essa cadeia de caracteres para o valor JSON:

json('[1, 2, 3]')

E devolve este resultado: [1, 2, 3]

Exemplo 2

Este exemplo converte essa cadeia de caracteres em JSON:

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

E devolve este resultado:

{
  "fullName": "Sophia Owen"
}

Exemplo 3

Este exemplo converte este XML em JSON:

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

E devolve este resultado:

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

cruzamento

Retornar uma coleção que tenha apenas os itens comuns nas coleções especificadas. Para aparecer no resultado, um item deve aparecer em todas as coleções passadas para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome aparecerá no resultado.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção1>, <coleção2>, ...	Sim	Array ou Object, mas não ambos	As coleções das quais desejas apenas os itens comuns

Valor de retorno	Tipo	Descrição
< itens comuns>	Array ou Objeto, respectivamente	Uma coleção que tem apenas os itens comuns nas coleções especificadas

Exemplo

Este exemplo localiza os itens comuns nessas matrizes:

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

E retorna uma matriz com apenas estes itens: [1, 2]

aderir

Retorna uma cadeia de caracteres que tem todos os itens de uma matriz e tem cada caractere separado por um delimitador de .

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	Matriz	A matriz que tem os itens para unir
< delimitador>	Sim	String	O separador que aparece entre cada caractere na cadeia de caracteres resultante

Valor de retorno	Tipo	Descrição
< char1><delimitador><char2><delimitador>...	Corda	A cadeia de caracteres resultante criada a partir de todos os itens na matriz especificada

Exemplo

Este exemplo cria uma cadeia de caracteres de todos os itens nessa matriz com o caractere especificado como delimitador:

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

E devolve este resultado: "a.b.c"

último

Retornar o último item de uma coleção.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	String ou matriz	A coleção onde encontrar o último item

Valor de retorno	Tipo	Descrição
< > do último item de coleção	String ou Array, respectivamente	O último item da coleção

Exemplo

Estes exemplos encontram o último item destas coleções:

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

E devolve estes resultados:

Primeiro exemplo: "d"
Segundo exemplo: 3

lastIndexOf

Retornar a posição inicial ou o valor do índice para a última ocorrência de uma determinada substring. Essa função não diferencia maiúsculas de minúsculas e os índices começam com o número 0.

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

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	String	A cadeia de caracteres que contém a substring a localizar
< searchText>	Sim	String	A substring a ser localizada

Valor de retorno	Tipo	Descrição
< valor de índice final>	Inteiro	A posição inicial ou o valor do índice para a última ocorrência da substring especificada. Se a cadeia de caracteres não for encontrada, retorne o número -1.

Exemplo

Este exemplo localiza o valor de índice inicial para a última ocorrência da substring "world" na string "hello world":

lastIndexOf('hello world', 'world')

E devolve este resultado: 6

comprimento

Retornar o número de itens numa coleção.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	String ou matriz	A coleção com os itens a contar

Valor de retorno	Tipo	Descrição
< número ou comprimento>	Inteiro	O número de itens na coleção

Exemplo

Estes exemplos contam o número de itens nessas coleções:

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

E devolva este resultado: 4

menos

Verifique se o primeiro valor é menor que o segundo. Retorne true quando o primeiro valor for menor ou retorne false quando o primeiro valor for mais.

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

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Inteiro, Float ou String	O primeiro valor para verificar se é menor que o segundo valor
< comparaCom>	Sim	Inteiro, Ponto Flutuante ou String, respectivamente	O item de comparação

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne true quando o primeiro valor for menor que o segundo. Devolver falso quando o primeiro valor for igual ou maior que o segundo valor.

Exemplo

Estes exemplos verificam se o primeiro valor é menor que o segundo.

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

E apresente estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

menor ou igual

Verifique se o primeiro valor é menor ou igual ao segundo valor. Retorne true quando o primeiro valor for menor ou igual, ou retorne false quando o primeiro valor for mais.

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

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Inteiro, Ponto Flutuante ou String	O primeiro valor para verificar se menor ou igual ao segundo valor
< compareTo>	Sim	Inteiro, Flutuante ou String, respectivamente	O item de comparação

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Devolva verdadeiro quando o primeiro valor for menor ou igual ao segundo valor. Retorne false quando o primeiro valor for maior que o segundo.

Exemplo

Estes exemplos verificam se o primeiro valor é menor ou igual ao segundo valor.

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

E devolva estes resultados:

Primeiro exemplo: true
Segundo exemplo: false

máx.

Retornar o valor mais alto de uma lista ou matriz com números que são inclusivos em ambas as extremidades.

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

Parâmetro	Necessário	Tipo	Descrição
< número1>, <número2>, ...	Sim	Inteiro, Ponto flutuante ou ambos	O conjunto de números do qual você deseja o valor mais alto
[<número1>, <número2>, ...]	Sim	Array - Inteiro, Float ou ambos	A matriz de números a partir da qual você deseja o valor mais alto

Valor de retorno	Tipo	Descrição
< valor máximo>	Inteiro ou flutuador	O valor mais alto na matriz ou conjunto de números especificado

Exemplo

Estes exemplos obtêm o valor mais alto do conjunto de números e da matriz:

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

E devolva este resultado: 3

min

Retornar o menor valor de um conjunto de números ou de uma matriz.

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

Parâmetro	Necessário	Tipo	Descrição
< número1>, <número2>, ...	Sim	Inteiro, Flutuante ou ambos	O conjunto de números do qual você deseja o menor valor
[<número1>, <número2>, ...]	Sim	Array - Inteiro, Float ou ambos	A matriz de números a partir da qual você deseja o menor valor

Valor de retorno	Tipo	Descrição
< valor mínimo>	Inteiro ou flutuador	O valor mais baixo no conjunto especificado de números ou matriz especificada

Exemplo

Estes exemplos obtêm o menor valor no conjunto de números e na matriz:

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

E devolva este resultado: 1

Modificação

Retorne o restante da divisão de dois números. Para obter o resultado inteiro, consulte div().

mod(<dividend>, <divisor>)

Parâmetro	Necessário	Tipo	Descrição
< dividendos>	Sim	Inteiro ou flutuador	O número a ser dividido pelo divisor
< divisor>	Sim	Inteiro ou flutuador	O número que divide o dividendo , mas não pode ser 0.

Valor de retorno	Tipo	Descrição
< resultado do módulo>	Número inteiro ou flutuante	O restante da divisão do primeiro número pelo segundo número

Exemplo

Este exemplo divide o primeiro número pelo segundo número:

mod(3, 2)

E devolva este resultado: 1

Mul

Devolva o produto multiplicando dois números.

mul(<multiplicand1>, <multiplicand2>)

Parâmetro	Necessário	Tipo	Descrição
< multiplicand1>	Sim	Inteiro ou flutuador	O número a multiplicar por multiplicand2
< multiplicand2>	Sim	Inteiro ou flutuador	O número que multiplica multiplicand1

Valor de retorno	Tipo	Descrição
< produto-resultado>	Inteiro ou flutuador	O produto da multiplicação do primeiro número pelo segundo número

Exemplo

Estes exemplos multiplicam o primeiro número pelo segundo número:

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

E retorne estes resultados:

Primeiro exemplo: 2
Segundo exemplo 3

não

Verifique se uma expressão é falsa. Retorne verdadeiro quando a expressão for falsa, ou retorne falso quando for verdadeira.

not(<expression>)

Parâmetro	Necessário	Tipo	Descrição
< expressão>	Sim	Booleano	A expressão a verificar

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne verdadeiro quando a expressão for falsa. Devolva falso quando a expressão for verdadeira.

Exemplo 1

Estes exemplos verificam se as expressões especificadas são falsas:

not(false)
not(true)

E devolva estes resultados:

Primeiro exemplo: A expressão é false, portanto, a função retorna true.
Segundo exemplo: A expressão é true, portanto, a função retorna false.

Exemplo 2

Estes exemplos verificam se as expressões especificadas são falsas:

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

E apresente os seguintes resultados:

Primeiro exemplo: A expressão é false, portanto, a função retorna true.
Segundo exemplo: A expressão é true, portanto, a função retorna false.

ou

Verifique se pelo menos uma expressão é verdadeira. Retorna verdadeiro quando pelo menos uma expressão for verdadeira, ou retorna falso quando ambas forem falsas.

or(<expression1>, <expression2>)

Parâmetro	Necessário	Tipo	Descrição
< expressão1>, <expressão2>	Sim	Booleano	As expressões a verificar

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Devolve verdadeiro quando pelo menos uma expressão for verdadeira. Retorne false quando ambas as expressões forem falsas.

Exemplo 1

Estes exemplos verificam se pelo menos uma expressão é verdadeira:

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

E devolva estes resultados:

Primeiro exemplo: Pelo menos uma expressão é verdadeira, portanto, a função retorna true.
Segundo exemplo: Ambas as expressões são falsas, portanto, a função retorna false.

Exemplo 2

Estes exemplos verificam se pelo menos uma expressão é verdadeira:

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

E devolva estes resultados:

Primeiro exemplo: Pelo menos uma expressão é verdadeira, portanto, a função retorna true.
Segundo exemplo: Ambas as expressões são falsas, portanto, a função retorna false.

rand

Retorna um inteiro aleatório de um intervalo especificado, que é inclusivo apenas na extremidade inicial.

rand(<minValue>, <maxValue>)

Parâmetro	Necessário	Tipo	Descrição
< valorMínimo>	Sim	Inteiro	O número inteiro mais baixo do intervalo
< maxValue>	Sim	Inteiro	O inteiro que segue o número inteiro mais alto no intervalo que a função pode retornar

Valor de retorno	Tipo	Descrição
< resultado aleatório>	Inteiro	O inteiro aleatório retornado a partir do intervalo especificado

Exemplo

Este exemplo obtém um inteiro aleatório do intervalo especificado, excluindo o valor máximo:

rand(1, 5)

E retorna um destes números como resultado: 1, 2, 3ou 4

gama

Retornar uma matriz inteira que começa a partir de um inteiro especificado.

range(<startIndex>, <count>)

Parâmetro	Necessário	Tipo	Descrição
< startIndex>	Sim	Inteiro	Um valor inteiro que inicia a matriz como o primeiro item
< contagem>	Sim	Inteiro	O número de inteiros na matriz

Valor de retorno	Tipo	Descrição
[<intervalo-resultado>]	Matriz	A matriz com inteiros a partir do índice especificado

Exemplo

Este exemplo cria uma matriz inteira que começa a partir do índice especificado e tem o número especificado de inteiros:

range(1, 4)

E devolve este resultado: [1, 2, 3, 4]

substituir

Substitua uma substring pela string especificada e retorne a string de resultado. Esta função diferencia maiúsculas de minúsculas.

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

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	Corda	A cadeia de caracteres que tem a substring para substituir
< oldText>	Sim	String	A substring a substituir
< novoTexto>	Sim	Cadeia	A cadeia de caracteres de substituição

Valor de retorno	Tipo	Descrição
< texto atualizado>	String	A cadeia de caracteres atualizada após a substituição da substring Se a substring não for encontrada, retorne a cadeia de caracteres original.

Exemplo

Este exemplo localiza a substring "old" em "the old string" e substitui "old" por "new":

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

E devolve este resultado: "the new string"

pular

Remova itens da frente de uma coleção e retorne todos os outros itens.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	Matriz	A coleção cujos itens você deseja remover
< contagem>	Sim	Inteiro	Um número inteiro positivo para o número de itens a remover na frente

Valor de retorno	Tipo	Descrição
[<coleção atualizada>]	Matriz	A coleção atualizada depois de remover os itens especificados

Exemplo

Este exemplo remove um item, o número 0, da frente da matriz especificada:

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

E retorna essa matriz com os itens restantes: [1,2,3]

divisão

Retorna uma matriz que contém substrings, separadas por vírgulas, com base no caractere delimitador especificado na cadeia de caracteres original.

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

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	String	A cadeia de caracteres a ser separada em substrings com base no delimitador especificado na string original
< delimitador>	Sim	Cadeia	O caractere na cadeia de caracteres original a ser usado como delimitador

Valor de retorno	Tipo	Descrição
[<substring1>,<substring2>,...]	Array	Uma matriz que contém subcadeias da cadeia de caracteres original, separadas por vírgulas

Exemplo

Este exemplo cria uma matriz com substrings da cadeia de caracteres especificada com base no caractere especificado como delimitador:

split('a_b_c', '_')

E retorna essa matriz como resultado: ["a","b","c"]

inícioDoDia

Retorne o início do dia para uma marca temporal.

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

Parâmetro	Necessário	Tipo	Descrição
carimbo de data/hora <>	Sim	corda	A cadeia de caracteres que contém o carimbo de data/hora
< formato>	Não	Fio	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	String	O carimbo de data/hora especificado, mas começando na marca de zero hora para o dia

Exemplo

Este exemplo encontra o início do dia para este marca temporal:

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

E devolve este resultado: "2018-03-15T00:00:00.0000000Z"

início da hora

Devolve o início da hora para um timestamp.

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

Parâmetro	Necessário	Tipo	Descrição
< > de carimbo de data/hora	Sim	String	A string que contém o timestamp
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	Cadeia	O carimbo de data/hora especificado, mas começando no minuto zero para a hora

Exemplo

Este exemplo localiza o início da hora para este timestamp.

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

E devolve este resultado: "2018-03-15T13:00:00.0000000Z"

iníciodemês

Retorne o início do mês para um carimbo de data/hora.

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

Parâmetro	Necessário	Tipo	Descrição
< carimbo de data/hora>	Sim	Corda	A cadeia de caracteres que contém o carimbo de data/hora
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	Corda	O carimbo de data/hora especificado, mas começando no primeiro dia do mês na marca de zero hora

Exemplo

Este exemplo devolve o início do mês para esta data e hora.

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

E devolve este resultado: "2018-03-01T00:00:00.0000000Z"

começaCom

Verifique se uma cadeia de caracteres começa com uma subcadeia de caracteres específica. Retorne true quando a substring for encontrada ou retorne false quando não for encontrado. Esta função não diferencia maiúsculas de minúsculas.

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

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	String	A cadeia de caracteres a verificar
< texto de pesquisa>	Sim	String	A cadeia de caracteres inicial para localizar

Valor de retorno	Tipo	Descrição
verdadeiro ou falso	Booleano	Retorne verdadeiro quando for encontrada a substring inicial. Retornar falso quando não encontrado.

Exemplo 1

Este exemplo verifica se a string "hello world" começa com a substring "hello":

startsWith('hello world', 'hello')

E devolve este resultado: true

Exemplo 2

Este exemplo verifica se a cadeia de caracteres "hello world" começa com a substring "greetings":

startsWith('hello world', 'greetings')

E devolve este resultado: false

string

Devolva a versão em cadeia de caracteres de um valor.

string(<value>)

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Qualquer	O valor a converter

Valor de retorno	Tipo	Descrição
< valor de cadeia de caracteres>	Cadeia	A versão da cadeia de caracteres para o valor especificado

Exemplo 1

Este exemplo cria a versão da cadeia de caracteres para esse número:

string(10)

E devolve este resultado: "10"

Exemplo 2

Este exemplo cria uma cadeia de caracteres para o objeto JSON especificado e usa o caractere de barra invertida (\) como um caractere de escape para as aspas duplas (").

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

E devolve este resultado: "{ \\"name\\": \\"Sophie Owen\\" }"

sub

Retornar o resultado subtraindo o segundo número do primeiro número.

sub(<minuend>, <subtrahend>)

Parâmetro	Necessário	Tipo	Descrição
< minuend>	Sim	Inteiro ou flutuador	O número do qual subtrair o subtrahend
< subtraendo>	Sim	Inteiro ou flutuador	O número a subtrair do minuend

Valor de retorno	Tipo	Descrição
< resultado>	Inteiro ou flutuador	O resultado da subtração do segundo número do primeiro número

Exemplo

Este exemplo subtrai o segundo número do primeiro número:

sub(10.3, .3)

E devolve este resultado: 10

substring

Retorna caracteres de uma cadeia de caracteres, começando a partir da posição especificada ou índice. Os valores de índice começam com o número 0.

substring('<text>', <startIndex>, <length>)

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	String	A cadeia de caracteres cujos caracteres você deseja
< startIndex>	Sim	Inteiro	Um número positivo igual ou superior a 0 que pretende utilizar como posição inicial ou valor de índice
< comprimento>	Sim	Inteiro	Um número positivo de caracteres que você deseja na substring

Valor de retorno	Tipo	Descrição
< substring-result>	Corda	Uma substring com o número especificado de caracteres, começando na posição de índice especificada na cadeia de caracteres de origem

Exemplo

Este exemplo cria uma substring de cinco caracteres a partir da cadeia de caracteres especificada, começando a partir do valor de índice 6:

substring('hello world', 6, 5)

E devolve este resultado: "world"

subtrairFromTime

Subtraia um número de unidades de tempo de uma marca de tempo. Consulte também getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Parâmetro	Necessário	Tipo	Descrição
< > marca temporal	Sim	Corda	A cadeia de caracteres que contém o timestamp
< intervalo>	Sim	Inteiro	O número de unidades de tempo especificadas para subtrair
< unidade de tempo>	Sim	String	A unidade de tempo a utilizar com intervalo: "Segundo", "Minuto", "Hora", "Dia", "Semana", "Mês", "Ano"
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< carimbo de data/hora atualizado>	Corda	O timestamp menos o número especificado de unidades de tempo

Exemplo 1

Este exemplo subtrai um dia deste timestamp:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

E devolve este resultado: "2018-01-01T00:00:00:0000000Z"

Exemplo 2

Este exemplo subtrai um dia deste carimbo de data/hora:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

E retorna esse resultado usando o formato "D" opcional: "Monday, January, 1, 2018"

tomar

Devolver itens do início de uma coleção.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção>	Sim	String ou matriz	A coleção cujos itens você deseja
< contagem>	Sim	Número Inteiro	Um número inteiro positivo referente ao número de itens que desejas desde o início.

Valor de retorno	Tipo	Descrição
< subconjunto> ou [<subconjunto>]	String ou Array, respectivamente	Uma cadeia de caracteres ou matriz que possui o número especificado de itens retirados do início da coleção original.

Exemplo

Estes exemplos obtêm o número especificado de itens do início dessas coleções.

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

E devolva estes resultados:

Primeiro exemplo: "abc"
Segundo exemplo: [0, 1, 2]

carrapatos

Retorne o valor da propriedade ticks para um carimbo de data/hora especificado. Um de tick é um intervalo de 100 nanossegundos.

ticks('<timestamp>')

Parâmetro	Necessário	Tipo	Descrição
< > carimbo de data e hora	Sim	String	A cadeia de caracteres para um selo temporal

Valor de retorno	Tipo	Descrição
< número de ticks>	Inteiro	O número de ticks que decorreram desde as 12:00:00 meia-noite, 1 de janeiro de 0001 no calendário gregoriano desde o carimbo de data/hora de entrada

paraMais baixo

Retornar uma cadeia de caracteres em formato minúsculo. Se um caractere na cadeia de caracteres não tiver uma versão minúscula, esse caractere permanecerá inalterado na cadeia de caracteres retornada.

toLower('<text>')

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	Corda / Cadeia	A cadeia de caracteres a ser retornada em formato minúsculo

Valor de retorno	Tipo	Descrição
< texto minúsculo>	String	A cadeia de caracteres original em formato minúsculo

Exemplo

Este exemplo converte essa cadeia de caracteres em minúsculas:

toLower('Hello World')

E devolve este resultado: "hello world"

toUpper

Retornar uma cadeia de caracteres em formato maiúsculo. Se um caractere na cadeia de caracteres não tiver uma versão em maiúsculas, esse caractere permanecerá inalterado na cadeia de caracteres retornada.

toUpper('<text>')

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	Cadeia	A cadeia de caracteres a ser retornada em formato maiúsculo

Valor de retorno	Tipo	Descrição
< texto em maiúsculas>	Cadeia	A cadeia de caracteres original em formato maiúsculo

Exemplo

Este exemplo converte essa cadeia de caracteres em maiúsculas:

toUpper('Hello World')

E devolve este resultado: "HELLO WORLD"

guarnição

Remova o espaço em branco à esquerda e à direita de uma cadeia de caracteres e retorne a cadeia de caracteres atualizada.

trim('<text>')

Parâmetro	Necessário	Tipo	Descrição
< texto>	Sim	String	A cadeia de caracteres da qual se devem remover os espaços em branco à esquerda e à direita.

Valor de retorno	Tipo	Descrição
< textoAtualizado>	String	Uma versão atualizada para a cadeia de caracteres original sem espaço em branco à esquerda ou à direita

Exemplo

Este exemplo remove o espaço em branco à esquerda e à direita da cadeia de caracteres " Hello World ":

trim(' Hello World  ')

E devolve este resultado: "Hello World"

União

Retorne uma coleção que inclua todos os itens das coleções especificadas. Para aparecer no resultado, um item pode aparecer em qualquer coleção passada para essa função. Se um ou mais itens tiverem o mesmo nome, o último item com esse nome aparecerá no resultado.

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

Parâmetro	Necessário	Tipo	Descrição
< coleção1>, <coleção2>, ...	Sim	Array ou Object, mas não ambos	As coleções de onde você deseja todos os itens itens

Valor de retorno	Tipo	Descrição
< coleçãoAtualizada>	Array ou Objeto, respectivamente	Uma coleção com todos os itens das coleções especificadas - sem duplicatas

Exemplo

Este exemplo obtém todos os itens de essas coleções:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

E devolve este resultado: [1, 2, 3, 10, 101]

componente URI

Retorna uma versão codificada de URI (identificador de recurso uniforme) para uma cadeia de caracteres substituindo caracteres não seguros de URL por caracteres de escape. Use esta função em vez de encodeUriComponent(). Embora ambas as funções funcionem da mesma maneira, uriComponent() é preferível.

uriComponent('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres a ser convertida para o formato codificado por URI

Valor de retorno	Tipo	Descrição
< URI codificado>	String	A cadeia de caracteres codificada por URI com caracteres de escape

Exemplo

Este exemplo cria uma versão codificada por URI para esta cadeia de caracteres:

uriComponent('https://contoso.com')

E devolve este resultado: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Retornar a versão binária de um componente de identificador de recurso uniforme (URI).

uriComponentToBinary('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres codificada por URI para converter

Valor de retorno	Tipo	Descrição
< binário para URI codificado>	String	A versão binária para a cadeia de caracteres codificada por URI. O conteúdo binário é codificado em base64 e representado por `$content`.

Exemplo

Este exemplo cria a versão binária para essa cadeia de caracteres codificada por URI:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

E devolve este resultado:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Retorne a versão da cadeia de caracteres para uma cadeia de caracteres codificada por URI (identificador de recurso uniforme), decodificando efetivamente a cadeia de caracteres codificada por URI.

uriComponentToString('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	String	A cadeia de caracteres codificada por URI a descodificar

Valor de retorno	Tipo	Descrição
< uri decodificado>	Corda	A versão decodificada para a cadeia de caracteres codificada por URI

Exemplo

Este exemplo cria a versão da cadeia de caracteres decodificada para essa cadeia de caracteres codificada por URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

E devolve este resultado: "https://contoso.com"

utcNow

Retornar o carimbo de data/hora atual.

utcNow('<format>')

Opcionalmente, você pode especificar um formato diferente com o parâmetro de formato <>.

Parâmetro	Necessário	Tipo	Descrição
< formato>	Não	String	Um especificador de formato único ou um padrão de formato personalizado . O formato padrão para o carimbo de data/hora é "o" (aaaa-MM-ddTHH:mm:ss.fffffffK), que está em conformidade com ISO 8601 e preserva as informações de fuso horário.

Valor de retorno	Tipo	Descrição
< > carimbo de data/hora atual	String	A data e hora atuais

Exemplo 1

Suponha que hoje é 15 de abril de 2018 às 13:00:00. Este exemplo obtém a marca temporal atual:

utcNow()

E devolve este resultado: "2018-04-15T13:00:00.0000000Z"

Exemplo 2

Suponha que hoje é 15 de abril de 2018 às 13:00:00. Este exemplo obtém a marca temporal atual usando o formato "D" opcional:

utcNow('D')

E devolve este resultado: "Sunday, April 15, 2018"

XML

Retornar a versão XML para uma cadeia de caracteres que contém um objeto JSON.

xml('<value>')

Parâmetro	Necessário	Tipo	Descrição
< valor>	Sim	Corda	A cadeia de caracteres com o objeto JSON para converter O objeto JSON deve ter apenas uma propriedade raiz, que não pode ser uma matriz. Use o símbolo de barra invertida (\) como um símbolo de escape para as aspas duplas (").

Valor de retorno	Tipo	Descrição
< xml-version>	Objeto	O XML codificado para a cadeia de caracteres especificada ou objeto JSON

Exemplo 1

Este exemplo cria a versão XML para essa cadeia de caracteres, que contém um objeto JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

E retorna este resultado XML:

<name>Sophia Owen</name>

Exemplo 2

Suponha que você tenha este objeto JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Este exemplo cria XML para uma cadeia de caracteres que contém esse objeto JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

E retorna este resultado XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

XPath

Verifique se há nós ou valores que correspondam a uma expressão XPath (XML Path Language) e retorne os nós ou valores correspondentes. Uma expressão XPath, ou apenas "XPath", ajuda você a navegar por uma estrutura de documento XML para que você possa selecionar nós ou valores de computação no conteúdo XML.

xpath('<xml>', '<xpath>')

Parâmetro	Necessário	Tipo	Descrição
< xml>	Sim	Qualquer	A cadeia de caracteres XML para procurar nós ou valores que correspondam a um valor de expressão XPath
< > xpath	Sim	Qualquer	A expressão XPath usada para localizar nós ou valores XML correspondentes

Valor de retorno	Tipo	Descrição
< xml-node>	XML	Um nó XML quando apenas um único nó corresponde à expressão XPath especificada
< valor>	Qualquer	O valor de um nó XML quando só um valor corresponde à expressão XPath especificada
[<xml-node1>, <xml-node2>, ...] -ou- [<valor1>, <valor2>, ...]	Matriz	Uma matriz com nós XML ou valores que correspondem à expressão XPath especificada

Exemplo 1

Seguindo no Exemplo 1, este exemplo localiza nós que correspondem ao nó <count></count> e adiciona esses valores de nó com a função sum():

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

E devolve este resultado: 30

Exemplo 2

Neste exemplo, ambas as expressões localizam nós que correspondem ao nó <location></location>, nos argumentos especificados, que incluem XML com um namespace. As expressões usam o caractere de barra invertida (\) como um caractere de escape para as aspas duplas (").

Expressão 1

xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Expressão 2

xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Eis os argumentos:

Este XML, que inclui o namespace do documento XML, xmlns="http://contoso.com":

<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>

Uma das expressões XPath aqui:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Aqui está o nó de resultado que corresponde ao nó <location></location>:

<location xmlns="https://contoso.com">Paris</location>

Exemplo 3

Seguindo no Exemplo 3, este exemplo localiza o valor no nó <location></location>:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

E devolve este resultado: "Paris"

Observação

Pode-se adicionar comentários a expressões de fluxo de dados, mas não em expressões de pipeline.

Para obter instruções sobre o uso geral de parâmetros, consulte Parâmetros do Data Factory no Fabric

Partilhar via

Expressões e funções para o Data Factory no Microsoft Fabric

Expressões

Exemplos

Exemplo de expressão complexa

Editor de conteúdo dinâmico

Substituindo caracteres especiais

Escapando do caractere de aspas simples

Variáveis de escopo do pipeline

Funções

Funções de data

Funções de cadeia de caracteres

Funções de recolha

Funções lógicas

Funções de conversão

Funções matemáticas

Referência de função

adicionar

addDias

adicionarHoras

adicionarMinutos

adicionarSegundos

adicionarAoTempo

e ainda

matriz

base64

base64ToBinary

base64ToString

binário

Bool

coalescer

concat

contém:

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

diaDoMês

dia da semana

dia do ano

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

vazio

termina com

igual a

primeiro

flutuar

formatDateTime

getFutureTime

obterTempoPassado

maior

greaterOrEquals

GUID (Identificador Globalmente Único)

se

indexOf

Int

Json

cruzamento

aderir

último

lastIndexOf

comprimento

menos

menor ou igual

máx.

min

Modificação

Mul

não

ou

rand

gama

substituir

pular