COleDateTime::SetDate

Article
03/04/2013

Définit la date de cet objet d' COleDateTime .

int SetDate(
   int nYear,
   int nMonth,
   int nDay 
) throw( );

Paramètres

nYear, nMonth, nDay
Indiquez les composants date à copier dans cet objet d' COleDateTime .

Valeur de retour

Zéro si la valeur de cet objet d' COleDateTime a été définie avec succès ; sinon, 1.Cette valeur de retour est basé sur le type énuméré par DateTimeStatus .Pour plus d'informations, consultez la fonction membre de SetStatus .

Notes

La date est définie aux valeurs spécifiées.L'heure est définie de chronométrer 0, minuit.

Consultez le tableau suivant pour les limites pour les valeurs de paramètre :

Paramètre	Limites
nYear	100 – 9999
nMonth	1 – 12
nDay	0 – 31

Si le jour du mois dépasse, il est converti au niveau correct du mois et le mois et/ou l'année est incrémenté en conséquence.Une valeur de jour de zéro indique le dernier jour du mois précédent.Le comportement est identique à SystemTimeToVariantTime.

Si la valeur de date spécifiée par les paramètres n'est pas valide, l'état de cet objet est défini à COleDateTime::invalid.Vous devez utiliser GetStatus pour vérifier la validité de la valeur de DATE et ne devez pas supposer que la valeur de m_dt reste non modifiée.

Voici quelques exemples des valeurs de date :

nYear	nMonth	nDay	Valeur
2000	2	29	29 février 2000
1776	7	4	4 juillet 1776
1925	4	35	En avril 1925 35 (date non valide)
10000	1	1	1er janvier 10000 (Date non valide)

Pour définir les deux date et d'heure, consultez COleDateTime::SetDateTime.

Pour plus d'informations sur les fonctions membres qui questionnent la valeur de cet objet d' COleDateTime , consultez les fonctions membres suivantes :

Pour plus d'informations sur les limites des valeurs d' COleDateTime , consultez l'article date et heure : Prise en charge d'automation.

Exemple

// set only the date, time set to midnight
dt.SetDate(1999, 3, 19);
ASSERT(dt.GetYear() == 1999);
ASSERT(dt.GetDay() == 19);
ASSERT(dt.GetMonth() == 3);
ASSERT(dt.GetHour() == 0);
ASSERT(dt.GetMinute() == 0);
ASSERT(dt.GetSecond() == 0);

// setting the time only resets the date to 1899!
dt.SetTime(22, 15, 0);
ASSERT(dt.GetYear() == 1899);
ASSERT(dt.GetDay() == 30);
ASSERT(dt.GetMonth() == 12);
ASSERT(dt.GetHour() == 22);
ASSERT(dt.GetMinute() == 15);
ASSERT(dt.GetSecond() == 0);