CDateTimeCtrl Class

CDateTimeCtrl Class  :
Encapsulates the functionality of a date and time picker control.

class CDateTimeCtrl : public CWnd

The date and time picker control (DTP control) provides a simple interface to exchange date and time information with a user. This interface contains fields, each of which displays a part of the date and time information stored in the control. The user can change the information stored in the control by changing the content of the string in a given field. The user can move from field to field using the mouse or the keyboard.

You can customize the date and time picker control by applying a variety of styles to the object when you create it.

Header: afxdtctl.h

Base Class Members:

CObject Members
CCmdTarget Members
CWnd Members

Construction
CDateTimeCtrl

Constructs a CDateTimeCtrl object.

Create  : Creates the date and time picker control and attaches it to the CDateTimeCtrl object.

Attributes
GetMonthCalColor :  Retrieves the color for a given portion of the month calendar within the date and time picker control.

GetMonthCalCtrl :  Retrieves the date and time picker's child month calendar control.

GetMonthCalFont: Retrieves the font currently used by the date and time picker control's child month calendar control.

GetRange   :  Retrieves the current minimum and maximum allowable system times for a date and time picker control.

SetFormat :  Sets the display of a date and time picker control based on a given format string.

SetMonthCalColor :  Sets the color for a given portion of the month calendar within a date and time picker control.

SetMonthCalFont : Sets the font to be used by the date and time picker control's child month calendar control.

SetRange : Sets the minimum and maximum allowable system times for a date and time picker control.

Operations

GetTime : Retrieves the currently selected time from a date and time picker control and places it in a specified SYSTEMTIME structure.

SetTime : Sets the time in a date and time picker control.


CDateTimeCtrl::SetRange

Sets the minimum and maximum allowable system times for a date and time picker control.

Signatures:
BOOL SetRange( const COleDateTime* pMinRange,   const COleDateTime* pMaxRange );
BOOL SetRange( const CTime* pMinRange,  const CTime* pMaxRange );

Parameters

pMinRange :   A pointer to a COleDateTime object or a CTime object containing the earliest time allowed in the CDateTimeCtrl object.

pMaxRange : A pointer to a COleDateTime object or a CTime object containing the latest time allowed in the CDateTimeCtrl object.

Return Value
Nonzero if successful; otherwise 0.


CDateTimeCtrl::GetRange

Retrieves the current minimum and maximum allowable system times for a date and time picker control.

DWORD GetRange(COleDateTime* pMinRange, COleDateTime* pMaxRange ) const;
DWORD GetRange(  CTime* pMinRange,   CTime* pMaxRange ) const;

Parameters:
pMinRange : A pointer to a COleDateTime object or a CTime object containing the earliest time allowed in the CDateTimeCtrl object.

pMaxRange : A pointer to a COleDateTime object or a CTime object containing the latest time allowed in the CDateTimeCtrl object.

Return Value
A DWORD value containing flags that indicate which ranges are set.
 If  return value & GDTR_MAX == 0

then the second parameter is valid. Similarly, if
return value & GDTR_MIN == 0, then the first parameter is valid.

EXAMPLE
// This function will set several ranges in the control, then  call the ShowRange() function to show the set ranges to the  user.

void CDatesDlg::OnTestBTN()
{
// Gain a pointer to the control  CMonthCalCtrl* pCtrl = (CMonthCalCtrl*)  GetDlgItem //IDC_MONTHCALENDAR1);

CDateTimeCtrl* pCtrl = (CDateTimeCtrl*) GetDlgItem(IDC_DATETIMEPICKER1);
ASSERT(pCtrl != NULL);

// Set minimum of January 1st, 1995 with no maximum.
COleDateTime dtMin;
COleDateTime dtMax;

dtMin = COleDateTime(1995, 1, 1, 0, 0, 0);
dtMax.SetStatus(COleDateTime::null);
pCtrl->SetRange(&dtMin, &dtMax);
ShowRange(pCtrl);

// Set no minimum and maximum of September 30th, 1997.
dtMin.SetStatus(COleDateTime::null);
dtMax = COleDateTime(1997, 9, 30, 0, 0, 0);
pCtrl->SetRange(&dtMin, &dtMax);
ShowRange(pCtrl);

// Set minimum of April 15, 1992 and maximum of June 5, 2002.
dtMin = COleDateTime(1992, 4, 15, 0, 0, 0);
dtMax = COleDateTime(2002, 6, 5, 0, 0, 0);
pCtrl->SetRange(&dtMin, &dtMax);

ShowRange(pCtrl);
}

void CDatesDlg::ShowRange(CDateTimeCtrl* pCtrl)
{
   ASSERT(pCtrl != NULL);
   CString strMessage;
   COleDateTime dtMinimum;
   COleDateTime dtMaximum;

// Get the range.
WORD dwResult = pCtrl->GetRange(&dtMinimum, &dtMaximum);

// If a minimum was specified, format it. Otherwise, indicate that there is no lower bound.
if (dwResult & GDTR_MIN)
strMessage += dtMinimum.Format(_T("Minimum range is %x %X.\r\n"));

else
strMessage += _T("No minimum range.\r\n");

// Treat maximum similarly.
if (dwResult & GDTR_MAX)
strMessage += dtMaximum.Format(_T("Maximum range is %x %X.\r\n"));

else
strMessage += _T("No maximum range.\r\n");

// Show the user.
AfxMessageBox(strMessage);
}

Also read :
http://journeyallover.blogspot.com/2010/08/date-and-time-in-c.html