Devolve uma Variante (Data) contendo a data à qual foi adicionado um intervalo de tempo especifico.
Sintaxe
DateAdd ( intervalo, número, data )
A sintaxe da função DateAdd tem estes argumentos:
|
Argumento |
Descrição |
|---|---|
|
interval |
Obrigatório. Expressão de cadeia que é o intervalo de tempo que pretende adicionar. |
|
número |
Obrigatório. Expressão numérica que corresponde ao número de intervalos que pretende adicionar. Pode ser positivo (para obter datas no futuro) ou negativo (para obter datas no passado) |
|
data |
Obrigatório. Variante (Data) ou literal que representa a data à qual o intervalo é adicionado. |
Definições
O argumento intervalargumento tem as seguintes definições:
|
Definição |
Descrição |
|---|---|
|
aaaa |
Ano |
|
t |
Trimestre |
|
m |
Mês |
|
a |
Dia do ano |
|
d |
Dia |
|
s |
Dia útil |
|
ss |
Semana |
|
h |
Hora |
|
n |
Minuto |
|
s |
Segundo |
Observações
Pode utilizar a função DateAdd para adicionar ou subtrair um intervalo de tempo especificado de uma data. Por exemplo, pode utilizar DateAdd para calcular uma data de 30 dias a partir de hoje ou uma hora daqui a 45 minutos.
Para adicionar dias à data, pode utilizar o Dia do Ano ("y"), Dia ("d" ou Dia Da Semana ("w").
A função DateAdd não devolverá uma data inválida. O exemplo seguinte adiciona um mês a 31 de janeiro:
DateAdd("m", 1, "31-Jan-95")
Neste caso, DateAdd devolve 28-Fev-95, não 31-Fev-95. Se data for 31-Jan-96, devolve 29-Fev-96 porque 1996 é um ano bissexto.
Se a data calculada anteceder o ano 100 (ou seja, subtrair mais anos do que na data), ocorrerá um erro.
Se núm não for um valor Longo, é arredondado para o número inteiro mais próximo antes de ser avaliado.
Nota: O formato do valor devolvido para DateAdd é determinado pelas definições Painel de Controlo, não pelo formato transmitido no argumento de data.
Nota: Para date, se a definição da propriedade do Calendário for Gregoriano, a data fornecida tem de ser Gregoriana. Se o calendário for Hijri, a data fornecida tem de ser Hijri. Se os valores do mês forem nomes, o nome tem de ser consistente com a definição de propriedade Calendário atual. Para minimizar a possibilidade de nomes de mês entrarem em conflito com a definição de propriedade Calendário atual, introduza os valores de mês numéricos (formato de Data Abreviada).
Exemplos de consulta
|
Expressão |
Resultados |
|---|---|
|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Devolve os resultados ao adicionar 1 ano aos valores de data do campo "DateofSale". |
|
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Devolve os resultados ao subtrair 1 ano aos valores de data do campo "DateofSale". |
|
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Devolve os resultados na coluna "NewDate" ao adicionar 10 dias aos valores de data do campo "DateofSale". |
|
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Devolve os resultados na coluna "NewDate" ao subtrair 1 semana (7 dias) dos valores de data do campo "DateofSale". |
Exemplo de VBA
Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, veja Access VBA reference (Referência do VBA do Access).
Este exemplo utiliza uma data como entrada e utiliza a função DateAdd para apresentar uma data correspondente, um número especificado de meses no futuro.
Dim FirstDate As Date ' Declare variables.
Dim IntervalType As String
Dim Number As Integer
Dim Msg
IntervalType = "m" ' "m" specifies months as interval.
FirstDate = InputBox("Enter a date")
Number = InputBox("Enter number of months to add")
Msg = "New date: " & _
DateAdd(IntervalType, Number, FirstDate)
MsgBox Msg