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 seguintes operadores de comparação são compatíveis somente com valores de tipo de número.

• = (Igual a)
• <> (diferente de)
• > (Maior que)
• < (menor que)
• >= (Maior ou igual a)
• <= (Menor que 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
AVERAGE(argumento 1, argumento 2, … argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• Função: AVERAGE(1,2,3)

  O resultado é 2.

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

  O resultado é o valor médio do número de caracteres na coluna first_name e na coluna 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
DIVIDE(argumento 1, argumento 2 ... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• Função: DIVIDE(10,20, 0,25, 10)

  O resultado é 0,2.

• Fórmula: DIVIDE(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 de argumentos especificado.

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
MAX(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: MAX(LENGTH(first_name), LENGTH(last_name))

  O resultado é o número de caracteres na coluna first_name ou na coluna 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:

• Função: 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 na coluna last_name, o que for menor.

MULTIPLY

Retorna o valor multiplicado total dos argumentos.

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

Exemplos:

• Função: MULTIPLY(12, 4)

  O resultado é 48.

• Fórmula: MULTIPLY(ordem, 2)

  O resultado é o valor da coluna de ordem multiplicado por 2.

ENERGIA

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

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

Exemplos:

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

  O resultado é 9.

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

  O resultado é o número de caracteres na coluna full_name elevado a 2.

SUBTRAIR

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
SUBTRACT(argumento 1, argumento 2 ... argumento n)	valor numérico, chamada de função ou variável	Valor numérico

Exemplos:

• Função: SUBTRACT(1.15, 0.02, 0.45, -0.85)

  O resultado é 1,53.

• Fórmula: SUBTRACT(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: SUM(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.SE

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

Sintaxe	Entrada	Saída
COUNTIF(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: COUNTIF(2,3,2,"string",2)

O resultado é 2.

MODO

Retorna o valor que se repete com mais frequência no conjunto de argumentos especificado.

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:

Função: MODE(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
CONCATENATE(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, "@", LOWERCASE(example), ".com")

  O resultado é o valor concatenado<first_name_value> .<last_name_value> @exemplo.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ÚSCULA

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(“ExamPle inpuT stRing”)

  O resultado é uma cadeia de caracteres de entrada de exemplo.

• 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”, “Queijo”)

  A cadeia de caracteres do resultado é Pizza de queijo.

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

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

TÍTULOCASO

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("cadeia de caracteres de exemplo")

  O resultado é uma 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("eXamPle sTring")

  O resultado é EXAMPLE STRING.

• Função:UPPERCASE(estado)

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

LOCALIZAR

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

Nota:

Esta função faz distinção entre maiúsculas e 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 subcadeia de caracteres não existe na cadeia de caracteres principal, -1 é retornado.

Exemplo:

Função: FIND("bom dia", "bom dia")

O resultado é 5.

PESQUISAR

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

Nota:

Esta função não faz distinção entre maiúsculas e 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 subcadeia de caracteres 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 subcadeia de caracteres 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 subcadeia de caracteres é 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 subcadeia de caracteres do resultado é "boa".

Funções de data e hora

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

NOW

Retorna a data e a 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.

HORADIFF

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 de tempo 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_início, data_término, unidade_diferença_de_data)	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 individuais de ano, mês e dia especificados. A data de criação está no fuso horário do Tempo Universal Coordenado (UTC).

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 de dia a partir 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 a partir 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 de ano a partir 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 de 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 que serão extraídos.	Cadeia de caracteres

Exemplo:

TEXT("2022-08-17 9:10:12","yyyy-MM")

O resultado é 2022-08.

DATEVALUE

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 da data de entrada especificada, excluindo os feriados e finais de semana especificados antes ou após o número especificado de n dias.

Sintaxe	Entrada	Saída
WORKDAY(data_início, 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. days: número de dias como 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.

NETWORKDAYS

Calcula o número de dias úteis entre duas datas, excluindo finais 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
NETWORKDAYS(data_início, data_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 ao calcular 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 AND lógica 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> )	conditional_expression: 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 que é 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 que é 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, "High", "Médio")

  Se o número de incidentes for maior que 5, a cadeia de caracteres "Alta" 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 estiver acima de 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 uma operação OR lógica 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: OR(2>3,4<5)

  O resultado é verdadeiro.

• Fórmula: OR(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.

IFERRO

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
IFERROR(expressão 1, expressão 2)	expressão 1: expressão aritmética, lógica, chamada de função, cadeia de caracteres, valor numérico ou variável. expressão 2: expressão aritmética, 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( MULTIPLY(snr_factor, sinal), MULTIPLY( default_factor, sinal))

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