X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2edb0bdef6238c8c246b6978bc14828b7033d931..db67d86dd1de506a5bb14dd59e9c45230120758a:/docs/latex/wx/tdate.tex?ds=sidebyside diff --git a/docs/latex/wx/tdate.tex b/docs/latex/wx/tdate.tex index 5b1219cab7..06b14b681f 100644 --- a/docs/latex/wx/tdate.tex +++ b/docs/latex/wx/tdate.tex @@ -13,9 +13,9 @@ Classes: \helpref{wxDateTime}{wxdatetime}, \helpref{wxDateSpan}{wxdatespan}, \helpref{wxTimeSpan}{wxtimespan}, \helpref{wxCalendarCtrl}{wxcalendarctrl} -\subsection{Introduction} +\subsection{Introduction}\label{introductiontowxdatetime} -wxWindows provides a set of powerful classes to work with dates and times. Some +wxWidgets provides a set of powerful classes to work with dates and times. Some of the supported features of \helpref{wxDateTime}{wxdatetime} class are: \twocolwidtha{7cm} @@ -32,12 +32,12 @@ format.} 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 }: 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: @@ -51,7 +51,7 @@ Finally, in other parts of this manual you may find mentions of wxDate and 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 - @@ -78,7 +78,7 @@ region, dependent). Future versions will probably have Julian calendar support 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 @@ -162,8 +162,8 @@ wxDateTime corresponding to the given date in, say, Pacific Standard Time. 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 @@ -211,7 +211,7 @@ TODO. \subsection{Compatibility}\label{tdatecompatibility} -The old classes for date/time manipulations ported from wxWindows version 1.xx +The old classes for date/time manipulations ported from wxWidgets version 1.xx are still included but are reimplemented in terms of wxDateTime. However, using them is strongly discouraged because they have a few quirks/bugs and were not `Y2K' compatible.