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

Exemplo: [Produtos].Avg([PrecoUnitario])

Count(Valor)

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

Exemplo: [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.

Exemplo: [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)

Exemplo: 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.

Exemplo: [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.

Exemplo: [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.

Exemplo: [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).

Exemplo: [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.

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

Funções de data e hora

AddDays(DateTime, DaysCount)

Retorna um valor de uma Data que é o número especificado de dias antes (Numero negativos) ou depois (Numero 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 decimal de 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.

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

AddHours(DateTime, HoursCount)

Retorna um valor Data e Hora que é o número especificado de dias  antes (Numero negativos) ou depois (Numero 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 decimal de 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.

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

AddMilliSeconds(DateTime, MilliSecondsCount)

Retorna um valor Data e hora que é o número especificado de milissegundos antes (Numero negativos) ou depois (Numero 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 decimal de 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.

Exemplo: AddMilliSeconds(([StartTime], 5000)) → Aumenta em 5000 milissegundos o tempo de inicio (StartTime)

AddMinutes(DateTime, MinutesCount)

Retorna um valor Data e hora que é o número especificado de minutos antes (Numero negativos) ou depois (Numero 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 decimal de 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.

Exemplo: AddMinutes([StartTime], -30) → Reduz em 30 minutos o tempo de inicio (StartTime)

AddMonths(DateTime, MonthsCount)

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

Os operandos são:

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

2 - o valor inteiro de número de meses será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo.

Exemplo: AddMonths([OrderDate], 1) → Aumenta em 1 mês a data da ordem (OrdemDate)

AddSeconds(DateTime, SegundosCount)

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

Os operandos são:

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

2 - o valor decimal de número de segundos 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 segundos.

Exemplo: AddSeconds([StartTime], -60) → Reduz em 60 segundos o tempo de inicio (StartTime)

AddTicks(DateTime, TicksCount)

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

Os operandos são:

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

2 - o valor inteiro de número de ticks de 100 nanossegundos será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo.

Exemplo: AddTicks([StartTime], 5000) → Aumenta em 5000 ticks (500.000 nanossegundos) o tempo de inicio (StartTime)

AddTimeSpan(DateTime, TimeSpan)

Retorna um valor Data e hora que difere por um período de tempo especificado de uma data especificada.

Os operandos são:

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

2 - o objeto duração que é o período  será o valor de avanço ou retrocesso da data especificada. 

Exemplo: AddTimeSpan([StartTime], [Duration]) 

AddYears(DateTime, YearsCount)

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

Os operandos são:

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

2 -o valor inteiro de número de anos será o valor de avanço ou retrocesso da data especificada. Este número pode ser negativo ou positivo.

Exemplo: AddYears([EndDate], -1) → Reduz em 1 ano a data final (EndDate)

DateDiffDay(startDate, endDate)

Retorna o número de dias entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffDay([StartDate], [FinishDate]) → Retorna o numero de dias entre a data de inicio (StartDate) e data final (FinishDate)

DateDiffHour(startDate, endDate)

Retorna o número de horas entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffHour([StartTime], [FinishTime]) → Retorna o numero de horas entre a data de inicio (StartTime) e data final (FinishTime)

DateDiffMilliSecond(startDate, endDate)

Retorna o número de milissegundos entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffMilliSecond([StartTime], [FinishTime]) → Retorna o numero de milissegundos entre a data de inicio (StartTime) e data final (FinishTime)

DateDiffMinute(startDate, endDate)

Retorna o número de minutos entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffMinute([StartTime], [FinishTime]) → Retorna o numero de minutos entre a data de inicio (StartTime) e data final (FinishTime)

DateDiffMonth(startDate, endDate)

Retorna o número de meses entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffMonth([StartTime], [FinishTime]) → Retorna o numero de meses entre a data de inicio (StartTime) e data final (FinishTime)

DateDiffMonth(startDate, endDate)

Retorna o número de segundos entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffSecond([StartTime], [FinishTime]) → Retorna o numero de segundos entre a data de inicio (StartTime) e data final (FinishTime)

DateDiffTick(startDate, endDate)

Retorna o número de limites de ticks entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffTick([StartTime], [FinishTime]) → Retorna o numero de ticks (Grupo de 100 nanossegundos) entre a data de inicio (StartTime) e data final (FinishTime)

DateDiffYear(startDate, endDate)

Retorna o número de limites de anos entre as datas especificadas.

Os operandos são:

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

2 - o valor Datafim é a data final.

Exemplo: DateDiffYear([StartDate], [FinishDate]) → Retorna o numero de anos entre a data de inicio (StartDate) e data final (FinishDate)

DateTimeFromParts(Ano, Mês, Dia, Hora, Minuto, Segundo, Milissegundo)

Retorna um valor de data construído a partir do Ano, Mês, Dia, Hora, Minuto, Segundo e Milissegundo especificados.

Os operandos são:

1 - (Obrigatório) - um valor inteiro que é o valor do ano completo (quatro dígitos, século incluído).

2 - (Obrigatório) - um valor inteiro que é o número do mês (1-12).

3 - (Obrigatório) - um valor inteiro que é o dia do mês (1-31).

4 - (Opcional) - um valor de hora no formato de 24 horas (0-23).

5 - (Opcional) - um valor de minuto (0-59).

6 - (Opcional) - um segundo valor (0-59).

7 - (Opcional) - um valor em milissegundos.

Exemplo: DateTimeFromParts(2018, 5, 5, 20) → Retorna a data 05/05/2018 20:00:00

GetDate(DateTime)

Retorna a parte da data desconsiderando os horas, minutos, segundos de uma data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um objeto DateTime com a mesma parte de data. O horário é 00:00:00.

Exemplo: GetDate(01-05-2024 08:33:21) → Retorna a data 01-05-2024 00:00:00

GetDay(DateTime)

Obtém o dia do mês na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 1 e 31.

Exemplo: GetDay([OrderDate]) → Retornará o dia da Ordem, ex.: 28

GetDayOfWeek(DateTime)

Obtém o dia da semana na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um valor inteiro da enumeração Dia da Semana (0 a 6). Não depende da cultura atual.

Exemplo: GetDayOfWeek([OrderDate])

GetDayOfYear(DateTime)

Obtém o dia do ano na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 1 e 366.

Exemplo: GetDayOfYear([OrderDate])

GetHour(DateTime)

Retorna o valor das horas na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 0 e 23.

Exemplo: GetHour([StartTime])

GetMilliSecond(DateTime)

Retorna o valor em milissegundos na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 0 e 999.

Exemplo: GetMilliSecond([StartTime])

GetMinute(DateTime)

Retorna o valor dos minutos na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 0 e 59.

Exemplo: GetMinute([StartTime])

GetMonth(DateTime)

Obtém o mês na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro e depende do calendário atual.

Exemplo: GetMonth([StartTime])

GetSecond(DateTime)

Retorna o valor dos segundos na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 0 e 59.

Exemplo: GetSecond([StartTime])

GetTimeOfDay(DateTime)

Obtém a parte da hora da data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é o objeto Int64 que é o número de ticks de 100 nanossegundos decorridos desde a meia-noite.

Exemplo: GetTimeOfDay([StartTime])

GetYear(DateTime)

Obtém o ano na data especificada.

O operando deve ser do tipo DateTime.

O valor de retorno é um número inteiro no intervalo entre 1 e 9999.

Exemplo: GetYear([StartTime])

InDateRange(DataHora1, DataHora2, DataHora3)

Exemplo: InDateRange([OrderDate], #2022-01-01 00:00:00#, #2022-12-31 23:59:59#)

IsApril(DateTime)

Retorna True se a data especificada estiver dentro de abril.

Exemplo: IsApril([OrderDate])

IsAugust(DateTime)

Retorna True se a data especificada estiver dentro de agosto.

Exemplo: IsAugust([OrderDate])

IsDecember(DateTime)

Retorna True se a data especificada estiver dentro de dezembro.

Exemplo: IsDecember([OrderDate])

IsFebruary(DateTime)

Retorna True se a data especificada estiver dentro de fevereiro.

Exemplo: IsFebruary([OrderDate])

IsJanuary(DateTime)

Retorna True se a data especificada estiver dentro de janeiro.

Exemplo: IsJanuary([OrderDate])

IsJuly(DateTime)

Retorna True se a data especificada estiver dentro de julho.

Exemplo: IsJuly([OrderDate])

IsJune(DateTime)

Retorna True se a data especificada estiver dentro de junho.

Exemplo: IsJune([OrderDate])

IsLastMonth(DateTime)

Retorna True se a data especificada estiver no mês anterior.

Exemplo: IsLastMonth([OrderDate])

IsLastYear(DateTime)

Retorna True se a data especificada estiver no ano anterior.

Exemplo: IsLastYear([OrderDate])

IsMarch(DateTime)

Retorna True se a data especificada estiver dentro de março.

Exemplo: IsMarch([OrderDate])

IsMay(DateTime)

Retorna True se a data especificada estiver dentro de maio.

Exemplo: IsMay([OrderDate])

IsNextMonth(DateTime)

Retorna True se a data especificada estiver no próximo mês.

Exemplo: IsNextMonth([OrderDate])

IsNextYear(DateTime)

Retorna True se a data especificada estiver no próximo ano.

Exemplo: IsNextYear([OrderDate])

IsNovember(DateTime)

Retorna True se a data especificada estiver dentro de novembro.

Exemplo: IsNovember([OrderDate])

IsOctober(DateTime)

Retorna True se a data especificada estiver dentro de outubro.

Exemplo: IsOctober([OrderDate])

IsSameDay(DateTime)

Retorna True se os valores de data/hora especificados estiverem no mesmo dia.

Exemplo: IsSameDay([OrderDate])

IsSeptember(DateTime)

Retorna True se a data especificada estiver dentro de setembro.

Exemplo: IsSeptember([OrderDate])

IsThisMonth(DateTime)

Retorna True se a data especificada estiver dentro do mês atual.

Exemplo: IsThisMonth([OrderDate])

IsThisWeek(DateTime)

Retorna True se a data especificada estiver na semana atual.

Exemplo: IsThisWeek([OrderDate])

IsYearToDate(DateTime)

Retorna True se a data especificada estiver dentro do período que começa no primeiro dia do ano atual e continua até a data atual (incluindo a data atual).

Exemplo: IsYearToDate([OrderDate])

IsThisYear(DateTime)

Retorna True se a data especificada estiver no ano atual.

Exemplo: IsThisYear([OrderDate])

LocalDateTimeDayAfterTomorrow()

Retorna o valor DateTime que possui a parte da data dois dias após a data atual e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeDayAfterTomorrow(), 5)

LocalDateTimeLastMonth()

Retorna o valor DateTime que possui a parte da data um mês antes da data atual e a parte da hora 00:00:00.

Exemplo: AddMonths(LocalDateTimeLastMonth(), 5)

LocalDateTimeLastWeek()

Retorna o valor DateTime que possui a parte da data 7 dias antes do início da semana atual e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeLastWeek(), 5)

LocalDateTimeLastYear()

Retorna o valor DateTime que possui a parte da data que é o primeiro dia do ano anterior e a parte da hora 00:00:00.

Exemplo: AddYears(LocalDateTimeLastYear(), 5)

LocalDateTimeNextMonth()

Retorna o valor DateTime que possui a parte da data que é o primeiro dia do próximo mês e a parte da hora 00:00:00.

Exemplo: AddMonths(LocalDateTimeNextMonth(), 5)

LocalDateTimeNextWeek()

Retorna o valor DateTime que possui a parte da data 7 dias após o início da semana atual e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeNextWeek(), 5)

LocalDateTimeNextYear()

Retorna o valor DateTime com a parte da data que corresponde ao primeiro dia do próximo ano e a parte da hora 00:00:00.

Exemplo: AddYears(LocalDateTimeNextYear(), 5)

LocalDateTimeNow()

Retorna o valor DateTime que é o momento atual.

Exemplo: AddDays(LocalDateTimeNow(), 5)

LocalDateTimeThisMonth()

Retorna o valor DateTime com a parte da data que é o primeiro dia do mês atual e a parte da hora 00:00:00.

Exemplo: AddMonths(LocalDateTimeThisMonth(), 5)

LocalDateTimeThisWeek()

Retorna o valor DateTime com a parte da data que é o primeiro dia da semana atual e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeThisWeek(), 5)

LocalDateTimeThisYear()

Retorna o valor DateTime com a parte da data que é o primeiro dia do ano atual e a parte da hora 00:00:00.

Exemplo: AddYears(LocalDateTimeThisYear(), 5)

LocalDateTimeToday()

Retorna o valor DateTime com a parte da data que é o início do dia atual e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeToday(), 5)

LocalDateTimeTomorrow()

Retorna o valor DateTime com a parte da data que é o dia seguinte e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeTomorrow(), 5)

LocalDateTimeTwoMonthsAway()

Retorna o valor DateTime com a parte da data que é o primeiro dia do mês após o mês seguinte e a parte da hora 00:00:00.

Exemplo: AddMonths(LocalDateTimeTwoMonthAway(), 5)

LocalDateTimeTwoWeeksAway()

Retorna o valor DateTime com a parte da data que é o primeiro dia da semana após a semana seguinte e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeTwoWeeksAway(), 5)

LocalDateTimeTwoYearsAway()

Retorna o valor DateTime com a parte da data que é o primeiro dia do ano após o ano seguinte e a parte da hora 00:00:00.

Exemplo: AddYears(LocalDateTimeTwoYearsAway(), 5)

LocalDateTimeYearBeforeToday()

Retorna o valor DateTime com a parte da data que é a data de um ano atrás e a parte da hora de 00:00:00.

Exemplo: AddYears(LocalDateTimeYearBeforeToday(), 5)

LocalDateTimeYesterday()

Retorna o valor DateTime com a parte da data que é o dia anterior e a parte da hora 00:00:00.

Exemplo: AddDays(LocalDateTimeYesterday(), 5)

Now()

Retorna o valor DateTime que é a data e hora atuais.

Exemplo: AddDays(Now(), 5)

Today()

Retorna um valor DateTime que é a data atual. A parte horária está definida como 00:00:00.

Exemplo: AddMonths(Today(), 1)

UtcNow()

Retorna um objeto DateTime que é a data e hora atuais no Tempo Universal Coordenado (UTC).

Exemplo: AddDays(UtcNow(), 7)

Lógico

Iif(Expressão1, True_Value1,…, ExpressãoN, True_ValueN, False_Value)

Retorna um dos valores especificados dependendo dos valores das expressões lógicas.

A função pode receber 2N+1 argumentos (onde N é o número de expressões lógicas especificadas):

• Cada argumento ímpar especifica uma expressão lógica.

• Cada argumento par especifica o valor retornado se a expressão anterior for avaliada como True.

• O último argumento especifica o valor que será retornado se as expressões lógicas avaliadas anteriormente produzirem False.

• Se você passar apenas um argumento, o argumento passado será retornado.

• Se você comparar 0 (zero) com um valor Nulo, a expressão será avaliada como True.

Exemplos:

Iif(Name = 'Bob', 1, 0)

Iif(Name = 'Bob', 1, Name = 'Dan', 2, Name = 'Sam', 3, 0)

InRange(Valor1, Valor2, Valor3)

Exemplo: InRange([ProductPrice], 10.00, 50.00)

IsNull(Value)

Compara o primeiro operando com o valor NULL.

Esta função requer um ou dois operandos da classe CriteriaOperator. O valor retornado depende do número de argumentos.

Se um único operando for passado, a função retornará True se o operando for nulo; caso contrário, nulo.

Se dois operandos forem passados, a função retornará o segundo operando se o primeiro operando for nulo. Caso contrário, a função retorna o primeiro operando.

Exemplo: IsNull([OrderDate])

IsNullOrEmpty(String)

Retorna True se o valor especificado for nulo ou uma string vazia. Caso contrário, retorna False.

Exemplo: IsNullOrEmpty([ProductName])

Matemática

Abs(Value)

Retorna o valor positivo absoluto da expressão numérica fornecida.

Exemplo: Abs(1 - [Discount])

Acos(Value)

Retorna o arco cosseno de um número (o ângulo em radianos, cujo cosseno é a expressão flutuante fornecida).

Exemplo: Acos([Value])

Asin(Value)

Retorna o arco seno de um número (o ângulo em radianos cujo seno é a expressão flutuante fornecida).

Exemplo: Asin([Value])

Atn(Value)

Retorna o arco tangente de um número (o ângulo em radianos cuja tangente é a expressão flutuante fornecida).

Exemplo: Atn([Value])

Atn2(Value1, Value2)

Retorna o arco tangente (a função tangente inversa) do quociente dos dois operandos numéricos especificados. O arco tangente é o ângulo no intervalo de -π/2 a π/2 radianos.

Os operandos são:

1 - a coordenada y de um ponto em coordenadas cartesianas (x, y).

2 - a coordenada x de um ponto em coordenadas cartesianas (x, y).

Se os operandos especificados não puderem ser convertidos em Double, o NotSupportedException será lançado.

Exemplo: Atn2([Value1], [Value2])

BigMul(Value1, Value2)

Calcula o produto completo de dois operandos inteiros.

Se os operandos especificados não puderem ser convertidos em Int32, o NotSupportedException será lançado.

Exemplo: BigMul([Amount], [Quantity])

Ceiling(Value)

Retorna o menor valor integral maior ou igual ao operando numérico especificado.

Se o operando especificado não for numérico, o NotSupportedException será lançado.

Exemplo: Ceiling([Value])

Cos(Value)

Retorna o cosseno do ângulo em radianos.

Exemplo: Cos([Value])

Cosh(Value)

Retorna o cosseno hiperbólico do ângulo em radianos.

Exemplo: Cosh([Value])

Exp(Value)

Retorna o valor exponencial da expressão flutuante.

Exemplo: Exp([Value])

Floor(Value)

Retorna o maior valor integral menor ou igual ao operando numérico especificado.

Se o operando especificado não for numérico, o NotSupportedException será lançado.

Exemplo: Floor([Value])

Log(Value)

Retorna o logaritmo natural de um número especificado.

Exemplo: Log([Value])

Log(Value, Base)

Retorna o logaritmo do operando numérico especificado. O valor de retorno depende do número de operandos.

Se um operando for passado, a função retornará o logaritmo natural (base e) de um operando especificado.

Se dois operandos forem passados, a função retornará o logaritmo do operando especificado para a base especificada. Os operandos são:

1 - um número cujo logaritmo deve ser calculado.

2 - a base do logaritmo.

Se o operando não puder ser convertido em Double, a NotSupportedException será lançada.

A função Log inverte a função FunctionOperatorType.Exp. Para calcular o logaritmo de base 10, use a função FunctionOperatorType.Log10.

Exemplo: Log([Value], 2)

Log10(Value)

Retorna o logaritmo de base 10 do número especificado.

Exemplo: Log10([Value])

Max(Value1, Value2)

Retorna o maior de dois valores numéricos.

Exemplo: Max([Value1], [Value2])

Min(Value1, Value2)

Retorna o menor de dois valores numéricos.

Exemplo: Min([Value1], [Value2])

Power(Value, Power)

Retorna um operando numérico especificado elevado a uma potência especificada.

Os operandos são:

1 - o número base.

2 - o expoente ao qual o número base é elevado.

Se o operando não puder ser convertido em Double, a NotSupportedException será lançada.

A função Power inverte a função FunctionOperatorType.Log ou FunctionOperatorType.Log10. Use o operando FunctionOperatorType.Exp para calcular potências do número e.

Exemplo: Power([Value], 3)

Rnd()

Retorna um número aleatório menor que 1, mas maior ou igual a zero.

Exemplo: Rnd()*100

Round(Value)

Arredonda um operando numérico especificado para o número inteiro mais próximo ou para um número especificado de dígitos fracionários.

Os operandos são:

1 - um valor para arredondar.

2 - (opcional) o número de casas decimais para arredondar. 0 indica que o primeiro operando é arredondado para o número inteiro mais próximo.

Exemplo: Round([Value])

Round(Value, Precision)

Arredonda o valor fornecido para o número inteiro mais próximo ou para um número especificado de casas decimais.

Exemplo: Round([Value], 2)

Sign(Value)

Retorna o sinal positivo (+1), zero (0) ou negativo (-1) da expressão fornecida.

Exemplo: Sign([Value])

Sin(Value)

Retorna o seno do operando numérico, em radianos.

Se o operando não puder ser convertido em Double, a NotSupportedException será lançada.

Exemplo: Sin([Value])

Sinh(Value)

Retorna o seno hiperbólico do operando numérico, em radianos.

Se o operando não puder ser convertido em Double, a NotSupportedException será lançada.

Exemplo: Sinh([Value])

Sqr(Value)

Retorna a raiz quadrada de um operando numérico especificado.

Se o operando não puder ser convertido em Double, a NotSupportedException será lançada.

Exemplo: Sqr([Value])

Tan(Value)

Retorna a tangente do operando numérico especificado que é um ângulo em radianos.

Se o operando não puder ser convertido em Double, a NotSupportedException será lançada.

Exemplo: Tan([Value])

Tanh(Value)

Retorna a tangente hiperbólica de um operando numérico especificado que é um ângulo em radianos.

Se os operandos especificados não puderem ser convertidos em Double, o NotSupportedException será lançado.

Exemplo: Tanh([Value])

ToDecimal(Value)

Converte um operando numérico em um valor decimal.

Exemplo: ToDecimal([Value])

ToDouble(Value)

Converte um operando numérico em um valor duplo.

Exemplo: ToDouble([Value])

ToFloat(Value)

Converte um operando numérico em um valor de ponto flutuante.

Exemplo: ToFloat([Value])

ToInt(Value)

Converte um operando numérico em um valor inteiro.

Exemplo: ToInt([Value])

ToLong(Value)

Converte um operando numérico em um valor inteiro longo.

Exemplo: ToLong([Value])

Funções de relatório

Argb(Alpha, Red, Green, Blue)

Retorna uma string que define uma cor usando os valores do canal de cores Alfa, Vermelho, Verde e Azul.

Argb(1, 200, 30, 200)
Resultado: '1.200.30.200'

ConvertDataToEPC(BeneficiaryName, IBAN, BIC, TransferAmount, CreditorReference, RemittanceInformation, TransferPurpose, Message)

Converte os elementos de dados especificados em uma string formatada para o QR Code EPC. Os parâmetros TransferPurpose e Message são opcionais.

ConvertDataToEPC('Red Cross of Belgium', 'BE72000000001616', 'BPOTBEB1','20.0', '', 'Urgency fund', 'CHAR', 'Sample EPC QR code')

GetDisplayText(?parameterName)

Retorna o texto exibido para o valor de pesquisa de um parâmetro.

Para parâmetros que não são de pesquisa, esta função retorna um valor convertido em uma string.

O trecho de código a seguir obtém o texto exibido para ?employeeParameter que está vinculado a valores predefinidos estáticos ou dinâmicos:

GetDisplayText(?employeeParameter)

Rgb(Red, Green, Blue)

Retorna uma string que define a cor usando os valores dos canais de cores Vermelho, Verde e Azul.

Rgb(30,200,150)
Resultado: '30.200.150'

String

Ascii(String)

Retorna o código ASCII do primeiro caractere de um operando string.

Se o argumento for uma string vazia, o null valor será retornado.

Exemplo: Ascii('a')

Char(Number)

Converte um operando numérico em um caractere Unicode.

Se o operando especificado não for numérico, o NotSupportedException será lançado.

Exemplo: Char(65) + Char(51)

CharIndex(String1, String2, Start, Length)

Retorna o índice da primeira ocorrência de uma string especificada dentro de outra string.

Os operandos são:

1 - uma string que você deseja encontrar em outra string.

2 - uma string que contém a string que você está procurando.

3 - (opcional) um número inteiro que especifica o índice baseado em zero no qual a pesquisa começa. Se este operando não for especificado, a pesquisa começa no início da string.

4 - (opcional) um número inteiro que especifica o número de caracteres a serem examinados, começando na posição especificada. Se este operando não for especificado, a busca continua até o final da string.

Esta função executa uma pesquisa de palavras (diferenciando maiúsculas de minúsculas e culturalmente) usando a cultura atual. Se uma substring especificada for encontrada, a função retornará seu índice. Caso contrário, -1 será retornado.

Exemplo: CharIndex('e', 'devexpress')

Concat(String1, …, StringN)

Concatena as strings especificadas.

Exemplo: Concat('A', ')', [ProductName])

Contains(String1, SubString1)

Retorna True se a string especificada ocorrer dentro de outra string especificada; de outra forma, False.

Os operandos são:

1 - uma string que contém a string que você está procurando.

2 - uma string que você deseja encontrar em outra string.

Exemplo: Contains([ProductName], 'dairy')

EndsWith(String1, SubString1)

Retorna True se o final de uma string especificada corresponder a outra string especificada; de outra forma, False.

Os operandos são:

1 - uma string que contém a string que você está procurando.

2 - uma string para comparar com a substring no final de outra string.

Exemplo: EndsWith([Description], 'The end.')

Insert(String1, StartPosition, String2)

Retorna uma nova string na qual uma string especificada é inserida em uma posição de índice especificada em outra string especificada.

Os operandos são:

1 - a string na qual outra string deve ser inserida.

2 - a posição do índice com base zero da inserção.

3 - a string a ser inserida.

Exemplo: Insert([Name], 0, 'ABC-')

Len(Value)

Retorna o comprimento da string especificada por um operando.

Exemplo: Len([Description])

Lower(String)

Converte todos os caracteres de um operando de string em letras minúsculas em uma cultura invariável. Exemplo:Lower([ProductName])

PadLeft(String, Length, Char)

Retorna uma nova string que preenche o caractere na string especificada à esquerda com um caractere Unicode especificado, para um comprimento total especificado.

Os operandos são:

1 - uma string a ser preenchida.

2 - o número total de caracteres na string resultante, incluindo caracteres de preenchimento.

3 - (opcional) um caractere de preenchimento Unicode. Se não for especificado, o caractere de espaço será usado para preenchimento. Se uma string for passada como este operando, seu primeiro caractere será usado para preenchimento.

Exemplo: PadLeft([Name], 30)

PadRight(String, Length, Char)

Retorna uma nova string de comprimento especificado em que o final de uma string especificada é preenchido com espaços ou com um caractere Unicode especificado.

Os operandos são:

1 - uma string a ser preenchida.

2 - o número total de caracteres na string resultante, incluindo caracteres de preenchimento.

3 - (opcional) um caractere de preenchimento Unicode. Se não for especificado, o caractere de espaço será usado para preenchimento. Se uma string for passada como este operando, seu primeiro caractere será usado para preenchimento.

Exemplo: PadRight([Name], 30)

Remove(String, StartPosition, Length)

Retorna uma nova string com o número especificado de caracteres removidos da string especificada, começando na posição especificada.

Os operandos são:

1 - a string que precisa ser encurtada.

2 - o índice baseado em zero no qual a remoção de caracteres começa.

3 - (opcional) um número inteiro que especifica o número de caracteres a serem removidos, começando na posição especificada. Se este operando não for especificado, todos os caracteres entre a posição inicial e o final da string serão removidos.

Exemplo: Remove([Name], 0, 3)

Replace(String1, SubString2, String3)

Retorna uma nova string na qual todas as ocorrências de uma string especificada (string1) em outra string (string2) são substituídas pela string especificada (string3).

Os operandos são:

1 - a string na qual são feitas as substituições.

2 - a string a ser substituída.

3 - a string para substituir todas as ocorrências da string especificada.

Exemplo: Replace([Name], 'The ', '')

Reverse(String)

Retorna uma string na qual a ordem dos caracteres de uma string especificada é invertida.

Exemplo: Reverse([Name])

StartsWith(String1, SubString1)

Retorna True se o início de uma string corresponder a outra string; de outra forma, False.

Os operandos são:

1 - uma string para testar.

2 - uma string para corresponder ao início de outra string.

Exemplo: StartsWith([Title], 'The best')

Substring(String, StartPosition, Length)

Retorna uma substring da string especificada. Esta função requer dois ou três operandos.

Se dois operandos forem passados, a substring começa no início da string especificada. Os operandos são:

1 - a string de origem.

2 - um número inteiro que especifica a posição baseada em zero na qual a substring começa.

Se três operandos forem passados, uma substring inicia na posição especificada na string de origem. Os operandos são:

1 - a string de origem.

2 - um número inteiro que especifica a posição baseada em zero na qual a substring começa.

3 - um número inteiro que especifica o comprimento da substring.

Exemplo: Substring([Description], 2, 3)

ToStr(Value)

Retorna uma representação de string do valor ou propriedade especificada.

Se o operando não puder ser convertido em uma string, NotSupportedException será lançada.

Exemplo: ToStr([ID])

Trim(String)

Retorna uma string que é uma cópia da string especificada com todos os caracteres de espaço em branco removidos do início e do final da string especificada.

Exemplo: Trim([ProductName])

Upper(String)

Converte todos os caracteres de um operando de string em letras maiúsculas em uma cultura invariável.

Exemplo: Upper([ProductName])

Funções para associações de expressões e campos calculados

Abaixo está uma lista de funções usadas para construir ligações de expressão e campos calculados:

NewLine()

Retorna a string de nova linha definida para o ambiente atual.

[CategoryName]+NewLine()+[Description]

FormatString(Format, Value1, … , ValueN)

Retorna a string especificada com valores de campo formatados.

FormatString('{0:$0.00}', [UnitPrice])

Rgb(Red, Green, Blue)

Retorna uma string que define a cor usando os valores dos canais de cores Vermelho, Verde e Azul.

Rgb(30,200,150)

Join()

Concatena valores de parâmetros de relatório com vários valores em uma string. Use esta função ao vincular um parâmetro de vários valores a um rótulo para exibir valores de parâmetros em um relatório. Não use esta função como uma função agregada ou para concatenar valores de campo.

Esta função tem duas sobrecargas:

• Join(parameter) — concatena os valores dos parâmetros especificados usando uma vírgula como separador.
• Join(parameter, separator) — concatena valores de parâmetros especificados usando o separador especificado.

Join(?CategoriesParameter)

Funções para procedimentos armazenados

As seguintes funções são usadas para vincular um relatório a um procedimento armazenado:

Join()

Concatena os valores do parâmetro de relatório de vários valores em uma string.

Esta função pode ser usada ao mapear parâmetros de relatório de vários valores para parâmetros de consulta gerados a partir de parâmetros de um procedimento armazenado. 

Esta função tem duas sobrecargas:

• Join(parameter) — concatena os valores dos parâmetros especificados usando uma vírgula como separador.
• Join(parameter, separator) — concatena os valores dos parâmetros especificados usando o separador especificado.

Join(?Parameter1)

CreateTable(Column1, …, ColumnN)

Cria uma tabela a partir de vários valores de parâmetros com vários valores.

Esta função pode ser usada ao mapear parâmetros de relatório de vários valores para o parâmetro de consulta gerado a partir do parâmetro User Defined Table Type de um procedimento armazenado. 

CreateTable(?Parameter1, ..., ?ParameterN)

Funções para Editor de Expressão de Resumo

Use as seguintes funções ao calcular um resumo em um relatório e seus grupos:

sumAvg(Expression)

Calcula a média de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumAvg([UnitPrice])

sumCount(Expression)

Conta o número de valores na região de resumo especificada (grupo, página ou relatório). Num cenário simples, não é possível passar um parâmetro.

Quando você utiliza esta função na banda mestre de um relatório mestre-detalhe e passa um campo de detalhe como parâmetro, a função conta o número de registros dentro da banda de detalhe.

Veja também:

• Conte o número de registros em um relatório ou grupo
• Conte o número de grupos em um relatório

sumCount([UnitPrice])

sumCarryoverSum(Expression)

Calcula os totais transportados e antecipados.

sumCarryoverSum([Amount])

sumDAvg(Expression)

Calcula a média de todos os valores distintos na região de resumo especificada (grupo, página ou relatório).

sumDAvg([UnitPrice])

sumDCount(Expression)

Conta o número de valores distintos na região de resumo especificada (grupo, página ou relatório). Num cenário simples, não é possível passar um parâmetro.

sumDCount([UnitPrice])

sumDStdDev(Expression)

Calcula o desvio padrão de todos os valores distintos na região de resumo especificada (grupo, página ou relatório).

sumDStdDev([UnitPrice])

sumDStdDevP(Expression)

Calcula o desvio padrão da população de todos os valores distintos na região de resumo especificada (grupo, página ou relatório).

sumDStdDevP([UnitPrice])

sumDSum(Expression)

Calcula o total de todos os valores distintos na região de resumo especificada (grupo, página ou relatório).

sumDSum([UnitPrice])

sumDVar(Expression)

Calcula a quantidade de variação para todos os valores distintos na região de resumo especificada (grupo, página ou relatório).

sumDVar([UnitPrice])

sumDVarP(Expression)

Calcula a variação populacional de todos os valores distintos na região de resumo especificada (grupo, página ou relatório).

sumDVarP([UnitPrice])

sumMax(Expression)

Calcula o máximo de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumMax([UnitPrice])

sumMedian(Expression)

Encontra o número do meio em uma sequência.

Observe que se o número total de elementos for ímpar, esta função retorna o valor do número do meio em uma sequência. Se o número total de elementos for par, esta função retorna a média aritmética dos dois números centrais.

sumMedian([UnitPrice])

sumMin(Expression)

Calcula o mínimo de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumMin([UnitPrice])

sumPercentage(Expression)

Calcula a porcentagem do valor da linha atual em relação ao total de todos os valores na área de resumo especificada (grupo, página ou relatório).

sumPercentage([UnitPrice])

sumRecordNumber(Expression)

Retorna o número do registro atual na região de resumo especificada (grupo, página ou relatório). Isto significa, por exemplo, que se o resumo for calculado para um grupo, então o número do registro será calculado apenas dentro desse grupo e será redefinido sempre que um novo grupo for iniciado.

Num cenário simples, não é possível passar um parâmetro.

sumRecordNumber()

sumRunningSum(Expression)

Calcula a soma de todos os valores anteriores exibidos em uma linha de dados antes do valor da linha de dados atual.

sumRunningSum([UnitPrice])

sumStdDev(Expression)

Calcula o desvio padrão de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumStdDev([UnitPrice])

sumStdDevP(Expression)

alcula o desvio padrão da população de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumStdDevP([UnitPrice])

sumSum(Expression)

Calcula o total de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumSum([UnitsInStock])

sumVar(Expression)

Calcula a quantidade de variação para todos os valores na região de resumo especificada (grupo, página ou relatório).

sumVar([UnitPrice])

sumVarP(Expression)

Calcula a variação populacional de todos os valores na região de resumo especificada (grupo, página ou relatório).

sumVarP([UnitPrice])

sumWAvg(Expression, Expression)

Calcula a média ponderada de todos os valores na região de resumo especificada (grupo, página ou relatório). Este tipo de resumo retorna o resultado da seguinte operação: Sum(Expression1 * Expression2) / Sum(Expression2).

sumWAvg([UnitPrice])