COleDateTime::GetStatus

DateTimeStatus GetStatus( ) const;

Return Value

Returns the status of this COleDateTime value.

Remarks

Call this member function to get the status (validity) of a given COleDateTime object.

The return value is defined by the DateTimeStatus enumerated type, which is defined within the COleDateTime class.

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

For a brief description of these status values, see the following list:

• COleDateTime::valid   Indicates that this COleDateTime object is valid.
  
  
• COleDateTime::invalid   Indicates that this COleDateTime object is invalid; that is, its value may be incorrect.
  
  
• COleDateTime::null   Indicates that this COleDateTime object is null, that is, that no value has been supplied for this object. (This is “null” in the database sense of “having no value,” as opposed to the C++ NULL.)

The status of a COleDateTime object is invalid in the following cases:

• If its value is set from a VARIANT or COleVariant value that could not be converted to a date/time value.
  
  
• If its value is set from a time_t, SYSTEMTIME, or FILETIME value that could not be converted to a valid date/time value.
  
  
• If its value is set by SetDateTime with invalid parameter values.
  
  
• If this object has experienced an overflow or underflow during an arithmetic assignment operation, namely, += or -=.
  
  
• If an invalid value was assigned to this object.
  
  
• If the status of this object was explicitly set to invalid using SetStatus.

For more information about the operations that may set the status to invalid, see the following member functions:

• COleDateTime
  
  
• SetDateTime
  
  
• operator +, -
  
  
• operator +=, -=

For more information about the bounds for COleDateTime values, see the article Date and Time: Automation Support in Visual C++ Programmer’s Guide.

COleDateTime Overview |  Class Members |  Hierarchy Chart

See Also   COleDateTime::SetStatus, COleDateTime::m_status