qdate.3qt

tmark1.11:用于生成QT/EMBEDDED应用工程的Markfile文件

.TH QDate 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
QDate \- Date functions
.SH SYNOPSIS
.br
.PP
\fC#include <qdatetime.h>\fR
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQDate\fR ()"
.br
.ti -1c
.BI "\fBQDate\fR ( int " "y" ", int " "m" ", int d )"
.br
.ti -1c
.BI "bool \fBisNull\fR () const"
.br
.ti -1c
.BI "bool \fBisValid\fR () const"
.br
.ti -1c
.BI "int \fByear\fR () const"
.br
.ti -1c
.BI "int \fBmonth\fR () const"
.br
.ti -1c
.BI "int \fBday\fR () const"
.br
.ti -1c
.BI "int \fBdayOfWeek\fR () const"
.br
.ti -1c
.BI "int \fBdayOfYear\fR () const"
.br
.ti -1c
.BI "int \fBdaysInMonth\fR () const"
.br
.ti -1c
.BI "int \fBdaysInYear\fR () const"
.br
.ti -1c
.BI "virtual QString \fBmonthName\fR ( int month ) const"
.br
.ti -1c
.BI "virtual QString \fBdayName\fR ( int weekday ) const"
.br
.ti -1c
.BI "QString \fBtoString\fR () const"
.br
.ti -1c
.BI "bool \fBsetYMD\fR ( int " "y" ", int " "m" ", int d )"
.br
.ti -1c
.BI "QDate \fBaddDays\fR ( int days ) const"
.br
.ti -1c
.BI "int \fBdaysTo\fR ( const QDate & ) const"
.br
.ti -1c
.BI "bool \fBoperator==\fR ( const QDate & d ) const"
.br
.ti -1c
.BI "bool \fBoperator!=\fR ( const QDate & d ) const"
.br
.ti -1c
.BI "bool \fBoperator<\fR ( const QDate & d ) const"
.br
.ti -1c
.BI "bool \fBoperator<=\fR ( const QDate & d ) const"
.br
.ti -1c
.BI "bool \fBoperator>\fR ( const QDate & d ) const"
.br
.ti -1c
.BI "bool \fBoperator>=\fR ( const QDate & d ) const"
.br
.in -1c
.SS "Static Public Members"
.in +1c
.ti -1c
.BI "QDate \fBcurrentDate\fR ()"
.br
.ti -1c
.BI "bool \fBisValid\fR ( int " "y" ", int " "m" ", int d )"
.br
.ti -1c
.BI "bool \fBleapYear\fR ( int year )"
.br
.in -1c
.SS "Static Protected Members"
.in +1c
.ti -1c
.BI "uint \fBgreg2jul\fR ( int " "y" ", int " "m" ", int d )"
.br
.ti -1c
.BI "void \fBjul2greg\fR ( uint " "jd" ", int & " "y" ", int & " "m" ", int & d )"
.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 QDate & " "d" ")"
.br
.ti -1c
.BI "QDataStream & \fBoperator>>\fR (QDataStream & " "s" ", QDate & " "d" ")"
.br
.in -1c
.SH DESCRIPTION
The QDate class provides date functions.
.PP
The QDate is based on the Gregorian (modern western) calendar. This calendar was first adopted by England in 1752, and subsequently by most other western countries. QDate computes the wrong day of week for all dates earlier than 14th September 1752, and the day it computes is correct only in some countries for years between 1752 and 1923.
.PP
The end of time is reached around 8000AD, by which time we expect Qt to be obsolete.
.PP
See also: QTime and QDateTime.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QDate::QDate ()"
Constructs a null date. Null dates are invalid.
.SH "QDate::QDate ( int y, int m, int d )"
Constructs a date with the year \fIy,\fR month \fIm\fR and day \fId.\fR
.SH "QDate QDate::addDays ( int ndays ) const"
Returns this date plus \fIndays\fR days.
.SH "QDate QDate::currentDate () \fC[static]\fR"
Returns the current date.
.PP
See also: QTime::currentTime() and QDateTime::currentDateTime().
.SH "int QDate::day () const"
Returns the day of the month (1..31) for this date.
.PP
See also: year(), month() and dayOfWeek().
.SH "QString QDate::dayName ( int weekday ) const \fC[virtual]\fR"
Returns the name of the \fIweekday.\fR
.PP
Weekday 1 == "Mon", day 2 == "Tue" etc.
.SH "int QDate::dayOfWeek () const"
Returns the weekday (Monday=1 .. Sunday=7) for this date.
.PP
See also: day().
.SH "int QDate::dayOfYear () const"
Returns the day of the year (1..365) for this date.
.SH "int QDate::daysInMonth () const"
Returns the number of days in the month (28..31) for this date.
.SH "int QDate::daysInYear () const"
Returns the number of days in the year (365 or 366) for this date.
.SH "int QDate::daysTo ( const QDate & d ) const"
Returns the number of days from this date to \fId,\fR which is negative if \fId\fR is in the past.
.PP
Example:
.PP
.nf
.br
    QDate d1( 1995, 5, 17 );            // May 17th 1995
.br
    QDate d2( 1995, 5, 20 );            // May 20th 1995
.br
    d1.daysTo( d2 );                    // returns 3
.br
    d2.daysTo( d1 );                    // returns -3
.fi
.PP
See also: addDays().
.SH "uint QDate::greg2jul ( int y, int m, int d ) \fC[static protected]\fR"
For internal use only.
.SH "bool QDate::isNull () const"
Returns TRUE if the date is null. A null date is invalid.
.PP
See also: isValid().
.SH "bool QDate::isValid () const"
Returns TRUE if the date is valid.
.PP
See also: isNull().
.SH "bool QDate::isValid ( int y, int m, int d ) \fC[static]\fR"
Returns TRUE if the specified date is valid.
.PP
Note that years 00-99 are treated as 1900-1999.
.PP
See also: isNull().
.SH "void QDate::jul2greg ( uint jd, int & y, int & m, int & d ) \fC[static protected]\fR"
For internal use only.
.SH "bool QDate::leapYear ( int y ) \fC[static]\fR"
Returns TRUE if the specified year \fIy\fR is a leap year.
.SH "int QDate::month () const"
Returns the month (January=1 .. December=12) for this date.
.PP
See also: year() and day().
.SH "QString QDate::monthName ( int month ) const \fC[virtual]\fR"
Returns the name of the \fImonth.\fR
.PP
Month 1 == "Jan", month 2 == "Feb" etc.
.SH "bool QDate::operator!= ( const QDate & d ) const"
Returns TRUE if this date is different from \fId,\fR or FALSE if they are equal.
.SH "bool QDate::operator< ( const QDate & d ) const"
Returns TRUE if this date is before \fId,\fR otherwise FALSE.
.SH "bool QDate::operator<= ( const QDate & d ) const"
Returns TRUE if this date is before or equal to \fId,\fR otherwise FALSE.
.SH "bool QDate::operator== ( const QDate & d ) const"
Returns TRUE if this date is equal to \fId,\fR or FALSE if they are different.
.SH "bool QDate::operator> ( const QDate & d ) const"
Returns TRUE if this date is after \fId,\fR otherwise FALSE.
.SH "bool QDate::operator>= ( const QDate & d ) const"
Returns TRUE if this date is equal to or after \fId,\fR otherwise FALSE.
.SH "bool QDate::setYMD ( int y, int m, int d )"
Sets the year \fIy,\fR month \fIm\fR and day \fId.\fR Returns TRUE if the date is valid, otherwise FALSE.
.SH "QString QDate::toString () const"
Returns the date as a string.
.PP
The string format is "Sat May 20 1995".
.SH "int QDate::year () const"
Returns the year (>= 1752) for this date.
.PP
See also: month() and day().
.SH RELATED FUNCTION DOCUMENTATION
.SH "QDataStream & operator<< (QDataStream & s, const QDate & d)"
Writes the date to the stream.
.PP
Serialization format: [Q_UINT32], Julian day.
.SH "QDataStream & operator>> (QDataStream & s, QDate & d)"
Reads a date from the stream.
.SH "SEE ALSO"
.BR http://www.troll.no/qt/qdate.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.