qdatetime.3qt

来自「tmark1.11:用于生成QT/EMBEDDED应用工程的Markfile文件」· 3QT 代码 · 共 205 行

.TH QDateTime 3qt "6 July 1999" "Troll Tech AS" \" -*- nroff -*-
.\" Copyright 1992-1999 Troll Tech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QDateTime \- Combines QDate and QTime into a single class
.SH SYNOPSIS
.br
.PP
\fC#include <qdatetime.h>\fR
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQDateTime\fR ()"
.br
.ti -1c
.BI "\fBQDateTime\fR ( const QDate & )"
.br
.ti -1c
.BI "\fBQDateTime\fR ( const QDate &, const QTime & )"
.br
.ti -1c
.BI "bool \fBisNull\fR () const"
.br
.ti -1c
.BI "bool \fBisValid\fR () const"
.br
.ti -1c
.BI "QDate \fBdate\fR () const"
.br
.ti -1c
.BI "QTime \fBtime\fR () const"
.br
.ti -1c
.BI "void \fBsetDate\fR ( const QDate & date )"
.br
.ti -1c
.BI "void \fBsetTime\fR ( const QTime & time )"
.br
.ti -1c
.BI "void \fBsetTime_t\fR ( uint secsSince1Jan1970UTC )"
.br
.ti -1c
.BI "QString \fBtoString\fR () const"
.br
.ti -1c
.BI "QDateTime \fBaddDays\fR ( int days ) const"
.br
.ti -1c
.BI "QDateTime \fBaddSecs\fR ( int secs ) const"
.br
.ti -1c
.BI "int \fBdaysTo\fR ( const QDateTime & ) const"
.br
.ti -1c
.BI "int \fBsecsTo\fR ( const QDateTime & ) const"
.br
.ti -1c
.BI "bool \fBoperator==\fR ( const QDateTime & dt ) const"
.br
.ti -1c
.BI "bool \fBoperator!=\fR ( const QDateTime & dt ) const"
.br
.ti -1c
.BI "bool \fBoperator<\fR ( const QDateTime & dt ) const"
.br
.ti -1c
.BI "bool \fBoperator<=\fR ( const QDateTime & dt ) const"
.br
.ti -1c
.BI "bool \fBoperator>\fR ( const QDateTime & dt ) const"
.br
.ti -1c
.BI "bool \fBoperator>=\fR ( const QDateTime & dt ) const"
.br
.in -1c
.SS "Static Public Members"
.in +1c
.ti -1c
.BI "QDateTime \fBcurrentDateTime\fR ()"
.br
.in -1c
.SH RELATED FUNCTION DOCUMENTATION
(Note that these are not member functions.)
.in +1c
.ti -1c
.BI "QDataStream & \fBoperator<<\fR (QDataStream & " "s" ", const QDateTime & " "dt" ")"
.br
.ti -1c
.BI "QDataStream & \fBoperator>>\fR (QDataStream & " "s" ", QDateTime & " "dt" ")"
.br
.in -1c
.SH DESCRIPTION
The QDateTime class combines QDate and QTime into a single class.
.PP
QDateTime provides high precision date and time functions since it can work with Gregorian dates up to about year 8000.
.PP
Most countries that use the Gregorian calendar switched to it between 1550 and 1920.
.PP
See also: QDate and QTime.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QDateTime::QDateTime ()"
Constructs a null datetime (i.e. null date and null time). A null datetime is invalid, since the date is invalid.
.SH "QDateTime::QDateTime ( const QDate & date )"
Constructs a datetime with date \fIdate\fR and null time (00:00:00.000).
.SH "QDateTime::QDateTime ( const QDate & date, const QTime & time )"
Constructs a datetime with date \fIdate\fR and time \fItime.\fR
.SH "QDateTime QDateTime::addDays ( int ndays ) const"
Returns the datetime plus \fIndays\fR days.
.PP
See also: daysTo().
.SH "QDateTime QDateTime::addSecs ( int nsecs ) const"
Returns the datetime plus \fInsecs\fR seconds.
.PP
See also: secsTo().
.SH "QDateTime QDateTime::currentDateTime () \fC[static]\fR"
Returns the current datetime.
.PP
See also: QDate::currentDate() and QTime::currentTime().
.SH "QDate QDateTime::date () const"
Returns the date part of this datetime.
.PP
See also: time().
.SH "int QDateTime::daysTo ( const QDateTime & dt ) const"
Returns the number of days from this datetime to \fIdt,\fR which is negative if \fIdt\fR is in the past.
.PP
See also: addDays() and secsTo().
.SH "bool QDateTime::isNull () const"
Returns TRUE if both the date and the time are null. A null date is invalid.
.PP
See also: QDate::isNull() and QTime::isNull().
.SH "bool QDateTime::isValid () const"
Returns TRUE if both the date and the time are value.
.PP
See also: QDate::isValid() and QTime::isValid().
.SH "bool QDateTime::operator!= ( const QDateTime & dt ) const"
Returns TRUE if this datetime is different from \fIdt,\fR or FALSE if they are equal.
.PP
See also: operator==().
.SH "bool QDateTime::operator< ( const QDateTime & dt ) const"
Returns TRUE if this datetime is before \fIdt,\fR otherwise FALSE.
.SH "bool QDateTime::operator<= ( const QDateTime & dt ) const"
Returns TRUE if this datetime is before or equal to \fIdt,\fR otherwise FALSE.
.SH "bool QDateTime::operator== ( const QDateTime & dt ) const"
Returns TRUE if this datetime is equal to \fIdt,\fR or FALSE if they are different.
.PP
See also: operator!=().
.SH "bool QDateTime::operator> ( const QDateTime & dt ) const"
Returns TRUE if this datetime is after \fIdt,\fR otherwise FALSE.
.SH "bool QDateTime::operator>= ( const QDateTime & dt ) const"
Returns TRUE if this datetime is equal to or after \fIdt,\fR otherwise FALSE.
.SH "int QDateTime::secsTo ( const QDateTime & dt ) const"
Returns the number of seconds from this datetime to \fIdt,\fR which is negative if \fIt\fR is in the past.
.PP
Example:
.PP
.nf
.br
    QDateTime dt = QDateTime::currentDateTime();
.br
    QDateTime x( QDate(dt.year(),12,24), QTime(17,00) );
.br
    qDebug( "There are %d seconds to Christmas", dt.secsTo(x) );
.fi
.PP
See also: addSecs(), daysTo() and QTime::secsTo().
.SH "void QDateTime::setDate ( const QDate & date )"
Sets the date part of this datetime.
.PP
See also: setTime().
.SH "void QDateTime::setTime ( const QTime & time )"
Sets the time part of this datetime.
.PP
See also: setDate().
.SH "void QDateTime::setTime_t ( uint secsSince1Jan1970UTC )"
Sets the local date and time given the number of seconds that have passed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC). On systems that do not support timezones this function will behave as if local time were UTC.
.PP
Note that Microsoft Windows supports only a limited range of values for \fIsecsSince1Jan1970UTC.\fR
.SH "QTime QDateTime::time () const"
Returns the time part of this datetime.
.PP
See also: date().
.SH "QString QDateTime::toString () const"
Returns the datetime as a string.
.PP
The string format is "Sat May 20 03:40:13 1998".
.SH RELATED FUNCTION DOCUMENTATION
.SH "QDataStream & operator<< (QDataStream & s, const QDateTime & dt)"
Writes a datetime to the stream.
.PP
Serialization format: [QDate QTime].
.SH "QDataStream & operator>> (QDataStream & s, QDateTime & dt)"
Reads a datetime from the stream.
.SH "SEE ALSO"
.BR http://www.troll.no/qt/qdatetime.html
.SH COPYRIGHT
Copyright 1992-1999 Troll Tech AS.  See the license file included in
the distribution for a complete license statement.
.SH AUTHOR
Generated automatically from the source code.