%% Created: 07.03.00
%% RCS-ID: $Id$
%% Copyright: (c) Vadim Zeitlin
-%% License: wxWidgets license
+%% License: wxWindows license
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Date and time classes overview}\label{wxdatetimeoverview}
Classes: \helpref{wxDateTime}{wxdatetime}, \helpref{wxDateSpan}{wxdatespan}, \helpref{wxTimeSpan}{wxtimespan}, \helpref{wxCalendarCtrl}{wxcalendarctrl}
-\subsection{Introduction}
+\subsection{Introduction}\label{introductiontowxdatetime}
wxWidgets provides a set of powerful classes to work with dates and times. Some
of the supported features of \helpref{wxDateTime}{wxdatetime} class are:
them is fast}
\end{twocollist}
-\subsection{All date/time classes at a glance}
+\subsection{All date/time classes at a glance}\label{alldatetimeclasses}
There are 3 main classes declared in {\tt <wx/datetime.h>}: except
\helpref{wxDateTime}{wxdatetime} itself which represents an absolute
moment in time, there are also two classes -
-\helpref{wxTimeSpan}{wxtimespan} and \helpref{wxDateSpan}{wxdatespan} which
+\helpref{wxTimeSpan}{wxtimespan} and \helpref{wxDateSpan}{wxdatespan} - which
represent the intervals of time.
There are also helper classes which are used together with wxDateTime:
wxTime classes. \helpref{These classes}{tdatecompatibility} are obsolete and
superseded by wxDateTime.
-\subsection{wxDateTime characteristics}
+\subsection{wxDateTime characteristics}\label{wxdatetimecharacteristics}
\helpref{wxDateTime}{wxdatetime} stores the time as a signed number of
milliseconds since the Epoch which is fixed, by convention, to Jan 1, 1970 -
as well and support for other calendars (Maya, Hebrew, Chinese...) is not
ruled out.
-\subsection{Difference between wxDateSpan and wxTimeSpan}
+\subsection{Difference between wxDateSpan and wxTimeSpan}\label{dateandtimespansdifference}
While there is only one logical way to represent an absolute moment in the
time (and hence only one wxDateTime class), there are at least two methods to
To do it, you will need to call \helpref{ToTimezone}{wxdatetimetotimezone} or
\helpref{MakeTimezone}{wxdatetimemaketimezone} methods to adjust the date for
the target time zone. There are also special versions of these functions
-\helpref{ToGMT}{wxdatetimetogmt} and \helpref{MakeGMT}{wxdatetimemakegmt} for
-the most common case - when the date should be constructed in GMT.
+\helpref{ToUTC}{wxdatetimetoutc} and \helpref{MakeUTC}{wxdatetimemakeutc} for
+the most common case - when the date should be constructed in UTC.
You also can just retrieve the value for some time zone without converting the
object to it first. For this you may pass TimeZone argument to any of the