COleDateTime::SetDateTime

Article
06/09/2015

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 :