Restituisce un oggetto Variant (Date) che contiene una data con un intervallo di tempo specificato aggiunto.
Sintassi
DateAdd(interval, number, date)
Gli DateAdd argomenti della funzione sono i seguenti:
| Argomento | Descrizione |
|---|---|
interval |
Obbligatorio. Espressione stringa che rappresenta l'intervallo di tempo che si desidera aggiungere. |
number |
Obbligatorio. Espressione numerica, ovvero il numero di intervalli che si desidera sommare. Può essere positivo ottenere date nel futuro o negativo ottenere date nel passato. |
date |
Obbligatorio. Variante (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 30 giorni da oggi o un'ora 45 minuti da oggi.
Per aggiungere giorni a date, è possibile usare Giorno dell'anno ("y"), Giorno ("d") o Giorno della settimana ("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 febbraio 95, non 31 febbraio 95. Se date è 31 gennaio 96, restituisce 29 febbraio 96 perché il 1996 è un anno bisestile.
Se la data calcolata precede l'anno 100, ossia è necessario sottrarre un numero di anni superiore a datequello in , 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 dalle impostazioni del Pannello di controllo, non dal formato passato nell'argomentodate.
Nota
Per date, se l'impostazione della Calendar proprietà è gregoriana, la data specificata 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 possibilità di conflitti, immettere i valori numerici del mese 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 DateofSale data nel campo. |
SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; |
Aggiunge 10 giorni ai valori di data nel DateofSale campo e restituisce i NewDate risultati nella 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 NewDate risultati nella 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 in Access.
In questo esempio viene accettata una data come input e viene usata 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