X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/cdfb1ae1bcacb8327589a09e6a67f8fc1ef5a82e..42bf070c7e17428344b476fdb500ab85f0b753df:/docs/latex/wx/datetime.tex diff --git a/docs/latex/wx/datetime.tex b/docs/latex/wx/datetime.tex index 3baa8dab1c..eaa45dcfcf 100644 --- a/docs/latex/wx/datetime.tex +++ b/docs/latex/wx/datetime.tex @@ -235,6 +235,7 @@ values were correct as constructors can not return an error code. \helpref{Set(double jdn)}{wxdatetimesetjdn}\\ \helpref{Set(h, m, s, ms)}{wxdatetimesettime}\\ \helpref{Set(day, mon, year, h, m, s, ms)}{wxdatetimesetdate}\\ +\helpref{SetFromDOS(unsigned long ddt)}{wxdatetimesetfromdos}\\ \helpref{ResetTime}{wxdatetimeresettime}\\ \helpref{SetYear}{wxdatetimesetyear}\\ \helpref{SetMonth}{wxdatetimesetmonth}\\ @@ -268,7 +269,8 @@ some more complicated calculations to find the answer are under the \helpref{GetWeekOfMonth}{wxdatetimegetweekofmonth}\\ \helpref{GetYearDay}{wxdatetimegetyearday}\\ \helpref{IsWorkDay}{wxdatetimeisworkday}\\ -\helpref{IsGregorianDate}{wxdatetimeisgregoriandate} +\helpref{IsGregorianDate}{wxdatetimeisgregoriandate}\\ +\helpref{GetAsDOS}{wxdatetimegetasdos} \membersection{Date comparison} @@ -531,7 +533,7 @@ given week day. \func{static bool}{IsLeapYear}{\param{int }{year = Inv\_Year}, \param{Calendar }{cal = Gregorian}} -Returns {\tt TRUE} if the {\it year} is a leap one in the specified calendar. +Returns {\tt true} if the {\it year} is a leap one in the specified calendar. This functions supports Gregorian and Julian calendars. @@ -539,7 +541,7 @@ This functions supports Gregorian and Julian calendars. \func{static bool}{IsWestEuropeanCountry}{\param{Country }{country = Country\_Default}} -This function returns {\tt TRUE} if the specified (or default) country is one +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. @@ -547,7 +549,7 @@ DST convention and date and time formatting rules. \func{static bool}{IsDSTApplicable}{\param{int }{year = Inv\_Year}, \param{Country }{country = Country\_Default}} -Returns {\tt TRUE} if DST was used n the given year (the current one by +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} @@ -777,7 +779,7 @@ Same as \helpref{Set}{wxdatetimesettm}. \constfunc{bool}{IsValid}{\void} -Returns {\tt TRUE} if the object represents a valid time moment. +Returns {\tt true} if the object represents a valid time moment. \membersection{wxDateTime::GetTm}\label{wxdatetimegettm} @@ -872,41 +874,59 @@ both conventions for the week start. See the description of these \constfunc{bool}{IsWorkDay}{\param{Country }{country = Country\_Default}} -Returns {\tt TRUE} is this day is not a holiday in the given country. +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}} -Returns {\tt TRUE} if the given date os later than the date of adoption of the +Returns {\tt true} if the given date os 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 %%%%%%%%%%%%%%%%%%%%%%% + +\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} +format. + +\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} +format. + %%%%%%%%%%%%%%%%%%%%%%%%%%% comparison %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \membersection{wxDateTime::IsEqualTo}\label{wxdatetimeisequalto} \constfunc{bool}{IsEqualTo}{\param{const wxDateTime\& }{datetime}} -Returns {\tt TRUE} if the two dates are strictly identical. +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. +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. +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}} -Returns {\tt TRUE} if this date lies strictly between the two others, +Returns {\tt true} if this date lies strictly between the two others, \wxheading{See also} @@ -916,8 +936,8 @@ Returns {\tt TRUE} if this date lies strictly between the two others, \constfunc{bool}{IsBetween}{\param{const wxDateTime\& }{t1}, \param{const wxDateTime\& }{t2}} -Returns {\tt TRUE} if \helpref{IsStrictlyBetween}{wxdatetimeisstrictlybetween} -is {\tt TRUE} or if the date is equal to one of the limit values. +Returns {\tt true} if \helpref{IsStrictlyBetween}{wxdatetimeisstrictlybetween} +is {\tt true} or if the date is equal to one of the limit values. \wxheading{See also} @@ -927,19 +947,19 @@ is {\tt TRUE} or if the date is equal to one of the limit values. \constfunc{bool}{IsSameDate}{\param{const wxDateTime\& }{dt}} -Returns {\tt TRUE} if the date is the same without comparing the time parts. +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). +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}} -Returns {\tt TRUE} if the date is equal to another one up to the given time +Returns {\tt true} if the date is equal to another one up to the given time interval, i.e. if the absolute difference between the two dates is less than this interval. @@ -957,17 +977,6 @@ Adds the given time span to this object. \pythonnote{This method is named {\tt AddTS} in wxPython.} -\membersection{wxDateTime::Subtract}\label{wxdatetimesubtractts} - -\constfunc{wxDateTime}{Subtract}{\param{const wxTimeSpan\& }{diff}} - -\func{wxDateTime\&}{Subtract}{\param{const wxTimeSpan\& }{diff}} - -\func{wxDateTime\&}{operator$-=$}{\param{const wxTimeSpan\& }{diff}} - -Subtracts the given time span from this object. - -\pythonnote{This method is named {\tt SubtractTS} in wxPython.} \membersection{wxDateTime::Add}\label{wxdatetimeaddds} @@ -981,6 +990,20 @@ Adds the given date span to this object. \pythonnote{This method is named {\tt AddDS} in wxPython.} + +\membersection{wxDateTime::Subtract}\label{wxdatetimesubtractts} + +\constfunc{wxDateTime}{Subtract}{\param{const wxTimeSpan\& }{diff}} + +\func{wxDateTime\&}{Subtract}{\param{const wxTimeSpan\& }{diff}} + +\func{wxDateTime\&}{operator$-=$}{\param{const wxTimeSpan\& }{diff}} + +Subtracts the given time span from this object. + +\pythonnote{This method is named {\tt SubtractTS} in wxPython.} + + \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractds} \constfunc{wxDateTime}{Subtract}{\param{const wxDateSpan\& }{diff}} @@ -993,6 +1016,7 @@ Subtracts the given date span from this object. \pythonnote{This method is named {\tt SubtractDS} in wxPython.} + \membersection{wxDateTime::Subtract}\label{wxdatetimesubtractdt} \constfunc{wxTimeSpan}{Subtract}{\param{const wxDateTime\& }{dt}} @@ -1028,18 +1052,19 @@ free ways, you should use \helpref{ParseDateTime}{wxdatetimeparsedatetime} or 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 -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 @@ -1056,7 +1081,8 @@ 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 -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} @@ -1127,7 +1153,7 @@ This function returns the time representation in the ISO 8601 format \membersection{wxDateTime::SetToWeekDayInSameWeek}\label{wxdatetimesettoweekdayinsameweek} -\func{wxDateTime\&}{SetToWeekDayInSameWeek}{\param{WeekDay }{weekday}} +\func{wxDateTime\&}{SetToWeekDayInSameWeek}{\param{WeekDay }{weekday}, \param{WeekFlags}{flags = {\tt Monday\_First}}} Adjusts the date so that it will still lie in the same week as before, but its week day will be the given one. @@ -1136,9 +1162,9 @@ Returns the reference to the modified object itself. \membersection{wxDateTime::GetWeekDayInSameWeek}\label{wxdatetimegetweekdayinsameweek} -\constfunc{wxDateTime}{GetWeekDayInSameWeek}{\param{WeekDay }{weekday}} +\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. @@ -1187,7 +1213,7 @@ For example, {\tt SetToWeekDay(2, wxDateTime::Wed)} will set the date to the second Wednesday in the current month and {\tt SetToWeekDay(-1, wxDateTime::Sun)} -- to the last Sunday in it. -Returns {\tt TRUE} if the date was modified successfully, {\tt FALSE} +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} @@ -1205,7 +1231,7 @@ The effect of calling this function is the same as of calling {\tt SetToWeekDay(-1, weekday, month, year)}. The date will be set to the last {\it weekday} in the given month and year (the current ones by default). -Always returns {\tt TRUE}. +Always returns {\tt true}. \membersection{wxDateTime::GetLastWeekDay}\label{wxdatetimegetlastweekday} @@ -1216,16 +1242,16 @@ Returns the copy of this object to which \membersection{wxDateTime::SetToTheWeek}\label{wxdatetimesettotheweek} -\func{bool}{SetToTheWeek}{\param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}} +\func{bool}{SetToTheWeek}{\param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}, \param{WeekFlags}{flags = {\tt Monday\_First}}} 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 +{\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. \membersection{wxDateTime::GetWeek}\label{wxdatetimegetweek} -\constfunc{wxDateTime}{GetWeek}{\param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}} +\constfunc{wxDateTime}{GetWeek}{\param{wxDateTime\_t }{numWeek}, \param{WeekDay }{weekday = Mon}, \param{WeekFlags}{flags = {\tt Monday\_First}}} Returns the copy of this object to which \helpref{SetToTheWeek}{wxdatetimesettotheweek} was applied. @@ -1312,30 +1338,30 @@ year 1 is Rata Die day 1. \membersection{wxDateTime::ToTimezone}\label{wxdatetimetotimezone} -\constfunc{wxDateTime}{ToTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = FALSE}} +\constfunc{wxDateTime}{ToTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = false}} -Transform the date to the given time zone. If {\it noDST} is {\tt TRUE}, no +Transform the date to the given time zone. If {\it noDST} is {\tt true}, no DST adjustments will be made. Returns the date in the new time zone. \membersection{wxDateTime::MakeTimezone}\label{wxdatetimemaketimezone} -\func{wxDateTime\&}{MakeTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = FALSE}} +\func{wxDateTime\&}{MakeTimezone}{\param{const TimeZone\& }{tz}, \param{bool }{noDST = false}} 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. +{\it noDST} is {\tt true}, no DST adjustments will be made. \membersection{wxDateTime::ToGMT}\label{wxdatetimetogmt} -\constfunc{wxDateTime}{ToGMT}{\param{bool }{noDST = FALSE}} +\constfunc{wxDateTime}{ToGMT}{\param{bool }{noDST = false}} 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}} +\func{wxDateTime\&}{MakeGMT}{\param{bool }{noDST = false}} This is the same as calling \helpref{MakeTimezone}{wxdatetimemaketimezone} with the argument {\tt GMT0}. @@ -1344,7 +1370,7 @@ the argument {\tt GMT0}. \constfunc{int}{IsDST}{\param{Country }{country = Country\_Default}} -Returns {\tt TRUE} if the DST is applied for this date in the given country. +Returns {\tt true} if the DST is applied for this date in the given country. \wxheading{See also}