]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/datetime.tex
Implemented wxBitmap::HasAlpha() and ::UseAlpha().
[wxWidgets.git] / docs / latex / wx / datetime.tex
index 645c6db74762597f39e3034da6f479a379e151e9..d87afb1c8ecff06e359216ad346eabaaee1a7fa5 100644 (file)
@@ -6,7 +6,7 @@
 %% Created:     07.03.00
 %% RCS-ID:      $Id$
 %% Copyright:   (c) Vadim Zeitlin
 %% Created:     07.03.00
 %% RCS-ID:      $Id$
 %% Copyright:   (c) Vadim Zeitlin
-%% License:     wxWindows license
+%% License:     wxWidgets license
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \section{\class{wxDateTime}}\label{wxdatetime}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \section{\class{wxDateTime}}\label{wxdatetime}
@@ -121,7 +121,7 @@ parameters is one of the following values:
 \end{verbatim}
 
 Date calculations often depend on the country and wxDateTime allows to set the
 \end{verbatim}
 
 Date calculations often depend on the country and wxDateTime allows to set the
-country whose conventions should be used using 
+country whose conventions should be used using
 \helpref{SetCountry}{wxdatetimesetcountry}. It takes one of the following
 values as parameter:
 
 \helpref{SetCountry}{wxdatetimesetcountry}. It takes one of the following
 values as parameter:
 
@@ -148,7 +148,7 @@ values as parameter:
 Different parts of the world use different conventions for the week start.
 In some countries, the week starts on Sunday, while in others -- on Monday.
 The ISO standard doesn't address this issue, so we support both conventions in
 Different parts of the world use different conventions for the week start.
 In some countries, the week starts on Sunday, while in others -- on Monday.
 The ISO standard doesn't address this issue, so we support both conventions in
-the functions whose result depends on it (\helpref{GetWeekOfYear}{wxdatetimegetweekofyear} and 
+the functions whose result depends on it (\helpref{GetWeekOfYear}{wxdatetimegetweekofyear} and
 \helpref{GetWeekOfMonth}{wxdatetimegetweekofmonth}).
 
 The desired behvaiour may be specified by giving one of the following
 \helpref{GetWeekOfMonth}{wxdatetimegetweekofmonth}).
 
 The desired behvaiour may be specified by giving one of the following
@@ -180,7 +180,8 @@ No base class
 
 \latexignore{\rtfignore{\wxheading{Function groups}}}
 
 
 \latexignore{\rtfignore{\wxheading{Function groups}}}
 
-\membersection{Static functions}
+
+\membersection{Static functions}\label{datetimestaticfunctions}
 
 For convenience, all static functions are collected here. These functions
 either set or return the static variables of wxDateSpan (the country), return
 
 For convenience, all static functions are collected here. These functions
 either set or return the static variables of wxDateSpan (the country), return
@@ -191,7 +192,7 @@ Please note that although several function accept an extra {\it Calendar}
 parameter, it is currently ignored as only the Gregorian calendar is
 supported. Future versions will support other calendars.
 
 parameter, it is currently ignored as only the Gregorian calendar is
 supported. Future versions will support other calendars.
 
-\pythonnote{These methods are standalone functions named 
+\pythonnote{These methods are standalone functions named
 {\tt wxDateTime\_<StaticMethodName>} in wxPython.}
 
 \helpref{SetCountry}{wxdatetimesetcountry}\\
 {\tt wxDateTime\_<StaticMethodName>} in wxPython.}
 
 \helpref{SetCountry}{wxdatetimesetcountry}\\
@@ -214,7 +215,8 @@ supported. Future versions will support other calendars.
 \helpref{UNow}{wxdatetimeunow}\\
 \helpref{Today}{wxdatetimetoday}
 
 \helpref{UNow}{wxdatetimeunow}\\
 \helpref{Today}{wxdatetimetoday}
 
-\membersection{Constructors, assignment operators and setters}
+
+\membersection{Constructors, assignment operators and setters}\label{datetimeconstructors}
 
 Constructors and various {\tt Set()} methods are collected here. If you
 construct a date object from separate values for day, month and year, you
 
 Constructors and various {\tt Set()} methods are collected here. If you
 construct a date object from separate values for day, month and year, you
@@ -245,14 +247,14 @@ values were correct as constructors can not return an error code.
 \helpref{SetSecond}{wxdatetimesetsecond}\\
 \helpref{SetMillisecond}{wxdatetimesetmillisecond}\\
 \helpref{operator$=$(time\_t)}{wxdatetimeoperatoreqtimet}\\
 \helpref{SetSecond}{wxdatetimesetsecond}\\
 \helpref{SetMillisecond}{wxdatetimesetmillisecond}\\
 \helpref{operator$=$(time\_t)}{wxdatetimeoperatoreqtimet}\\
-\helpref{operator$=$(struct tm)}{wxdatetimeoperatoreqtm}
-%\helpref{operator$=$(struct Tm)}{wxdatetimeoperatortm2}
+\helpref{operator$=$(struct tm)}{wxdatetimeoperatoreqtm}\rtfsp
 
 
-\membersection{Accessors}
+
+\membersection{Accessors}\label{datetimeaccessors}
 
 Here are the trivial accessors. Other functions, which might have to perform
 
 Here are the trivial accessors. Other functions, which might have to perform
-some more complicated calculations to find the answer are under the 
-\helpref{Calendar calculations}{wxdatetimecalculations} section.
+some more complicated calculations to find the answer are under the
+\helpref{Calendar calculations}{datetimecalculations} section.
 
 \helpref{IsValid}{wxdatetimeisvalid}\\
 \helpref{GetTicks}{wxdatetimegetticks}\\
 
 \helpref{IsValid}{wxdatetimeisvalid}\\
 \helpref{GetTicks}{wxdatetimegetticks}\\
@@ -272,7 +274,8 @@ some more complicated calculations to find the answer are under the
 \helpref{IsGregorianDate}{wxdatetimeisgregoriandate}\\
 \helpref{GetAsDOS}{wxdatetimegetasdos}
 
 \helpref{IsGregorianDate}{wxdatetimeisgregoriandate}\\
 \helpref{GetAsDOS}{wxdatetimegetasdos}
 
-\membersection{Date comparison}
+
+\membersection{Date comparison}\label{datecomparison}
 
 There are several function to allow date comparison. To supplement them, a few
 global operators $>$, $<$ etc taking wxDateTime are defined.
 
 There are several function to allow date comparison. To supplement them, a few
 global operators $>$, $<$ etc taking wxDateTime are defined.
@@ -286,7 +289,8 @@ global operators $>$, $<$ etc taking wxDateTime are defined.
 \helpref{IsSameTime}{wxdatetimeissametime}\\
 \helpref{IsEqualUpTo}{wxdatetimeisequalupto}
 
 \helpref{IsSameTime}{wxdatetimeissametime}\\
 \helpref{IsEqualUpTo}{wxdatetimeisequalupto}
 
-\membersection{Date arithmetics}
+
+\membersection{Date arithmetics}\label{datearithmetics}
 
 These functions carry out \helpref{arithmetics}{tdatearithm} on the wxDateTime
 objects. As explained in the overview, either wxTimeSpan or wxDateSpan may be
 
 These functions carry out \helpref{arithmetics}{tdatearithm} on the wxDateTime
 objects. As explained in the overview, either wxTimeSpan or wxDateSpan may be
@@ -294,7 +298,7 @@ added to wxDateTime, hence all functions are overloaded to accept both
 arguments.
 
 Also, both {\tt Add()} and {\tt Subtract()} have both const and non-const
 arguments.
 
 Also, both {\tt Add()} and {\tt Subtract()} have both const and non-const
-version. The first one returns a new obejct which represents the
+version. The first one returns a new object which represents the
 sum/difference of the original one with the argument while the second form
 modifies the object to which it is applied. The operators $-=$ and $+=$ are
 defined to be equivalent to the second forms of these functions.
 sum/difference of the original one with the argument while the second form
 modifies the object to which it is applied. The operators $-=$ and $+=$ are
 defined to be equivalent to the second forms of these functions.
@@ -309,36 +313,37 @@ defined to be equivalent to the second forms of these functions.
 \helpref{oparator$-=$(wxTimeSpan)}{wxdatetimesubtractts}\\
 \helpref{oparator$-=$(wxDateSpan)}{wxdatetimesubtractds}
 
 \helpref{oparator$-=$(wxTimeSpan)}{wxdatetimesubtractts}\\
 \helpref{oparator$-=$(wxDateSpan)}{wxdatetimesubtractds}
 
-\membersection{Parsing and formatting dates}
 
 
-These functions convert wxDateTime obejcts to and from text. The
+\membersection{Parsing and formatting dates}\label{datetimeparsing}
+
+These functions convert wxDateTime objects to and from text. The
 conversions to text are mostly trivial: you can either do it using the default
 conversions to text are mostly trivial: you can either do it using the default
-date and time representations for the current locale ( 
-\helpref{FormatDate}{wxdatetimeformatdate} and 
+date and time representations for the current locale (
+\helpref{FormatDate}{wxdatetimeformatdate} and
 \helpref{FormatTime}{wxdatetimeformattime}), using the international standard
 \helpref{FormatTime}{wxdatetimeformattime}), using the international standard
-representation defined by ISO 8601 ( 
-\helpref{FormatISODate}{wxdatetimeformatisodate} and 
+representation defined by ISO 8601 (
+\helpref{FormatISODate}{wxdatetimeformatisodate} and
 \helpref{FormatISOTime}{wxdatetimeformatisotime}) or by specifying any format
 at all and using \helpref{Format}{wxdatetimeformat} directly.
 
 The conversions from text are more interesting, as there are much more
 \helpref{FormatISOTime}{wxdatetimeformatisotime}) or by specifying any format
 at all and using \helpref{Format}{wxdatetimeformat} directly.
 
 The conversions from text are more interesting, as there are much more
-possibilities to care about. The simplest cases can be taken care of with 
+possibilities to care about. The simplest cases can be taken care of with
 \helpref{ParseFormat}{wxdatetimeparseformat} which can parse any date in the
 given (rigid) format. \helpref{ParseRfc822Date}{wxdatetimeparserfc822date} is
 another function for parsing dates in predefined format -- the one of RFC 822
 which (still...) defines the format of email messages on the Internet. This
 \helpref{ParseFormat}{wxdatetimeparseformat} which can parse any date in the
 given (rigid) format. \helpref{ParseRfc822Date}{wxdatetimeparserfc822date} is
 another function for parsing dates in predefined format -- the one of RFC 822
 which (still...) defines the format of email messages on the Internet. This
-format can not be described with {\tt strptime(3)}-like format strings used by 
+format can not be described with {\tt strptime(3)}-like format strings used by
 \helpref{Format}{wxdatetimeformat}, hence the need for a separate function.
 
 \helpref{Format}{wxdatetimeformat}, hence the need for a separate function.
 
-But the most interesting functions are 
-\helpref{ParseTime}{wxdatetimeparsetime}, 
-\helpref{ParseDate}{wxdatetimeparsedate} and 
+But the most interesting functions are
+\helpref{ParseTime}{wxdatetimeparsetime},
+\helpref{ParseDate}{wxdatetimeparsedate} and
 \helpref{ParseDateTime}{wxdatetimeparsedatetime}. They try to parse the date
 ans time (or only one of them) in `free' format, i.e. allow them to be
 specified in any of possible ways. These functions will usually be used to
 parse the (interactive) user input which is not bound to be in any predefined
 format. As an example, \helpref{ParseDateTime}{wxdatetimeparsedatetime} can
 \helpref{ParseDateTime}{wxdatetimeparsedatetime}. They try to parse the date
 ans time (or only one of them) in `free' format, i.e. allow them to be
 specified in any of possible ways. These functions will usually be used to
 parse the (interactive) user input which is not bound to be in any predefined
 format. As an example, \helpref{ParseDateTime}{wxdatetimeparsedatetime} can
-parse the strings such as {\tt "tomorrow"}, {\tt "March first"} and even 
+parse the strings such as {\tt "tomorrow"}, {\tt "March first"} and even
 {\tt "next Sunday"}.
 
 \helpref{ParseRfc822Date}{wxdatetimeparserfc822date}\\
 {\tt "next Sunday"}.
 
 \helpref{ParseRfc822Date}{wxdatetimeparserfc822date}\\
@@ -352,7 +357,8 @@ parse the strings such as {\tt "tomorrow"}, {\tt "March first"} and even
 \helpref{FormatISODate}{wxdatetimeformatisodate}\\
 \helpref{FormatISOTime}{wxdatetimeformatisotime}
 
 \helpref{FormatISODate}{wxdatetimeformatisodate}\\
 \helpref{FormatISOTime}{wxdatetimeformatisotime}
 
-\membersection{Calendar calculations}\label{wxdatetimecalculations}
+
+\membersection{Calendar calculations}\label{datetimecalculations}
 
 The functions in this section perform the basic calendar calculations, mostly
 related to the week days. They allow to find the given week day in the
 
 The functions in this section perform the basic calendar calculations, mostly
 related to the week days. They allow to find the given week day in the
@@ -371,14 +377,14 @@ wxDateTime -- they only work with the date part of it.
 \helpref{GetWeekDay}{wxdatetimegetweekday2}\\
 \helpref{SetToLastWeekDay}{wxdatetimesettolastweekday}\\
 \helpref{GetLastWeekDay}{wxdatetimegetlastweekday}\\
 \helpref{GetWeekDay}{wxdatetimegetweekday2}\\
 \helpref{SetToLastWeekDay}{wxdatetimesettolastweekday}\\
 \helpref{GetLastWeekDay}{wxdatetimegetlastweekday}\\
-\helpref{SetToTheWeek}{wxdatetimesettotheweek}\\
-\helpref{GetWeek}{wxdatetimegetweek}\\
+\helpref{SetToWeekOfYear}{wxdatetimesettoweekofyear}\\
 \helpref{SetToLastMonthDay}{wxdatetimesettolastmonthday}\\
 \helpref{GetLastMonthDay}{wxdatetimegetlastmonthday}\\
 \helpref{SetToYearDay}{wxdatetimesettoyearday}\\
 \helpref{GetYearDay}{wxdatetimegetyearday}
 
 \helpref{SetToLastMonthDay}{wxdatetimesettolastmonthday}\\
 \helpref{GetLastMonthDay}{wxdatetimegetlastmonthday}\\
 \helpref{SetToYearDay}{wxdatetimesettoyearday}\\
 \helpref{GetYearDay}{wxdatetimegetyearday}
 
-\membersection{Astronomical/historical functions}
+
+\membersection{Astronomical/historical functions}\label{astronomyhistoryfunctions}
 
 Some degree of support for the date units used in astronomy and/or history is
 provided. You can construct a wxDateTime object from a
 
 Some degree of support for the date units used in astronomy and/or history is
 provided. You can construct a wxDateTime object from a
@@ -394,10 +400,11 @@ provided. You can construct a wxDateTime object from a
 \helpref{GetMJD}{wxdatetimegetmjd}\\
 \helpref{GetRataDie}{wxdatetimegetratadie}
 
 \helpref{GetMJD}{wxdatetimegetmjd}\\
 \helpref{GetRataDie}{wxdatetimegetratadie}
 
-\membersection{Time zone and DST support}
+
+\membersection{Time zone and DST support}\label{datetimedstzone}
 
 Please see the \helpref{time zone overview}{tdatetimezones} for more
 
 Please see the \helpref{time zone overview}{tdatetimezones} for more
-information about time zones. ormally, these functions should be rarely used.
+information about time zones. Normally, these functions should be rarely used.
 
 \helpref{ToTimezone}{wxdatetimetotimezone}\\
 \helpref{MakeTimezone}{wxdatetimemaketimezone}\\
 
 \helpref{ToTimezone}{wxdatetimetotimezone}\\
 \helpref{MakeTimezone}{wxdatetimemaketimezone}\\
@@ -415,6 +422,7 @@ information about time zones. ormally, these functions should be rarely used.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% static functions %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% static functions %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::ConvertYearToBC}\label{wxdatetimeconvertyeartobc}
 
 \func{static int}{ConvertYearToBC}{\param{int }{year}}
 \membersection{wxDateTime::ConvertYearToBC}\label{wxdatetimeconvertyeartobc}
 
 \func{static int}{ConvertYearToBC}{\param{int }{year}}
@@ -432,6 +440,7 @@ This function should be used like this:
     printf("The year is %d%s", wxDateTime::ConvertYearToBC(y), y > 0 ? "AD" : "BC");
 \end{verbatim}
 
     printf("The year is %d%s", wxDateTime::ConvertYearToBC(y), y > 0 ? "AD" : "BC");
 \end{verbatim}
 
+
 \membersection{wxDateTime::GetAmPmStrings}\label{wxdatetimegetampmstrings}
 
 \func{static void}{GetAmPmStrings}{\param{wxString *}{am}, \param{wxString *}{pm}}
 \membersection{wxDateTime::GetAmPmStrings}\label{wxdatetimegetampmstrings}
 
 \func{static void}{GetAmPmStrings}{\param{wxString *}{am}, \param{wxString *}{pm}}
@@ -440,6 +449,7 @@ Returns the translations of the strings {\tt AM} and {\tt PM} used for time
 formatting for the current locale. Either of the pointers may be {\tt NULL} if
 the corresponding value is not needed.
 
 formatting for the current locale. Either of the pointers may be {\tt NULL} if
 the corresponding value is not needed.
 
+
 \membersection{wxDateTime::GetBeginDST}\label{wxdatetimegetbegindst}
 
 \func{static wxDateTime}{GetBeginDST}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}}
 \membersection{wxDateTime::GetBeginDST}\label{wxdatetimegetbegindst}
 
 \func{static wxDateTime}{GetBeginDST}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}}
@@ -452,6 +462,7 @@ by default). This function suffers from limitations described in
 
 \helpref{GetEndDST}{wxdatetimegetenddst}
 
 
 \helpref{GetEndDST}{wxdatetimegetenddst}
 
+
 \membersection{wxDateTime::GetCountry}\label{wxdatetimegetcountry}
 
 \func{static Country}{GetCountry}{\void}
 \membersection{wxDateTime::GetCountry}\label{wxdatetimegetcountry}
 
 \func{static Country}{GetCountry}{\void}
@@ -463,18 +474,21 @@ calculations, for example.
 
 \helpref{SetCountry}{wxdatetimesetcountry}
 
 
 \helpref{SetCountry}{wxdatetimesetcountry}
 
+
 \membersection{wxDateTime::GetCurrentYear}\label{wxdatetimegetcurrentyear}
 
 \func{static int}{GetCurrentYear}{\param{Calendar }{cal = Gregorian}}
 
 Get the current year in given calendar (only Gregorian is currently supported).
 
 \membersection{wxDateTime::GetCurrentYear}\label{wxdatetimegetcurrentyear}
 
 \func{static int}{GetCurrentYear}{\param{Calendar }{cal = Gregorian}}
 
 Get the current year in given calendar (only Gregorian is currently supported).
 
+
 \membersection{wxDateTime::GetCurrentMonth}\label{wxdatetimegetcurrentmonth}
 
 \func{static Month}{GetCurrentMonth}{\param{Calendar }{cal = Gregorian}}
 
 Get the current month in given calendar (only Gregorian is currently supported).
 
 \membersection{wxDateTime::GetCurrentMonth}\label{wxdatetimegetcurrentmonth}
 
 \func{static Month}{GetCurrentMonth}{\param{Calendar }{cal = Gregorian}}
 
 Get the current month in given calendar (only Gregorian is currently supported).
 
+
 \membersection{wxDateTime::GetCentury}\label{wxdatetimegetcentury}
 
 \func{static int}{GetCentury}{\param{int }{year = Inv\_Year}}
 \membersection{wxDateTime::GetCentury}\label{wxdatetimegetcentury}
 
 \func{static int}{GetCentury}{\param{int }{year = Inv\_Year}}
@@ -482,6 +496,7 @@ Get the current month in given calendar (only Gregorian is currently supported).
 Get the current century, i.e. first two digits of the year, in given calendar
 (only Gregorian is currently supported).
 
 Get the current century, i.e. first two digits of the year, in given calendar
 (only Gregorian is currently supported).
 
+
 \membersection{wxDateTime::GetEndDST}\label{wxdatetimegetenddst}
 
 \func{static wxDateTime}{GetEndDST}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}}
 \membersection{wxDateTime::GetEndDST}\label{wxdatetimegetenddst}
 
 \func{static wxDateTime}{GetEndDST}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}}
@@ -493,6 +508,7 @@ default).
 
 \helpref{GetBeginDST}{wxdatetimegetbegindst}
 
 
 \helpref{GetBeginDST}{wxdatetimegetbegindst}
 
+
 \membersection{wxDateTime::GetMonthName}\label{wxdatetimegetmonthname}
 
 \func{static wxString}{GetMonthName}{\param{Month }{month}, \param{NameFlags }{flags = Name\_Full}}
 \membersection{wxDateTime::GetMonthName}\label{wxdatetimegetmonthname}
 
 \func{static wxString}{GetMonthName}{\param{Month }{month}, \param{NameFlags }{flags = Name\_Full}}
@@ -504,6 +520,7 @@ given month.
 
 \helpref{GetWeekDayName}{wxdatetimegetweekdayname}
 
 
 \helpref{GetWeekDayName}{wxdatetimegetweekdayname}
 
+
 \membersection{wxDateTime::GetNumberOfDays}\label{wxdatetimegetnumberofdays}
 
 \func{static wxDateTime\_t}{GetNumberOfDays}{\param{int }{year}, \param{Calendar }{cal = Gregorian}}
 \membersection{wxDateTime::GetNumberOfDays}\label{wxdatetimegetnumberofdays}
 
 \func{static wxDateTime\_t}{GetNumberOfDays}{\param{int }{year}, \param{Calendar }{cal = Gregorian}}
@@ -518,6 +535,21 @@ The only supported value for {\it cal} parameter is currently {\tt Gregorian}.
 \pythonnote{These two methods are named {\tt GetNumberOfDaysInYear}
 and {\tt GetNumberOfDaysInMonth} in wxPython.}
 
 \pythonnote{These two methods are named {\tt GetNumberOfDaysInYear}
 and {\tt GetNumberOfDaysInMonth} in wxPython.}
 
+
+\membersection{wxDateTime::GetTimeNow}\label{wxdatetimegettimenow}
+
+\func{static time\_t}{GetTimeNow}{\void}
+
+Returns the current time.
+
+
+\membersection{wxDateTime::GetTmNow}\label{wxdatetimegettmnow}
+
+\func{static struct tm *}{GetTmNow}{\void}
+
+Returns the current time broken down.
+
+
 \membersection{wxDateTime::GetWeekDayName}\label{wxdatetimegetweekdayname}
 
 \func{static wxString}{GetWeekDayName}{\param{WeekDay }{weekday}, \param{NameFlags }{flags = Name\_Full}}
 \membersection{wxDateTime::GetWeekDayName}\label{wxdatetimegetweekdayname}
 
 \func{static wxString}{GetWeekDayName}{\param{WeekDay }{weekday}, \param{NameFlags }{flags = Name\_Full}}
@@ -529,6 +561,7 @@ given week day.
 
 \helpref{GetMonthName}{wxdatetimegetmonthname}
 
 
 \helpref{GetMonthName}{wxdatetimegetmonthname}
 
+
 \membersection{wxDateTime::IsLeapYear}\label{wxdatetimeisleapyear}
 
 \func{static bool}{IsLeapYear}{\param{int }{year = Inv\_Year}, \param{Calendar }{cal = Gregorian}}
 \membersection{wxDateTime::IsLeapYear}\label{wxdatetimeisleapyear}
 
 \func{static bool}{IsLeapYear}{\param{int }{year = Inv\_Year}, \param{Calendar }{cal = Gregorian}}
@@ -537,6 +570,7 @@ Returns {\tt true} if the {\it year} is a leap one in the specified calendar.
 
 This functions supports Gregorian and Julian calendars.
 
 
 This functions supports Gregorian and Julian calendars.
 
+
 \membersection{wxDateTime::IsWestEuropeanCountry}\label{wxdatetimeiswesteuropeancountry}
 
 \func{static bool}{IsWestEuropeanCountry}{\param{Country }{country = Country\_Default}}
 \membersection{wxDateTime::IsWestEuropeanCountry}\label{wxdatetimeiswesteuropeancountry}
 
 \func{static bool}{IsWestEuropeanCountry}{\param{Country }{country = Country\_Default}}
@@ -545,6 +579,7 @@ This function returns {\tt true} if the specified (or default) country is one
 of Western European ones. It is used internally by wxDateTime to determine the
 DST convention and date and time formatting rules.
 
 of Western European ones. It is used internally by wxDateTime to determine the
 DST convention and date and time formatting rules.
 
+
 \membersection{wxDateTime::IsDSTApplicable}\label{wxdatetimeisdstapplicable}
 
 \func{static bool}{IsDSTApplicable}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}}
 \membersection{wxDateTime::IsDSTApplicable}\label{wxdatetimeisdstapplicable}
 
 \func{static bool}{IsDSTApplicable}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}}
@@ -552,6 +587,7 @@ DST convention and date and time formatting rules.
 Returns {\tt true} if DST was used n the given year (the current one by
 default) in the given country.
 
 Returns {\tt true} if DST was used n the given year (the current one by
 default) in the given country.
 
+
 \membersection{wxDateTime::Now}\label{wxdatetimenow}
 
 \func{static wxDateTime}{Now}{\void}
 \membersection{wxDateTime::Now}\label{wxdatetimenow}
 
 \func{static wxDateTime}{Now}{\void}
@@ -565,7 +601,7 @@ Example:
     printf("Current time in Paris:\t%s\n", now.Format("%c", wxDateTime::CET).c_str());
 \end{verbatim}
 
     printf("Current time in Paris:\t%s\n", now.Format("%c", wxDateTime::CET).c_str());
 \end{verbatim}
 
-Note that this function is accurate up to second: 
+Note that this function is accurate up to second:
 \helpref{wxDateTime::UNow}{wxdatetimeunow} should be used for better precision
 (but it is less efficient and might not be available on all platforms).
 
 \helpref{wxDateTime::UNow}{wxdatetimeunow} should be used for better precision
 (but it is less efficient and might not be available on all platforms).
 
@@ -573,6 +609,7 @@ Note that this function is accurate up to second:
 
 \helpref{Today}{wxdatetimetoday}
 
 
 \helpref{Today}{wxdatetimetoday}
 
+
 \membersection{wxDateTime::SetCountry}\label{wxdatetimesetcountry}
 
 \func{static void}{SetCountry}{\param{Country }{country}}
 \membersection{wxDateTime::SetCountry}\label{wxdatetimesetcountry}
 
 \func{static void}{SetCountry}{\param{Country }{country}}
@@ -587,6 +624,7 @@ The possible values for {\it country} parameter are enumerated in
 
 \helpref{GetCountry}{wxdatetimegetcountry}
 
 
 \helpref{GetCountry}{wxdatetimegetcountry}
 
+
 \membersection{wxDateTime::Today}\label{wxdatetimetoday}
 
 \func{static wxDateTime}{Today}{\void}
 \membersection{wxDateTime::Today}\label{wxdatetimetoday}
 
 \func{static wxDateTime}{Today}{\void}
@@ -598,6 +636,7 @@ same as \helpref{Now()}{wxdatetimenow}, but the time part is set to $0$).
 
 \helpref{Now}{wxdatetimenow}
 
 
 \helpref{Now}{wxdatetimenow}
 
+
 \membersection{wxDateTime::UNow}\label{wxdatetimeunow}
 
 \func{static wxDateTime}{UNow}{\void}
 \membersection{wxDateTime::UNow}\label{wxdatetimeunow}
 
 \func{static wxDateTime}{UNow}{\void}
@@ -612,6 +651,7 @@ current platform (supported under most Unices and Win32).
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% constructors &c %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% constructors &c %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimedef}
 
 \func{}{wxDateTime}{\void}
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimedef}
 
 \func{}{wxDateTime}{\void}
@@ -619,6 +659,7 @@ current platform (supported under most Unices and Win32).
 Default constructor. Use one of {\tt Set()} functions to initialize the object
 later.
 
 Default constructor. Use one of {\tt Set()} functions to initialize the object
 later.
 
+
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimetimet}
 
 \func{wxDateTime\&}{wxDateTime}{\param{time\_t }{timet}}
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimetimet}
 
 \func{wxDateTime\&}{wxDateTime}{\param{time\_t }{timet}}
@@ -627,6 +668,7 @@ Same as \helpref{Set}{wxdatetimewxdatetimetimet}.
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromTimeT} in wxPython.}
 
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromTimeT} in wxPython.}
 
+
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimetm}
 
 \func{wxDateTime\&}{wxDateTime}{\param{const struct tm\& }{tm}}
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimetm}
 
 \func{wxDateTime\&}{wxDateTime}{\param{const struct tm\& }{tm}}
@@ -635,6 +677,7 @@ Same as \helpref{Set}{wxdatetimewxdatetimetm}
 
 \pythonnote{Unsupported.}
 
 
 \pythonnote{Unsupported.}
 
+
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimejdn}
 
 \func{wxDateTime\&}{wxDateTime}{\param{double }{jdn}}
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimejdn}
 
 \func{wxDateTime\&}{wxDateTime}{\param{double }{jdn}}
@@ -643,6 +686,7 @@ Same as \helpref{Set}{wxdatetimewxdatetimejdn}
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromJDN} in wxPython.}
 
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromJDN} in wxPython.}
 
+
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimetime}
 
 \func{wxDateTime\&}{wxDateTime}{\param{wxDateTime\_t }{hour}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimetime}
 
 \func{wxDateTime\&}{wxDateTime}{\param{wxDateTime\_t }{hour}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
@@ -651,15 +695,17 @@ Same as \helpref{Set}{wxdatetimewxdatetimetime}
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromHMS} in wxPython.}
 
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromHMS} in wxPython.}
 
+
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimedate}
 
 \membersection{wxDateTime::wxDateTime}\label{wxdatetimewxdatetimedate}
 
-\func{wxDateTime\&}{wxDateTime}{\param{wxDateTime\_t }{day}, \param{Month }{month = Inv\_Month}, \param{int}{ Inv\_Year}, 
+\func{wxDateTime\&}{wxDateTime}{\param{wxDateTime\_t }{day}, \param{Month }{month = Inv\_Month}, \param{int}{ Inv\_Year},
 \param{wxDateTime\_t }{hour = 0}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
 
 Same as \helpref{Set}{wxdatetimesetdate}
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromDMY} in wxPython.}
 
 \param{wxDateTime\_t }{hour = 0}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
 
 Same as \helpref{Set}{wxdatetimesetdate}
 
 \pythonnote{This constructor is named {\tt wxDateTimeFromDMY} in wxPython.}
 
+
 \membersection{wxDateTime::SetToCurrent}\label{wxdatetimesettocurrent}
 
 \func{wxDateTime\&}{SetToCurrent}{\void}
 \membersection{wxDateTime::SetToCurrent}\label{wxdatetimesettocurrent}
 
 \func{wxDateTime\&}{SetToCurrent}{\void}
@@ -667,6 +713,7 @@ Same as \helpref{Set}{wxdatetimesetdate}
 Sets the date and time of to the current values. Same as assigning the result
 of \helpref{Now()}{wxdatetimenow} to this object.
 
 Sets the date and time of to the current values. Same as assigning the result
 of \helpref{Now()}{wxdatetimenow} to this object.
 
+
 \membersection{wxDateTime::Set}\label{wxdatetimesettimet}
 
 \func{wxDateTime\&}{Set}{\param{time\_t }{timet}}
 \membersection{wxDateTime::Set}\label{wxdatetimesettimet}
 
 \func{wxDateTime\&}{Set}{\param{time\_t }{timet}}
@@ -676,6 +723,7 @@ since Jan 1, 1970.
 
 \pythonnote{This method is named {\tt SetTimeT} in wxPython.}
 
 
 \pythonnote{This method is named {\tt SetTimeT} in wxPython.}
 
+
 \membersection{wxDateTime::Set}\label{wxdatetimesettm}
 
 \func{wxDateTime\&}{Set}{\param{const struct tm\& }{tm}}
 \membersection{wxDateTime::Set}\label{wxdatetimesettm}
 
 \func{wxDateTime\&}{Set}{\param{const struct tm\& }{tm}}
@@ -685,6 +733,7 @@ Sets the date and time from the broken down representation in the standard
 
 \pythonnote{Unsupported.}
 
 
 \pythonnote{Unsupported.}
 
+
 \membersection{wxDateTime::Set}\label{wxdatetimesetjdn}
 
 \func{wxDateTime\&}{Set}{\param{double }{jdn}}
 \membersection{wxDateTime::Set}\label{wxdatetimesetjdn}
 
 \func{wxDateTime\&}{Set}{\param{double }{jdn}}
@@ -698,6 +747,7 @@ Julian proleptic calendar.
 
 \pythonnote{This method is named {\tt SetJDN} in wxPython.}
 
 
 \pythonnote{This method is named {\tt SetJDN} in wxPython.}
 
+
 \membersection{wxDateTime::Set}\label{wxdatetimesettime}
 
 \func{wxDateTime\&}{Set}{\param{wxDateTime\_t }{hour}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
 \membersection{wxDateTime::Set}\label{wxdatetimesettime}
 
 \func{wxDateTime\&}{Set}{\param{wxDateTime\_t }{hour}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
@@ -707,66 +757,77 @@ from supplied parameters.
 
 \pythonnote{This method is named {\tt SetHMS} in wxPython.}
 
 
 \pythonnote{This method is named {\tt SetHMS} in wxPython.}
 
+
 \membersection{wxDateTime::Set}\label{wxdatetimesetdate}
 
 \func{wxDateTime\&}{Set}{\param{wxDateTime\_t }{day}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}, \param{wxDateTime\_t }{hour = 0}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
 
 Sets the date and time from the parameters.
 
 \membersection{wxDateTime::Set}\label{wxdatetimesetdate}
 
 \func{wxDateTime\&}{Set}{\param{wxDateTime\_t }{day}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}, \param{wxDateTime\_t }{hour = 0}, \param{wxDateTime\_t }{minute = 0}, \param{wxDateTime\_t }{second = 0}, \param{wxDateTime\_t }{millisec = 0}}
 
 Sets the date and time from the parameters.
 
+
 \membersection{wxDateTime::ResetTime}\label{wxdatetimeresettime}
 
 \func{wxDateTime\&}{ResetTime}{\void}
 
 Reset time to midnight (00:00:00) without changing the date.
 
 \membersection{wxDateTime::ResetTime}\label{wxdatetimeresettime}
 
 \func{wxDateTime\&}{ResetTime}{\void}
 
 Reset time to midnight (00:00:00) without changing the date.
 
+
 \membersection{wxDateTime::SetYear}\label{wxdatetimesetyear}
 
 \func{wxDateTime\&}{SetYear}{\param{int }{year}}
 
 Sets the year without changing other date components.
 
 \membersection{wxDateTime::SetYear}\label{wxdatetimesetyear}
 
 \func{wxDateTime\&}{SetYear}{\param{int }{year}}
 
 Sets the year without changing other date components.
 
+
 \membersection{wxDateTime::SetMonth}\label{wxdatetimesetmonth}
 
 \func{wxDateTime\&}{SetMonth}{\param{Month }{month}}
 
 Sets the month without changing other date components.
 
 \membersection{wxDateTime::SetMonth}\label{wxdatetimesetmonth}
 
 \func{wxDateTime\&}{SetMonth}{\param{Month }{month}}
 
 Sets the month without changing other date components.
 
+
 \membersection{wxDateTime::SetDay}\label{wxdatetimesetday}
 
 \func{wxDateTime\&}{SetDay}{\param{wxDateTime\_t }{day}}
 
 Sets the day without changing other date components.
 
 \membersection{wxDateTime::SetDay}\label{wxdatetimesetday}
 
 \func{wxDateTime\&}{SetDay}{\param{wxDateTime\_t }{day}}
 
 Sets the day without changing other date components.
 
+
 \membersection{wxDateTime::SetHour}\label{wxdatetimesethour}
 
 \func{wxDateTime\&}{SetHour}{\param{wxDateTime\_t }{hour}}
 
 Sets the hour without changing other date components.
 
 \membersection{wxDateTime::SetHour}\label{wxdatetimesethour}
 
 \func{wxDateTime\&}{SetHour}{\param{wxDateTime\_t }{hour}}
 
 Sets the hour without changing other date components.
 
+
 \membersection{wxDateTime::SetMinute}\label{wxdatetimesetminute}
 
 \func{wxDateTime\&}{SetMinute}{\param{wxDateTime\_t }{minute}}
 
 Sets the minute without changing other date components.
 
 \membersection{wxDateTime::SetMinute}\label{wxdatetimesetminute}
 
 \func{wxDateTime\&}{SetMinute}{\param{wxDateTime\_t }{minute}}
 
 Sets the minute without changing other date components.
 
+
 \membersection{wxDateTime::SetSecond}\label{wxdatetimesetsecond}
 
 \func{wxDateTime\&}{SetSecond}{\param{wxDateTime\_t }{second}}
 
 Sets the second without changing other date components.
 
 \membersection{wxDateTime::SetSecond}\label{wxdatetimesetsecond}
 
 \func{wxDateTime\&}{SetSecond}{\param{wxDateTime\_t }{second}}
 
 Sets the second without changing other date components.
 
+
 \membersection{wxDateTime::SetMillisecond}\label{wxdatetimesetmillisecond}
 
 \func{wxDateTime\&}{SetMillisecond}{\param{wxDateTime\_t }{millisecond}}
 
 Sets the millisecond without changing other date components.
 
 \membersection{wxDateTime::SetMillisecond}\label{wxdatetimesetmillisecond}
 
 \func{wxDateTime\&}{SetMillisecond}{\param{wxDateTime\_t }{millisecond}}
 
 Sets the millisecond without changing other date components.
 
+
 \membersection{wxDateTime::operator$=$}\label{wxdatetimeoperatoreqtimet}
 
 \func{wxDateTime\&}{operator}{\param{time\_t }{timet}}
 
 Same as \helpref{Set}{wxdatetimesettimet}.
 
 \membersection{wxDateTime::operator$=$}\label{wxdatetimeoperatoreqtimet}
 
 \func{wxDateTime\&}{operator}{\param{time\_t }{timet}}
 
 Same as \helpref{Set}{wxdatetimesettimet}.
 
+
 \membersection{wxDateTime::operator$=$}\label{wxdatetimeoperatoreqtm}
 
 \func{wxDateTime\&}{operator}{\param{const struct tm\& }{tm}}
 \membersection{wxDateTime::operator$=$}\label{wxdatetimeoperatoreqtm}
 
 \func{wxDateTime\&}{operator}{\param{const struct tm\& }{tm}}
@@ -775,18 +836,21 @@ Same as \helpref{Set}{wxdatetimesettm}.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% accessors %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% accessors %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::IsValid}\label{wxdatetimeisvalid}
 
 \constfunc{bool}{IsValid}{\void}
 
 Returns {\tt true} if the object represents a valid time moment.
 
 \membersection{wxDateTime::IsValid}\label{wxdatetimeisvalid}
 
 \constfunc{bool}{IsValid}{\void}
 
 Returns {\tt true} if the object represents a valid time moment.
 
+
 \membersection{wxDateTime::GetTm}\label{wxdatetimegettm}
 
 \constfunc{Tm}{GetTm}{\param{const TimeZone\& }{tz = Local}}
 
 Returns broken down representation of the date and time.
 
 \membersection{wxDateTime::GetTm}\label{wxdatetimegettm}
 
 \constfunc{Tm}{GetTm}{\param{const TimeZone\& }{tz = Local}}
 
 Returns broken down representation of the date and time.
 
+
 \membersection{wxDateTime::GetTicks}\label{wxdatetimegetticks}
 
 \constfunc{time\_t}{GetTicks}{\void}
 \membersection{wxDateTime::GetTicks}\label{wxdatetimegetticks}
 
 \constfunc{time\_t}{GetTicks}{\void}
@@ -794,54 +858,63 @@ Returns broken down representation of the date and time.
 Returns the number of seconds since Jan 1, 1970. An assert failure will occur
 if the date is not in the range covered by {\tt time\_t} type.
 
 Returns the number of seconds since Jan 1, 1970. An assert failure will occur
 if the date is not in the range covered by {\tt time\_t} type.
 
+
 \membersection{wxDateTime::GetYear}\label{wxdatetimegetyear}
 
 \constfunc{int}{GetYear}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the year in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetYear}\label{wxdatetimegetyear}
 
 \constfunc{int}{GetYear}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the year in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetMonth}\label{wxdatetimegetmonth}
 
 \constfunc{Month}{GetMonth}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the month in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetMonth}\label{wxdatetimegetmonth}
 
 \constfunc{Month}{GetMonth}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the month in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetDay}\label{wxdatetimegetday}
 
 \constfunc{wxDateTime\_t}{GetDay}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the day in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetDay}\label{wxdatetimegetday}
 
 \constfunc{wxDateTime\_t}{GetDay}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the day in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetWeekDay}\label{wxdatetimegetweekday}
 
 \constfunc{WeekDay}{GetWeekDay}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the week day in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetWeekDay}\label{wxdatetimegetweekday}
 
 \constfunc{WeekDay}{GetWeekDay}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the week day in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetHour}\label{wxdatetimegethour}
 
 \constfunc{wxDateTime\_t}{GetHour}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the hour in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetHour}\label{wxdatetimegethour}
 
 \constfunc{wxDateTime\_t}{GetHour}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the hour in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetMinute}\label{wxdatetimegetminute}
 
 \constfunc{wxDateTime\_t}{GetMinute}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the minute in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetMinute}\label{wxdatetimegetminute}
 
 \constfunc{wxDateTime\_t}{GetMinute}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the minute in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetSecond}\label{wxdatetimegetsecond}
 
 \constfunc{wxDateTime\_t}{GetSecond}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the seconds in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetSecond}\label{wxdatetimegetsecond}
 
 \constfunc{wxDateTime\_t}{GetSecond}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the seconds in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetMillisecond}\label{wxdatetimegetmillisecond}
 
 \constfunc{wxDateTime\_t}{GetMillisecond}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the milliseconds in the given timezone (local one by default).
 
 \membersection{wxDateTime::GetMillisecond}\label{wxdatetimegetmillisecond}
 
 \constfunc{wxDateTime\_t}{GetMillisecond}{\param{const TimeZone\& }{tz = Local}}
 
 Returns the milliseconds in the given timezone (local one by default).
 
+
 \membersection{wxDateTime::GetDayOfYear}\label{wxdatetimegetdayofyear}
 
 \constfunc{wxDateTime\_t}{GetDayOfYear}{\param{const TimeZone\& }{tz = Local}}
 \membersection{wxDateTime::GetDayOfYear}\label{wxdatetimegetdayofyear}
 
 \constfunc{wxDateTime\_t}{GetDayOfYear}{\param{const TimeZone\& }{tz = Local}}
@@ -849,16 +922,23 @@ Returns the milliseconds in the given timezone (local one by default).
 Returns the day of the year (in $1\ldots366$ range) in the given timezone
 (local one by default).
 
 Returns the day of the year (in $1\ldots366$ range) in the given timezone
 (local one by default).
 
+
 \membersection{wxDateTime::GetWeekOfYear}\label{wxdatetimegetweekofyear}
 
 \constfunc{wxDateTime\_t}{GetWeekOfYear}{\param{WeekFlags }{flags = Monday\_First}, \param{const TimeZone\& }{tz = Local}}
 
 Returns the number of the week of the year this date is in. The first week of
 \membersection{wxDateTime::GetWeekOfYear}\label{wxdatetimegetweekofyear}
 
 \constfunc{wxDateTime\_t}{GetWeekOfYear}{\param{WeekFlags }{flags = Monday\_First}, \param{const TimeZone\& }{tz = Local}}
 
 Returns the number of the week of the year this date is in. The first week of
-the year is, according to international standards, the one containing Jan 4.
-The week number is in $1\ldots53$ range ($52$ for non leap years).
+the year is, according to international standards, the one containing Jan 4 or,
+equivalently, the first week which has Thursday in this year. Both of these
+definitions are the same as saying that the first week of the year must contain
+more than half of its days in this year. Accordingly, the week number will
+always be in $1\ldots53$ range ($52$ for non leap years).
 
 The function depends on the \helpref{week start}{wxdatetime} convention
 
 The function depends on the \helpref{week start}{wxdatetime} convention
-specified by the {\it flags} argument.
+specified by the {\it flags} argument but its results for
+\texttt{Sunday\_First} are not well-defined as the ISO definition quoted above
+applies to the weeks starting on Monday only.
+
 
 \membersection{wxDateTime::GetWeekOfMonth}\label{wxdatetimegetweekofmonth}
 
 
 \membersection{wxDateTime::GetWeekOfMonth}\label{wxdatetimegetweekofmonth}
 
@@ -870,58 +950,66 @@ As \helpref{GetWeekOfYear}{wxdatetimegetweekofyear}, this function supports
 both conventions for the week start. See the description of these
 \helpref{week start}{wxdatetime} conventions.
 
 both conventions for the week start. See the description of these
 \helpref{week start}{wxdatetime} conventions.
 
+
 \membersection{wxDateTime::IsWorkDay}\label{wxdatetimeisworkday}
 
 \constfunc{bool}{IsWorkDay}{\param{Country }{country = Country\_Default}}
 
 Returns {\tt true} is this day is not a holiday in the given country.
 
 \membersection{wxDateTime::IsWorkDay}\label{wxdatetimeisworkday}
 
 \constfunc{bool}{IsWorkDay}{\param{Country }{country = Country\_Default}}
 
 Returns {\tt true} is this day is not a holiday in the given country.
 
+
 \membersection{wxDateTime::IsGregorianDate}\label{wxdatetimeisgregoriandate}
 
 \constfunc{bool}{IsGregorianDate}{\param{GregorianAdoption }{country = Gr\_Standard}}
 
 \membersection{wxDateTime::IsGregorianDate}\label{wxdatetimeisgregoriandate}
 
 \constfunc{bool}{IsGregorianDate}{\param{GregorianAdoption }{country = Gr\_Standard}}
 
-Returns {\tt true} if the given date os later than the date of adoption of the
+Returns {\tt true} if the given date is later than the date of adoption of the
 Gregorian calendar in the given country (and hence the Gregorian calendar
 calculations make sense for it).
 
 %%%%%%%%%%%%%%%%%%%%%% dos date and time format %%%%%%%%%%%%%%%%%%%%%%%
 
 Gregorian calendar in the given country (and hence the Gregorian calendar
 calculations make sense for it).
 
 %%%%%%%%%%%%%%%%%%%%%% dos date and time format %%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::SetFromDOS}\label{wxdatetimesetfromdos}
 
 \func{wxDateTime\&}{Set}{\param{unsigned long }{ddt}}
 
 \membersection{wxDateTime::SetFromDOS}\label{wxdatetimesetfromdos}
 
 \func{wxDateTime\&}{Set}{\param{unsigned long }{ddt}}
 
-Sets the date from the date and time in 
-\urlref{DOS}{http://developer.novell.com/ndk/doc/smscomp/index.html?page=/ndk/doc/smscomp/sms\_docs/data/hc2vlu5i.html} 
+Sets the date from the date and time in
+\urlref{DOS}{http://developer.novell.com/ndk/doc/smscomp/index.html?page=/ndk/doc/smscomp/sms\_docs/data/hc2vlu5i.html}
 format.
 
 format.
 
+
 \membersection{wxDateTime::GetAsDOS}\label{wxdatetimegetasdos}
 
 \constfunc{unsigned long}{GetAsDOS}{\void}
 
 \membersection{wxDateTime::GetAsDOS}\label{wxdatetimegetasdos}
 
 \constfunc{unsigned long}{GetAsDOS}{\void}
 
-Returns the date and time in 
-\urlref{DOS}{http://developer.novell.com/ndk/doc/smscomp/index.html?page=/ndk/doc/smscomp/sms\_docs/data/hc2vlu5i.html} 
+Returns the date and time in
+\urlref{DOS}{http://developer.novell.com/ndk/doc/smscomp/index.html?page=/ndk/doc/smscomp/sms\_docs/data/hc2vlu5i.html}
 format.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% comparison %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 format.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% comparison %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::IsEqualTo}\label{wxdatetimeisequalto}
 
 \constfunc{bool}{IsEqualTo}{\param{const wxDateTime\& }{datetime}}
 
 Returns {\tt true} if the two dates are strictly identical.
 
 \membersection{wxDateTime::IsEqualTo}\label{wxdatetimeisequalto}
 
 \constfunc{bool}{IsEqualTo}{\param{const wxDateTime\& }{datetime}}
 
 Returns {\tt true} if the two dates are strictly identical.
 
+
 \membersection{wxDateTime::IsEarlierThan}\label{wxdatetimeisearlierthan}
 
 \constfunc{bool}{IsEarlierThan}{\param{const wxDateTime\& }{datetime}}
 
 Returns {\tt true} if this date precedes the given one.
 
 \membersection{wxDateTime::IsEarlierThan}\label{wxdatetimeisearlierthan}
 
 \constfunc{bool}{IsEarlierThan}{\param{const wxDateTime\& }{datetime}}
 
 Returns {\tt true} if this date precedes the given one.
 
+
 \membersection{wxDateTime::IsLaterThan}\label{wxdatetimeislaterthan}
 
 \constfunc{bool}{IsLaterThan}{\param{const wxDateTime\& }{datetime}}
 
 Returns {\tt true} if this date is later than the given one.
 
 \membersection{wxDateTime::IsLaterThan}\label{wxdatetimeislaterthan}
 
 \constfunc{bool}{IsLaterThan}{\param{const wxDateTime\& }{datetime}}
 
 Returns {\tt true} if this date is later than the given one.
 
+
 \membersection{wxDateTime::IsStrictlyBetween}\label{wxdatetimeisstrictlybetween}
 
 \constfunc{bool}{IsStrictlyBetween}{\param{const wxDateTime\& }{t1}, \param{const wxDateTime\& }{t2}}
 \membersection{wxDateTime::IsStrictlyBetween}\label{wxdatetimeisstrictlybetween}
 
 \constfunc{bool}{IsStrictlyBetween}{\param{const wxDateTime\& }{t1}, \param{const wxDateTime\& }{t2}}
@@ -932,6 +1020,7 @@ Returns {\tt true} if this date lies strictly between the two others,
 
 \helpref{IsBetween}{wxdatetimeisbetween}
 
 
 \helpref{IsBetween}{wxdatetimeisbetween}
 
+
 \membersection{wxDateTime::IsBetween}\label{wxdatetimeisbetween}
 
 \constfunc{bool}{IsBetween}{\param{const wxDateTime\& }{t1}, \param{const wxDateTime\& }{t2}}
 \membersection{wxDateTime::IsBetween}\label{wxdatetimeisbetween}
 
 \constfunc{bool}{IsBetween}{\param{const wxDateTime\& }{t1}, \param{const wxDateTime\& }{t2}}
@@ -943,18 +1032,21 @@ is {\tt true} or if the date is equal to one of the limit values.
 
 \helpref{IsStrictlyBetween}{wxdatetimeisstrictlybetween}
 
 
 \helpref{IsStrictlyBetween}{wxdatetimeisstrictlybetween}
 
+
 \membersection{wxDateTime::IsSameDate}\label{wxdatetimeissamedate}
 
 \constfunc{bool}{IsSameDate}{\param{const wxDateTime\& }{dt}}
 
 Returns {\tt true} if the date is the same without comparing the time parts.
 
 \membersection{wxDateTime::IsSameDate}\label{wxdatetimeissamedate}
 
 \constfunc{bool}{IsSameDate}{\param{const wxDateTime\& }{dt}}
 
 Returns {\tt true} if the date is the same without comparing the time parts.
 
+
 \membersection{wxDateTime::IsSameTime}\label{wxdatetimeissametime}
 
 \constfunc{bool}{IsSameTime}{\param{const wxDateTime\& }{dt}}
 
 Returns {\tt true} if the time is the same (although dates may differ).
 
 \membersection{wxDateTime::IsSameTime}\label{wxdatetimeissametime}
 
 \constfunc{bool}{IsSameTime}{\param{const wxDateTime\& }{dt}}
 
 Returns {\tt true} if the time is the same (although dates may differ).
 
+
 \membersection{wxDateTime::IsEqualUpTo}\label{wxdatetimeisequalupto}
 
 \constfunc{bool}{IsEqualUpTo}{\param{const wxDateTime\& }{dt}, \param{const wxTimeSpan\& }{ts}}
 \membersection{wxDateTime::IsEqualUpTo}\label{wxdatetimeisequalupto}
 
 \constfunc{bool}{IsEqualUpTo}{\param{const wxDateTime\& }{dt}, \param{const wxTimeSpan\& }{ts}}
@@ -965,6 +1057,7 @@ this interval.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% arithmetics %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% arithmetics %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::Add}\label{wxdatetimeaddts}
 
 \constfunc{wxDateTime}{Add}{\param{const wxTimeSpan\& }{diff}}
 \membersection{wxDateTime::Add}\label{wxdatetimeaddts}
 
 \constfunc{wxDateTime}{Add}{\param{const wxTimeSpan\& }{diff}}
@@ -978,6 +1071,7 @@ Adds the given time span to this object.
 \pythonnote{This method is named {\tt AddTS} in wxPython.}
 
 
 \pythonnote{This method is named {\tt AddTS} in wxPython.}
 
 
+
 \membersection{wxDateTime::Add}\label{wxdatetimeaddds}
 
 \constfunc{wxDateTime}{Add}{\param{const wxDateSpan\& }{diff}}
 \membersection{wxDateTime::Add}\label{wxdatetimeaddds}
 
 \constfunc{wxDateTime}{Add}{\param{const wxDateSpan\& }{diff}}
@@ -991,6 +1085,7 @@ Adds the given date span to this object.
 \pythonnote{This method is named {\tt AddDS} in wxPython.}
 
 
 \pythonnote{This method is named {\tt AddDS} in wxPython.}
 
 
+
 \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractts}
 
 \constfunc{wxDateTime}{Subtract}{\param{const wxTimeSpan\& }{diff}}
 \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractts}
 
 \constfunc{wxDateTime}{Subtract}{\param{const wxTimeSpan\& }{diff}}
@@ -1004,6 +1099,7 @@ Subtracts the given time span from this object.
 \pythonnote{This method is named {\tt SubtractTS} in wxPython.}
 
 
 \pythonnote{This method is named {\tt SubtractTS} in wxPython.}
 
 
+
 \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractds}
 
 \constfunc{wxDateTime}{Subtract}{\param{const wxDateSpan\& }{diff}}
 \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractds}
 
 \constfunc{wxDateTime}{Subtract}{\param{const wxDateSpan\& }{diff}}
@@ -1017,6 +1113,7 @@ Subtracts the given date span from this object.
 \pythonnote{This method is named {\tt SubtractDS} in wxPython.}
 
 
 \pythonnote{This method is named {\tt SubtractDS} in wxPython.}
 
 
+
 \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractdt}
 
 \constfunc{wxTimeSpan}{Subtract}{\param{const wxDateTime\& }{dt}}
 \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractdt}
 
 \constfunc{wxTimeSpan}{Subtract}{\param{const wxDateTime\& }{dt}}
@@ -1026,6 +1123,7 @@ as wxTimeSpan.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% parsing/formatting %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% parsing/formatting %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::ParseRfc822Date}\label{wxdatetimeparserfc822date}
 
 \func{const wxChar *}{ParseRfc822Date}{\param{const wxChar* }{date}}
 \membersection{wxDateTime::ParseRfc822Date}\label{wxdatetimeparserfc822date}
 
 \func{const wxChar *}{ParseRfc822Date}{\param{const wxChar* }{date}}
@@ -1046,29 +1144,32 @@ which is not RFC 822 compliant. If you need to parse date formatted in more
 free ways, you should use \helpref{ParseDateTime}{wxdatetimeparsedatetime} or
 \helpref{ParseDate}{wxdatetimeparsedate} instead.
 
 free ways, you should use \helpref{ParseDateTime}{wxdatetimeparsedatetime} or
 \helpref{ParseDate}{wxdatetimeparsedate} instead.
 
+
 \membersection{wxDateTime::ParseFormat}\label{wxdatetimeparseformat}
 
 \membersection{wxDateTime::ParseFormat}\label{wxdatetimeparseformat}
 
-\func{const wxChar *}{ParseFormat}{\param{const wxChar *}{date}, \param{const wxChar *}{format = "\%c"}, \param{const wxDateTime\& }{dateDef = wxDefaultDateTime}}
+\func{const wxChar *}{ParseFormat}{\param{const wxChar *}{date}, \param{const wxChar *}{format = wxDefaultDateTimeFormat}, \param{const wxDateTime\& }{dateDef = wxDefaultDateTime}}
 
 This function parses the string {\it date} according to the given
 {\it format}. The system {\tt strptime(3)} function is used whenever available,
 
 This function parses the string {\it date} according to the given
 {\it format}. The system {\tt strptime(3)} function is used whenever available,
-but even if it is not, this function is still implemented (although support
-for locale-dependent format specificators such as {\tt "\%c"}, {\tt "\%x"} or
-{\tt "\%X"} may be not perfect). This function does handle the month and
-weekday names in the current locale on all platforms, however.
+but even if it is not, this function is still implemented, although support
+for locale-dependent format specifiers such as {\tt "\%c"}, {\tt "\%x"} or {\tt "\%X"} may
+not be perfect and GNU extensions such as {\tt "\%z"} and {\tt "\%Z"} are
+not implemented. This function does handle the month and weekday
+names in the current locale on all platforms, however.
 
 
-Please the description of ANSI C function {\tt strftime(3)} for the syntax of
-the format string.
+Please see the description of the ANSI C function {\tt strftime(3)} for the syntax
+of the format string.
 
 The {\it dateDef} parameter is used to fill in the fields which could not be
 
 The {\it dateDef} parameter is used to fill in the fields which could not be
-determined from the format string. For example, if the format is {\tt "\%d"}
-(the day of the month), the month and the year are taken from {\it dateDef}.
-If it is not specified, \helpref{Today}{wxdatetimetoday} is used as the
+determined from the format string. For example, if the format is {\tt "\%d"} (the
+ay of the month), the month and the year are taken from {\it dateDef}. If
+it is not specified, \helpref{Today}{wxdatetimetoday} is used as the
 default date.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 the character which stopped the scan.
 
 default date.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 the character which stopped the scan.
 
+
 \membersection{wxDateTime::ParseDateTime}\label{wxdatetimeparsedatetime}
 
 \func{const wxChar *}{ParseDateTime}{\param{const wxChar *}{datetime}}
 \membersection{wxDateTime::ParseDateTime}\label{wxdatetimeparsedatetime}
 
 \func{const wxChar *}{ParseDateTime}{\param{const wxChar *}{datetime}}
@@ -1080,20 +1181,23 @@ will accept anything that may be accepted and will only reject strings which
 can not be parsed in any way at all.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 can not be parsed in any way at all.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
-the character which stopped the scan.
+the character which stopped the scan.  This method is currently not
+implemented, so always returns NULL.
+
 
 \membersection{wxDateTime::ParseDate}\label{wxdatetimeparsedate}
 
 \func{const wxChar *}{ParseDate}{\param{const wxChar *}{date}}
 
 This function is like \helpref{ParseDateTime}{wxdatetimeparsedatetime}, but it
 
 \membersection{wxDateTime::ParseDate}\label{wxdatetimeparsedate}
 
 \func{const wxChar *}{ParseDate}{\param{const wxChar *}{date}}
 
 This function is like \helpref{ParseDateTime}{wxdatetimeparsedatetime}, but it
-only allows the date to be specified. It is thus less flexible then 
+only allows the date to be specified. It is thus less flexible then
 \helpref{ParseDateTime}{wxdatetimeparsedatetime}, but also has less chances to
 misinterpret the user input.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 the character which stopped the scan.
 
 \helpref{ParseDateTime}{wxdatetimeparsedatetime}, but also has less chances to
 misinterpret the user input.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 the character which stopped the scan.
 
+
 \membersection{wxDateTime::ParseTime}\label{wxdatetimeparsetime}
 
 \func{const wxChar *}{ParseTime}{\param{const wxChar *}{time}}
 \membersection{wxDateTime::ParseTime}\label{wxdatetimeparsetime}
 
 \func{const wxChar *}{ParseTime}{\param{const wxChar *}{time}}
@@ -1104,14 +1208,15 @@ only allows the time to be specified in the input string.
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 the character which stopped the scan.
 
 Returns {\tt NULL} if the conversion failed, otherwise return the pointer to
 the character which stopped the scan.
 
+
 \membersection{wxDateTime::Format}\label{wxdatetimeformat}
 
 \membersection{wxDateTime::Format}\label{wxdatetimeformat}
 
-\constfunc{wxString }{Format}{\param{const wxChar *}{format = "\%c"}, \param{const TimeZone\& }{tz = Local}}
+\constfunc{wxString }{Format}{\param{const wxChar *}{format = wxDefaultDateTimeFormat}, \param{const TimeZone\& }{tz = Local}}
 
 This function does the same as the standard ANSI C {\tt strftime(3)} function.
 Please see its description for the meaning of {\it format} parameter.
 
 
 This function does the same as the standard ANSI C {\tt strftime(3)} function.
 Please see its description for the meaning of {\it format} parameter.
 
-It also accepts a few wxWindows-specific extensions: you can optionally specify
+It also accepts a few wxWidgets-specific extensions: you can optionally specify
 the width of the field to follow using {\tt printf(3)}-like syntax and the
 format specification {\tt \%l} can be used to get the number of milliseconds.
 
 the width of the field to follow using {\tt printf(3)}-like syntax and the
 format specification {\tt \%l} can be used to get the number of milliseconds.
 
@@ -1119,6 +1224,7 @@ format specification {\tt \%l} can be used to get the number of milliseconds.
 
 \helpref{ParseFormat}{wxdatetimeparseformat}
 
 
 \helpref{ParseFormat}{wxdatetimeparseformat}
 
+
 \membersection{wxDateTime::FormatDate}\label{wxdatetimeformatdate}
 
 \constfunc{wxString }{FormatDate}{\void}
 \membersection{wxDateTime::FormatDate}\label{wxdatetimeformatdate}
 
 \constfunc{wxString }{FormatDate}{\void}
@@ -1126,6 +1232,7 @@ format specification {\tt \%l} can be used to get the number of milliseconds.
 Identical to calling \helpref{Format()}{wxdatetimeformat} with {\tt "\%x"}
 argument (which means `preferred date representation for the current locale').
 
 Identical to calling \helpref{Format()}{wxdatetimeformat} with {\tt "\%x"}
 argument (which means `preferred date representation for the current locale').
 
+
 \membersection{wxDateTime::FormatTime}\label{wxdatetimeformattime}
 
 \constfunc{wxString }{FormatTime}{\void}
 \membersection{wxDateTime::FormatTime}\label{wxdatetimeformattime}
 
 \constfunc{wxString }{FormatTime}{\void}
@@ -1133,6 +1240,7 @@ argument (which means `preferred date representation for the current locale').
 Identical to calling \helpref{Format()}{wxdatetimeformat} with {\tt "\%X"}
 argument (which means `preferred time representation for the current locale').
 
 Identical to calling \helpref{Format()}{wxdatetimeformat} with {\tt "\%X"}
 argument (which means `preferred time representation for the current locale').
 
+
 \membersection{wxDateTime::FormatISODate}\label{wxdatetimeformatisodate}
 
 \constfunc{wxString }{FormatISODate}{\void}
 \membersection{wxDateTime::FormatISODate}\label{wxdatetimeformatisodate}
 
 \constfunc{wxString }{FormatISODate}{\void}
@@ -1140,6 +1248,7 @@ argument (which means `preferred time representation for the current locale').
 This function returns the date representation in the ISO 8601 format
 (YYYY-MM-DD).
 
 This function returns the date representation in the ISO 8601 format
 (YYYY-MM-DD).
 
+
 \membersection{wxDateTime::FormatISOTime}\label{wxdatetimeformatisotime}
 
 \constfunc{wxString }{FormatISOTime}{\void}
 \membersection{wxDateTime::FormatISOTime}\label{wxdatetimeformatisotime}
 
 \constfunc{wxString }{FormatISOTime}{\void}
@@ -1149,6 +1258,7 @@ This function returns the time representation in the ISO 8601 format
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% calendar calculations %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% calendar calculations %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::SetToWeekDayInSameWeek}\label{wxdatetimesettoweekdayinsameweek}
 
 \func{wxDateTime\&}{SetToWeekDayInSameWeek}{\param{WeekDay }{weekday}, \param{WeekFlags}{flags = {\tt Monday\_First}}}
 \membersection{wxDateTime::SetToWeekDayInSameWeek}\label{wxdatetimesettoweekdayinsameweek}
 
 \func{wxDateTime\&}{SetToWeekDayInSameWeek}{\param{WeekDay }{weekday}, \param{WeekFlags}{flags = {\tt Monday\_First}}}
@@ -1158,14 +1268,16 @@ week day will be the given one.
 
 Returns the reference to the modified object itself.
 
 
 Returns the reference to the modified object itself.
 
+
 \membersection{wxDateTime::GetWeekDayInSameWeek}\label{wxdatetimegetweekdayinsameweek}
 
 \constfunc{wxDateTime}{GetWeekDayInSameWeek}{\param{WeekDay }{weekday}, \param{WeekFlags}{flags = {\tt Monday\_First}}}
 
 \membersection{wxDateTime::GetWeekDayInSameWeek}\label{wxdatetimegetweekdayinsameweek}
 
 \constfunc{wxDateTime}{GetWeekDayInSameWeek}{\param{WeekDay }{weekday}, \param{WeekFlags}{flags = {\tt Monday\_First}}}
 
-Returns the copy of this object to which 
+Returns the copy of this object to which
 \helpref{SetToWeekDayInSameWeek}{wxdatetimesettoweekdayinsameweek} was
 applied.
 
 \helpref{SetToWeekDayInSameWeek}{wxdatetimesettoweekdayinsameweek} was
 applied.
 
+
 \membersection{wxDateTime::SetToNextWeekDay}\label{wxdatetimesettonextweekday}
 
 \func{wxDateTime\&}{SetToNextWeekDay}{\param{WeekDay }{weekday}}
 \membersection{wxDateTime::SetToNextWeekDay}\label{wxdatetimesettonextweekday}
 
 \func{wxDateTime\&}{SetToNextWeekDay}{\param{WeekDay }{weekday}}
@@ -1175,6 +1287,7 @@ date.
 
 Returns the reference to the modified object itself.
 
 
 Returns the reference to the modified object itself.
 
+
 \membersection{wxDateTime::GetNextWeekDay}\label{wxdatetimegetnextweekday}
 
 \constfunc{wxDateTime}{GetNextWeekDay}{\param{WeekDay }{weekday}}
 \membersection{wxDateTime::GetNextWeekDay}\label{wxdatetimegetnextweekday}
 
 \constfunc{wxDateTime}{GetNextWeekDay}{\param{WeekDay }{weekday}}
@@ -1182,6 +1295,7 @@ Returns the reference to the modified object itself.
 Returns the copy of this object to which
 \helpref{SetToNextWeekDay}{wxdatetimesettonextweekday} was applied.
 
 Returns the copy of this object to which
 \helpref{SetToNextWeekDay}{wxdatetimesettonextweekday} was applied.
 
+
 \membersection{wxDateTime::SetToPrevWeekDay}\label{wxdatetimesettoprevweekday}
 
 \func{wxDateTime\&}{SetToPrevWeekDay}{\param{WeekDay }{weekday}}
 \membersection{wxDateTime::SetToPrevWeekDay}\label{wxdatetimesettoprevweekday}
 
 \func{wxDateTime\&}{SetToPrevWeekDay}{\param{WeekDay }{weekday}}
@@ -1191,6 +1305,7 @@ date.
 
 Returns the reference to the modified object itself.
 
 
 Returns the reference to the modified object itself.
 
+
 \membersection{wxDateTime::GetPrevWeekDay}\label{wxdatetimegetprevweekday}
 
 \constfunc{wxDateTime}{GetPrevWeekDay}{\param{WeekDay }{weekday}}
 \membersection{wxDateTime::GetPrevWeekDay}\label{wxdatetimegetprevweekday}
 
 \constfunc{wxDateTime}{GetPrevWeekDay}{\param{WeekDay }{weekday}}
@@ -1198,6 +1313,7 @@ Returns the reference to the modified object itself.
 Returns the copy of this object to which
 \helpref{SetToPrevWeekDay}{wxdatetimesettoprevweekday} was applied.
 
 Returns the copy of this object to which
 \helpref{SetToPrevWeekDay}{wxdatetimesettoprevweekday} was applied.
 
+
 \membersection{wxDateTime::SetToWeekDay}\label{wxdatetimesettoweekday}
 
 \func{bool}{SetToWeekDay}{\param{WeekDay }{weekday}, \param{int }{n = 1}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
 \membersection{wxDateTime::SetToWeekDay}\label{wxdatetimesettoweekday}
 
 \func{bool}{SetToWeekDay}{\param{WeekDay }{weekday}, \param{int }{n = 1}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
@@ -1214,6 +1330,7 @@ second Wednesday in the current month and
 Returns {\tt true} if the date was modified successfully, {\tt false}
 otherwise meaning that the specified date doesn't exist.
 
 Returns {\tt true} if the date was modified successfully, {\tt false}
 otherwise meaning that the specified date doesn't exist.
 
+
 \membersection{wxDateTime::GetWeekDay}\label{wxdatetimegetweekday2}
 
 \constfunc{wxDateTime}{GetWeekDay}{\param{WeekDay }{weekday}, \param{int }{n = 1}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
 \membersection{wxDateTime::GetWeekDay}\label{wxdatetimegetweekday2}
 
 \constfunc{wxDateTime}{GetWeekDay}{\param{WeekDay }{weekday}, \param{int }{n = 1}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
@@ -1221,6 +1338,7 @@ otherwise meaning that the specified date doesn't exist.
 Returns the copy of this object to which
 \helpref{SetToWeekDay}{wxdatetimesettoweekday} was applied.
 
 Returns the copy of this object to which
 \helpref{SetToWeekDay}{wxdatetimesettoweekday} was applied.
 
+
 \membersection{wxDateTime::SetToLastWeekDay}\label{wxdatetimesettolastweekday}
 
 \func{bool}{SetToLastWeekDay}{\param{WeekDay }{weekday}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
 \membersection{wxDateTime::SetToLastWeekDay}\label{wxdatetimesettolastweekday}
 
 \func{bool}{SetToLastWeekDay}{\param{WeekDay }{weekday}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
@@ -1231,6 +1349,7 @@ The effect of calling this function is the same as of calling
 
 Always returns {\tt true}.
 
 
 Always returns {\tt true}.
 
+
 \membersection{wxDateTime::GetLastWeekDay}\label{wxdatetimegetlastweekday}
 
 \func{wxDateTime}{GetLastWeekDay}{\param{WeekDay }{weekday}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
 \membersection{wxDateTime::GetLastWeekDay}\label{wxdatetimegetlastweekday}
 
 \func{wxDateTime}{GetLastWeekDay}{\param{WeekDay }{weekday}, \param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
@@ -1238,21 +1357,20 @@ Always returns {\tt true}.
 Returns the copy of this object to which
 \helpref{SetToLastWeekDay}{wxdatetimesettolastweekday} was applied.
 
 Returns the copy of this object to which
 \helpref{SetToLastWeekDay}{wxdatetimesettolastweekday} was applied.
 
-\membersection{wxDateTime::SetToTheWeek}\label{wxdatetimesettotheweek}
 
 
-\func{bool}{SetToTheWeek}{\param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}, \param{WeekFlags}{flags = {\tt Monday\_First}}}
+\membersection{wxDateTime::SetToWeekOfYear}\label{wxdatetimesettoweekofyear}
 
 
-Set the date to the given {\it weekday} in the week with given number
-{\it numWeek}. The number should be in range $1\ldots53$ and {\tt false} will
-be returned if the specified date doesn't exist. {\tt true} is returned if the
-date was changed successfully.
+\func{static wxDateTime}{SetToWeekOfYear}{\param{int }{year}, \param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}}
 
 
-\membersection{wxDateTime::GetWeek}\label{wxdatetimegetweek}
+Set the date to the given \arg{weekday} in the week number \arg{numWeek} of the
+given \arg{year} . The number should be in range $1\ldots53$.
 
 
-\constfunc{wxDateTime}{GetWeek}{\param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}, \param{WeekFlags}{flags = {\tt Monday\_First}}}
+Note that the returned date may be in a different year than the one passed to
+this function because both the week $1$ and week $52$ or $53$ (for leap years)
+contain days from different years. See
+\helpref{GetWeekOfYear}{wxdatetimegetweekofyear} for the explanation of how the
+year weeks are counted.
 
 
-Returns the copy of this object to which
-\helpref{SetToTheWeek}{wxdatetimesettotheweek} was applied.
 
 \membersection{wxDateTime::SetToLastMonthDay}\label{wxdatetimesettolastmonthday}
 
 
 \membersection{wxDateTime::SetToLastMonthDay}\label{wxdatetimesettolastmonthday}
 
@@ -1263,6 +1381,7 @@ default).
 
 Returns the reference to the modified object itself.
 
 
 Returns the reference to the modified object itself.
 
+
 \membersection{wxDateTime::GetLastMonthDay}\label{wxdatetimegetlastmonthday}
 
 \constfunc{wxDateTime}{GetLastMonthDay}{\param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
 \membersection{wxDateTime::GetLastMonthDay}\label{wxdatetimegetlastmonthday}
 
 \constfunc{wxDateTime}{GetLastMonthDay}{\param{Month }{month = Inv\_Month}, \param{int }{year = Inv\_Year}}
@@ -1270,6 +1389,7 @@ Returns the reference to the modified object itself.
 Returns the copy of this object to which
 \helpref{SetToLastMonthDay}{wxdatetimesettolastmonthday} was applied.
 
 Returns the copy of this object to which
 \helpref{SetToLastMonthDay}{wxdatetimesettolastmonthday} was applied.
 
+
 \membersection{wxDateTime::SetToYearDay}\label{wxdatetimesettoyearday}
 
 \func{wxDateTime\&}{SetToYearDay}{\param{wxDateTime\_t }{yday}}
 \membersection{wxDateTime::SetToYearDay}\label{wxdatetimesettoyearday}
 
 \func{wxDateTime\&}{SetToYearDay}{\param{wxDateTime\_t }{yday}}
@@ -1281,6 +1401,7 @@ the other ones.
 
 Returns the reference to the modified object itself.
 
 
 Returns the reference to the modified object itself.
 
+
 \membersection{wxDateTime::GetYearDay}\label{wxdatetimegetyearday}
 
 \constfunc{wxDateTime}{GetYearDay}{\param{wxDateTime\_t }{yday}}
 \membersection{wxDateTime::GetYearDay}\label{wxdatetimegetyearday}
 
 \constfunc{wxDateTime}{GetYearDay}{\param{wxDateTime\_t }{yday}}
@@ -1290,6 +1411,7 @@ Returns the copy of this object to which
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% astronomical functions %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% astronomical functions %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::GetJulianDayNumber}\label{wxdatetimegetjuliandaynumber}
 
 \constfunc{double}{GetJulianDayNumber}{\void}
 \membersection{wxDateTime::GetJulianDayNumber}\label{wxdatetimegetjuliandaynumber}
 
 \constfunc{double}{GetJulianDayNumber}{\void}
@@ -1301,12 +1423,14 @@ of rounding errors!
 
 \helpref{GetModifiedJulianDayNumber}{wxdatetimegetmodifiedjuliandaynumber}
 
 
 \helpref{GetModifiedJulianDayNumber}{wxdatetimegetmodifiedjuliandaynumber}
 
+
 \membersection{wxDateTime::GetJDN}\label{wxdatetimegetjdn}
 
 \constfunc{double}{GetJDN}{\void}
 
 Synonym for \helpref{GetJulianDayNumber}{wxdatetimegetjuliandaynumber}.
 
 \membersection{wxDateTime::GetJDN}\label{wxdatetimegetjdn}
 
 \constfunc{double}{GetJDN}{\void}
 
 Synonym for \helpref{GetJulianDayNumber}{wxdatetimegetjuliandaynumber}.
 
+
 \membersection{wxDateTime::GetModifiedJulianDayNumber}\label{wxdatetimegetmodifiedjuliandaynumber}
 
 \constfunc{double}{GetModifiedJulianDayNumber}{\void}
 \membersection{wxDateTime::GetModifiedJulianDayNumber}\label{wxdatetimegetmodifiedjuliandaynumber}
 
 \constfunc{double}{GetModifiedJulianDayNumber}{\void}
@@ -1316,12 +1440,14 @@ equal to $JDN - 2400000.5$. The MJDs are simpler to work with as the integral
 MJDs correspond to midnights of the dates in the Gregorian calendar and not th
 noons like JDN. The MJD $0$ is Nov 17, 1858.
 
 MJDs correspond to midnights of the dates in the Gregorian calendar and not th
 noons like JDN. The MJD $0$ is Nov 17, 1858.
 
+
 \membersection{wxDateTime::GetMJD}\label{wxdatetimegetmjd}
 
 \constfunc{double}{GetMJD}{\void}
 
 Synonym for \helpref{GetModifiedJulianDayNumber}{wxdatetimegetmodifiedjuliandaynumber}.
 
 \membersection{wxDateTime::GetMJD}\label{wxdatetimegetmjd}
 
 \constfunc{double}{GetMJD}{\void}
 
 Synonym for \helpref{GetModifiedJulianDayNumber}{wxdatetimegetmodifiedjuliandaynumber}.
 
+
 \membersection{wxDateTime::GetRataDie}\label{wxdatetimegetratadie}
 
 \constfunc{double}{GetRataDie}{\void}
 \membersection{wxDateTime::GetRataDie}\label{wxdatetimegetratadie}
 
 \constfunc{double}{GetRataDie}{\void}
@@ -1334,6 +1460,7 @@ year 1 is Rata Die day 1.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% timezone and DST %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%% timezone and DST %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
+
 \membersection{wxDateTime::ToTimezone}\label{wxdatetimetotimezone}
 
 \constfunc{wxDateTime}{ToTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = false}}
 \membersection{wxDateTime::ToTimezone}\label{wxdatetimetotimezone}
 
 \constfunc{wxDateTime}{ToTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = false}}
@@ -1343,6 +1470,7 @@ DST adjustments will be made.
 
 Returns the date in the new time zone.
 
 
 Returns the date in the new time zone.
 
+
 \membersection{wxDateTime::MakeTimezone}\label{wxdatetimemaketimezone}
 
 \func{wxDateTime\&}{MakeTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = false}}
 \membersection{wxDateTime::MakeTimezone}\label{wxdatetimemaketimezone}
 
 \func{wxDateTime\&}{MakeTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = false}}
@@ -1350,6 +1478,7 @@ Returns the date in the new time zone.
 Modifies the object in place to represent the date in another time zone. If
 {\it noDST} is {\tt true}, no DST adjustments will be made.
 
 Modifies the object in place to represent the date in another time zone. If
 {\it noDST} is {\tt true}, no DST adjustments will be made.
 
+
 \membersection{wxDateTime::ToGMT}\label{wxdatetimetogmt}
 
 \constfunc{wxDateTime}{ToGMT}{\param{bool }{noDST = false}}
 \membersection{wxDateTime::ToGMT}\label{wxdatetimetogmt}
 
 \constfunc{wxDateTime}{ToGMT}{\param{bool }{noDST = false}}
@@ -1357,6 +1486,7 @@ Modifies the object in place to represent the date in another time zone. If
 This is the same as calling \helpref{ToTimezone}{wxdatetimetotimezone} with
 the argument {\tt GMT0}.
 
 This is the same as calling \helpref{ToTimezone}{wxdatetimetotimezone} with
 the argument {\tt GMT0}.
 
+
 \membersection{wxDateTime::MakeGMT}\label{wxdatetimemakegmt}
 
 \func{wxDateTime\&}{MakeGMT}{\param{bool }{noDST = false}}
 \membersection{wxDateTime::MakeGMT}\label{wxdatetimemakegmt}
 
 \func{wxDateTime\&}{MakeGMT}{\param{bool }{noDST = false}}
@@ -1364,6 +1494,7 @@ the argument {\tt GMT0}.
 This is the same as calling \helpref{MakeTimezone}{wxdatetimemaketimezone} with
 the argument {\tt GMT0}.
 
 This is the same as calling \helpref{MakeTimezone}{wxdatetimemaketimezone} with
 the argument {\tt GMT0}.
 
+
 \membersection{wxDateTime::IsDST}\label{wxdatetimeisdst}
 
 \constfunc{int}{IsDST}{\param{Country }{country = Country\_Default}}
 \membersection{wxDateTime::IsDST}\label{wxdatetimeisdst}
 
 \constfunc{int}{IsDST}{\param{Country }{country = Country\_Default}}