diff options
Diffstat (limited to 'doc/html/tqdatetime.html')
| -rw-r--r-- | doc/html/tqdatetime.html | 393 |
1 files changed, 393 insertions, 0 deletions
diff --git a/doc/html/tqdatetime.html b/doc/html/tqdatetime.html new file mode 100644 index 000000000..a4fcde797 --- /dev/null +++ b/doc/html/tqdatetime.html @@ -0,0 +1,393 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/tools/tqdatetime.cpp:1861 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>TQDateTime Class</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQDateTime Class Reference</h1> + +<p>The TQDateTime class provides date and time functions. +<a href="#details">More...</a> +<p>All the functions in this class are <a href="threads.html#reentrant">reentrant</a> when TQt is built with thread support.</p> +<p><tt>#include <<a href="tqdatetime-h.html">tqdatetime.h</a>></tt> +<p><a href="tqdatetime-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn><a href="#TQDateTime"><b>TQDateTime</b></a> ()</li> +<li class=fn><a href="#TQDateTime-2"><b>TQDateTime</b></a> ( const TQDate & date )</li> +<li class=fn><a href="#TQDateTime-3"><b>TQDateTime</b></a> ( const TQDate & date, const TQTime & time )</li> +<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li> +<li class=fn>bool <a href="#isValid"><b>isValid</b></a> () const</li> +<li class=fn>TQDate <a href="#date"><b>date</b></a> () const</li> +<li class=fn>TQTime <a href="#time"><b>time</b></a> () const</li> +<li class=fn>uint <a href="#toTime_t"><b>toTime_t</b></a> () const</li> +<li class=fn>void <a href="#setDate"><b>setDate</b></a> ( const TQDate & date )</li> +<li class=fn>void <a href="#setTime"><b>setTime</b></a> ( const TQTime & time )</li> +<li class=fn>void <a href="#setTime_t-2"><b>setTime_t</b></a> ( uint secsSince1Jan1970UTC )</li> +<li class=fn>void <a href="#setTime_t"><b>setTime_t</b></a> ( uint secsSince1Jan1970UTC, TQt::TimeSpec ts )</li> +<li class=fn>TQString <a href="#toString-2"><b>toString</b></a> ( TQt::DateFormat f = TQt::TextDate ) const</li> +<li class=fn>TQString <a href="#toString"><b>toString</b></a> ( const TQString & format ) const</li> +<li class=fn>TQDateTime <a href="#addDays"><b>addDays</b></a> ( int ndays ) const</li> +<li class=fn>TQDateTime <a href="#addMonths"><b>addMonths</b></a> ( int nmonths ) const</li> +<li class=fn>TQDateTime <a href="#addYears"><b>addYears</b></a> ( int nyears ) const</li> +<li class=fn>TQDateTime <a href="#addSecs"><b>addSecs</b></a> ( int nsecs ) const</li> +<li class=fn>int <a href="#daysTo"><b>daysTo</b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>int <a href="#secsTo"><b>secsTo</b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const TQDateTime & dt ) const</li> +<li class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const TQDateTime & dt ) const</li> +</ul> +<h2>Static Public Members</h2> +<ul> +<li class=fn>TQDateTime <a href="#currentDateTime-2"><b>currentDateTime</b></a> ()</li> +<li class=fn>TQDateTime <a href="#currentDateTime"><b>currentDateTime</b></a> ( TQt::TimeSpec ts )</li> +<li class=fn>TQDateTime <a href="#fromString"><b>fromString</b></a> ( const TQString & s, TQt::DateFormat f = TQt::TextDate )</li> +</ul> +<h2>Related Functions</h2> +<ul> +<li class=fn>TQDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( TQDataStream & s, const TQDateTime & dt )</li> +<li class=fn>TQDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( TQDataStream & s, TQDateTime & dt )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + + +The TQDateTime class provides date and time functions. +<p> + +<p> A TQDateTime object contains a calendar date and a clock time (a +"datetime"). It is a combination of the <a href="tqdate.html">TQDate</a> and <a href="tqtime.html">TQTime</a> classes. +It can read the current datetime from the system clock. It +provides functions for comparing datetimes and for manipulating a +datetime by adding a number of seconds, days, months or years. +<p> A TQDateTime object is typically created either by giving a date +and time explicitly in the constructor, or by using the static +function <a href="#currentDateTime">currentDateTime</a>(), which returns a TQDateTime object set +to the system clock's time. The date and time can be changed with +<a href="#setDate">setDate</a>() and <a href="#setTime">setTime</a>(). A datetime can also be set using the +<a href="#setTime_t">setTime_t</a>() function, which takes a POSIX-standard "number of +seconds since 00:00:00 on January 1, 1970" value. The <a href="#fromString">fromString</a>() +function returns a TQDateTime given a string and a date format +which is used to interpret the date within the string. +<p> The <a href="#date">date</a>() and <a href="#time">time</a>() functions provide access to the date and +time parts of the datetime. The same information is provided in +textual format by the <a href="#toString">toString</a>() function. +<p> TQDateTime provides a full set of operators to compare two +TQDateTime objects where smaller means earlier and larger means +later. +<p> You can increment (or decrement) a datetime by a given number of +seconds using <a href="#addSecs">addSecs</a>() or days using <a href="#addDays">addDays</a>(). Similarly you can +use <a href="#addMonths">addMonths</a>() and <a href="#addYears">addYears</a>(). The <a href="#daysTo">daysTo</a>() function returns the +number of days between two datetimes, and <a href="#secsTo">secsTo</a>() returns the +number of seconds between two datetimes. +<p> The range of a datetime object is constrained to the ranges of the +<a href="tqdate.html">TQDate</a> and <a href="tqtime.html">TQTime</a> objects which it embodies. +<p> <p>See also <a href="tqdate.html">TQDate</a>, <a href="tqtime.html">TQTime</a>, <a href="tqdatetimeedit.html">TQDateTimeEdit</a>, and <a href="time.html">Time and Date</a>. + +<hr><h2>Member Function Documentation</h2> +<h3 class=fn><a name="TQDateTime"></a>TQDateTime::TQDateTime () +</h3> + +<p> Constructs a null datetime (i.e. null date and null time). A null +datetime is invalid, since the date is invalid. +<p> <p>See also <a href="#isValid">isValid</a>(). + +<h3 class=fn><a name="TQDateTime-2"></a>TQDateTime::TQDateTime ( const <a href="tqdate.html">TQDate</a> & date ) +</h3> +Constructs a datetime with date <em>date</em> and null (but valid) time +(00:00:00.000). + +<h3 class=fn><a name="TQDateTime-3"></a>TQDateTime::TQDateTime ( const <a href="tqdate.html">TQDate</a> & date, const <a href="tqtime.html">TQTime</a> & time ) +</h3> +Constructs a datetime with date <em>date</em> and time <em>time</em>. + +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="addDays"></a>TQDateTime::addDays ( int ndays ) const +</h3> +Returns a TQDateTime object containing a datetime <em>ndays</em> days +later than the datetime of this object (or earlier if <em>ndays</em> is +negative). +<p> <p>See also <a href="#daysTo">daysTo</a>(), <a href="#addMonths">addMonths</a>(), <a href="#addYears">addYears</a>(), and <a href="#addSecs">addSecs</a>(). + +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="addMonths"></a>TQDateTime::addMonths ( int nmonths ) const +</h3> +Returns a TQDateTime object containing a datetime <em>nmonths</em> months +later than the datetime of this object (or earlier if <em>nmonths</em> +is negative). +<p> <p>See also <a href="#daysTo">daysTo</a>(), <a href="#addDays">addDays</a>(), <a href="#addYears">addYears</a>(), and <a href="#addSecs">addSecs</a>(). + +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="addSecs"></a>TQDateTime::addSecs ( int nsecs ) const +</h3> +Returns a TQDateTime object containing a datetime <em>nsecs</em> seconds +later than the datetime of this object (or earlier if <em>nsecs</em> is +negative). +<p> <p>See also <a href="#secsTo">secsTo</a>(), <a href="#addDays">addDays</a>(), <a href="#addMonths">addMonths</a>(), and <a href="#addYears">addYears</a>(). + +<p>Example: <a href="listviews-example.html#x136">listviews/listviews.cpp</a>. +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="addYears"></a>TQDateTime::addYears ( int nyears ) const +</h3> +Returns a TQDateTime object containing a datetime <em>nyears</em> years +later than the datetime of this object (or earlier if <em>nyears</em> is +negative). +<p> <p>See also <a href="#daysTo">daysTo</a>(), <a href="#addDays">addDays</a>(), <a href="#addMonths">addMonths</a>(), and <a href="#addSecs">addSecs</a>(). + +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="currentDateTime"></a>TQDateTime::currentDateTime ( <a href="ntqt.html#TimeSpec-enum">TQt::TimeSpec</a> ts )<tt> [static]</tt> +</h3> +Returns the current datetime, as reported by the system clock, for the +TimeSpec <em>ts</em>. The default TimeSpec is LocalTime. +<p> <p>See also <a href="tqdate.html#currentDate">TQDate::currentDate</a>(), <a href="tqtime.html#currentTime">TQTime::currentTime</a>(), and <a href="ntqt.html#TimeSpec-enum">TQt::TimeSpec</a>. + +<p>Example: <a href="listviews-example.html#x137">listviews/listviews.cpp</a>. +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="currentDateTime-2"></a>TQDateTime::currentDateTime ()<tt> [static]</tt> +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Returns the current datetime, as reported by the system clock. +<p> <p>See also <a href="tqdate.html#currentDate">TQDate::currentDate</a>() and <a href="tqtime.html#currentTime">TQTime::currentTime</a>(). + +<h3 class=fn><a href="tqdate.html">TQDate</a> <a name="date"></a>TQDateTime::date () const +</h3> + +<p> Returns the date part of the datetime. +<p> <p>See also <a href="#setDate">setDate</a>() and <a href="#time">time</a>(). + +<h3 class=fn>int <a name="daysTo"></a>TQDateTime::daysTo ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns the number of days from this datetime to <em>dt</em> (which is +negative if <em>dt</em> is earlier than this datetime). +<p> <p>See also <a href="#addDays">addDays</a>() and <a href="#secsTo">secsTo</a>(). + +<h3 class=fn><a href="tqdatetime.html">TQDateTime</a> <a name="fromString"></a>TQDateTime::fromString ( const <a href="tqstring.html">TQString</a> & s, <a href="ntqt.html#DateFormat-enum">TQt::DateFormat</a> f = TQt::TextDate )<tt> [static]</tt> +</h3> +Returns the TQDateTime represented by the string <em>s</em>, using the +format <em>f</em>, or an invalid datetime if this is not possible. +<p> Note for <a href="ntqt.html#DateFormat-enum">TQt::TextDate</a>: It is recommended that you use the +English short month names (e.g. "Jan"). Although localized month +names can also be used, they depend on the user's locale settings. +<p> <b>Warning:</b> Note that <a href="ntqt.html#DateFormat-enum">TQt::LocalDate</a> cannot be used here. + +<h3 class=fn>bool <a name="isNull"></a>TQDateTime::isNull () const +</h3> + +<p> Returns TRUE if both the date and the time are null; otherwise +returns FALSE. A null datetime is invalid. +<p> <p>See also <a href="tqdate.html#isNull">TQDate::isNull</a>() and <a href="tqtime.html#isNull">TQTime::isNull</a>(). + +<h3 class=fn>bool <a name="isValid"></a>TQDateTime::isValid () const +</h3> + +<p> Returns TRUE if both the date and the time are valid; otherwise +returns FALSE. +<p> <p>See also <a href="tqdate.html#isValid">TQDate::isValid</a>() and <a href="tqtime.html#isValid">TQTime::isValid</a>(). + +<h3 class=fn>bool <a name="operator!-eq"></a>TQDateTime::operator!= ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns TRUE if this datetime is different from <em>dt</em>; otherwise +returns FALSE. +<p> <p>See also <a href="#operator-eq-eq">operator==</a>(). + +<h3 class=fn>bool <a name="operator-lt"></a>TQDateTime::operator< ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns TRUE if this datetime is earlier than <em>dt</em>; otherwise +returns FALSE. + +<h3 class=fn>bool <a name="operator-lt-eq"></a>TQDateTime::operator<= ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns TRUE if this datetime is earlier than or equal to <em>dt</em>; +otherwise returns FALSE. + +<h3 class=fn>bool <a name="operator-eq-eq"></a>TQDateTime::operator== ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns TRUE if this datetime is equal to <em>dt</em>; otherwise returns FALSE. +<p> <p>See also <a href="#operator!-eq">operator!=</a>(). + +<h3 class=fn>bool <a name="operator-gt"></a>TQDateTime::operator> ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns TRUE if this datetime is later than <em>dt</em>; otherwise +returns FALSE. + +<h3 class=fn>bool <a name="operator-gt-eq"></a>TQDateTime::operator>= ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns TRUE if this datetime is later than or equal to <em>dt</em>; +otherwise returns FALSE. + +<h3 class=fn>int <a name="secsTo"></a>TQDateTime::secsTo ( const <a href="tqdatetime.html">TQDateTime</a> & dt ) const +</h3> +Returns the number of seconds from this datetime to <em>dt</em> (which +is negative if <em>dt</em> is earlier than this datetime). +<p> Example: +<pre> + TQDateTime dt = TQDateTime::<a href="#currentDateTime">currentDateTime</a>(); + TQDateTime xmas( TQDate(dt.<a href="#date">date</a>().year(),12,24), TQTime(17,00) ); + <a href="ntqapplication.html#qDebug">tqDebug</a>( "There are %d seconds to Christmas", dt.<a href="#secsTo">secsTo</a>(xmas) ); + </pre> + +<p> <p>See also <a href="#addSecs">addSecs</a>(), <a href="#daysTo">daysTo</a>(), and <a href="tqtime.html#secsTo">TQTime::secsTo</a>(). + +<h3 class=fn>void <a name="setDate"></a>TQDateTime::setDate ( const <a href="tqdate.html">TQDate</a> & date ) +</h3> + +<p> Sets the date part of this datetime to <em>date</em>. +<p> <p>See also <a href="#date">date</a>() and <a href="#setTime">setTime</a>(). + +<h3 class=fn>void <a name="setTime"></a>TQDateTime::setTime ( const <a href="tqtime.html">TQTime</a> & time ) +</h3> + +<p> Sets the time part of this datetime to <em>time</em>. +<p> <p>See also <a href="#time">time</a>() and <a href="#setDate">setDate</a>(). + +<h3 class=fn>void <a name="setTime_t"></a>TQDateTime::setTime_t ( uint secsSince1Jan1970UTC, <a href="ntqt.html#TimeSpec-enum">TQt::TimeSpec</a> ts ) +</h3> +Sets the date and time to <em>ts</em> time (<a href="ntqt.html#TimeSpec-enum">TQt::LocalTime</a> or <a href="ntqt.html#TimeSpec-enum">TQt::UTC</a>) given the number of seconds that have passed since +1970-01-01T00:00:00, Coordinated Universal Time (UTC). On systems +that do not support timezones this function will behave as if +local time were UTC. +<p> On Windows, only a subset of <em>secsSince1Jan1970UTC</em> values are +supported, as Windows starts counting from 1980. +<p> <p>See also <a href="#toTime_t">toTime_t</a>(). + +<h3 class=fn>void <a name="setTime_t-2"></a>TQDateTime::setTime_t ( uint secsSince1Jan1970UTC ) +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Convenience function that sets the date and time to local time +based on the given UTC time. + +<h3 class=fn><a href="tqtime.html">TQTime</a> <a name="time"></a>TQDateTime::time () const +</h3> + +<p> Returns the time part of the datetime. +<p> <p>See also <a href="#setTime">setTime</a>() and <a href="#date">date</a>(). + +<h3 class=fn><a href="tqstring.html">TQString</a> <a name="toString"></a>TQDateTime::toString ( const <a href="tqstring.html">TQString</a> & format ) const +</h3> +Returns the datetime as a string. The <em>format</em> parameter +determines the format of the result string. +<p> These expressions may be used for the date: +<p> <center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Expression <th valign="top">Output +<tr bgcolor="#f0f0f0"> <td valign="top">d <td valign="top">the day as number without a leading zero (1-31) +<tr bgcolor="#d0d0d0"> <td valign="top">dd <td valign="top">the day as number with a leading zero (01-31) +<tr bgcolor="#f0f0f0"> <td valign="top">ddd +<td valign="top">the abbreviated localized day name (e.g. 'Mon'..'Sun'). +Uses <a href="tqdate.html#shortDayName">TQDate::shortDayName</a>(). +<tr bgcolor="#d0d0d0"> <td valign="top">dddd +<td valign="top">the long localized day name (e.g. 'Monday'..'Sunday'). +Uses <a href="tqdate.html#longDayName">TQDate::longDayName</a>(). +<tr bgcolor="#f0f0f0"> <td valign="top">M <td valign="top">the month as number without a leading zero (1-12) +<tr bgcolor="#d0d0d0"> <td valign="top">MM <td valign="top">the month as number with a leading zero (01-12) +<tr bgcolor="#f0f0f0"> <td valign="top">MMM +<td valign="top">the abbreviated localized month name (e.g. 'Jan'..'Dec'). +Uses <a href="tqdate.html#shortMonthName">TQDate::shortMonthName</a>(). +<tr bgcolor="#d0d0d0"> <td valign="top">MMMM +<td valign="top">the long localized month name (e.g. 'January'..'December'). +Uses <a href="tqdate.html#longMonthName">TQDate::longMonthName</a>(). +<tr bgcolor="#f0f0f0"> <td valign="top">yy <td valign="top">the year as two digit number (00-99) +<tr bgcolor="#d0d0d0"> <td valign="top">yyyy <td valign="top">the year as four digit number (1752-8000) +</table></center> +<p> These expressions may be used for the time: +<p> <center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Expression <th valign="top">Output +<tr bgcolor="#f0f0f0"> <td valign="top">h +<td valign="top">the hour without a leading zero (0..23 or 1..12 if AM/PM display) +<tr bgcolor="#d0d0d0"> <td valign="top">hh +<td valign="top">the hour with a leading zero (00..23 or 01..12 if AM/PM display) +<tr bgcolor="#f0f0f0"> <td valign="top">m <td valign="top">the minute without a leading zero (0..59) +<tr bgcolor="#d0d0d0"> <td valign="top">mm <td valign="top">the minute with a leading zero (00..59) +<tr bgcolor="#f0f0f0"> <td valign="top">s <td valign="top">the second whithout a leading zero (0..59) +<tr bgcolor="#d0d0d0"> <td valign="top">ss <td valign="top">the second whith a leading zero (00..59) +<tr bgcolor="#f0f0f0"> <td valign="top">z <td valign="top">the milliseconds without leading zeroes (0..999) +<tr bgcolor="#d0d0d0"> <td valign="top">zzz <td valign="top">the milliseconds with leading zeroes (000..999) +<tr bgcolor="#f0f0f0"> <td valign="top">AP +<td valign="top">use AM/PM display. <em>AP</em> will be replaced by either "AM" or "PM". +<tr bgcolor="#d0d0d0"> <td valign="top">ap +<td valign="top">use am/pm display. <em>ap</em> will be replaced by either "am" or "pm". +</table></center> +<p> All other input characters will be ignored. +<p> Example format strings (assumed that the TQDateTime is +21<small><sup>st</sup></small> May 2001 14:13:09) +<p> <center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Format <th valign="top">Result +<tr bgcolor="#f0f0f0"> <td valign="top">dd.MM.yyyy <td valign="top" colspan="1" rowspan="1"> 21.05.2001 +<tr bgcolor="#d0d0d0"> <td valign="top">ddd MMMM d yy <td valign="top" colspan="1" rowspan="1"> Tue May 21 01 +<tr bgcolor="#f0f0f0"> <td valign="top">hh:mm:ss.zzz <td valign="top" colspan="1" rowspan="1"> 14:13:09.042 +<tr bgcolor="#d0d0d0"> <td valign="top">h:m:s ap <td valign="top" colspan="1" rowspan="1"> 2:13:9 pm +</table></center> +<p> If the datetime is an invalid datetime, then <a href="tqstring.html#TQString-null">TQString::null</a> will be returned. +<p> <p>See also <a href="tqdate.html#toString">TQDate::toString</a>() and <a href="tqtime.html#toString">TQTime::toString</a>(). + +<h3 class=fn><a href="tqstring.html">TQString</a> <a name="toString-2"></a>TQDateTime::toString ( <a href="ntqt.html#DateFormat-enum">TQt::DateFormat</a> f = TQt::TextDate ) const +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Returns the datetime as a string. The <em>f</em> parameter determines +the format of the string. +<p> If <em>f</em> is <a href="ntqt.html#DateFormat-enum">TQt::TextDate</a>, the string format is "Wed May 20 +03:40:13 1998" (using <a href="tqdate.html#shortDayName">TQDate::shortDayName</a>(), <a href="tqdate.html#shortMonthName">TQDate::shortMonthName</a>(), +and <a href="tqtime.html#toString">TQTime::toString</a>() to generate the string, so the day and month +names will have localized names). +<p> If <em>f</em> is <a href="ntqt.html#DateFormat-enum">TQt::ISODate</a>, the string format corresponds to the +ISO 8601 extended specification for representations of dates and +times, which is YYYY-MM-DDTHH:MM:SS. +<p> If <em>f</em> is <a href="ntqt.html#DateFormat-enum">TQt::LocalDate</a>, the string format depends on the +locale settings of the system. +<p> If the format <em>f</em> is invalid or the datetime is invalid, <a href="#toString">toString</a>() +returns a null string. +<p> <p>See also <a href="tqdate.html#toString">TQDate::toString</a>() and <a href="tqtime.html#toString">TQTime::toString</a>(). + +<h3 class=fn>uint <a name="toTime_t"></a>TQDateTime::toTime_t () const +</h3> +Returns the datetime as the number of seconds that have passed +since 1970-01-01T00:00:00, Coordinated Universal Time (UTC). +<p> On systems that do not support timezones, this function will +behave as if local time were UTC. +<p> <p>See also <a href="#setTime_t">setTime_t</a>(). + +<hr><h2>Related Functions</h2> +<h3 class=fn><a href="ntqdatastream.html">TQDataStream</a> & <a name="operator-lt-lt"></a>operator<< ( <a href="ntqdatastream.html">TQDataStream</a> & s, const <a href="tqdatetime.html">TQDateTime</a> & dt ) +</h3> + +<p> Writes the datetime <em>dt</em> to the stream <em>s</em>. +<p> <p>See also <a href="datastreamformat.html">Format of the TQDataStream operators</a>. + +<h3 class=fn><a href="ntqdatastream.html">TQDataStream</a> & <a name="operator-gt-gt"></a>operator>> ( <a href="ntqdatastream.html">TQDataStream</a> & s, <a href="tqdatetime.html">TQDateTime</a> & dt ) +</h3> + +<p> Reads a datetime from the stream <em>s</em> into <em>dt</em>. +<p> <p>See also <a href="datastreamformat.html">Format of the TQDataStream operators</a>. + +<!-- eof --> +<hr><p> +This file is part of the <a href="index.html">TQt toolkit</a>. +Copyright © 1995-2007 +<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>TQt 3.3.8</div> +</table></div></address></body> +</html> |