COleDateTime::SetDate

Artikel
02/26/2013

Legt das Datum COleDateTime dieses Objekts fest.

int SetDate(
   int nYear,
   int nMonth,
   int nDay 
) throw( );

Parameter

nYear, nMonth, nDay
Geben Sie die in diesem Objekt an COleDateTime kopiert werden Datumskomponenten.

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

Das Datum wird auf die angegebenen Werte festgelegt.Die Zeit wird, Zeit 0, Mitternacht bewerten festgelegt.

Siehe die folgende Tabelle für Grenzen für Parameterwerte:

Parameter	Begrenzungen
nYear	100 – 9999
nMonth	1 – 12
nDay	0 – 31

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 der Datumswert, der von der Parameter angegeben wird, ungültig ist, wird der Status dieses Objekts auf COleDateTime::invalid festgelegt.Sie sollten GetStatus verwenden, um die Gültigkeit des DATE-Werts zu überprüfen und sollten nicht davon ausgehen, dass der Wert von m_dt unverändert.

Hier einige Beispiele von Datumswerten:

nYear	nMonth	nDay	Wert
2000	2	29	29. Februar 2000
1776	7	4	4. Juli 1776
1925	4	35	35 im April 1925 (ungültiges Datum)
10000	1	1	10000 1. Januar (ungültiges Datum)

Um Datum und Zeit festzulegen, finden Sie unter COleDateTime::SetDateTime.

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

// set only the date, time set to midnight
dt.SetDate(1999, 3, 19);
ASSERT(dt.GetYear() == 1999);
ASSERT(dt.GetDay() == 19);
ASSERT(dt.GetMonth() == 3);
ASSERT(dt.GetHour() == 0);
ASSERT(dt.GetMinute() == 0);
ASSERT(dt.GetSecond() == 0);

// setting the time only resets the date to 1899!
dt.SetTime(22, 15, 0);
ASSERT(dt.GetYear() == 1899);
ASSERT(dt.GetDay() == 30);
ASSERT(dt.GetMonth() == 12);
ASSERT(dt.GetHour() == 22);
ASSERT(dt.GetMinute() == 15);
ASSERT(dt.GetSecond() == 0);