Share via


COleDateTime::COleDateTime

Constructs a COleDateTime object.

COleDateTime( ) throw( ); 
COleDateTime(
   const VARIANT& varSrc 
) throw( );
COleDateTime(
   DATE dtSrc 
) throw( );
COleDateTime(
   time_t timeSrc 
) throw( );
COleDateTime(
   __time64_t timeSrc 
) throw( );
COleDateTime(
   const SYSTEMTIME& systimeSrc 
) throw( );
COleDateTime(
   const FILETIME& filetimeSrc 
) throw( );
COleDateTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec 
) throw( );
COleDateTime(
   WORD wDosDate,
   WORD wDosTime 
) throw( );
COleDateTime(
   const DBTIMESTAMP& dbts
) throw();

Parameters

  • dateSrc
    An existing COleDateTime object to be copied into the new COleDateTime object.

  • varSrc
    An existing VARIANT data structure (possibly a COleVariant object) to be converted to a date/time value (VT_DATE) and copied into the new COleDateTime object.

  • dtSrc
    A date/time (DATE) value to be copied into the new COleDateTime object.

  • timeSrc
    A time_t or __time64_t value to be converted to a date/time value and copied into the new COleDateTime object.

  • systimeSrc
    A SYSTEMTIME structure to be converted to a date/time value and copied into the new COleDateTime object.

  • filetimeSrc
    A FILETIME structure to be converted to a date/time value and copied into the new COleDateTime object. Note that FILETIME uses Universal Coordinated Time (UTC), so if you pass a local time in the structure, your results will be incorrect. See File Times in the Windows SDK for more information.

  • nYear, nMonth, nDay, nHour, nMin, nSec
    Indicate the date and time values to be copied into the new COleDateTime object.

  • wDosDate, wDosTime
    MS-DOS date and time values to be converted to a date/time value and copied into the new COleDateTime object.

  • dbts
    A reference to a DBTimeStamp structure containing the current local time.

Remarks

All these constructors create new COleDateTime objects initialized to the specified value. The following table shows valid ranges for each date and time component:

Date/time component

Valid range

year

100 – 9999

month

0 – 12

day

0 – 31

hour

0 – 23

minute

0 – 59

second

0 – 59

Note that the actual upper bound for the day component varies based on the month and year components. For details, see the SetDate or SetDateTime member functions.

Following is a brief description of each constructor:

  • COleDateTime( )   Constructs a COleDateTime object initialized to 0 (midnight, 30 December 1899).

  • COleDateTime( dateSrc )   Constructs a COleDateTime object from an existing COleDateTime object.

  • COleDateTime( varSrc )   Constructs a COleDateTime object. Attempts to convert a VARIANT structure or COleVariant object to a date/time (VT_DATE) value. If this conversion is successful, the converted value is copied into the new COleDateTime object. If it is not, the value of the COleDateTime object is set to 0 (midnight, 30 December 1899) and its status to invalid.

  • COleDateTime( dtSrc )   Constructs a COleDateTime object from a DATE value.

  • COleDateTime( timeSrc )   Constructs a COleDateTime object from a time_t value.

  • COleDateTime( systimeSrc )   Constructs a COleDateTime object from a SYSTEMTIME value.

  • COleDateTime( filetimeSrc )   Constructs a COleDateTime object from a FILETIME value. . Note that FILETIME uses Universal Coordinated Time (UTC), so if you pass a local time in the structure, your results will be incorrect. See File Times in the Windows SDK for more information.

  • COleDateTime( nYear, nMonth, nDay, nHour, nMin, nSec )   Constructs a COleDateTime object from the specified numerical values.

  • COleDateTime( wDosDate, wDosTime )   Constructs a COleDateTime object from the specified MS-DOS date and time values.

For more information on the time_t data type, see the time function in the Run-Time Library Reference.

For more information, see the SYSTEMTIME and FILETIME structures in the Windows SDK.

For more information about the bounds for COleDateTime values, see the article Date and Time: Automation Support.

Note

The constructor using DBTIMESTAMP parameter is only available when OLEDB.h is included.

Example

time_t osBinaryTime;   // C run-time time (defined in <time.h>)
time(&osBinaryTime);   // Get the current time from the 
                     // operating system.

COleDateTime time1;   // initialized to 00:00am, 30 December 1899
                     // (and m_nStatus is valid!)

COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime);   // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

SYSTEMTIME sysTime;   // Win32 time information
GetSystemTime(&sysTime);

COleDateTime time5(sysTime);    

Requirements

Header: atlcomtime.h

See Also

Reference

COleDateTime Class

Hierarchy Chart

COleDateTime::SetDate

COleDateTime::SetDateTime

COleDateTime::SetTime

COleDateTime::GetStatus

COleDateTime::operator =

COleDateTime::m_dt

COleDateTime::m_status

Other Resources

COleDateTime Members