Partager via


COleDateTime::SetDateTime

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 :

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

Exemple

Consultez l'exemple pour GetStatus.

Configuration requise

Header: atlcomtime.h

Voir aussi

Référence

COleDateTime, classe

Graphique de la hiérarchie

COleDateTime::COleDateTime

COleDateTime::SetDate

COleDateTime::SetTime

COleDateTime::operator =

COleDateTime::GetStatus

COleDateTime::m_dt