| 主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 | |
QDate类提供了日期功能。 详情请见……
#include <qdatetime.h>
QDate对象包含日历日期，比如现代西方（教皇格列高利一世的）日历年、月和日的数字。它可以从系统时钟中读取当前日期。它提供比较日期和操作日期的函数，比如加上一定数量的天、月或年。
QDate对象通常可以由明白地给定的年、月、日数字来创建，或者使用静态函数currentDate()让QDate对象包含系统时钟日期。一个明确的日期也可以用setYMD()来设置。fromString()函数通过一个给定的字符串和在字符串中日期格式的间隔说明就可以返回一个QDate。
year()、month()和day()函数提供了对年、月、日数字的访问。也提供了dayOfWeek()和dayOfYear()函数。toString()、shortDayName()、longDayName()、shortMonthName()和longMonthName()提供了文本格式的相同信息。
QDate提供了一整套的操作符来比较两个QDate对象，在这里小于表示早一些，大于表示晚一些。
你可以使用addDays()给一个日期增加（或减少）一个给定的天数。相似地你可以使用addMonths()和addYears()。daysTo()函数返回两个日期之间的天数。
daysInMonth()和daysInYear()函数分别返回这个日期在当月和当年的天数。leapYear()函数说明这个日期是不是在一个闰年中。
注意QDate不应用于早于格列高利历的日期的计算。这个历法是英格兰从1752年9月14日采用的（因此这是最早有效的QDate），并且后来其他绝大多数西方国家知道1923年才采用。
QDate的结束时间可以一直到8000年，到那个时候我们希望Qt已经被废弃了。
也可以参考QTime、QDateTime、QDateEdit、QDateTimeEdit和时间和日期。
y必须在1752－8000之间，m必须在1－12之间，d必须在1－31之间。例外，如果y在0－99之间，它表示的是1900－1999。
也可以参考isValid()。
也可以参考daysTo()。
也可以参考QTime::currentTime()和QDateTime::currentDateTime()。
也可以参考year()、month()和dayOfWeek()。
使用shortDayName()来替代它。
也可以参考day()和daysInYear()。
也可以参考day()和daysInMonth()。
实例：
QDate d1( 1995, 5, 17 ); // 1995年5月17日
QDate d2( 1995, 5, 20 ); // 1995年5月20日
d1.daysTo( d2 ); // 返回3
d2.daysTo( d1 ); // 返回-3
也可以参考addDays()。
注意Qt::LocalDate在这里不能使用。
注意Qt::TextDate：它被推荐使用英语中的月的缩写格式（比如Jan）。本地的月名称也可以被使用，但这取决于用户的本地设置。
如果这个日期是零日期，返回真，否则返回假。一个零日期是无效的。
也可以参考isValid()。
也可以参考isNull()。
如果一个给定的（年、月、日分别为y、m、d）日期是有效的，返回真。
实例：
QDate::isValid( 2002, 5, 17 ); // 真，2002年5月17日是有效的
QDate::isValid( 2002, 2, 30 ); // 假，2月30日是不存在的
QDate::isValid( 2004, 2, 29 ); // 真，2004年是闰年
QDate::isValid( 1202, 6, 6 ); // 假，1202是在格列高利历之前的
注意如果y在0－99范围内表示1900－1999。
1 = “Monday”、2 = “Tuesday”、……7 = “Sunday”
日名称将根据系统本地设置而改变。
也可以参考toString()、shortDayName()、shortMonthName()和longMonthName()。
1 = “January”、2 = “February”、……12 = “December”
月名称将根据系统本地设置而改变。
也可以参考toString()、shortMonthName()、shortDayName()和longDayName()。
使用shortMonthName()来替代它。
y必须在1752－8000之间，m必须在1－12之间，d必须在1－31之间。例外，如果y在0－99之间，它表示的是1900－1999。
如果日期有效，返回真，否则返回假。
1 = “Mon”、2 = “Tue”、……7 = “Sun”
日名称将根据系统本地设置而改变。
也可以参考toString()、shortMonthName()、longMonthName()和longDayName()。
1 = “Jan”、2 = “Feb”、……12 = “Dec”
月名称将根据系统本地设置而改变。
也可以参考toString()、longMonthName()、shortDayName()和longDayName()。
这些是可能用到的表达式：
所有其他输入字符都将被忽略。
格式字符串实例（假设这个QDate为2001年5月21日）
也可以参考QDate::toString() and QTime::toString().
返回一个字符串的日期。f参数决定了结果字符串的格式。
如果f是Qt::TextDate，字符串格式是“Sat May 20 1995”（使用shortDayName()和shortMonthName()函数来生成本地指定的字符串）。
如果f是Qt::ISODate，字符串格式遵循ISO 8601表示日期的说明，也就是YYYY-MM-DD，YYYY是年，MM是月（01－12），DD是日（01－31）。
如果f是Qt::LocalDate，字符串格式依赖于系统的本地设置。
也可以参考shortDayName() and shortMonthName().
也可以参考QDataStream操作符的格式。
也可以参考QDataStream操作符的格式。
这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。
| Copyright © 2002 Trolltech | Trademarks | 译者:Cavendish | Qt 3.0.5版
|