Caixa de diálogo Definir Fórmula (Construtor de Relatórios 1.0)

Use para criar um novo campo que contenha uma fórmula.

Opções

• Campos
  Use esta guia para localizar no modelo de relatório os campos que você deseja incluir na expressão. Clique duas vezes no campo para adicioná-lo à expressão.

• Funções
  Use esta guia para selecionar a função que você deseja usar na expressão. Clique duas vezes na função para adicioná-la à expressão. Para obter uma descrição de cada função, consulte a seção a seguir.

• Nome do campo
  Digite um nome para a expressão que está sendo criada.

• Fórmula
  Use para escrever e editar a fórmula.

• Pesquisar
  Clique para abrir a caixa de diálogo Pesquisa.

• Atalhos de função
  Clique para adicionar um operador à formula exibida na caixa Fórmula. A caixa de diálogo Definir Fórmula fornece atalhos para as funções mais usadas; no entanto, também é possível selecionar esses operadores na guia Funções. A seguir, é fornecida uma explicação de cada atalho.

  + Use para somar dois valores.

  - Use para subtrair um valor de outro.

  * Use para multiplicar dois valores de texto.

  / Use para dividir dois valores.

  & Use para concatenar dois valores.

  ( Use para iniciar um cálculo.

  ) Use para encerrar um cálculo.

Opções do menu de atalho

Para ver essas opções de menu, clique com o botão direito do mouse nas fórmulas da caixa Fórmula ou na área de fórmula expandida.

• Expandir
  Clique para exibir a fórmula e sua relação com a entidade de contexto. Isso é necessário para filtrar ou indicar o nível de agregação.

• Renomear
  Clique para renomear a fórmula exibida na caixa de diálogo Fórmula.

• Agregar Aqui
  Clique no nome do campo para alterar o nível de agregação. Esta opção só estará disponível depois que a fórmula for expandida.

• Nenhum filtro aplicado
  Se você clicar duas vezes em um nome de campo exibido na caixa Fórmula, será exibida a relação entre a entidade na qual a fórmula está definida e o próprio campo. É possível aplicar um filtro à expressão em qualquer lugar no caminho do modelo. Clique para aplicar um filtro à expressão e clique em Criar novo filtro. A caixa de diálogo Dados do Filtro é exibida.

Funções

As informações a seguir descrevem cada uma das funções encontradas na guia Funções da caixa de diálogo Definir Fórmula.

Agregado

Para resumir um intervalo de valores numéricos, use as funções a seguir.

• SUM
  Retorna a soma de todos os valores não-nulos em um conjunto de valores.

  Sintaxe

  SUM(aggregate)

  SUM pode ser usada apenas em campos que contenham valores numéricos. Os valores nulos são ignorados.

• AVERAGE
  Retorna a média (aritmética) de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  AVERAGE(aggregate)

  AVERAGE pode ser usada apenas em campos que contenham valores numéricos. Os valores nulos são ignorados.

• MAX
  Retorna o máximo de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  MAX(aggregate)

  Para colunas de caracteres, MAX localiza o valor mais alto na seqüência de agrupamento. Os valores nulos são ignorados.

• MIN
  Retorna o mínimo de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  MIN(aggregate)

  Para colunas de caracteres, MIN localiza o valor mais baixo na seqüência de agrupamento. Os valores nulos são ignorados.

• COUNT
  Retorna o número de valores não-nulos de um conjunto de valores.

  Sintaxe

  COUNT(aggregate)

  COUNT sempre retorna um valor do tipo de dados Int.

• COUNTDISTINCT
  Retorna o número de valores não-nulos de um conjunto de valores.

  Sintaxe

  COUNTDISTINCT(aggregate)

• STDev
  Retorna o desvio padrão de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  STDEV(aggregate)

• STDevP
  Retorna o desvio padrão da população de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  STDEVP(aggregate)

• VAR
  Retorna a variância de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  VAR(aggregate)

• VARP
  Retorna a variância da população de todos os valores não-nulos de um conjunto de valores.

  Sintaxe

  VARP(aggregate)

Condicional

Para testar uma condição, use as funções a seguir.

• IF
  Retorna um valor se for especificada uma condição que seja avaliada como TRUE e outro valor se for especificada uma condição avaliada como FALSE.

  Sintaxe

  IFcondition, value_if_true, value_if_false)

  A condição deve ser avaliada como TRUE ou FALSE. Value_if_true representa o valor retornado se a condição for true. Value_if_false representa o valor retornado se a condição for false.

• IN
  Determina se um valor está presente em um conjunto de valores.

  Sintaxe

  IN(item, set)

• Switch
  Avalia uma lista de expressões e retorna um valor de uma expressão associado à primeira expressão na lista que seja True. Switch pode ter um ou mais pares de condições/valores.

  Sintaxe

  Switch(condition1, value1, …)

Conversão

Para converter um valor de um tipo de dados em outro, use as funções a seguir.

• INT
  Converte um valor em um inteiro.

  Sintaxe

  INT(value)

• DECIMAL
  Converte um valor em um decimal.

  Sintaxe

  DECIMAL(value)

• FLOAT
  Converte um valor em um tipo de dados float.

  Sintaxe

  FLOAT(value)

• TEXT
  Converte um valor numérico em texto.

  Sintaxe

  TEXT(value)

Data e hora

Para exibir a data ou a hora, use as funções a seguir.

• DATE
  Retorna um valor de data/hora que representa o ano, o mês e o dia especificados às 00h00.

  Sintaxe

  DATE(year, month, day)

• DATEONLY
  Retorna um valor de data/hora que representa o ano, o mês e o dia especificados.

  Sintaxe

  DATEONLY(datetime)

• DATETIME
  Retorna um valor de data/hora que representa o ano, o mês, o dia, a hora, o minuto e o segundo especificados.

  Sintaxe

  DATETIME(year, month, day, hour, minute, second)

• YEAR
  Retorna um valor de ano a partir de uma data e hora.

  Sintaxe

  YEAR(datetime)

• QUARTER
  Retorna o trimestre do calendário (1 a 4) da data e hora.

  Sintaxe

  QUARTER(datetime)

• MONTH
  Retorna o mês (1 a 12) de uma data e hora.

  Sintaxe

  MONTH(datetime)

• DAY
  Extrai o dia de uma data e hora.

  Sintaxe

  DAY(datetime)

• HOUR
  Extrai a hora (0 a 23) de uma data e hora.

  Sintaxe

  HOUR(datetime)

• MINUTE
  Extrai o minuto de uma data e hora.

  Sintaxe

  MINUTE(datetime)

• SECOND
  Extrai o segundo de uma data e hora.

  Sintaxe

  SECOND(datetime)

• DAYOFYEAR
  Retorna o dia do ano do datetime. 1º de janeiro = 1 a 31 de dezembro = 366, pressupondo-se que se trate de um ano bissexto.

  Sintaxe

  DAYOFYEAR(datetime)

• WEEK
  Retorna o valor numérico correspondente à semana no ano civil.

  Sintaxe

  WEEK(datetime)

• DAYOFWEEK
  Retorna o dia da semana, começando com segunda-feira. Segunda-feira = 1 até domingo = 7.

  Sintaxe

  DAYOFWEEK(datetime)

• NOW
  Retorna a data e a hora atuais.

  Sintaxe

  NOW( )

• TODAY
  Retorna a data atual.

  Sintaxe

  TODAY( )

• DATEDIFF
  Retorna a diferença entre a Data e hora de início e a Data e hora de término.

  Sintaxe

  DATEDIFF(interval, datetime, datetime)

• DATEADD
  Retorna um valor de data e hora que é o resultado da adição do número especificado de unidades de intervalo de tempo à data e à hora originais.

  Sintaxe

  DATEADD(interval, units, datetime)

Lógica

Para testar a lógica de uma condição, use as funções a seguir.

• AND
  Retornará TRUE se todos os argumentos forem TRUE; retornará FALSE se um ou mais argumentos forem FALSE.

  Sintaxe

  AND(logical, logical)

  Os argumentos devem ser avaliados como valores lógicos, como TRUE ou FALSE, ou devem ser matrizes ou referências com valores lógicos. Se um argumento de matriz ou referência contiver texto ou células vazias, esses valores serão ignorados.

• OR
  Retornará TRUE se qualquer argumento for TRUE; retornará FALSE se todos os argumentos forem FALSE.

  Sintaxe

  OR(logical, logical)

  Os argumentos devem ser avaliados como valores lógicos, como TRUE ou FALSE, ou estar contidos em matrizes ou referências com valores lógicos. Se uma matriz ou referência contiver texto ou células vazias, esses valores serão ignorados.

• NOT
  Inverte o valor do argumento. Use NOT para garantir que uma cláusula não seja igual a um determinado valor.

  Sintaxe

  NOT(logical)

  Se o valor for FALSE, NOT retornará TRUE; se o valor for TRUE, NOT retornará FALSE.

Matemática

Para manipular valores numéricos, use as funções a seguir.

• MOD
  Retorna o resto após a divisão de um número por um divisor. O divisor não pode ser 0.

  Sintaxe

  MOD(number, divisor)

• TRUNC
  Trunca um número de acordo com o número de dígitos especificado. Se o número for positivo, será truncado à direita do decimal. Se o número for negativo, será truncado à esquerda do decimal.

  Sintaxe

  TRUNC(number, digits)

• ROUND
  Arredonda um número para um número especificado de dígitos.

  Sintaxe

  ROUND(number, digits)

  Se o número de dígitos for maior que 0 (zero), o número será arredondado para o número especificado de casas decimais. Se o número de dígitos for 0, o número será arredondado para o inteiro mais próximo. Se o número for menor que 0, será arredondado à esquerda do ponto decimal.

Operadores

Operadores aritméticos

Para efetuar operações matemáticas básicas, como adição, subtração, ou multiplicação, combinar números e produzir resultados numéricos, use os operadores a seguir.

• + Adicionar
  Use para adicionar dois ou mais itens.

  Sintaxe

  value + value

• - Subtração
  Use para deduzir um item de outro.

  Sintaxe

  value- value

• * Multiplicação
  Use para multiplicar itens.

  Sintaxe

  value* value

• / Divisão
  Use para dividir itens. O divisor não pode ser 0.

  Sintaxe

  value/divisor

• - Negação
  Alterar o sinal do valor.

  Sintaxe

  -value

• ^ Exponenciação
  Use para elevar um valor a uma potência (exponenciação).

  Sintaxe

  value^power

Operadores de comparação

Para comparar dois valores e retornar um valor lógico TRUE ou FALSE, use os operadores a seguir.

• = Igual a
  Use para igualar dois valores. True quando value1 é igual a value2.

  Sintaxe

  value1= value2

• <> Não igual a
  Use para indicar que dois valores não são iguais. True quando o value1 não é igual ao value2.

  Sintaxe

  value1 <> value2

• > Maior que
  Use para indicar que um valor é maior que outro. True quando o value1 é maior que o value2.

  Sintaxe

  value1 > value2

• >= Maior ou Igual a
  Usado para indicar que um valor é maior ou igual a outro. True quando o value1 for maior ou igual ao value2.

  Sintaxe

  value1 >= value2

• < Menor que
  Use para indicar que um valor é menor que outro. True quando value1 é menor que value2.

  Sintaxe

  value1 < value2

• <= Menor ou Igual a
  Use para indicar que um valor é menor ou igual a outro. True quando o value1 é menor ou igual ao value2.

  Sintaxe

  value1 <= value2

Texto

Para manipular texto no relatório, use as funções a seguir.

• Concat (&)
  Combina duas cadeias de caracteres em uma única. A segunda cadeia de caracteres é anexada à primeira.

  Sintaxe

  string & string

• Find
  Posição da primeira instância de uma cadeia de caracteres.

  Sintaxe

  FIND(string, substring)

• Left
  Retorna os caracteres da extremidade esquerda de uma cadeia de caracteres.

  Sintaxe

  LEFT(string, length)

• Length
  Retorna o número de caracteres de uma cadeia.

  Sintaxe

  LENGTH(string)

• Lower
  Converte uma cadeia de caracteres maiúsculos em minúsculos.

  Sintaxe

  LOWER(string)

• LTrim
  Retorna uma cadeia de caracteres com os espaços à esquerda removidos.

  Sintaxe

  LTRIM(string)

• Replace
  Retorna uma cadeia de caracteres com todas as instâncias de uma subcadeia de caracteres substituídas por outra subcadeia.

  Sintaxe

  REPLACE(find, replace, string)

• Right
  Retorna os caracteres mais à direita de uma cadeia.

  Sintaxe

  RIGHT(string, length)

• RTrim
  Retorna uma cadeia de caracteres com os espaços à direita removidos.

  Sintaxe

  RTRIM(string)

• Text
  Converte um valor numérico em uma cadeia de caracteres.

  Sintaxe

  TEXT(value)

• Substring
  Retorna uma subcadeia de caracteres de uma cadeia de caracteres.

  Sintaxe

  SUBSTRING(string, start, length)

• Upper
  Converte uma cadeia de caracteres minúsculos em maiúsculos.

  Sintaxe

  UPPER(string)

Informações

Para retornar informações globais sobre usuários, use as funções a seguir.

• GetUserID
  Retorna a ID utilizada pelo usuário para acessar os dados.

  Sintaxe

  GETUSERID()

• GetUserCulture
  Retorna o idioma ou a localidade do usuário.

  Syntax

  GETUSERCULTURE()

Consulte também

Conceitos

Ajuda F1 do Construtor de Relatórios 1.0

Trabalhando com fórmulas (Construtor de Relatórios 1.0)

Usando funções (Construtor de Relatórios 1.0)