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 che si vuole aggiungere. |
|
num |
Obbligatorio. Espressione numerica che rappresenta il numero di intervalli che si desidera aggiungere. Può essere positivo (per ottenere date in futuro) o negativo (per ottenere le date in passato). |
|
date |
Obbligatorio. Variante (Data) o letterale che rappresenta la data in cui viene aggiunto l'intervallo. |
Suggerimento: In Access 2010, il Generatore di espressioni usa la tecnologia IntelliSense, che consente di identificare gli argomenti obbligatori nell'espressione.
Impostazioni
L'argomentointervallo ha 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
Puoi usare la funzione DateAdd per aggiungere o sottrarre un intervallo di tempo specificato da una data. Ad esempio, puoi usare DateAdd per calcolare una data di 30 giorni a partire da oggi o da un ora di 45 minuti.
Per aggiungere giorni alla Data, è possibile usare il giorno dell'anno ("y"), Day ("d") o giorno della settimana ("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 se si sottrae più anni rispetto alla Datacorrente, 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 del Pannello di controllo e non dal formato passato nell'argomento Data .
Nota: Per Data, se l'impostazione della proprietà Calendario è Gregoriana, la data specificata 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à Calendario corrente. Per ridurre al minimo la possibilità che i nomi dei mesi siano in conflitto con l'impostazione della proprietà Calendario corrente, immettere i valori numerici mensili (formato data breve).
Esempi di query
Espressione | Risultati |
|---|---|
|
Selezionare DateAdd ("aaaa", 1, [DateofSale]) come expr1 da ProductSales; |
Restituisce i risultati aggiungendo 1 anno ai valori di data del campo "DateofSale". |
|
Selezionare DateAdd ("aaaa",-1, [DateofSale]) come expr1 da ProductSales; |
Restituisce i risultati sottraendo 1 anno ai valori di data del campo "DateofSale". |
|
Selezionare DateAdd ("d", 10, [DateofSale]) come NewDate da ProductSales; |
Restituisce i risultati nella colonna "NewDate" aggiungendo 10 giorni ai valori di data del campo "DateofSale". |
|
Selezionare DateAdd ("ww",-1, [DateofSale]) come NewDate da 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, selezionare Riferimenti per sviluppatori nell'elenco a discesa accanto a Cerca e immettere uno o più termini nella casella di ricerca.
Questo esempio prende una data come input e usa la funzione DateAdd per visualizzare una data corrispondente in un numero specificato di mesi in 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
Nota: Questa pagina è stata tradotta automaticamente e potrebbe contenere errori di grammatica o imprecisioni. L'intento è quello di rendere fruibile il contenuto. Queste informazioni sono risultate utili' Questo è l'articolo in inglese per riferimento.
