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