Visão geral

Expressões são fórmulas utilizadas na plataforma de forma muito semelhante às usadas em programas de planilha, como a do Microsoft Excel. Embora tenham evoluído com o tempo e essas semelhanças sejam muito menores agora. É uma linguagem de modelagem baseada em expressões que visa facilitar a geração de texto a partir de um contexto de valores.

Nesse artigo trataremos um pouco sobre:

• Modelos
• Tipos
• Operadores
• Funções

Modelos

Expressões podem ser chamadas usando o seguinte modelo: @(...).

Por exemplo, o modelo Hi @(""Dr "" & upper(foo))pega o valor da variável @foo, converte para maiúsculas e o prefixa com outra palavra. Observe que dentro de uma expressão complexa você não precisa colocar @ antes de todas as variáveis.

Tipos

Temos os seguintes tipos de expressões aceitos na plataforma: Array: usado para a criação de um array de itens:

Booleano: é um booleano verdadeiroou falso

Data: é um valor de data do calendário gregoriano

Data e Hora: é um valor de data e hora

Função: é uma função que pode ser chamada

Número: é um número inteiro ou fracionado

Objeto: é um objeto com propriedades nomeadas

Texto: é uma sequência de caracteres

Tempo: é uma hora do dia

Operadores

Abaixo, segue a lista de todos os operadores que podem ser utilizados na construção de expressões na plataforma: + : soma dois números

& : une dois valores de texto

/ : divide um número por outro

= : retorna ""true"" se dois valores são textualmente iguais

^ : ele um número à potência de outro

> : retorna ""true"" se o primeiro número for maior que o segundo

> = : retorna ""true"" se o primeiro número for maior que ou igual ao segundo

< : retorna ""true"" se o primeiro número for menor que o segundo

< = : retorna ""true"" se o primeiro número for menor que ou igual ao segundo

***** : multiplica dois números

- (un ário) : nega um número

! : retorna ""true"" se dois valores não são textualmente iguais

- (bin ário) : subtrai dois números

Funções

As expressões têm acesso a um conjunto de funções internas que podem ser usadas para executar tarefas mais complexas. As funções são chamadas usando a sintaxe @(function_name(args..)) e podem assumir como argumentos valores literais @(length(split(""1 2 3"", "" ""))ou variáveis no contexto@(title(contact.name).

abs(número): retorna o valor absoluto de number.

and(valores...): retorna se todos os dados de valuessão verdadeiros

array(valores...): toma vários valuese os retorna como uma matriz.

attachment_parts(anexo): analisa um anexo em suas diferentes partes

boolean(valor): tenta converter valuepara um booleano. Um erro será retornado se o valor não puder ser convertido.

char(código): retorna o caractere para UNICODE fornecido code. É o inverso do código.

clean(texto): remove todos os caracteres não imprimíveis de text. É o inverso de char.

code(texto): retorna o código UNICODE para o primeiro caractere de text. É o inverso do char.

count(valor): retorna o número de itens na matriz ou propriedades especificadas em um objeto. Ele retornará um erro se for passado um item que não é contável.

date(valor): tenta converter (valor)para uma data. Se for texto, ele será analisado em uma data usando o formato de data padrão. Um erro será retornado se o valor não puder ser convertido.

date_from_parts(ano, mês, dia): cria uma data de year``month``day.

datetime(valor): tenta converter valuepara um datatime. Se for texto, ele será analisado em uma data e hora usando os formatos padrão de data e hora. Um erro será retornado se o valor não puder ser convertido.

datetime_ad (datetime, offset, unit): Calcula o valor da data alcançada adicionando o offsetnúmero de unitao datetime. As durações válidas são ""Y"" para anos, ""M"" para meses, ""W"" para semanas, ""D"" para dias, ""h"" para horas, ""m"" para minutos e ""s"" para segundos.

datetime_diff(date1``date2``unidade): retorna a duração entre date1e date2no unitespecificado. As durações válidas são ""Y"" para anos, ""M"" para meses, ""W"" para semanas, ""D"" para dias, ""h"" para horas, ""m"" para minutos e ""s"" para segundos.

datetime_from_epoch(segundos): converte o horário da época UNIX secondsem uma nova data.

default(valor, padrão): retorna valuese não estiver vazio ou com erro, caso contrário ele retornarádefault.

epoch(data): converte dateem um horário de época UNIX. O número retornado pode conter segundos fracionários.

extract(objeto, propriedades): pega um objeto e extrai a propriedade nomeada.

extract_object(objeto, propriedades...): pega um objeto e retorna um novo objeto extraindo apenas as propriedades nomeadas.

field(texto, índice, delimitador): divide textusando o dadodelimitere retorna o campo index. O índice começa em zero. Ao dividir com um espaço, o delimitador é considerado como todo o espaço em branco.

foreach(valores, func, [argumentos...]): cria uma nova matriz aplicando funca cada valor emvalues. Se a função fornecida receber mais de um argumento, você poderá passar argumentos adicionais após a função.

foreach_value(objeto, func, [args...]): cria um novo objeto aplicando funca cada valor de propridade object. Se a função fornecida receber mais de um argumento, você poderá passar argumentos adicionais após a função.

format(valor): formatos de valuede acordo com seu tipo.

format_date(data, [, formato]): formatadatecomo texto de acordo com o dadoformat. Seformatnão for especificado, o formato padrão do ambiente será usado. A cadeia de formato pode consistir nos seguintes caractere. Os caracteres '', ':', ',', 'T', '-' e '_' são ignorados. Qualquer outro caractere é um erro.

• YY- últimos dois dígitos do ano 0-99

• YYYY- quatro dígitos do ano 0000-9999

• M- retorna o mês, sem o zero 1-12

• MM- retorna o mês com o zero preenchido 01-12

• D- dia do mês 1-31

• DD- dia do mês, zero preenchido 01-31

  @(format_date(""1979-07-18T15:00:00.000000Z"")) → 18-07-1979@(format_date(""1979-07-18T15:00:00.000000Z"", ""YYYY-MM-DD"")) → 1979-07-18@(format_date(""2010-05-10T19:50:00.000000Z"", ""YYYY M DD"")) → 2010 5 10@(format_date(""1979-07-18T15:00:00.000000Z"", ""YYYY"")) → 1979 @(format_date(""1979-07-18T15:00:00.000000Z"", ""M"")) → 7 @(format_date(""NOT DATE"", ""YYYY-MM-DD"")) → ERROR format_datetime (data e hora [, formato [, fuso horário]]) Formata datetime como texto de acordo com o dado format. Se formatnão for especificado, o formato padrão do ambiente será usado. A cadeia de contato pode consistir nos seguintes caracteres. Os caracteres '', ':', ',', 'T', '-' e '_' são ignorados. Qualquer outro caractere é um erro.

• YY- últimos dois dígitos do ano 0-99

• YYYY- quatro dígitos do ano 0000-9999

• M- retorna o mês, sem o zero 1-12

• MM- retorna o mês com o zero preenchido 01-12

• D- dia do mês 1-31

• DD- dia do mês, zero preenchido 01-31

• h- hora do dia 1-12

• hh- hora do dia 01-12

• tt- vinte de quatro horas do dia 00-23

• m- minuto sem o zero preenchido 0-59

• mm- minuto com o zero preenchido 00-59

• s- segundo sem o zero preenchido 0-59

• ss- segundo sem o zero preenchido 00-59

• fff- milissegundos

• ffffff- microssegundos

• fffffffff- nanosegundos

• aa- AM ou PM

• AA- AM ou PM

• Z- deslocamento de hora e minuto do UTC ou Z do UTC

• ZZZ- deslocamento de hora e minuto do UTC

O fuso horário deve ser o nome de local, conforme especificado no bando de dados do fuso horário da IANA, como """"America / Guayaquil"" ou ""America / Los_Angeles"". Se não especificado, o fuso horário atual será usado. Um erro será retornado se o fuso horário não for reconhecido.

format_location(local): formata o dadolocationcomo seu nome.

format_number(número, lugares [, humanizar]): formata numbero número decimal especificado places. Um terceiro argumento opcional humanizepode ser falso para desativar o uso de mil separadores.

format_time (hora, [, formato]): formata timecomo texto de acordo com o dato format . Se formatnão for especificado, o formato padrão do ambiente será usado. A cadeia de formato pode consistir nos seguintes caracteres. Os caracteres '', ':', ',', 'T', '-' e '_' são ignorados. Qualquer outro caractere é um erro.

• h- hora do dia 1-12

• hh- hora do dia 01-12

• tt- vinte de quatro horas do dia 00-23

• m- minuto sem o zero preenchido 0-59

• mm- minuto com zero preenchido 00-59

• s- segundo sem o zero preenchido 0-59

• ss- segundo com o zero preencido 00-59

• fff- milissegundos

• ffffff- microssegundos

• fffffffff- nanosegundos

• aa- AM ou PM

• AA- AM ou PM

  @(format_time(""14:50:30.000000"")) → 14:50@(format_time(""14:50:30.000000"", ""h:mm aa"")) → 2:50 pm@(format_time(""15:00:27.000000"", ""s"")) → 27 @(format_time(""NOT TIME"", ""hh:mm"")) → ERROR format_urn(urn): formataurnem texto amigável para humanos.

  @(format_urn(""tel:+250781234567"")) → 0781 234 567@(format_urn(""twitter:134252511151#billy_bob"")) → billy_bob@(format_urn(contact.urn)) → (202) 456-1111 @(format_urn(urns.tel)) → (202) 456-1111 @(format_urn(urns.mailto)) → foo@bar.com @(format_urn(""NOT URN"")) → ERROR html_decode(texto): decodificações HTMLtext

  @(html_decode(""Red & Blue"")) → Red & Blue @(html_decode(""5 + 10"")) → 5 + 10 if (teste, valor1, valor2): retorna value1se testé verdade e value2se não. Se o primeiro argumento for um erro, esse erro será retornado.

  @(if(1 = 1, ""foo"", ""bar"")) → foo @(if(""foo"" > ""bar"", ""foo"", ""bar"")) → ERROR is_error(valor): retorna se valuetiver um erro.

  @(is_error(datetime(""foo""))) → true @(is_error(run.not.existing)) → true @(is_error(""hello"")) → false join(matriz, separador): associa o dadoarrayde strings comseparatorpara citar texto.

  @(join(array(""a"", ""b"", ""c""), ""|"")) → a|b|c @(join(split(""a.b.c"", "".""), "" "")) → a b c json(valor): retorna a representação JSON de value.

  @(json(""string"")) → ""string"" @(json(10)) → 10 @(json(null)) → null @(json(contact.uuid)) → ""5d76d86b-3bb9-4d5a-b822-c9d86f5d8e4f"" lower(texto): converte textpara minúsculas.

  @(lower(""HellO"")) → hello @(lower(""hello"")) → hello @(lower(""123"")) → 123 @(lower(""😀"")) → 😀 max (números...): retorna o valor máximo emnumbers.

  @(max(1, 2)) → 2 @(max(1, -1, 10)) → 10 @(max(1, 10, ""foo"")) → ERROR mean(números...): retorna a média aritmética denumbers.

  @(mean(1, 2)) → 1.5 @(mean(1, 2, 6)) → 3 @(mean(1, ""foo"")) → ERROR min(números...): retorna o valor mínimo em numbers.

  @(min(1, 2)) → 1 @(min(2, 2, -10)) → -10 @(min(1, 2, ""foo"")) → ERROR mod(dividendo, divisor): retorna o restante da divisão de dividendpor divisor.

  @(mod(5, 2)) → 1 @(mod(4, 2)) → 0 @(mod(5, ""foo"")) → ERROR now(): retorna a data e a hora atuais no fuso horário atual.

  @(now()) → 2018-04-11T13:24:30.123456-05:00 number(valores): tenta converter valuepara um número. Um erro será retornado se o valor não puder ser convertido.

  @(number(10)) → 10 @(number(""123.45000"")) → 123.45 @(number(""what?"")) → ERROR object(pares...): pega os pares de valores do nome da propriedade e os retorna como um novo objeto.

  @(object()) → {} @(object(""a"", 123, ""b"", ""hello"")) → {a: 123, b: hello} @(object(""a"")) → ERROR or(valores...): retorna se algum dos dados valuesé verdadeiro.

  @(or(true)) → true @(or(true, false, true)) → true parse_datetime(texto, formato [, fuso horário]): analisa textem uma data usando o dadoformat. A cadeia de formato pode consistir nos seguintes caracteres. Os caracteres '', ':', ',', 'T', '-' e '_' são ignorados. Qualquer outro caractere é um erro.

• YY- últimos dois dígitos do ano 0-99

• YYYY- quatro dígitos do ano 0000-9999

• M- mês 1-12

• MM- mês 01-12

• D- dia do mês sem o zero preenchido 1-31

• DD- dia do mês, zero preenchido 01-31

• h- hora do dia sem o zero preenchido 1-12

• hh- hora do dia com o zero preenchido 01-12

• tt- vinte de quatro horas do dia 00-23

• m- minuto sem o zero preenchido 0-59

• mm- minuto com o zero preenchido 00-59

• s- segundo sem o zero preenchido 0-59

• ss- segundo com o zero preenchido 00-59

• fff- milissegundos

• ffffff- microssegundos

• fffffffff- nanosegundos

• aa- AM ou PM

• AA- AM ou PM

• Z- deslocamento de hora e minuto do UTC ou Z do UTC

• ZZZ- deslocamento de hora e minuto do UTC

O fuso horário deve ser o nome de local, conforme especificado no bando de dados do fuso horário da IANA, como """"America / Guayaquil"" ou ""America / Los_Angeles"". Se não especificado, o fuso horário atual será usado. Um erro será retornado se o fuso horário não for reconhecido.

Observe que os segundos fracionários serão analisados mesmo sem um identificador de formato explícito. Você deve especificar apenas segundos fracionários quando desejar afirmar o número de lugares no formato de entrada.

parse_datetime retornará um erro se não conseguir converter o texto em uma datetime.

parse_json(texto): tenta analisar textcomo JSON. Se o textJSON fornecido não for válido, será retornado um erro.

parse_time(texto, formato): analisa textem um tempo usando o dadoformat. A cadeia de formato pode consistir nos seguintes caracteres. Os caracteres '', ':', ',', 'T', '-' e '_' são ignorados. Qualquer outro caractere é um erro.

• h- hora do dia 1-12
• hh- hora do dia 01-12
• tt- vinte de quatro horas do dia 00-23
• m- minuto sem o zero preenchido 0-59
• mm- minuto com o zero preenchido 00-59
• s- segundo sem o zero preenchido 0-59
• ss- segundo com o zero preenchido 00-59
• fff- milissegundos
• ffffff- microssegundos
• fffffffff- nanosegundos
• aa- AM ou PM
• AA- AM ou PM

Observe que os segundos fracionários serão analisados mesmo sem um identificador de formato explícito. Você deve especificar apenas segundos fracionários quando desejar afirmar o número de lugares no formato de entrada.

parse_time retornará um erro se não conseguir converter o texto em uma datetime.

percent(número): formatosnumbercomo uma porcentagem.

rand(): retorna um único número aleatório entre [0,0-1,0).

rand_between(): um único inteiro aleatório no intervalo inclusivo fornecido.

read_chars(texto): converte textem algo que pode ser lido pelos sistemas de URA. O ReadChars dividirá os números como eles são mais fáceis de entender. Isso inclui a divisão em 3s ou 4s, se apropriado.

regex_match(texto, padrão [, grupo]): retorna a primeira correspondência da expressão regularpatternemtext. Um terceiro parâmetro opcional groupdetermina qual grupo correspondente será retornado.

remove_first_word(texto): remove a primeira palavra de text.

repeat(texto, contagem): retorna o número textrepetido countde vezes.

replace(texto, agulha, substituição [, contagem]): substitui até as countocorrências de needlecom replacementem text. Secountfor omitido ou for menor que 0, todas as ocorrências serão substituídas.

replace_time(datetime): retorna um novo datetime com a parte do tempo substituída portime.

round(número [, lugares]): arredonda numberpara o valor mais próximo. Opcionalmente, você pode passar o número de casas decimais para arredondar para asplaces. Se places<0, arredondará a parte inteira para os 10^ mais próximos (- lugares).

round_down(número [, lugares]): arredonda numberpara baixo até o valor inteiro mais próximo. Opcionalmente, você pode passar o número de casas decimais para arredondar para as places.

round_up(número [, lugares]): arredonda numberpara o valor inteiro mais próximo. Opcionalmente, você pode passar o número de casas decimais para arredondar para as places.

split(texto, [, delimitadores]): divide textem uma matriz de palavras separadas. Valores vazios são removidos da lista retornada. Há um parâmetro final opcional, delimiters que é uma sequência de caracteres usada para dividir o texto em palavras.

text(valor): tenta converter valueem texto. Um erro será retornado se o valor não puder ser convertido.

text_compare(texto1, texto2): retorna a ordem do dicionário de text1e text2. O valor retornado será -1 se text1vier antes de text2, 0 se eles forem iguais e 1 se text1vier depois de text2.

text_length(valor): retorna o comprimento (numero de caracteres) de valuequando convertido em texto.

text_slice(texto, início [, fim]): retorna a partetextentre start(inclusive) e end(exclusivo). Se endnão for especificado, todo o restante textserá incluído. Valores negativos para startou endcomeçam no final de text.

time(valor do tempo): tenta converter valuepara um horário. Se for um texto, ele será analisado em um horário usando o formato de horário padrão. Um erro será retornado se o valor não puder ser convertido.

time_from_parts(hora, minuto, segundo): cria um tempo de hour, minutee second.

title(texto): coloca em maiúscula cada palavra em text

today(): retorna a data atual no fuso horário do ambiente.

trim(texto, [, caracteres]): remove o espaço em branco de qualquer extremidade de text. Há um parâmetro opcional, charsque é uma sequência de caracteres a serem removidas em vez do espaço em branco.

trim_left(``texto, [, caracteres]): remove o espaço em branco desde o início do text. Há um parâmetro opcional, charsque é uma sequência de caracteres a serem removidas em vez do espaço em branco.

trim_right(``texto, [, caracteres]): remove o espaço em branco do final de text. Há um parâmetro opcional, charsque é uma sequência de caracteres a serem removidas em vez do espaço em branco.

tz(``data): retorna o nome do fuso horário de date. Se nenhuma informação de fuso horário estiver presente na data, o fuso horário atual será retornado.

tz_offset(``data): retorna o deslocamento do fuso horário de date. O deslocamento é retornado no formato [+/-]HH:MM. Se nenhuma informação de fuso horário estiver presente na data, o fuso horário atual será retornado.

upper(texto): converte textem maiúsculas.

url_encode(texto): codifica text para uso como um parâmetro de URL.

url_parts(urn): analisa uma URL em suas diferentes partes.

week_number(data): retorna o número da semana (1-54) de date.

weekday(data): retorna o dia da semana para date. Considera-se que a semana começa no domingo; portanto, um domingo retorna 0, uma segunda-feira retorna 1, etc.

word(texto, índice [, delimitadores]): retorna a palavra indexem text. Os índices começam em zero. Há um parâmetro opcional, delimitersque é uma sequência de caracteres usada para dividir o texto em palavras.

word_count(``texto, [, delimitadores]): retorna o número de palavras em text. Há um parâmetro opcional, delimitersque é uma sequência de caracteres usada para dividir o texto em palavras.

word_slice(``texto, início, fim [, delimitadores]): extrai uma sub-sequência de palavras de text. As palavras retornadas são aquelas que até incluem start, mas não incluem end . Os índices começam em zero e um valor final negativo significa que todas as palavras após o início devem ser retornadas. Há um parâmetro opcional, delimitersque é uma sequência de caracteres usada para dividir o texto em palavras.