Compartilhar via

  • Artigo

DATEADD (Construtor de Relatórios 1.0)

Retorna um tipo de campo datetime ou time resultante da adição do número especificado de unidades de intervalo de hora ao tipo de campo datetime ou time original. O resultado é o mesmo tipo de dados do campo datetime ou time inicial original.

Sintaxe

DATEADD(interval, units, datetime)

interval

Especifica as unidades (ano, trimestre, mês, dia, hora, minuto, segundo ou semana) usadas para calcular a adição de data ou hora.

units

Especifica o número de intervalos.

datetime

Especifica a data ou hora inicial à qual os intervalos são adicionados.

Comentários

  • Se a fórmula adicionar algumas unidades de intervalo de hora a uma hora de início, a unidade do intervalo só poderá ser HOUR, MINUTE ou SECOND.

  • Para exibir um valor datetime como um valor time é necessário formatar o campo para usar uma das seguintes cadeias de formato de datetime personalizadas na guia Número da caixa de diálogo Formatar: u, f ou s.

  • Os intervalos não diferenciam maiúsculas de minúsculas.

Os seguintes intervalos são válidos.

Intervalo

Resultado

YEAR

Retorna um datetime ou time que é o número de anos especificado a partir do datetime ou time.

QUARTER

Retorna um datetime ou time que é o número de trimestres especificado a partir do datetime ou time.

MONTH

Retorna um datetime ou time que é o número de meses especificado a partir do datetime ou time.

WEEK

Retorna um datetime ou time que é o número de semanas especificado a partir do datetime ou time.

DAY

Retorna um datetime ou time que é o número de dias especificado a partir do datetime ou time.

HOUR

Retorna um datetime ou time que é o número de horas especificado a partir do datetime ou time.

MINUTE

Retorna um datetime ou time que é o número de minutos especificado a partir do datetime ou time.

SECOND

Retorna um datetime ou time que é o número de segundos especificado a partir do datetime ou time.

Exemplo

Fórmula

Resultado

DATEADD(MONTH, 3, #8/18/2009#)

11/18/2009

DATEADD(HOUR, 3, DtId)

Retorna um valor time para cada instância do campo DtId. Por exemplo, se a hora original for 07:00:01 AM, o resultado será 10:00:01 AM.

DATEADD(DAY, 365, Sell End Date)

Retorna uma data de conclusão da venda para cada instância, que é de 365 dias contados a partir da data de conclusão da venda original. Por exemplo, se a data de conclusão da venda original for 18/12/2009, o resultado será 18/12/2010.