Qt中文文档-QDate

返回字符串形式的日期。 参数format控制输出的格式。如果传入参数cal, 它决定了使用的日历系统，默认是格里高利历。

日期格式的表示如下：

单引号包裹的内容将会一字不差地放进输出到字符串中（不带外面的单引号），尽管包含上述格式占位符。连续两个单引号(’’)会被转义成一个单引号输出。所有其他字符不会被转义，将原封不动输出。

没有分隔符的多个占位符（例如 “ddMM”）受支持，但要慎用。因为结果的可读性不好，容易引发歧义（例如难以区分“dM”的输出"212"是清2.12还是21,2）

假设今天是1969年7月20日，下面是一些格式字符串的例子

如果日期非法，会返回空字符串。

注意： 如果需要本地化的日期表达, 请使用 QLocale::system().toString()，因为 QDate 将在 Qt 6 使用英文表达（C语言风格）。

另请参阅：fromString()、QDateTime::toString()、QTime::toString() 和 QLocale::toString()。

返回这一天的最后一刻的时间。通常来说，是午夜前1ms：然而，如果时区转换让这一天跨过午夜（如夏令时），返回的是真实的最后一刻时间。这种情况只可能在使用时区参数QTimeZone zone或者本地时间参数 Qt::LocalTime spec时发生。

参数 offsetSeconds 会被忽略，除非参数 spec 为 Qt::OffsetFromUTC，其表示出了时区信息。如果UTC和那个时区间没有过渡，一天的结束是 QTime(23, 59, 59, 999)。

在罕见的日期被整体跳过（只在从东向西跨越国际日期变更线时），返回可能是非法的。将 Qt::TimeZone 作为 spec 参数传递 (而不是一个 QTimeZone) 也会造成非法结果，如果那一时刻超过了 QDateTime 的表示范围。

函数在 Qt 5.14 中引入。

另请参阅：startOfDay()。

返回一天的开始时刻。通常来说应该是午夜那一时刻：然而，如果时区转换让这一天跨过午夜（如夏令时），返回的是真实的最早的一刻时间。这种情况只可能在使用时区参数QTimeZone zone或者本地时间参数 Qt::LocalTime spec时发生。

参数 offsetSeconds 会被忽略，除非参数 spec 为 Qt::OffsetFromUTC，其表示出了时区信息。如果UTC和那个时区间没有过渡，一天的结束是 QTime(0, 0)。

在罕见的日期被整体跳过（只在从东向西跨越国际日期变更线时），返回可能是非法的。

将 Qt::TimeZone 作为 spec 参数传递 (而不是一个 QTimeZone) 也会造成非法结果，如果那一时刻超过了 QDateTime 的表示范围。

函数在 Qt 5.14 中引入。

另请参阅：endOfDay()。

返回一个 ndays 天之后的新日期对象(负数意味着往前减日期)。

当当前日期或新日期是非法日期时，返回非法日期。

另请参阅：addMonths()、addYears() 和 daysTo()。

返回一个 nmonths 月之后的新日期对象（负数意味着往前减日期）。

如果传入 cal 参数，会使用日历系统使用，否则使用格里高利历。

注意： 如果新的日期超出年、月的合理范围，函数讲返回那个月中最接近的日期。

另请参阅：addDays() 和 addYears()。

返回一个 nyears 年之后的新日期对象(负数意味着往前减日期)。

如果传入 cal 参数，会使用日历系统使用，否则使用格里高利历。

注意： 如果新的日期超出年、月的合理范围，函数讲返回那个月中最接近的日期。

另请参阅：addDays() 和 addMonths()。

返回日期是当前月份的第几天。

如果传入 cal 参数，会使用此日历系统，否则使用格里高利历。非法日期则返回0。

一些日历系统中，返回值可能大于7。

另请参阅：year()、month() 和 dayOfWeek()。

返回日期是当前周的第几天（1=周一，7=周日）。

如果传入 cal 参数，会使用此日历系统，否则使用格里高利历。非法日期则返回0。

一些日历系统中，返回值可能大于7。

另请参阅：day()、dayOfYear() 和 Qt::DayOfWeek。

返回日期是当年的第几天（第一天返回1）。

如果传入 cal 参数，会使用此日历系统，否则使用格里高利历。非法日期则返回0。

另请参阅：day() 和 dayOfWeek()。

返回日期对应的月份中总天数。

如果传入 cal 参数，会使用此日历系统，否则使用格里高利历 (返回值是 28~31)。非法日期则返回0。

另请参阅：day() 和 daysInYear()。

返回日期对应的一年中的总天数。

如果传入 cal 参数，会使用此日历系统，否则使用格里高利历 (返回值是 365 或 366)。非法日期则返回0。

另请参阅：day() 和 daysInMonth()。

返回两个日期相差的天数 (d 日期靠前则返回为负)。

如果比较的二者中有非法日期，返回0。

示例:

QDate d1(1995, 5, 17);  // May 17, 1995
QDate d2(1995, 5, 20);  // May 20, 1995
d1.daysTo(d2);          // returns 3
d2.daysTo(d1);          // returns -3

另请参阅：addDays()。

将jd表示的儒略日解析为日期并返回。

另请参阅：toJulianDay()。

返回 string 表示的 QDate 对象，非法字符串不会被解析。

注意 Qt::TextDate：建议使用英文的简写月份名称（例如 “Jan”）。尽管本地化的月份名称在 Qt 5 中也可使用，但它们会依赖于用户的区域设置。

注意： 对本地化的日期的支持，包括 Qt::SystemLocaleDate、Qt::SystemLocaleShortDate、Qt::SystemLocaleLongDate、Qt::LocaleDate、Qt::DefaultLocaleShortDate 和 Qt::DefaultLocaleLongDate，将在 Qt 6 被移除。使用 QLocale::toDate() 代替。

另请参阅：toString() 和 QLocale::toDate()。

返回 string 表示的 QDate 对象，非法字符串不会被解析。

如果传入 cal 参数，会使用此日历系统，否则使用格里高利历。下面的格式描述针对于格里高利历，其它日历可能不同。

日期格式的表示如下：

注意： 不行此函数的其他版, 日期和月份名必须使用用户本地语言。只有用户语言是英语时，英文名称才适用。

所有其他字符将会被舍弃，单引号(’’)包裹的内容，无论是否包含格式占位符也会被舍弃。例如：

QDate date = QDate::fromString("1MM12car2003", "d'MM'MMcaryyyy");
// date is 1 December 2003

如果字符串不符合格式，一个将返回一个非法的 QDate。不需要前面补0的格式是贪婪的，这意味着他们会读取两位数，尽管数字大小超出日期合法范围，并且会占据给后续格式读取的数字位置。例如，下面的日期可以表示1月30日，但M格式会捕获两位数字，导致日期返回非法：

QDate date = QDate::fromString("130", "Md"); // invalid

年月日中，没有出现在格式中的，将会使用如下默认值：

下面是默认值的示例：

QDate::fromString("1.30", "M.d");           // January 30 1900
QDate::fromString("20000110", "yyyyMMdd");  // January 10, 2000
QDate::fromString("20000110", "yyyyMd");    // January 10, 2000

注意： 如果使用本地化的日期表达, 请使用 QLocale::system().toDate(), 因为 QDate 将在 Qt 6使用英文表达 (C语言风格) 。

另请参阅：toString()、QDateTime::fromString()、QTime::fromString() 和 QLocale::toDate()。

返回月份编号，第一个月返回1。

如果传入 cal 参数，会使用日历系统使用，否则使用格里高利历。

对于格里高利历，1月就是咱中文说的阳历一月。

对于非法日期返回0。注意有一些日历中，月份可能多于12个。

另请参阅：year() 和 day()。

设置对应的日期，使用的是cal对应的日历。如果设置的日期合法，将返回 true，否则日期标记为非法并返回 false。

函数在 Qt 5.14 中引入。

另请参阅：isValid() 和 QCalendar::dateFromParts()。

将日期转换为儒略日。

另请参阅：fromJulianDay()。

这是一个重载函数，返回日期的字符串。 format 参数决定字符串格式。

如果 format 是 Qt::TextDate，日期使用默认格式。日期月份将使用系统地域设置，也就是 QLocale::system()。一个例子是 “Sat May 20 1995”。

如果 format 是 Qt::ISODate，字符串按照 ISO 8601 格式展开，格式形如 yyyy-MM-dd。例如2002-01-05

format 中的 Qt::SystemLocaleDate，Qt::SystemLocaleShortDate 和Qt::SystemLocaleLongDate 将在 Qt 6 中删除。这些应当由 QLocale::system().toString(date, QLocale::ShortFormat) 或 QLocale::system().toString(date, QLocale::LongFormat) 替代。

format 中的 Qt::LocaleDate，Qt::DefaultLocaleShortDate 和Qt::DefaultLocaleLongDate 将在 Qt 6 中删除。这些应当由 QLocale().toString(date, QLocale::ShortFormat) 或 QLocale().toString(date, QLocale::LongFormat) 替代。

如果 format 是 Qt::RFC2822Date, 字符串会转换成 RFC 2822 兼容的格式。示例其一是 “20 May 1995”。

如果日期非法，返回空字符串。

警告： Qt::ISODate 格式只在0~9999年可用。

另请参阅：fromString() 和 QLocale::toString()。

返回整数型的年份。

如果传入参数 cal , 它决定了使用的日历系统，默认是格里高利历。

如果日期不合法，返回0。在一些日历系统中，比第一年早的年份非法。

如果使用包含第0年的日历系统，在返回0时通过 isValid() 判断是否合法。这些日历正常的使用负年份，-1年的下一年是0年，再下一年是1年。

一些日历中，没有0年份但是有负数年份。例如格里高利历，公元前x年就是年份-x。

另请参阅：month()，day()，QCalendar::hasYearZero() 和 QCalendar::isProleptic()。

向数据流写入日期

另请参阅：Serializing Qt Data Types。

从数据流读出日期

另请参阅：Serializing Qt Data Types。