COleDateTime::SetDateTime

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

Valeur de retour

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

Paramètres

nYear, nMonth, nDay, nHour, nMin nSec

Indiquer les éléments de date et d'heure à copier dans cet objet COleDateTime.

Remarques

Appelez cette fonction membre pour définir la date et l'heure de cet objet COleDateTime.

Reportez-vous au tableau suivant pour les limites des valeurs de paramètre:

Paramètre Limites
nYear 100-9999
nMonth 1 – 12
nDay 1 – 31
nHour 0 – 23
nMin 0 – 59
nSec 0 – 59

La limite supérieure réelle de valeurs nDay varie selon le mois et l'année. Pour le mois 1, 3, 5, 7, 8, 10 et 12, la limite supérieure est de 31. Mois 4, 6, 9 et 11, c'est 30. Pendant 2 mois, c'est 28 ou 29 dans une année bissextile.

Si la valeur de date ou d'heure spécifiée par les paramètres n'est pas valide, que le statut de cet objet a la valeur non valide et la valeur de cet objet n'est pas modifiée.

Voici quelques exemples de valeurs d'heure:

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

Voici quelques exemples de valeurs de date:

nYear nMonth nDay Valeur
1995 4 15 15 Avril 1995
1789 7 14 17 Juillet 1789
1925 2 30 Non valide
10000 1 1 Non valide

Pour définir la date uniquement, voir COleDateTime::SetDate. Pour définir le temps seulement, voir COleDateTime::SetTime.

Pour plus d'informations sur les fonctions de membre, cette requête, la valeur de cet objet COleDateTime , consultez les fonctions membres suivants:

Pour plus d'informations sur les limites des valeurs COleDateTime , consultez l'article Date et heure : prise en charge Automation dans le Guide du programmeur Visual C++.

Aperçu COleDateTime |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;COleDateTime::COleDateTime, COleDateTime::SetDate, COleDateTime::SetTime, COleDateTime::operator =, COleDateTime::GetStatus, COleDateTime::m_dt

Index