Índice

Introdução

Esta página lista e detalha todas as funções que podem ser utilizadas nas expressões no design de um relatório.

Funções de Agregação

Avg(Valor)

Retorna a média dos valores da coleção de dados.

Ex,:

[Produtos].Avg([PrecoUnitario])

Count(Valor)

Retorna o número de objetos em uma coleção de dados.

Ex,:

[Products].Count() → Retorna a quantidade de produtos em uma coleção de dados

Exists()

Determina se o objeto (Valor Especifico) existe na coleção de dados.

Ex.:

[Categories][[CategoryID] == 7].Exists()

Join()

Concatena todos os valores de Expressão na Coleção com base na Condição especificada (opcional) em uma única string (texto) separada pelo Separador especificado (opcional). Se você não especificar um Separador , a função usará uma vírgula.

A função tem as seguintes sobrecargas (2 formas de usar):

[Coleção][Condição].Join(Expressão)

[Coleção][Condição].Join(Expressão, Separador)

Ex.:

A expressão a seguir concatena os valores do campo CompanyName em um relatório agrupado pelo campo CategoryID em uma única string (texto) separada por ponto e vírgula:

[][[CategoryID] == [^.CategoryID]].Join([CompanyName], ';') → Concatena o valor do Id e o Nome da categoria separado por virgula:  41,Cereais

Max(Valor)

Retorna o valor máximo da expressão em uma coleção de dados.

ex.:

[Products].Max([UnitPrice]) →  Retorna o maior valor de preço unitário de uma coleção de produtos.

Min(Valor)

Retorna o valor mínimo da expressão em uma coleção de dados.

ex.:

[Products].Min([UnitPrice]) → Retorna o menor valor de preço unitário de uma coleção de produtos.

Single()

Retorna um objeto (Dado procurado) se for o único elemento de uma coleção de dado.

ex.:

[Accounts].Single() is not null

Single(Expressão)

Você pode passar uma expressão como parâmetro: [Coleção][Condição].Single(Expressão) .

Esta função retorna a Expressão se a Coleção contiver apenas um objeto que atenda à Condição especificada (opcional).

ex.:

[Coleção].Single([Propriedade]) → Retorna o valor da propriedade do objeto encontrado.

Sum(Valor)

Retorna a soma de todos os valores de expressão na coleção.

Ex.:

[Products].Sum([UnitsInStock]) → Soma os valores Unidade em estoque da coleção produtos

Funções de data e hora

AddDays(Data, Numero de Dias)

Retorna um valor de uma Data que é o número especificado de dias antes (Numero de dias negativos) ou depois (Numero de dias positivo) de uma data especificada.

Os operandos são:

1 - o valor Data é a data de início especificada com ou sem horas.

2 - o valor número de dias será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo. Sua parte decimal é uma fração de dia.

Ex.:

AddDays([OrderDate], 30) → Adiciona 30 dias a partir da data de compra (OrderDate).

AddHours(Data, Numero de Horas)

Retorna um valor Data e Hora que é o número especificado de dias  antes (Numero de horas negativos) ou depois (Numero de horas positivo) de uma data especificada.

Os operandos são:

1 - o valor Data é a data de início especificada com ou sem horas.

2 - o valor número de horas será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo. Sua parte decimal é uma fração de hora.

Ex.:

AddHours([FinishTime], -2) → Reduz 2 horas a partir do tempo final (FinishTime).

AddMilliSeconds(Data, Numero de Milissegundos)

Retorna um valor Data e hora que é o número especificado de milissegundos antes (Numero de milissegundos negativos) ou depois (Numero de milissegundos positivo) de uma data especificada.

Os operandos são:

1 - o valor Data é a data de início especificada com ou sem horas.

2 - o valor número de milissegundos  será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo. Sua parte decimal é uma fração de milissegundo.

Ex.:

AddMilliSeconds(([StartTime], 5000))

AddMinutes(Data, Numero de Minutos)

Retorna um valor Data e hora que é o número especificado de minutos antes (Numero de minutos negativos) ou depois (Numero de minutos positivo) de uma data especificada.

Os operandos são:

1 - o valor Data é a data de início especificada com ou sem horas.

2 - o valor número de minutos será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo. Sua parte decimal é uma fração de milissegundo.

Ex.:

AddMinutes([StartTime], 30)

AddMonths(

Data,

Numero de Meses)

Retorna um valor data e hora que é o número especificado de meses antes ou depois de uma data de início especificada.

Os operandos são:

1 - o valor Data é a data de início.

2 - o valor número de meses será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo. Sua parte decimal é uma fração de meses.

Exemplo:

AddMonths([OrderDate], 1)

AddSeconds(

Data,

Numero de Segundos)

AddTicks(DateTime, TicksCount)

AddTimeSpan(DateTime, TimeSpan)

AddYears(DateTime, YearsCount)

DateDiffDay(startDate, endDate)

DateDiffHour(startDate, endDate)

DateDiffMilliSecond(startDate, endDate)

DateDiffMinute(startDate, endDate)

DateDiffMonth(startDate, endDate)

DateDiffSecond(startDate, endDate)

DateDiffTick(startDate, endDate)

DateDiffYear(startDate, endDate)

DateTimeFromParts(Year, Month, Day, Hour, Minute, Second, Millisecond)

GetDate(DateTime)

GetDay(DateTime)

GetDayOfWeek(DateTime)

GetDayOfYear(DateTime)

GetHour(DateTime)

GetMilliSecond(DateTime)

GetMinute(DateTime)

GetMonth(DateTime)

GetSecond(DateTime)

GetTimeOfDay(DateTime)

GetYear(DateTime)

InDateRange(DateTime1, DateTime2, DateTime3)

Lógico

Matemática

String

Reporting

Resumo

TOTVS