Restituisce un valore Variant (Date) contenente una data a cui è stato aggiunto un intervallo di tempo specificato.
Sintassi
DateAdd(intervallo; numero; data)
Gli argomenti della sintassi della funzione DateAdd sono i seguenti:
| Argomento | Descrizione |
|---|---|
| intervallo | Obbligatorio. Espressione stringa che rappresenta l'intervallo di tempo da aggiungere. |
| Numero | Obbligatorio. Espressione numerica che rappresenta il numero di intervalli da aggiungere. Può essere positivo (per ottenere date future) o negativo (per ottenere date passate). |
| Data | Obbligatorio. Valore Variant (Date) o valore letterale che rappresenta la data a cui viene aggiunto l'intervallo. |
Impostazioni
L'argomento intervalloha queste impostazioni:
| Impostazione | Descrizione |
|---|---|
| yyyy | Anno |
| q | Trimestre |
| m | Mese |
| y | Giorno dell'anno |
| d | Giorno |
| w | Giorno della settimana |
| ww | Settimana |
| h | Ora |
| n | Minuto |
| s | Secondo |
Osservazioni
È possibile usare la funzione DateAdd 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 alla data, è possibile usare Day of Year ("y"), Day ("d") o Weekday ("w").
La funzione DateAdd 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 data è 31-gen-96, restituisce 29-feb-96 perché 1996 è un anno bisestile.
Se la data calcolata precede l'anno 100, ovvero si sottrae più anni rispetto alla data corrente, si verifica un errore.
Se num non è un valore Long, viene arrotondato al numero intero più vicino prima di essere valutato.
Nota
Il formato del valore restituito per DateAdd è determinato dalle impostazioni di Pannello di controllo e non dal formato passato nell'argomento data.
Nota
Per data, se l'impostazione della proprietà Calendar è gregoriano, la data fornita deve essere gregoriana. Se il calendario è Hijri, la data specificata deve essere basata sul calendario Hijri. Se i valori dei mesi sono nomi, il nome deve essere coerente con l'impostazione della proprietà Calendar corrente. Per ridurre al minimo la possibilità che i nomi dei mesi entrino in conflitto con l'impostazione della proprietà Calendar corrente, immettere valori numerici per i mesi (formato Data breve).
Esempi di query
| Espressione | Risultati |
|---|---|
| SELECT DateAdd("AAAA",1,[DateofSale]) AS Espr1 FROM VenditeProdotto; | Restituisce i risultati aggiungendo 1 anno ai valori di data del campo "DateofSale". |
| SELECT DateAdd("AAAA",-1,[DateofSale]) AS Espr1 FROM VenditeProdotto; | Restituisce i risultati sottraendo 1 anno dai valori di data del campo "DateofSale". |
| SELECT DateAdd("d",10,[DateofSale]) AS NewDate FROM ProductSales; | Restituisce i risultati nella colonna "NewDate" aggiungendo 10 giorni ai valori di data del campo "DateofSale". |
| SELECT DateAdd("ww",-1,[DateofSale]) AS NewDate FROM ProductSales; | Restituisce i risultati nella colonna "NewDate" sottraendo 1 settimana (7 giorni) dai valori di data del campo "DateofSale". |
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 funzione DateAdd per visualizzare una 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