X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a333edbddfc6cbee65bd541ddb8515844964aae4..b3a029f0bbf8262cfe30914790802f88608ea618:/docs/latex/wx/datetime.tex diff --git a/docs/latex/wx/datetime.tex b/docs/latex/wx/datetime.tex index 6fc226c1d1..dd67d84bd7 100644 --- a/docs/latex/wx/datetime.tex +++ b/docs/latex/wx/datetime.tex @@ -43,7 +43,7 @@ Time zone symbolic names: GMT_6, GMT_5, GMT_4, GMT_3, GMT_2, GMT_1, GMT0, GMT1, GMT2, GMT3, GMT4, GMT5, GMT6, - GMT7, GMT8, GMT9, GMT10, GMT11, GMT12, + GMT7, GMT8, GMT9, GMT10, GMT11, GMT12, GMT13, // Note that GMT12 and GMT_12 are not the same: there is a difference // of exactly one day between them @@ -77,10 +77,14 @@ Time zone symbolic names: // Australia A_WST = GMT8, // Western Standard Time - A_CST = GMT12 + 1, // Central Standard Time (+9.5) + A_CST = GMT13 + 1, // Central Standard Time (+9.5) A_EST = GMT10, // Eastern Standard Time A_ESST = GMT11, // Eastern Summer Time + // New Zealand + NZST = GMT12, // Standard Time + NZDT = GMT13, // Daylight Saving Time + // Universal Coordinated Time = the new and politically correct name // for GMT UTC = GMT0 @@ -171,6 +175,10 @@ No base class +\wxheading{Library} + +\helpref{wxBase}{librarieslist} + \wxheading{See also} \helpref{Date classes overview}{wxdatetimeoverview},\rtfsp @@ -347,6 +355,14 @@ format. As an example, \helpref{ParseDateTime}{wxdatetimeparsedatetime} can parse the strings such as {\tt "tomorrow"}, {\tt "March first"} and even {\tt "next Sunday"}. +Finally notice that each of the parsing functions is available in several +overloads: if the input string is a narrow (\texttt{char *}) string, then a +narrow pointer is returned. If the input string is a wide string, a wide char +pointer is returned. Finally, if the input parameter is a wxString, a narrow +char pointer is also returned for backwards compatibility but there is also an +additional argument of wxString::const\_iterator type in which, if it is not +\NULL, an iterator pointing to the end of the scanned string part is returned. + \helpref{ParseRfc822Date}{wxdatetimeparserfc822date}\\ \helpref{ParseFormat}{wxdatetimeparseformat}\\ \helpref{ParseDateTime}{wxdatetimeparsedatetime}\\ @@ -858,6 +874,20 @@ Same as \helpref{Set}{wxdatetimesettm}. Returns {\tt true} if the object represents a valid time moment. +\membersection{wxDateTime::GetDateOnly}\label{wxdatetimegetdateonly} + +\constfunc{wxDateTime}{GetDateOnly}{\void} + +Returns the object having the same date component as this one but time of +00:00:00. + +\newsince{2.8.2} + +\wxheading{See also} + +\helpref{ResetTime}{wxdatetimeresettime} + + \membersection{wxDateTime::GetTm}\label{wxdatetimegettm} \constfunc{Tm}{GetTm}{\param{const TimeZone\& }{tz = Local}} @@ -1147,9 +1177,13 @@ as wxTimeSpan. \membersection{wxDateTime::ParseRfc822Date}\label{wxdatetimeparserfc822date} -\func{const wxChar *}{ParseRfc822Date}{\param{const wxChar* }{date}} +\func{const char *}{ParseRfc822Date}{\param{const wxString\& }{date}, \param{wxString::const\_iterator *}{end = \NULL}} + +\func{const char *}{ParseRfc822Date}{\param{const char* }{date}} + +\func{const wchar\_t *}{ParseRfc822Date}{\param{const wchar\_t* }{date}} -Parses the string {\it date} looking for a date formatted according to the RFC +Parses the string \arg{date} looking for a date formatted according to the RFC 822 in it. The exact description of this format may, of course, be found in the RFC (section $5$), but, briefly, this is the format used in the headers of Internet email messages and one of the most common strings expressing date in @@ -1168,7 +1202,11 @@ free ways, you should use \helpref{ParseDateTime}{wxdatetimeparsedatetime} or \membersection{wxDateTime::ParseFormat}\label{wxdatetimeparseformat} -\func{const wxChar *}{ParseFormat}{\param{const wxChar *}{date}, \param{const wxChar *}{format = wxDefaultDateTimeFormat}, \param{const wxDateTime\& }{dateDef = wxDefaultDateTime}} +\func{const char *}{ParseFormat}{\param{const wxString\& }{date}, \param{const wxString\& }{format = wxDefaultDateTimeFormat}, \param{const wxDateTime\& }{dateDef = wxDefaultDateTime}, \param{wxString::const\_iterator *}{end = \NULL}} + +\func{const char *}{ParseFormat}{\param{const char *}{date}, \param{const wxString\& }{format = wxDefaultDateTimeFormat}, \param{const wxDateTime\& }{dateDef = wxDefaultDateTime}} + +\func{const wchar\_t *}{ParseFormat}{\param{const wchar\_t *}{date}, \param{const wxString\& }{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, @@ -1193,7 +1231,11 @@ the character which stopped the scan. \membersection{wxDateTime::ParseDateTime}\label{wxdatetimeparsedatetime} -\func{const wxChar *}{ParseDateTime}{\param{const wxChar *}{datetime}} +\func{const char *}{ParseDateTime}{\param{const wxString\& }{datetime}, \param{wxString::const\_iterator *}{end = \NULL}} + +\func{const char *}{ParseDateTime}{\param{const char *}{datetime}} + +\func{const wchar\_t *}{ParseDateTime}{\param{const wchar\_t *}{datetime}} Parses the string {\it datetime} containing the date and time in free format. This function tries as hard as it can to interpret the given string as date @@ -1207,7 +1249,11 @@ the character which stopped the scan. \membersection{wxDateTime::ParseDate}\label{wxdatetimeparsedate} -\func{const wxChar *}{ParseDate}{\param{const wxChar *}{date}} +\func{const char *}{ParseDate}{\param{const wxString\& }{date}, \param{wxString::const\_iterator *}{end = \NULL}} + +\func{const char *}{ParseDate}{\param{const char *}{date}} + +\func{const wchar\_t *}{ParseDate}{\param{const wchar\_t *}{date}} This function is like \helpref{ParseDateTime}{wxdatetimeparsedatetime}, but it only allows the date to be specified. It is thus less flexible then @@ -1220,7 +1266,11 @@ the character which stopped the scan. \membersection{wxDateTime::ParseTime}\label{wxdatetimeparsetime} -\func{const wxChar *}{ParseTime}{\param{const wxChar *}{time}} +\func{const char *}{ParseTime}{\param{const wxString\& }{time}, \param{wxString::const\_iterator *}{end = \NULL}} + +\func{const char *}{ParseTime}{\param{const char *}{time}} + +\func{const wchar\_t *}{ParseTime}{\param{const wchar\_t *}{time}} This functions is like \helpref{ParseDateTime}{wxdatetimeparsedatetime}, but only allows the time to be specified in the input string. @@ -1546,9 +1596,37 @@ Returns {\tt true} if the DST is applied for this date in the given country. \section{\class{wxDateTimeHolidayAuthority}}\label{wxdatetimeholidayauthority} +\wxheading{Derived from} + +No base class + +\wxheading{Include files} + + + +\wxheading{Library} + +\helpref{wxBase}{librarieslist} + +\latexignore{\rtfignore{\wxheading{Members}}} + TODO \section{\class{wxDateTimeWorkDays}}\label{wxdatetimeworkdays} +\wxheading{Derived from} + +No base class + +\wxheading{Include files} + + + +\wxheading{Library} + +\helpref{wxBase}{librarieslist} + +\latexignore{\rtfignore{\wxheading{Members}}} + TODO