COleDateTimeSpan-Klasse

  • Artikel

Stellt eine relative Zeit, eine Zeitspanne dar.

Syntax

class COleDateTimeSpan

Member

Öffentliche Konstruktoren

Name Beschreibung
COleDateTimeSpan::COleDateTimeSpan Erstellt ein COleDateTimeSpan-Objekt.

Öffentliche Methoden

Name Beschreibung
COleDateTimeSpan::Format Generiert eine formatierte Zeichenfolgendarstellung eines COleDateTimeSpan Objekts.
COleDateTimeSpan::GetDays Gibt den Tagesteil des Bereichs zurück, den dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetHours Gibt den Stundenteil des Bereichs zurück, den dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetMinutes Gibt den Minutenbereich des Bereichs zurück, den dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetSeconds Gibt den zweiten Teil des Bereichs zurück, den dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetStatus Ruft den Status (Gültigkeit) dieses COleDateTimeSpan Objekts ab.
COleDateTimeSpan::GetTotalDays Gibt die Anzahl der Tage zurück, die dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetTotalHours Gibt die Anzahl der Stunden zurück, die dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetTotalMinutes Gibt die Anzahl der Minuten zurück, die dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::GetTotalSeconds Gibt die Anzahl der Sekunden zurück, die dieses COleDateTimeSpan Objekt darstellt.
COleDateTimeSpan::SetDateTimeSpan Legt den Wert dieses COleDateTimeSpan Objekts fest.
COleDateTimeSpan::SetStatus Legt den Status (Gültigkeit) dieses COleDateTimeSpan Objekts fest.

Öffentliche Operatoren

Name Beschreibung
operator +, - Addieren, Subtrahieren und Ändern des Vorzeichens für COleDateTimeSpan Werte.
operator +=, -= Addieren und subtrahieren Sie einen COleDateTimeSpan Wert von diesem COleDateTimeSpan Wert.
operator = Kopiert einen COleDateTimeSpan Wert.
Operator ==, <, <= Vergleichen Sie zwei COleDateTimeSpan Werte.
Operator double Wandelt diesen COleDateTimeSpan Wert in ein double.

Öffentliche Datenmember

Name Beschreibung
COleDateTimeSpan::m_span Enthält den zugrunde liegenden double Wert für dieses COleDateTimeSpan Objekt.
COleDateTimeSpan::m_status Enthält den Status dieses COleDateTimeSpan Objekts.

Hinweise

COleDateTimeSpan besitzt keine Basisklasse.

Eine COleDateTimeSpan Hält Zeit in Tagen.

COleDateTimeSpan wird mit der Begleitklasse COleDateTime verwendet. COleDateTime Kapselt den DATE Datentyp der OLE-Automatisierung. COleDateTime stellt absolute Zeitwerte dar. Alle COleDateTime Berechnungen umfassen COleDateTimeSpan Werte. Die Beziehung zwischen diesen Klassen entspricht dem verhältnis zwischen CTime und CTimeSpan.

Weitere Informationen zu den COleDateTime Und COleDateTimeSpan Klassen finden Sie im Artikel "Datum und Uhrzeit: Automatisierungsunterstützung".

Anforderungen

Header: ATLComTime.h

Relationale COleDateTimeSpan-Operatoren

Vergleichsoperatoren.

bool operator==(const COleDateTimeSpan& dateSpan) const throw();
bool operator!=(const COleDateTimeSpan& dateSpan) const throw();
bool operator<(const COleDateTimeSpan& dateSpan) const throw();
bool operator>(const COleDateTimeSpan& dateSpan) const throw();
bool operator<=(const COleDateTimeSpan& dateSpan) const throw();
bool operator>=(const COleDateTimeSpan& dateSpan) const throw();

Parameter

dateSpan
Das zu vergleichende COleDateTimeSpan-Element.

Rückgabewert

Diese Operatoren vergleichen zwei Datums-/Uhrzeitspannwerte und geben WAHR zurück, wenn die Bedingung wahr ist; andernfalls FALSE.

Hinweise

Hinweis

Wenn ein Operand ungültig ist, tritt ein ATLASSERT auf.

Beispiel

COleDateTimeSpan spanOne(3, 12, 0, 0); // 3 days and 12 hours
COleDateTimeSpan spanTwo(spanOne);     // 3 days and 12 hours
BOOL b;
b = spanOne == spanTwo;                // TRUE
b = spanOne < spanTwo;                 // FALSE, same value
b = spanOne > spanTwo;                 // FALSE, same value
b = spanOne <= spanTwo;                // TRUE, same value
b = spanOne >= spanTwo;                // TRUE, same value   

spanTwo.SetStatus(COleDateTimeSpan::invalid);
b = spanOne == spanTwo;                // FALSE, different status
b = spanOne != spanTwo;                // TRUE, different status

 

COleDateTimeSpan ts1(100.0);   // one hundred days
COleDateTimeSpan ts2(110.0);   // ten more days

ASSERT((ts1 != ts2) && (ts1 < ts2) && (ts1 <= ts2));

COleDateTimeSpan::COleDateTimeSpan

Erstellt ein COleDateTimeSpan-Objekt.

COleDateTimeSpan() throw();
COleDateTimeSpan(double dblSpanSrc) throw();
COleDateTimeSpan(LONG lDays, int nHours, int nMins, int nSecs) throw();

Parameter

dblSpanSrc
Die Anzahl der Tage, die in das neue COleDateTimeSpan Objekt kopiert werden sollen.

lDays, nHours, nMins, nSecs
Geben Sie die Tages- und Uhrzeitwerte an, die in das neue COleDateTimeSpan Objekt kopiert werden sollen.

Hinweise

Alle diese Konstruktoren erstellen neue COleDateTimeSpan Objekte, die mit dem angegebenen Wert initialisiert werden. Eine kurze Beschreibung der einzelnen Konstruktoren folgt:

  • COleDateTimeSpan( ) Erstellt ein Objekt, das COleDateTimeSpan auf 0 initialisiert wurde.

  • COleDateTimeSpan( dblSpanSrc ) Erstellt ein COleDateTimeSpan Objekt aus einem Gleitkommawert.

  • COleDateTimeSpan( lDays, , nHours, nMins nSecs , ) Erstellt ein COleDateTimeSpan Objekt, das für die angegebenen numerischen Werte initialisiert wurde.

Der Status des neuen COleDateTimeSpan Objekts ist auf "gültig" festgelegt.

Weitere Informationen zu den Grenzen für COleDateTimeSpan Werte finden Sie im Artikel "Datum und Uhrzeit: Automatisierungsunterstützung".

Beispiel

COleDateTimeSpan spanOne(2.75);          // 2 days and 18 hours
COleDateTimeSpan spanTwo(2, 18, 0, 0);   // 2 days and 18 hours
COleDateTimeSpan spanThree(3, -6, 0, 0); // 2 days and 18 hours

COleDateTimeSpan ts1;               // Uninitialized time value
COleDateTimeSpan ts2a(ts1);         // Copy constructor
COleDateTimeSpan ts2b = ts1;         // Copy constructor again
COleDateTimeSpan ts3(100.0);          // 100 days
COleDateTimeSpan ts4(0, 1, 5, 12);   // 1 hour, 5 minutes, and 12 seconds

COleDateTimeSpan::Format

Generiert eine formatierte Zeichenfolgendarstellung eines COleDateTimeSpan Objekts.

CString Format(LPCTSTR pFormat) const;
CString Format(UINT nID) const;

Parameter

pFormat
Eine Formatierungszeichenfolge ähnlich der Formatierungszeichenfolge printf . Formatierungscodes, denen ein Prozentzeichen (%) vorangestellt ist, werden durch die entsprechende COleDateTimeSpan Komponente ersetzt. Andere Zeichen in der Formatierungszeichenfolge werden unverändert in die zurückgegebene Zeichenfolge kopiert. Der Wert und die Bedeutung der Formatierungscodes Format sind unten aufgeführt:

  • %H Stunden am aktuellen Tag

  • %M Minuten in der aktuellen Stunde

  • %S Sekunden in der aktuellen Minute

  • %% Prozentzeichen

Die oben aufgeführten vier Formatcodes sind die einzigen Codes, die Format akzeptiert.

-

Nid
Die Ressourcen-ID für die Formatsteuerelementzeichenfolge.

Rückgabewert

Ein CString Wert, der den formatierten Datums-/Zeitbereichswert enthält.

Hinweise

Rufen Sie diese Funktionen auf, um eine formatierte Darstellung des Zeitspannwerts zu erstellen. Wenn der Status dieses COleDateTimeSpan Objekts null ist, ist der Rückgabewert eine leere Zeichenfolge. Wenn der Status ungültig ist, wird die Rückgabezeichenfolge von der Zeichenfolgenressource IDS_INVALID_DATETIMESPAN angegeben.

Eine kurze Beschreibung der Formulare für diese Funktion folgt:

Format( pFormat )
Dieses Formular formatiert den Wert mithilfe der Formatzeichenfolge, die spezielle Formatierungscodes enthält, die einem Prozentzeichen (%) vorangestellt sind, wie in printf. Die Formatierungszeichenfolge wird als Parameter an die Funktion übergeben.

Format( nID )
Dieses Formular formatiert den Wert mithilfe der Formatzeichenfolge, die spezielle Formatierungscodes enthält, die einem Prozentzeichen (%) vorangestellt sind, wie in printf. Die Formatierungszeichenfolge ist eine Ressource. Die ID dieser Zeichenfolgenressource wird als Parameter übergeben.

Beispiel

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);

COleDateTimeSpan::GetDays

Ruft den Tagesteil dieses Datums-/Zeitbereichswerts ab.

LONG GetDays() const throw();

Rückgabewert

Der Tagesteil dieses Datums-/Zeitspannwerts.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich liegen zwischen ungefähr - 3.615.000 und 3.615.000.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetDays() == 3);

COleDateTimeSpan::GetHours

Ruft den Stundenteil dieses Datums-/Zeitspannewerts ab.

LONG GetHours() const throw();

Rückgabewert

Der Stundenanteil dieses Datums-/Zeitbereichswerts.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen - 23 und 23.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetHours() == 1);

COleDateTimeSpan::GetMinutes

Ruft den Minutenteil dieses Datums-/Zeitbereichswerts ab.

LONG GetMinutes() const throw();

Rückgabewert

Der Minutenbereich dieses Datums-/Zeitspannwerts.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen - 59 und 59.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetMinutes() == 5);

COleDateTimeSpan::GetSeconds

Ruft den zweiten Teil dieses Datums-/Zeitbereichswerts ab.

LONG GetSeconds() const throw();

Rückgabewert

Der Sekundenteil dieses Datums-/Zeitspannewerts.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen - 59 und 59.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetSeconds() == 12);

COleDateTimeSpan::GetStatus

Ruft den Status (Gültigkeit) dieses COleDateTimeSpan Objekts ab.

DateTimeSpanStatus GetStatus() const throw();

Rückgabewert

Der Status dieses COleDateTimeSpan Werts.

Hinweise

Der Rückgabewert wird durch den DateTimeSpanStatus Aufzählungstyp definiert, der innerhalb der COleDateTimeSpan Klasse definiert ist.

enum DateTimeSpanStatus{
   valid = 0,
   invalid = 1,
   null = 2,
};

Eine kurze Beschreibung dieser Statuswerte finden Sie in der folgenden Liste:

  • COleDateTimeSpan::valid Gibt an, dass dieses COleDateTimeSpan Objekt gültig ist.

  • COleDateTimeSpan::invalid Gibt an, dass dieses COleDateTimeSpan Objekt ungültig ist. Das heißt, der Wert ist möglicherweise falsch.

  • COleDateTimeSpan::null Gibt an, dass dieses COleDateTimeSpan Objekt null ist, d. h., dass für dieses Objekt kein Wert angegeben wurde. (Dies ist "null" im Datenbankwert " ohne Wert" im Gegensatz zu C++ NULL.)

Der Status eines COleDateTimeSpan Objekts ist in den folgenden Fällen ungültig:

  • Wenn dieses Objekt während eines arithmetischen Zuordnungsvorgangs einen Überlauf oder Unterlauf erlebt hat, nämlich += oder -=.

  • Wenn diesem Objekt ein ungültiger Wert zugewiesen wurde.

  • Wenn der Status dieses Objekts explizit auf eine ungültige Verwendung SetStatusfestgelegt wurde.

Weitere Informationen zu den Vorgängen, die den Status möglicherweise auf ungültig festlegen können, finden Sie unter COleDateTimeSpan::operator +, - und COleDateTimeSpan::operator +=, -=.

Weitere Informationen zu den Grenzen für COleDateTimeSpan Werte finden Sie im Artikel "Datum und Uhrzeit: Automatisierungsunterstützung".

COleDateTimeSpan::GetTotalDays

Ruft diesen Datums-/Zeitbereichswert ab, der in Tagen ausgedrückt wird.

double GetTotalDays() const throw();

Rückgabewert

Dieser Datums-/Zeitbereichswert, der in Tagen ausgedrückt wird. Obwohl diese Funktion prototypiert ist, um ein Double zurückzugeben, wird immer ein ganzzahliger Wert zurückgegeben.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen ungefähr - 3,65e6 und 3,65e6.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

COleDateTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
ASSERT(ts.GetTotalDays() == 3);
ASSERT(ts.GetTotalHours() == 73);
ASSERT(ts.GetTotalMinutes() == 4385);
ASSERT(ts.GetTotalSeconds() == 263112);

COleDateTimeSpan::GetTotalHours

Ruft diesen in Stunden ausgedrückten Datums-/Zeitbereichswert ab.

double GetTotalHours() const throw();

Rückgabewert

Dieser Datums-/Zeitbereichswert, der in Stunden ausgedrückt wird. Obwohl diese Funktion prototypiert ist, um ein Double zurückzugeben, wird immer ein ganzzahliger Wert zurückgegeben.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen ungefähr - 8,77e7 und 8,77e7.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

Sehen Sie sich das Beispiel für GetTotalDays an.

COleDateTimeSpan::GetTotalMinutes

Ruft diesen Datums-/Zeitbereichswert in Minuten ab.

double GetTotalMinutes() const throw();

Rückgabewert

Dieser Datums-/Zeitbereichswert, der in Minuten ausgedrückt wird. Obwohl diese Funktion prototypiert ist, um ein Double zurückzugeben, wird immer ein ganzzahliger Wert zurückgegeben.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen ungefähr - 5,26e9 und 5,26e9.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

Sehen Sie sich das Beispiel für GetTotalDays an.

COleDateTimeSpan::GetTotalSeconds

Ruft diesen Datums-/Zeitbereichswert in Sekunden ab.

double GetTotalSeconds() const throw();

Rückgabewert

Dieser Datums-/Zeitspannewert, der in Sekunden ausgedrückt wird. Obwohl diese Funktion prototypiert ist, um ein Double zurückzugeben, wird immer ein ganzzahliger Wert zurückgegeben.

Hinweise

Die Rückgabewerte aus diesem Funktionsbereich zwischen ungefähr - 3,16e11 bis 3,16e11.

Weitere Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

Sehen Sie sich das Beispiel für GetTotalDays an.

COleDateTimeSpan::m_span

Der zugrunde liegende double Wert für dieses COleDateTime Objekt.

double m_span;

Hinweise

Dieser Wert gibt die Datums-/Zeitspanne in Tagen an.

Achtung

Wenn Sie den Wert im double Datenelement ändern, wird der Wert dieses COleDateTimeSpan Objekts geändert. Der Status dieses COleDateTimeSpan Objekts wird nicht geändert.

COleDateTimeSpan::m_status

Der Typ für dieses Datenelement ist der Aufzählungstyp DateTimeSpanStatus, der innerhalb der COleDateTimeSpan Klasse definiert ist.

DateTimeSpanStatus m_status;

Hinweise

enum DateTimeSpanStatus{
   valid = 0,
   invalid = 1,
   null = 2,
   };

Eine kurze Beschreibung dieser Statuswerte finden Sie in der folgenden Liste:

  • COleDateTimeSpan::valid Gibt an, dass dieses COleDateTimeSpan Objekt gültig ist.

  • COleDateTimeSpan::invalid Gibt an, dass dieses COleDateTimeSpan Objekt ungültig ist. Das heißt, der Wert ist möglicherweise falsch.

  • COleDateTimeSpan::null Gibt an, dass dieses COleDateTimeSpan Objekt null ist, d. h., dass für dieses Objekt kein Wert angegeben wurde. (Dies ist "null" im Datenbankwert " ohne Wert" im Gegensatz zu C++ NULL.)

Der Status eines COleDateTimeSpan Objekts ist in den folgenden Fällen ungültig:

  • Wenn dieses Objekt während eines arithmetischen Zuordnungsvorgangs einen Überlauf oder Unterlauf erlebt hat, nämlich += oder -=.

  • Wenn diesem Objekt ein ungültiger Wert zugewiesen wurde.

  • Wenn der Status dieses Objekts mithilfe von SetStatus explizit auf ungültig festgelegt wurde.

Weitere Informationen zu den Vorgängen, die den Status möglicherweise auf ungültig festlegen können, finden Sie unter COleDateTimeSpan::operator +, - und COleDateTimeSpan::operator +=, -=.

Achtung

Dieser Datenmemm ist für erweiterte Programmiersituationen vorgesehen. Sie sollten die Inlinememmfunktionen "GetStatus " und "SetStatus" verwenden. Weitere Vorsichtsmaßnahmen hinsichtlich der expliziten Festlegung dieses Datenelements finden Sie SetStatus in diesem Fall.

Weitere Informationen zu den Grenzen für COleDateTimeSpan Werte finden Sie im Artikel "Datum und Uhrzeit: Automatisierungsunterstützung".

COleDateTimeSpan::operator =

Kopiert einen COleDateTimeSpan Wert.

COleDateTimeSpan& operator=(double dblSpanSrc) throw();

Hinweise

Dieser überladene Zuordnungsoperator kopiert den Quellwert für Datum/Uhrzeit in dieses COleDateTimeSpan Objekt.

COleDateTimeSpan::operator +, -

Addieren, Subtrahieren und Ändern des Vorzeichens für COleDateTimeSpan Werte.

COleDateTimeSpan operator+(const COleDateTimeSpan& dateSpan) const throw();
COleDateTimeSpan operator-(const COleDateTimeSpan& dateSpan) const throw();
COleDateTimeSpan operator-() const throw();

Hinweise

Mit den ersten beiden Operatoren können Sie Datums-/Zeitspannwerte addieren und subtrahieren. Im dritten Können Sie das Vorzeichen eines Datums-/Zeitspannwerts ändern.

Wenn eine der Operanden null ist, ist der Status des resultierenden COleDateTimeSpan Werts null.

Wenn eine der Operanden ungültig ist und die andere ungültig ist, ist der Status des resultierenden COleDateTimeSpan Werts ungültig.

Weitere Informationen zu den gültigen, ungültigen und NULL-Statuswerten finden Sie in der m_status Membervariable.

Beispiel

COleDateTimeSpan ts1(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
COleDateTimeSpan ts2(100.0 / (24 * 3600.0)); // 100 seconds
COleDateTimeSpan ts3 = ts1 + ts2;
ASSERT(ts3.GetSeconds() == 52); // 6 mins, 52 secs

COleDateTimeSpan::operator +=, -=

Addieren und subtrahieren Sie einen COleDateTimeSpan Wert von diesem COleDateTimeSpan Wert.

COleDateTimeSpan& operator+=(const COleDateTimeSpan dateSpan) throw();
COleDateTimeSpan& operator-=(const COleDateTimeSpan dateSpan) throw();

Hinweise

Mit diesen Operatoren können Sie Datums-/Zeitspannewerte von diesem COleDateTimeSpan Objekt addieren und subtrahieren. Wenn eine der Operanden null ist, ist der Status des resultierenden COleDateTimeSpan Werts null.

Wenn eine der Operanden ungültig ist und die andere ungültig ist, ist der Status des resultierenden COleDateTimeSpan Werts ungültig.

Weitere Informationen zu den gültigen, ungültigen und NULL-Statuswerten finden Sie in der m_status Membervariable.

Beispiel

COleDateTimeSpan ts1(10.0); // 10 days
COleDateTimeSpan ts2(100.0); // 100 days
ts2 -= ts1;
ASSERT(ts2.GetTotalDays() == 90);

COleDateTimeSpan::operator double

Wandelt diesen COleDateTimeSpan Wert in ein double.

operator double() const throw();

Hinweise

Dieser Operator gibt den Wert dieses COleDateTimeSpan Werts als Gleitkommazahl von Tagen zurück.

COleDateTimeSpan::SetDateTimeSpan

Legt den Wert dieses Datums-/Zeitbereichswerts fest.

void SetDateTimeSpan(LONG lDays, int nHours, int nMins, int nSecs) throw();

Parameter

lDays, nHours, nMins, nSecs
Geben Sie die Datums- und Zeitspannewerte an, die in dieses COleDateTimeSpan Objekt kopiert werden sollen.

Hinweise

Funktionen, die den Wert eines COleDateTimeSpan Objekts abfragen, finden Sie in den folgenden Memberfunktionen:

Beispiel

COleDateTimeSpan spanOne;
COleDateTimeSpan spanTwo;
spanOne.SetDateTimeSpan(0, 2, 45, 0);  // 2 hours and 45 seconds
spanTwo.SetDateTimeSpan(0, 3, -15, 0); // 2 hours and 45 seconds

COleDateTimeSpan::SetStatus

Legt den Status (Gültigkeit) dieses COleDateTimeSpan Objekts fest.

void SetStatus(DateTimeSpanStatus status) throw();

Parameter

status
Der neue Statuswert für dieses COleDateTimeSpan Objekt.

Hinweise

Der Wert des Status-Parameters wird durch den DateTimeSpanStatus Aufzählungstyp definiert, der innerhalb der COleDateTimeSpan Klasse definiert ist.

enum DateTimeSpanStatus{
   valid = 0,
   invalid = 1,
   null = 2,
   };

Eine kurze Beschreibung dieser Statuswerte finden Sie in der folgenden Liste:

  • COleDateTimeSpan::valid Gibt an, dass dieses COleDateTimeSpan Objekt gültig ist.

  • COleDateTimeSpan::invalid Gibt an, dass dieses COleDateTimeSpan Objekt ungültig ist. Das heißt, der Wert ist möglicherweise falsch.

  • COleDateTimeSpan::null Gibt an, dass dieses COleDateTimeSpan Objekt null ist, d. h., dass für dieses Objekt kein Wert angegeben wurde. (Dies ist "null" im Datenbankwert " ohne Wert" im Gegensatz zu C++ NULL.)

    Achtung

    Diese Funktion richtet sich an erweiterte Programmiersituationen. Diese Funktion ändert die Daten in diesem Objekt nicht. Es wird am häufigsten verwendet, um den Status auf NULL oder ungültig festzulegen. Beachten Sie, dass der Zuordnungsoperator (Operator =) und SetDateTimeSpan den Status des Objekts basierend auf den Quellwerten festlegen.

Beispiel

// if the person is not still in school, set days to graduation to null
if (!m_bStillInSchool || m_dtDateOfGraduation.GetStatus() == COleDateTime::null)
   m_dtsDaysToGraduation.SetStatus(COleDateTimeSpan::null);

Siehe auch

COleDateTime-Klasse
CTime-Klasse
CTimeSpan-Klasse
Hierarchiediagramm
ATL/MFC Shared Classes