COleDateTime::SetDateTime

Article
03/04/2013

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

int SetDateTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec 
) throw( );

Paramètres

nYear, nMonth, nDay, nHour, nMin, nSec
Indiquez les composants de date et d'heure à 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

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
nHour	0 – 23
nMin	0 – 59
nSec	0 – 59

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 date ou la durée spécifiée par les paramètres n'est pas valide, l'état de cet objet a pour valeur non valide et la valeur de cet objet n'est pas modifiée.

Voici quelques exemples des valeurs d'heure :

nHour	nMin	nSec	Valeur
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	Invalid
9	60	0	Invalid

Voici quelques exemples des valeurs de date :

nYear	nMonth	nDay	Valeur
1995	4	15	15 avril 1995
1789	7	14	17 juillet 1789
1925	2	30	Invalid
10000	1	1	Invalid

Pour définir la date uniquement, consultez COleDateTime::SetDate.Pour définir l'heure uniquement, consultez COleDateTime::SetTime.

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