Restituisce un valore Variant (Date) che contiene una data con un intervallo di tempo specificato aggiunto.
Sintassi
DateAdd(interval, number, date)
La DateAdd funzione ha gli argomenti seguenti:
| Argomento | Descrizione |
|---|---|
interval |
Obbligatorio. Espressione stringa che rappresenta l'intervallo di tempo da aggiungere. |
number |
Obbligatorio. Espressione numerica che rappresenta il numero di intervalli da aggiungere. Può essere positivo ottenere date future o negative per ottenere date passate. |
date |
Obbligatorio. Variant (Date) o valore letterale che rappresenta la data a cui viene aggiunto l'intervallo. |
Impostazioni
L'argomento interval ha queste impostazioni:
| Impostazione | Descrizione |
|---|---|
yyyy |
Anno |
q |
Trimestre |
m |
Mese |
y |
Giorno dell'anno |
d |
Giorno |
w |
Weekday |
ww |
Settimana |
h |
Ora |
n |
Minuto |
s |
Secondo |
Osservazioni
È possibile usare la DateAdd funzione per aggiungere o sottrarre un intervallo di tempo specificato da una data. Ad esempio, è possibile usare DateAdd per calcolare una data di 30 giorni dalla data odierna o un'ora tra 45 minuti.
Per aggiungere giorni a date, è possibile usare Giorno dell'anno ("y"), Giorno ("d") o Giorno feriale ("w").
La DateAdd funzione non restituirà una data non valida. L'esempio seguente aggiunge un mese al 31 gennaio:
DateAdd("m", 1, "31-Jan-95")
In questo caso, DateAdd restituisce 28-feb-95, non 31-feb-95. Se date è 31-gen-96, restituisce 29-feb-96 perché 1996 è un anno bisestile.
Se la data calcolata precede l'anno 100, il che significa che si sottrae più dateanni rispetto a , si verifica un errore.
Se number non è un valore Long, Access lo arrotonda al numero intero più vicino prima di valutare l'espressione.
Nota
Il formato del valore restituito per DateAdd è determinato da Pannello di controllo impostazioni, non dal formato passato nell'argomentodate.
Nota
Per date, se l'impostazione della Calendar proprietà è Gregoriano, la data fornita deve essere gregoriana. Se il calendario è Hijri, la data specificata deve essere basata sul calendario Hijri. Se i valori del mese sono nomi, il nome deve corrispondere all'impostazione della proprietà corrente Calendar . Per ridurre la probabilità di conflitti, immettere i valori numerici dei mesi nel formato Data breve.
Esempi di query
| Espressione | Risultati |
|---|---|
SELECT DateAdd("YYYY",1,[DateofSale]) AS Expr1 FROM ProductSales; |
Aggiunge 1 anno ai valori di data nel DateofSale campo. |
SELECT DateAdd("YYYY",-1,[DateofSale]) AS Expr1 FROM ProductSales; |
Sottrae 1 anno dai valori di data nel DateofSale campo. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Aggiunge 10 giorni ai valori di data nel DateofSale campo e restituisce i risultati nella NewDate colonna. |
SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; |
Sottrae 1 settimana, o 7 giorni, dai valori di data nel DateofSale campo e restituisce i risultati nella NewDate colonna. |
Esempio di VBA
Nota
Gli esempi seguenti illustrano l'uso di questa funzione in un modulo di Visual Basic, Applications Edition (VBA). Per altre informazioni sull'uso di VBA, vedere Informazioni di riferimento su VBA per Access.
Questo esempio accetta una data come input e usa la DateAdd funzione per visualizzare la data corrispondente per un numero specificato di mesi nel 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