UDF > Date >


_DateAdd

Calcule une nouvelle date/heure en ajoutant/soustrayant un nombre d'intervalles de temps sp�cifi� � partir d'une date/heure initiale

#include <Date.au3>
_DateAdd ( $sType, $iNumber, $sDate )

Param�tres

$sType Intervalle de temps � utiliser:
D - Ajoute/soustrait des jours � la date sp�cifi�e
M - Ajoute/soustrait des mois � la date sp�cifi�e
Y - Ajoute/soustrait des ann�es � la date sp�cifi�e
w - Ajoute/soustrait des semaines � la date sp�cifi�e
h - Ajoute/soustrait des heures � la date sp�cifi�e
n - Ajoute/soustrait des minutes � la date sp�cifi�e
s - Ajoute/soustrait des secondes � la date sp�cifi�e
$iNumber Nombre d'intervalles qui doit �tre ajout�s/soustraits (utilisez le moins unaire pour la soustraction)
$sDate Date initiale au format AAAA/MM/JJ[ HH:MM:SS]

Valeur de retour

Succ�s: Retourne la date calcul�e.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 1 - $sType non valide
2 - $iNumber non valide
3 - $sDate non valide

Remarques

La date initiale valide doit �tre comprise entre "2000/01/01 00:00:00" et "3000/12/31 23:59:59".

La fonction ne retournera pas une date invalide. Par exemple, si 3 mois sont ajout�s � "2004/1/31" alors le r�sultat sera "2004/04/30".

Voir _DateTimeSplit() pour d'autres variations possibles du format de la date d'entr�e.

En relation

_DateDiff, _DateTimeSplit, _DateToDayOfWeek, _DateToDayOfWeekISO, _DateToDayValue, _DayValueToDate

Exemple

#include <Date.au3>
#include <MsgBoxConstants.au3>

; Ajoute 5 jours � aujourd'hui
Local $sNewDate = _DateAdd('d', 5, _NowCalcDate())
MsgBox($MB_SYSTEMMODAL, "", "Aujourd'hui + 5 jours :" & $sNewDate)

; Soustrait 2 semaines � partir d'aujourd'hui
$sNewDate = _DateAdd('w', -2, _NowCalcDate())
MsgBox($MB_SYSTEMMODAL, "", "Aujourd'hui moins 2 semaines : " & $sNewDate)

; Ajoute 15 minutes � l'heure actuelle
$sNewDate = _DateAdd('n', 15, _NowCalc())
MsgBox($MB_SYSTEMMODAL, "", "Heure actuelle + 15 minutes : " & $sNewDate)

; Date calcul�e d'un journal d'�v�nements qui retourne les secondes depuis 1970/01/01 00:00:00
$sNewDate = _DateAdd('s', 1087497645, "1970/01/01 00:00:00")
MsgBox($MB_SYSTEMMODAL, "", "Date : " & $sNewDate)