COleDateTime::SetDateTime
Legt das Datum und die Uhrzeit COleDateTime dieses Objekts fest.
int SetDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
Parameter
- nYear, nMonth, nDay, nHour, nMin, nSec
Geben Sie die in diesem Objekt an COleDateTime kopiert werden Datums- und Uhrzeitkomponenten.
Rückgabewert
Null wenn der Wert dieses COleDateTime-Objekts erfolgreich festgelegt wurde; andernfalls 1.Dieser Rückgabewert basiert auf dem DateTimeStatus Aufzählungstyp.Weitere Informationen finden Sie unter SetStatus die Memberfunktion.
Hinweise
Siehe die folgende Tabelle für Grenzen für Parameterwerte:
Parameter |
Begrenzungen |
|---|---|
nYear |
100 – 9999 |
nMonth |
1 – 12 |
nDay |
0 – 31 |
nHour |
0 – 23 |
nMin |
0 – 59 |
nSec |
0 – 59 |
Wenn der Tag des Monats überschritten, wird er dem richtigen Tag des Folgemonats konvertiert und Monat und/oder das Jahr wird entsprechend.Ein Tagswert Null gibt den letzten Tag des vorherigen Monats an.Das Verhalten entspricht SystemTimeToVariantTime.
Wenn das Datum oder der Zeitwert, die von der Parameter angegeben wird, ungültig ist, wird der Status dieses Objekts den Aufruf festgelegt und der Wert des Objekts wird nicht geändert.
Im Folgenden einige Beispiele für Zeitwerten:
nHour |
nMin |
nSec |
Wert |
|---|---|---|---|
1 |
3 |
3 |
01:03:03 |
23 |
45 |
0 |
23:45:00 |
25 |
30 |
0 |
Invalid |
9 |
60 |
0 |
Invalid |
Hier einige Beispiele von Datumswerten:
nYear |
nMonth |
nDay |
Wert |
|---|---|---|---|
1995 |
4 |
15 |
15. April 1995 |
1789 |
7 |
14 |
17. Juli 1789 |
1925 |
2 |
30 |
Invalid |
10000 |
1 |
1 |
Invalid |
Um nur das Datum festzulegen, finden Sie unter COleDateTime::SetDate.Um nur die Zeit festzulegen, finden Sie unter COleDateTime::SetTime.
Informationen zum Memberfunktionen, die den Wert dieses COleDateTime-Objekts abfragen, finden Sie in den Memberfunktionen:
Weitere Informationen über die Grenzen für COleDateTime-Werte, finden Sie im Artikel Datum und Uhrzeit: Automatisierungs-Unterstützung.
Beispiel
Im Beispiel für GetStatus.
Anforderungen
Header: atlcomtime.h