Compartilhar via

  • Artigo

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()