Funzione DateAdd() - Documentazione VBScript
Descrizione
Restituisce una data a cui è stato aggiunto un intervallo di tempo specificato.Sintassi
DateAdd(intervallo, numero, data)
Parametri
- intervallo
-
(Obbligatorio) Espressione stringa che rappresenta il tipo di intervallo da aggiungere.
Vedi la sezione Impostazioni per ulteriori approfondimenti. - numero
-
(Obbligatorio) Espressione numerica che specifica la lunghezza dell'intervallo da aggiungere. Può avere valore positivo per aggiungere un periodo temporale e negativo per sottrarre un periodo temporale.
- data
-
(Obbligatorio) Espressione del sottotipo Date o riconducibile a tale formato alla quale verrà aggiunto il valore di intervallo specificato.
Impostazioni
Il parametro intervallo accetta le seguenti impostazioni:
| Valore | Descrizione |
|---|---|
| s | Secondi |
| n | Minuti |
| h | Ora |
| d | Giorno |
| y | Giorno dell'anno |
| w | Giorno della settimana |
| ww | Settimana dell'anno |
| m | Mese |
| q | Trimestre |
| yyyy | Anno |
Note
La funzione integra dei controlli sulla validità del formato della data risultante. Nel caso in cui, ad esempio, si aggiungano 6 giorni alla data 28 giugno, il valore risultante non sarà 34 giugno poichè non risulterebbe un formato data corretto, bensì 4 luglio, ovvero il giorno esattamente corrispondente sul calendario al periodo aggiunto alla data di partenza.
Uguale controllo verrà eseguito nel caso il periodo finale corrisponda ad un nuovo anno o nel caso in cui l'aggiunta di secondi, minuti, ore e giorni porti rispettivamente a minuti, ore, giorni e mesi successivi a quello in esame.
Nel caso si debbano eseguire incrementi o decrementi sulle date è bene fare uso della funzione DateAdd() per evitare spiacevoli inconvenienti di formati non validi.
La funzione è compatibile anche con gli anni bisestili.
