Fórmulas para valores de coluna em Construtor de tabelas

Você pode usar uma função predefinida e criar uma fórmula para calcular o valor de uma coluna sem escrever um script. Use uma função predefinida ou crie uma fórmula aninhada usando as funções predefinidas existentes para calcular o tipo de valor da coluna.

Operadores compatíveis

Os operadores de comparação a seguir são compatíveis somente com valores de tipo numérico.

• (Igual a)
• (Diferente de)
• > (maior que)
• Menos de (menos de)
• (Maior ou igual a)
• (Menor ou igual a)

Funções matemáticas simples

Use funções matemáticas simples para executar cálculos matemáticos básicos em colunas de valor numérico.

MÉDIA

Retorna o valor médio dos argumentos.

Sintaxe	Entrada	Saída
Argumento 1, argumento 2,... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• AVERAGE (1,2,3)

  O resultado é 2.

• Fórmula: MÉDIA(LENGTH(first_name), LENGTH(last_name))

  O resultado é o valor médio do número de caracteres nas colunas first_name e last_name.

DIVIDIR

Retorna o valor do quociente final após dividir consecutivamente o primeiro argumento com o próximo argumento até que a função atinja o último argumento.

Sintaxe	Entrada	Saída
Argumento 1, argumento 2... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• DIVIDE(10,20, 0,25, 10)

  O resultado é 0,2.

• Fórmula: DIVIDIR(LENGTH(full_name),2)

  O resultado é o número de caracteres na coluna full_name dividido por 2.

INDEXMATCH

Recupera o primeiro valor não nulo do conjunto especificado de argumentos.

Sintaxe	Entrada	Saída
INDEXMATCH(argumento 1, argumento 2 ,... argumento n)	Cadeia de caracteres, valor numérico, chamada de função ou variável.	Valor numérico

Exemplo:

Função: INDEXMATCH(""," ",2,"STRING")

O resultado é 2.

MÁX

Retorna o maior valor dos argumentos especificados.

Sintaxe	Entrada	Saída
(Argumento 1, argumento 2,... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• Função: MAX (1, -5, 20, 6)

  O resultado é 20.

• Fórmula: MÁX(LENGTH(first_name), LENGTH(last_name))

  O resultado é o número de caracteres na coluna first_name ou last_name, o que for maior.

MÍN

Retorna o menor volume dos argumentos especificados.

Sintaxe	Entrada	Saída
MIN(argumento 1, argumento 2,... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• MIN (1, -5, 20, 6)

  O resultado é -5.

• Fórmula: MIN(LENGTH(first_name), LENGTH(last_name))

  O resultado é o número de caracteres na coluna first_name ou last_name, o que for menor.

MULTIPLIQUE

Retorna o valor total multiplicado dos argumentos.

Sintaxe	Entrada	Saída
MULTIPLICAR (argumento 1, argumento 2,... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• MULTIPLIQUE(12, 4)

  O resultado é 48.

• Fórmula: MULTIPLICAR (ordem, 2)

  O resultado é o valor da coluna Ordem multiplicado por 2.

ENERGIA

Retorna o resultado do valor de base elevado à potência do valor do expoente.

Sintaxe	Entrada	Saída
PODER (argumento 1, argumento 2)	o argumento 1 é a base e o argumento 2 é expoente. base: número ou variável exponente: número ou variável	Número

Exemplos:

• Função: PODER(3,2)

  O resultado é 9.

• POTÊNCIA (LENGTH(full_name),2)

  O resultado é o número de caracteres na coluna full_name com a potência de 2.

SUBTRAIA

Retorna o valor do resultado após subtrair consecutivamente o próximo argumento disponível do argumento anterior até que a função atinja o último argumento.

Sintaxe	Entrada	Saída
SUBSTRAT (argumento 1, argumento 2... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• Função: SUBTRAIR (1,15, 0,02, 0,45, -0,85)

  O resultado é 1,53.

• Fórmula: SUBTRAIR(LENGTH(full_name), LENGTH(first_name))

  O resultado é o número de caracteres da coluna full_name menos o número de caracteres da coluna first_name.

SOMA

Retorna a soma de todos os argumentos.

Sintaxe	Entrada	Saída
SUM(argumento 1, argumento 2, ... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• Função: SUM(0,03, -0,02, 1)

  O resultado é 1,01.

• Fórmula: SOMA(LENGTH(first_name), LENGTH(last_name))

  O resultado é o número total de caracteres na coluna first_name mais o número total de caracteres na coluna last_name.

CONT

Retorna o número de argumentos que correspondem aos critérios especificados no conjunto de argumentos especificado.

Sintaxe	Entrada	Saída
Cont(Argumento 1, Argumento 2, Argumento n-1, Critérios)	argumento 1... Argumento n: Cadeia de caracteres, valor numérico, chamada de função ou variável. Critérios: Critérios que avaliam o conjunto especificado de argumentos. Cadeia de caracteres, valor numérico, chamada de função ou variável.	Valor numérico

Exemplo:

Função: CONTSE(2,3,2,"string",2)

O resultado é 2.

MODO

Retorna o valor repetido com mais frequência no conjunto especificado de argumentos.

Sintaxe	Entrada	Saída
MODE(argumento 1, argumento 2, ... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplo:

MODO (1, 2, 2, 3, 3, 3)

O resultado é 3.

Funções de cadeia de caracteres

Use funções de cadeia de caracteres para reformatar ou executar cálculos em valores de coluna de cadeia de caracteres.

CONCATENAR

Une uma ou mais cadeias de caracteres de entrada em uma única cadeia de caracteres.

Sintaxe	Entrada	Saída
CONCATENAR(cadeia de caracteres 1, cadeia de caracteres 2,... cadeia de caracteres n)	cadeia de caracteres, chamada de função ou variável	Cadeia de caracteres

Exemplos:

• Função: CONCATENATE(first_name, ".", last_name, " ".com")

  O resultado é o valor concatenado <first_name_value>.<last_name_value> em example.com. Neste exemplo, <first_name_value> e <last_name_value> são espaços reservados.

• Função: CONCATENATE(first_name, " ", last_name)

  O resultado é a cadeia de caracteres concatenada do valor da coluna first_name e do valor da coluna last_name separados por um espaço em branco.

ISBLANK

Encontra espaços em branco ou valores vazios na cadeia de caracteres e retorna verdadeiro se houver algum.

Sintaxe	Entrada	Saída
ISBLANK(argumento)	Cadeia de caracteres ou valor	Verdadeiro ou falso

Exemplos:

• Função: ISBLANK("example_string")

  O resultado é falso.

• Função: ISBLANK(full_name)

  O resultado é verdadeiro somente quando há espaços vazios na coluna full_name. Caso contrário, o resultado será falso.

COMPRIMENTO

Retorna o número total de caracteres na cadeia de caracteres de entrada.

Sintaxe	Entrada	Saída
LENGTH(argumento)	valor de cadeia de caracteres, chamada de função ou variável	Valor numérico

Exemplos:

• Função: LENGTH("example_string")

  O resultado é 14.

• Função: LENGTH(full_name)

  O resultado é o número total de caracteres no valor da coluna full_name.

MINÚSCULAS

Converte a cadeia de caracteres de entrada para todos os caracteres em minúsculas.

Sintaxe	Entrada	Saída
LOWERCASE(argumento)	cadeia de caracteres, chamada de função ou variável	cadeia de caracteres em caracteres minúsculos

Exemplos:

• Função: LOWERCASE("Exemplo de cadeia de caracteres de entrada")

  O resultado é exemplo de cadeia de caracteres de entrada.

• Função: LOWERCASE(sys_created_by)

  O resultado é a cadeia de caracteres minúscula do valor da coluna sys_created_by.

SUBSTITUIR

Substitui os caracteres na cadeia de caracteres de origem pelos caracteres na cadeia de caracteres de destino.

Sintaxe	Entrada	Saída
REPLACE(source_string, target_string, replacement_string)	Source_string: Cadeia de caracteres, chamada de função ou variável Target_string: Cadeia de caracteres, chamada de função ou variável Replacement_string: Cadeia de caracteres, chamada de função ou variável	Cadeia de caracteres

Exemplos:

• Função: REPLACE("Pepperoni Pizza", "Pepperoni", "Cheese")

  A cadeia de caracteres resultante é Pizza de queijo.

• Função: REPLACE("[e-mail]", "example", company_name)

  A cadeia de caracteres do resultado é abe.tuter em <company_name>.com. Neste exemplo, <company_name> é um espaço reservado.

TITLECASE

Converte a cadeia de caracteres de entrada em todos os caracteres de capitalização de título.

Sintaxe	Entrada	Saída
TITLECASE(argumento)	cadeia de caracteres, chamada de função ou variável	cadeia de caracteres de capitalização de título

Exemplos:

• Função: TITLECASE("Exemplo de cadeia de caracteres")

  O resultado é Cadeia de caracteres de exemplo.

• Função: TITLECASE(full_name)

  O resultado é o valor da coluna de nome completo no caso do título.

MAIÚSCULA

Converte a cadeia de caracteres de entrada para todos os caracteres em maiúsculas.

Sintaxe	Entrada	Saída
UPPERCASE(argumento)	valor de cadeia de caracteres, chamada de função ou variável	cadeia de caracteres em letras maiúsculas

Exemplos:

• Função: UPPERCASE("Exemplo de cadeia de caracteres")

  O resultado é UMA CADEIA DE CARACTERES DE EXEMPLO.

• Função: UPPERCASE(state)

  O resultado é o valor da coluna Estado em maiúsculas.

LOCALIZAR

Pesquisa a primeira ocorrência de uma substring em uma cadeia de caracteres e retorna a posição da primeira ocorrência.

Nota:

Esta função diferencia maiúsculas de minúsculas.

Sintaxe	Entrada	Saída
FIND(search_string, source_string, from_index)	Search_string: Substring, chamada de função ou variável. Source_string: Cadeia de caracteres principal, chamada de função ou variável. From_index: Posição do índice na cadeia de caracteres principal de onde a pesquisa deve começar. Valor numérico, chamada de função ou variável.	Valor numérico (inteiro). Quando a substring não existe na cadeia de caracteres principal, -1 é retornado.

Exemplo:

Função: FIND("Manhã", "Bom dia")

O resultado é 5.

PESQUISA

Pesquisa uma substring em uma cadeia de caracteres e retorna a posição da primeira ocorrência da substring.

Nota:

Esta função não diferencia maiúsculas de minúsculas.

Sintaxe	Entrada	Saída
SEARCH(cadeiadecaracteres_pesquisa, cadeiadecaracteres_origem, do_índice)	Search_string: Substring, chamada de função ou variável. Source_string: Cadeia de caracteres principal, chamada de função ou variável. From_index: Posição do índice na cadeia de caracteres principal de onde a pesquisa deve começar. Valor numérico, chamada de função ou variável.	Valor numérico (inteiro). Quando a substring não existe na cadeia de caracteres principal, -1 é retornado.

Exemplos:

• SEARCH("Bom dia", "Bom dia")

  O resultado é 5.

• PESQUISAR("Mundo","Olá mundo!")

  O resultado é -1.

SUBSTRING

Recupera uma substring de uma cadeia de caracteres na posição de índice especificada e para o comprimento especificado.

Sintaxe	Entrada	Saída
SUBSTRING (cadeiadecaracteres_origem, índice_inicial, tamanho)	source_string: cadeia de caracteres, chamada de função ou variável. Start_index: Posição na cadeia de caracteres de onde a substring é extraída. Valor numérico, chamada de função ou variável. Comprimento: Comprimento da substring que deve ser extraída.	Cadeia de caracteres

Exemplo:

SUBSTRING("Olá, bom dia", 7, 4)

A substring do resultado é "boa".

Funções de data e hora

Use as funções de data e hora para calcular ou reformatar os valores da coluna de data e hora.

AGORA

Retorna a data e hora atuais da instância no formato ISO (AAAA-MM-DD hh:mm:ss).

Sintaxe	Entrada	Saída
NOW()	nenhum argumento é necessário para esta função	formato ISO da data e hora atuais

Exemplo:

Função: NOW()

O resultado é a data e hora atuais no formato ISO.

HOJE

Retorna a data atual com deslocamento de hora para o início do dia no formato ISO no fuso horário UTC.

Sintaxe	Entrada	Saída
HOJE()	nenhum argumento é necessário para esta função	Data atual com deslocamento de hora para o início do dia no formato ISO.

Exemplo:

Função: TODAY()

O resultado é a data atual e a hora de início do dia no formato ISO.

TEMPO

Avalia a diferença de duração de tempo entre duas datas.

Sintaxe	Entrada	Saída
TIMEDIFF(argumento1, argumento2)	Data no formato ISO (AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável	Duração

Exemplos:

• Função: TIMEDIFF("2021-05-02 9:10:12", "2021-04-07 6:2:23")

  O resultado é 25 03:07:49.

• Fórmula: TIMEDIFF(sys_created_on, NOW())

  O resultado é a diferença de duração entre a data sys_created_on e a data atual do sistema.

DATEDIF

Avalia a diferença entre as duas datas em dias, meses ou anos.

Sintaxe	Entrada	Saída
DATEDIF(data_inicial, data_final, data_diferença_unit)	Start_date: Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável. End_date: Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável. Date_difference_unit: Cadeia de caracteres e "Y", "M" ou "D" em minúsculas ou maiúsculas. O padrão é "D".	Valor numérico de duração com base na unidade de diferença de data especificada.

Exemplo:

Função: DATEDIF("2021-05-02 9:10:12", "2021-05-05 6:2:23 ","d")

O resultado é 3.

DATA

Cria uma data a partir dos valores de ano, mês e dia individuais especificados. A data de criação está no fuso horário UTC (Tempo universal coordenado).

Sintaxe	Entrada	Saída
DATE(year,month,day)	Ano: Valor numérico, variável ou função. Mês: Valor numérico, variável ou função. Dia: Valor numérico, variável ou função.	Data no formato ISO (AAAA-MM-DD hh:mm:ss)

Exemplo:

Função: DATE(2021,5,2)

O resultado é 2021-05-02 00:00:00.

DIA

Recupera o componente numérico do dia da data especificada.

Sintaxe	Entrada	Saída
DAY(data)	Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres, variável ou função.	Valor numérico (inteiro). Os valores variam de 1 a 31.

Exemplos:

• Função: DAY("2021-05-029:10:12")

  O resultado é 2.

• Função: DAY(NOW())

  O resultado será o componente de dia da data e hora atuais.

MÊS

Recupera o componente numérico do mês da data especificada.

Sintaxe	Entrada	Saída
MONTH(data)	Data: Data no formato ISO (AAAA-MM-DD ou AAAA-MM- DD hh:mm:ss) como cadeia de caracteres ou variável.	Valor numérico (inteiro). Os valores variam de 1 (janeiro) a 12 (dezembro).

Exemplos:

• Função: MONTH("2021-05-02 9:10:12")

  O resultado é 5.

• Função: DAY(NOW())

  O resultado será o componente do mês da data e hora atuais.

ANO

Recupera o componente "Ano" da data especificada.

Sintaxe	Entrada	Saída
YEAR(date)	Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres, variável ou função.	valor numérico (inteiro)

Exemplos:

• Função: YEAR("2021-05-02 9:10:12")

  O resultado é 2021.

• Função: YEAR(NOW())

  O resultado será o componente do ano da data e hora atuais.

DIA DA SEMANA

Retorna o dia numérico da semana para a data especificada. O intervalo de dias é de 1 (domingo) a 7 (sábado).

Sintaxe	Entrada	Saída
WEEKDAY(data)	Data: Data no formato ISO (AAAA-MM-DD ou AAAA-MM- DD hh:mm:ss) como cadeia de caracteres ou variável.	valor numérico (inteiro)

Exemplo:

Função: WEEKDAY("2021-05-02 9:10:12")

O resultado é 1.

TEXTO

Recupera os componentes de data específicos em uma data no formato de cadeia de caracteres.

Sintaxe	Entrada	Saída
TEXT(data, formato_texto)	Data: Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres, variável. Format_text: Componentes de data como cadeia de caracteres ou variável a serem extraídos.	Cadeia de caracteres

Exemplo:

TEXTO("2022-08-17 9:10:12","aaaa-MM")

O resultado é 2022-08.

DATAVALUE

Converte uma data no formato de texto em uma data no formato ISO.

Sintaxe	Entrada	Saída
DATEVALUE(texto_data)	Date_text: A data armazenada como texto deve estar no formato AAAA-MM-DD.	Data no formato ISO (AAAA-MM-DD hh:mm:ss) como cadeia de caracteres.

Exemplo:

Função: DATEVALUE("2021-05-02")

O resultado é 2021-05-02 00:00:00.

WORKDAY

Retorna o dia útil mais próximo para a data de entrada especificada excluindo os feriados e fins de semana especificados antes ou depois do n número de dias especificado.

Sintaxe	Entrada	Saída
WORKDAY(start_date, dias, feriado 1,feriado 2, ..., feriado n)	Start_date: Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável. Dias: Número de dias como um valor numérico, cadeia de caracteres ou função. feriado 1...feriado n (Opcional): Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável.	Data no formato ISO (AAAA-MM-DD hh:mm:ss) como cadeia de caracteres.

Exemplo:

Função: WORKDAY ("2022-08-17 9:10:12",2)

O resultado é 2022-08-19 00:00:00.

DADOS DE TRABALHO

Calcula o número de dias úteis entre duas datas excluindo fins de semana e datas de feriados especificadas. O número de dias úteis inclui a data de início e a data de término.

Sintaxe	Entrada	Saída
Data_de_trabalho(data_de_início,data_de_término,feriado 1,feriado 2, ... feriado n)	Start_date: Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável. End_date: Data no formato ISO (AAAA-MM-DD ou AAAA-MM-DD hh:mm:ss) como cadeia de caracteres ou variável. feriado 1,feriado 2, ... feriado n (opcional): Lista de feriados que devem ser excluídos no cálculo dos dias úteis.	valor numérico (inteiro)

Exemplo:

Função: NETWORKDAYS("2022-08-17 20:10:12","2022-08-19 9: 10:12")

O resultado é 3.

Funções lógicas

Use funções lógicas para executar operações lógicas em valores de coluna.

E

Executa uma operação lógica AND nos argumentos.

Sintaxe	Entrada	Saída
AND (argumento 1, argumento 2)	cadeia de caracteres, chamada de função ou variável	Verdadeiro ou falso

Exemplos:

• Função: AND(2>3, 4> 5)

  O resultado é falso.

• Fórmula: AND(LENGTH(sys_created_by)>25, LENGTH(sys_updated_by)>25)

  O resultado é verdadeiro somente quando o número de caracteres nas colunas sys_created_by e sys_updated_by é maior que 25. Caso contrário, o resultado será falso.

SE

Executa as declarações especificadas com base na saída booliana da expressão condicional.

Sintaxe	Entrada	Saída
SE(<conditional_expression>, <do_this_when_true>, <do this_when_false>)	Expression_condicional: Expressão condicional lógica, chamada de função ou variável Nota: A comparação lógica de cadeias de caracteres não é compatível com a expressão condicional. Do_this_when_true: Cadeia de caracteres, valor numérico, chamada de função ou variável retornada quando a condição é avaliada como verdadeira Do_this_when_false: Cadeia de caracteres, valor numérico, chamada de função ou variável retornada quando a condição é avaliada como falsa	Cadeia de caracteres, valor numérico, chamada de função ou variável com base na saída booliana da expressão condicional.

Exemplos:

• Função: IF(number_of_incidents > 5, "Alto", "Médio")

  Se o número de incidentes for maior que 5, a cadeia de caracteres "Alto" será retornada. Em outros casos, a cadeia de caracteres "Média" é retornada.

• Função: IF(LENGTH(full_name) > 100, "Número de caracteres excede o limite", "Número de caracteres dentro do limite")

  Se o número de caracteres da coluna full_name for superior a 100, a cadeia de caracteres "Número de caracteres excede o limite" será retornada. Caso contrário, a cadeia de caracteres "Número de caracteres dentro do limite" será retornada.

OU

Executa a operação lógica OR nos argumentos.

Sintaxe	Entrada	Saída
OR(argumento 1, argumento 2)	expressão condicional, chamada de função ou variável	Verdadeiro ou falso

Exemplos:

• Função: OU(2>3,4> 5)

  O resultado é verdadeiro.

• Fórmula: OU(LENGTH(first_name)>25, LENGTH(last_name)> 25)

  O resultado é verdadeiro quando o número de caracteres na coluna first_name é maior que 25 ou o número de caracteres na coluna last_name é menor que 25. Caso contrário, o resultado será falso.

ERROR

Avalia a expressão 1 e retorna o valor da expressão 1 quando não há erros na expressão 1. Quando ocorre um erro ao avaliar a expressão 1, a expressão 2 é avaliada e o valor da expressão 2 é retornado.

Sintaxe	Entrada	Saída
ERROR (expressão 1, expressão 2)	Expressão 1: Aritmética, expressão lógica, chamada de função, cadeia de caracteres, valor numérico ou variável. Expressão 2: Aritmética, expressão lógica, chamada de função, cadeia de caracteres, valor numérico ou variável.	Resultado da expressão 1 quando não há erros na expressão 1. Caso contrário, resultado da expressão 2.

Exemplo:

Função: IFERROR ( MULTIPLICK (snr_FACTOR, SIGNAL), MULTIPLICK ( default_factor, SIGNAL))

Se o valor snr_fator for um número válido, o valor multiplicado de snr_fator com sinal será retornado. Se o valor snr_factor não for um número válido, o valor multiplicado do valor default_factor com sinal será retornado.