apf.htm

VC 21天 学习VC 的好东西

	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTime(WORD wDosDate)</TD>
		<TD ALIGN="LEFT">Copies a date time from the MS-DOS-style values WORD and wDosTime</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTime(const SYSTEMTIME&amp; systimeSrc)</TD>
		<TD ALIGN="LEFT">Copies a date time from a SYSTEMTIME structure</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTime(const FILETIME&amp; filetimeSrc)</TD>
		<TD ALIGN="LEFT">Copies a date time from a FILETIME structure</TD>
	</TR>
</TABLE>
</P>
<P>If you've constructed COleDateTime with a valid date time, the object will be
marked with a valid status flag (COleDateTime::valid). Otherwise, the status flag
is invalid (COleDateTime::invalid). You can check this status by calling the GetStatus()
member function to return the relevant flag value, or you can force the flag value
by passing it into the SetStatus() function.</P>
<P>The status flag is also updated when you set date and time values to the object
by calling the SetDateTime() function. This function takes six integer parameters
for the year (100-9999), month (1-12), day of the month (1-31), hour (0-23), minute
(0-59), and second (0-59). You can also set just the date or time components by calling
SetDate()--passing just the year, month, and day of the month--or by calling SetTime()--passing
only the hour, minute, and second values.</P>
<P>You can use the GetCurrentTime() static function to retrieve the current system
time and set it to a COleDateTime object using the = operator overload function like
this:</P>
<P>
<PRE>COleDateTime dtCurrent;
dtCurrent = COleDateTime::GetCurrentTime();
</PRE>
<P>After running these lines, dtCurrent will be set to your machine's current system
date and time.</P>
<P>The same values (in the same ranges) can be retrieved by the return value of GetYear(),
GetMonth(), GetDay(), GetHour(), GetMinute(), or GetSecond(). There are also the
useful derivative functions: GetDayOfWeek() and GetDayOfYear(). GetDayOfWeek() returns
the day of the week in the range 1 to 7 where 1 is Sunday. The GetDayOfYear() function
returns a value in the range 1 to 366 starting at January 1.</P>
<P>You can retrieve a displayable formatted CString by using the Format() function.
This is probably one of the most useful COleDateTime functions because you can pass
several formatting codes to specify the exact format returned from Format(), as shown
in Table F.11. These codes are passed as either a string or a string resource identifier,
and several individual codes are strung together to add various aspects of the formatting.</P>
<P>These values are also modified by the current locale settings. The locale preferences
can affect things such as the names of days and months, the ordering of MM/DD/YY
representations, and the AM/PM indicators.</P>
<P>
<H4>TABLE F.11.&nbsp;FORMATTING CODES TO FORMAT THE COleDateTime TEXT OUTPUT.</H4>
<P>
<TABLE BORDER="1">
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT"><I>Code</I></TD>
		<TD ALIGN="LEFT"><I>Example</I></TD>
		<TD ALIGN="LEFT"><I>Description</I></TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%a</TD>
		<TD ALIGN="LEFT">Sat</TD>
		<TD ALIGN="LEFT">Abbreviated day of the week</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%A</TD>
		<TD ALIGN="LEFT">Saturday</TD>
		<TD ALIGN="LEFT">Day of the week</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%b</TD>
		<TD ALIGN="LEFT">Apr</TD>
		<TD ALIGN="LEFT">Abbreviated month</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%B</TD>
		<TD ALIGN="LEFT">April</TD>
		<TD ALIGN="LEFT">Month</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%c</TD>
		<TD ALIGN="LEFT">04/04/98 18:05:01</TD>
		<TD ALIGN="LEFT">Date and time in the current locale format</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%d</TD>
		<TD ALIGN="LEFT">04</TD>
		<TD ALIGN="LEFT">Day of the month (01-31)</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%H</TD>
		<TD ALIGN="LEFT">18</TD>
		<TD ALIGN="LEFT">Hour (00-23) 24 hour</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%I</TD>
		<TD ALIGN="LEFT">06</TD>
		<TD ALIGN="LEFT">Hour (01-12) 12 hour</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%j</TD>
		<TD ALIGN="LEFT">094</TD>
		<TD ALIGN="LEFT">Day of the year</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%m</TD>
		<TD ALIGN="LEFT">04</TD>
		<TD ALIGN="LEFT">Month (01-12)</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%M</TD>
		<TD ALIGN="LEFT">05</TD>
		<TD ALIGN="LEFT">Minute (01-59)</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%p</TD>
		<TD ALIGN="LEFT">PM</TD>
		<TD ALIGN="LEFT">AM/PM indicator for locale</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%S</TD>
		<TD ALIGN="LEFT">01</TD>
		<TD ALIGN="LEFT">Second (01-59)</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%U</TD>
		<TD ALIGN="LEFT">13</TD>
		<TD ALIGN="LEFT">Week of year (00-51) with Sunday as first day of week</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%w</TD>
		<TD ALIGN="LEFT">6</TD>
		<TD ALIGN="LEFT">Weekday (0-6) 0=Sunday</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%W</TD>
		<TD ALIGN="LEFT">13</TD>
		<TD ALIGN="LEFT">Week of year (00-51) with Monday as first day of week</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%x</TD>
		<TD ALIGN="LEFT">04/04/98</TD>
		<TD ALIGN="LEFT">Date in the current locale format</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%X</TD>
		<TD ALIGN="LEFT">18:05:01</TD>
		<TD ALIGN="LEFT">Time in the current locale format</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%y</TD>
		<TD ALIGN="LEFT">98</TD>
		<TD ALIGN="LEFT">Two-digit year (00-99)</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%Y</TD>
		<TD ALIGN="LEFT">1998</TD>
		<TD ALIGN="LEFT">Four-digit year (0100-9999)</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%z or %Z</TD>
		<TD ALIGN="LEFT">GMT Daylight Time</TD>
		<TD ALIGN="LEFT">Time zone name/abbreviation</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">% %</TD>
		<TD ALIGN="LEFT">%</TD>
		<TD ALIGN="LEFT">A percent sign</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%#c</TD>
		<TD ALIGN="LEFT">Saturday, April 04, 1998 18:05:01</TD>
		<TD ALIGN="LEFT">Current locale long date and time</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">%#x</TD>
		<TD ALIGN="LEFT">Saturday, April 04, 1998</TD>
		<TD ALIGN="LEFT">Current locale long date</TD>
	</TR>
</TABLE>
</P>
<P>You can use the following lines to generate a message box displaying your machine's
date and time like this:</P>
<P>
<PRE>COleDateTime dtCurrent;
dtCurrent = COleDateTime::GetCurrentTime();
AfxMessageBox(dtCurrent.Format(&quot;Today is %a %b %d, %Y&quot;));
</PRE>
<P>When run, the time will then be displayed in a message box in the following format:</P>
<P>
<PRE>Today is Sat Apr 04, 1998
</PRE>
<P>You can get COleDateTime to attempt to determine a date and time by calling ParseDateTime()
and passing a string for it to parse and a flag value to specify that only the date
or the time component is required. ParseDateTime() will then scan the string for
time in the format HH:MM:SS, and a date in the format DD/MM/YYYY, or in a long format
such as January 18th, 1998. If you only want to scan for the time, you can pass VAR_TIMEVALUEONLY
for the second parameter flag value, alternatively VAR_DATEVALUEONLY for just the
date. If you don't want the users' locale preferences to be used to indicate the
string format to check for, you can pass LOCALE_NOUSEROVERRIDE as this flag value.</P>
<P>There are also several operator overloads you can use to add and subtract COleDateTimeSpans
and to compare date and time values with other date and time values as shown in Table
F.12.</P>
<P>
<H4>TABLE F.12.&nbsp;OPERATOR OVERLOADS USED IN COleDateTime.</H4>
<P>
<TABLE BORDER="1">
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT"><I>Operator</I></TD>
		<TD ALIGN="LEFT"><I>Description</I></TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">=</TD>
		<TD ALIGN="LEFT">Copy a date/time value from another COleDateTime object, VARIANT structure, DATE
			structure, time_t structure, SYSTEMTIME structure, or FILETIME structure.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">+</TD>
		<TD ALIGN="LEFT">Add a COleDateTimeSpan value to a COleDateTime value.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">-</TD>
		<TD ALIGN="LEFT">Subtract a COleDateTimeSpan from a COleDateTime value or two COleDateTime objects
			from each other to yield a COleDateTimeSpan result.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">+=</TD>
		<TD ALIGN="LEFT">Add a COleDateTimeSpan value to the current COleDateTime object.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">-=</TD>
		<TD ALIGN="LEFT">Subtract a COleDateTimeSpan value from the current COleDateTime object.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">==</TD>
		<TD ALIGN="LEFT">Check whether two COleDateTime objects hold an identical date and time.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">!=</TD>
		<TD ALIGN="LEFT">Check whether two COleDateTime objects hold different dates and times.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">&lt;</TD>
		<TD ALIGN="LEFT">Check whether one COleDateTime object is less than another.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">&gt;</TD>
		<TD ALIGN="LEFT">Check whether one COleDateTime object is greater than another.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">&lt;=</TD>
		<TD ALIGN="LEFT">Check whether one COleDateTime object is less than or equal to another.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">&gt;=</TD>
		<TD ALIGN="LEFT">Check whether one COleDateTime object is greater than or equal to another.</TD>
	</TR>
</TABLE>

<H3><A NAME="Heading13"></A>Using the COleDateTimeSpan Class</H3>
<P>A COleDateTimeSpan object can hold the difference between two COleDateTime objects.
You can create one by subtracting one COleDateTime object from another or by using
one of the COleDateTimeSpan constructor forms shown in Table F.13.</P>
<P>
<H4>TABLE F.13.&nbsp;CONSTRUCTOR TYPES USED WITH COleDateTimeSpan.</H4>
<P>
<TABLE BORDER="1">
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">
			<H4>Constructor Definition
		</TD>
		<TD ALIGN="LEFT">
			<H4>Description
		</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTimeSpan()</TD>
		<TD ALIGN="LEFT">Create a time span set to zero.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTimeSpan(const COleDateTimeSpan&amp; srcSpan)</TD>
		<TD ALIGN="LEFT">Copy the time span from another COleDateTimeSpan object.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTimeSpan(long lDays, int nHours, int nMins, int nSecs)</TD>
		<TD ALIGN="LEFT">Initialize the time span with the passed parameter values.</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">COleDateTimeSpan(double dSpanSrc)</TD>
		<TD ALIGN="LEFT">Initialize the time span with the number of days passed value.</TD>
	</TR>
</TABLE>
</P>
<P>After you have a COleDateTimeSpan object, you can check or set its status using
the GetStatus() and SetStatus() functions just like the COleDateTime object. The
only differences are that the flag values are COleDateTimeSpan::valid and COleDateTimeSpan::invalid.</P>
<P>You can also set a time span by passing the number of days, hours, minutes, and
seconds as integer parameters to SetDateTimeSpan(). You can then retrieve these values
from a valid COleDateTimeSpan object by calling the GetDays(), GetHours(), GetMinutes(),
and GetSeconds() functions that all return long values representing each portion
of the time span value. If you want to retrieve the overall time span expressed in
days, hours, minutes, or seconds in one double value, you can call GetTotalDays(),
GetTotalHours(), GetTotalMinutes(), or GetTotalSeconds(), respectively.</P>
<P>You can format COleDateTimeSpan values as strings in the same way as COleDateTime
values by passing a format string using the codes appropriate to time spans from
Table F.11.</P>
<P>Several operator overloads help you use COleDateTimeSpan objects arithmetically
to add and subtract time spans to and from each other and also use them in conditions,
as shown