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

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

Os operandos são:

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

2 - o valor Double que é o número de segundos antes ou depois da data de início. Este número pode ser negativo ou positivo. Sua parte decimal é uma fração de segundo.

Ex.:

AddSeconds([StartTime], 60)

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