Funções de data e hora
A lista abaixo mostra as funções de data e hora que podem ser utilizadas em expressões.
| Função | Descrição |
|---|---|
| DateAdd(Arg1, Arg2, Arg3) | Adiciona um intervalo a Date, Time ou DateTime. O método pode adicionar um TimeSpan ou um Integer representando uma parte de data ou hora especificada (por exemplo, um número de dias). Se um TimeSpan for ser adicionado, dois argumentos serão necessários: uma coluna DateTime e uma coluna TimeSpan. Se um valor inteiro tiver que ser adicionado a uma parte de data ou hora, três argumentos serão usados:Arg1 é uma cadeia que descreve qual parte adicionar.Arg2 é um número que contém o número de partes a serem adicionadas.Arg3 é a coluna Date, Time ou DateTime. Os argumentos válidos para Arg1 são: 'year' ou 'yy' - O ano. 'quarter' ou 'qq' - O trimestre. 'month' ou 'mm' - O mês. 'day' ou 'dd' - O dia. 'week' ou 'wk' - A semana. 'hour' ou 'hh' - A hora. 'minute' ou 'mi' - O minuto. 'second' ou 'ss' - O segundo. 'millisecond' ou 'ms' - O milissegundo. Exemplos: DateAdd([Date Column], [TimeSpan Column]) DateAdd('year', 2, [Date Column]) DateAdd('month', 1, [Date Column]) |
| DateDiff(Arg1, Arg2, Arg3) | Calcula a diferença entre duas colunas Date,Time ouDateTime. O resultado é apresentado como TimeSpan ou como um valor real que representa uma parte do tempo especificada (por exemplo, a quantidade de dias). Se dois argumentos forem usados (uma coluna de data de início e uma coluna de data de interrupção), o resultado será um valor TimeSpan com a diferença total. Se três argumentos são utilizados, o primeiro argumento deve ser a parte para comparar. O segundo argumento é a coluna de data de início e o terceiro argumento é a coluna de data de término. O resultado da operação é um valor real. Os argumentos válidos para Arg1 são: 'year' ou 'yy' - O ano. 'quarter' ou 'qq' - O trimestre. 'month' ou 'mm' - O mês. 'day' ou 'dd' - O dia. 'week' ou 'wk' - A semana. 'hour' ou 'hh' - A hora. 'minute' ou 'mi' - O minuto. 'second' ou 'ss' - O segundo. 'millisecond' ou 'ms' - O milissegundo. Exemplo: DateDiff([Order Date], [Delivery Date]) DateDiff('day', [Order Date], [Delivery Date]) Para ver exemplos, consulte Cálculos de diferenças de tempo e Calculando períodos de tempo. |
| DatePart(Arg1, Arg2) | Retorna uma parte especificada de um Date, Time ou DateTime. Arg1 é uma sequência de caracteres que descreve qual parte da data obter, enquanto Arg2 é a coluna Date, Time ou DateTime. Os argumentos válidos para Arg1 são: 'year' ou 'yy' - O ano. 'quarter' ou 'qq' - O trimestre. 'month' ou 'mm' - O mês. 'day of year' ou 'dy' - O dia do ano. 'day' ou 'dd' - O dia. 'year and week' ou 'yywk' - O ano e a semana. 'week' ou 'wk' - A semana. 'day of week' ou 'dw' - O dia da semana. 'hour' ou 'hh' - A hora. 'minute' ou 'mi' - O minuto. 'second' ou 'ss' - O segundo. 'millisecond' ou 'ms' - O milissegundo. Exemplo: DatePart('year', [Date Column]) |
| DateTimeNow() | Retorna a hora atual do sistema. Exemplo: DateTimeNow() Para ver exemplos, consulte Cálculos de diferenças de tempo e Calculando períodos de tempo. |
| Day(Arg1) | Extrai o dia do mês de uma coluna Date ou DateTime. O resultado é um número inteiro entre 1 e 31. Exemplo: Day([Date Column]) |
| DayOfMonth(Arg1) | Extrai o dia do mês de uma coluna Date ou DateTime. O resultado é um número inteiro entre 1 e 31. Exemplo: DayOfMonth([Date Column]) |
| DayOfWeek(Arg1) | Extrai o dia da semana de uma coluna Date ou DateTime. Os dados subjacentes da nova coluna são um número inteiro entre 0 (domingo) e 6 (sábado), mas as configurações regionais determinam o início da semana, bem como a saída formatada. Exemplo: DayOfWeek([Date Column]) |
| DayOfYear(Arg1) | Extrai o dia do ano de uma coluna Date ou DateTime. Retorna um número inteiro entre 1 e 366. Exemplo: DayOfYear([Date Column]) |
| Days(Arg1) | Retorna o número de dias de um TimeSpan como um valor Integer entre -10675199 e 10675199; ou, se o argumento for um valor Integer, cria uma coluna TimeSpan em que a entrada é o número de dias. Exemplos: Days([TimeSpan Column]) Days(3) |
| FiscalMonth(Arg1, Arg2) | Retorna o mês de uma data. O primeiro argumento é a coluna Date. O segundo argumento (opcional) é o número de meses a mudar. Se nenhum segundo argumento for especificado, o valor da propriedade de documento FiscalYearOffset será usado. Configurações regionais determinam a saída formatada. Quando usado em hierarquias, o método FiscalMonth mantém o controle da ordem de classificação dos meses para que os itens de visualização sejam exibidos na ordem correta. Por exemplo, se o ano fiscal termina com janeiro, então o próximo ano fiscal deve iniciar com fevereiro como mostrado abaixo e não com janeiro: A hierarquia na imagem é construída usando a seguinte expressão: <FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)> Exemplos: FiscalMonth([Date Column], 1) FiscalMonth([Date Column]) |
| FiscalQuarter (Arg1, Arg2) | Retorna o trimestre fiscal de uma data (Arg1), com base em um turno especificado em meses (Arg2). O segundo argumento é opcional. Se nenhum segundo argumento for especificado, o valor da propriedade de documento FiscalYearOffset será usado. Exemplos: FiscalQuarter([Date Column], 1) FiscalQuarter([Date Column]) |
| FiscalYear (Arg1, Arg2) | Retorna o ano fiscal de uma data (Arg1), com base em um turno especificado em meses (Arg2). O segundo argumento é opcional. Se nenhum segundo argumento for especificado, o valor da propriedade de documento FiscalYearOffset será usado. Exemplos: FiscalYear([Date Column], 1) FiscalYear([Date Column]) |
| Hour(Arg1) | Extrai a hora de uma coluna DateTime ou Time. Retorna um número inteiro entre 0 e 23. Exemplo: Hour([Time Column]) |
| Hours(Arg1) |
Retorna o número de horas de um TimeSpan como um valor Integer entre 0 e 23; ou, se o argumento for um valor Integer, cria uma coluna TimeSpan em que a entrada é o número de horas. Exemplos: Hours([TimeSpan Column]) Hours(10) |
| Millisecond(Arg1) |
Extrai o milissegundo de uma coluna DateTime ou Time. Retorna um número inteiro entre 0 e 999. Exemplo: Millisecond([Time Column]) |
| Milliseconds(Arg1) |
Retorna a quantidade de milissegundos de um TimeSpan como um valor Real entre 0,0 e 999,0; ou, se o argumento for um valor Real, cria uma coluna TimeSpan em que a entrada é o número de milissegundos. Exemplos: Milliseconds([TimeSpan Column]) Milliseconds(123.45) |
| Minute(Arg1) | Extrai o minuto de uma coluna DateTime ou Time. Retorna um número inteiro entre 0 e 59. Exemplo: Minute([Time Column]) |
| Minutes(Arg1) |
Retorna a quantidade de minutos para um TimeSpan como um valor Integer entre 0 e 59; ou, se o argumento for um valor Integer, cria uma coluna TimeSpan em que a entrada é o número de minutos. Exemplos: Minutes([TimeSpan Column]) Minutes(50) |
| Month(Arg1) | Extrai o mês de uma coluna Date ou DateTime. Os dados subjacentes da nova coluna são um número inteiro entre 1 e 12, mas as configurações regionais determinam a saída formatada. Exemplo: Month([Date Column]) |
| Quarter(Arg1) | Extrai o trimestre de uma coluna Date ou DateTime. Os dados subjacentes da nova coluna são um número inteiro entre 1 e 4, mas as configurações regionais determinam a saída formatada. Exemplo: Quarter([Date Column]) |
| Second(Arg1) | Extrai o segundo de uma coluna DateTime ou Time. Retorna um número inteiro entre 0 e 59. Exemplo: Second([Time Column]) |
| Seconds(Arg1) | Retorna o número de segundos para um TimeSpan como um valor Integer entre 0 e 59; ou, se o argumento for um valor Integer, cria uma coluna TimeSpan em que a entrada é o número de segundos. Exemplos: Seconds([TimeSpan Column]) Seconds(10) |
| Today() | Retorna a data atual. Exemplo: Today() |
| TotalDays(Arg1) | Retorna a quantidade de dias de um TimeSpan como um valor real expresso em dias inteiros e dias fracionados. Exemplo: TotalDays([TimeSpan Column]) |
| TotalHours(Arg1) | Retorna a quantidade de horas de um TimeSpan como um valor real expresso em horas inteiras e horas fracionadas. Exemplo: TotalHours([TimeSpan Column]) |
| TotalMilliseconds(Arg1) | Retorna a quantidade de milissegundos de um TimeSpan como um valor real expresso em milissegundos inteiros e milissegundos fracionados. Exemplo: TotalMilliseconds([TimeSpan Column]) |
| TotalMinutes(Arg1) | Retorna a quantidade de minutos de um TimeSpan como um valor real expresso em minutos inteiros e minutos fracionados. Exemplo: TotalMinutes([TimeSpan Column]) |
| TotalSeconds() | Retorna a quantidade de segundos de um TimeSpan como um valor real expresso em segundos inteiros e segundos fracionados. Exemplo: TotalSeconds([TimeSpan Column]) |
| Week(Arg1) | Extrai a semana de uma coluna Date ou DateTime como um inteiro entre 1 e 54, no qual a primeira semana do ano depende das configurações regionais. Exemplo: Week([Date Column]) |
| Year(Arg1) | Extrai o ano de uma coluna Date ou DateTime. O resultado é do tipoInteger. Exemplo: Year([Date Column]) |
| YearAndWeek(Arg1) | Extrai o ano e a semana de uma coluna Date ou DateTime. Retorna um Integer (Ano*100 + Número da semana), por exemplo, a data 2005-10-13 retorna 200541. Exemplo: YearAndWeek([Date Column]) |
