QDate 过时成员

以下 QDate 类的成员已弃用。 它们被提供以保持旧源代码的运行。我们强烈建议不要在新代码中使用它们。

公共函数

成员函数文档

[自 6.9 弃用] QDateTime QDate::endOfDay(Qt::TimeSpec spec, int offsetSeconds = 0) const

此函数自 6.9 起已弃用。我们强烈建议不要在新代码中使用它。

这是一个重载的函数。

请使用 endOfDay(const QTimeZone &) 代替。返回一天结束的时间点。一天何时结束取决于时间如何描述：对于与 UTC 时区距离越远的用户，每天开始和结束得越早；对于与 UTC 时区距离越近的用户，每天开始和结束得越晚。可以使用 \a spec 和 \a offsetSeconds 指定要使用的时间表示（除非 \a spec 是 Qt::OffsetSeconds，则忽略），或者指定时区。通常，一天结束在午夜之前的 1 毫秒，即 24:00:00；然而，如果当地时间过渡导致给定的日期跳过该时刻（例如，夏令时春季向前跳过 23:00 及其后的小时），则返回一天中的最新时间。当 \a spec 是 Qt::OffsetFromUTC 时，\a offsetSeconds 给出隐含时区相对于 UTC 的偏移量。由于 UTC 及此类时区没有过渡，因此在这种情况下一天结束时是 QTime(23, 59, 59, 999)。在极为罕见的情况下，整个日期都被跳过（这发生在国际日期变更线东边的时区向西切换时），则返回值应该是无效的。如果传递 Qt::TimeZone 作为 \a spec（而不是传递 QTimeZone），或者日期的结束超出了 QDateTime 可表示的范围，也会产生无效结果。

[自 6.9 弃用] QDateTime QDate::startOfDay(Qt::TimeSpec spec, int offsetSeconds = 0) const

此函数自 6.9 起已弃用。我们强烈建议不要在新代码中使用它。

这是一个重载的函数。

请使用 startOfDay(const QTimeZone &) 代替。

返回一天开始的时间点。

一天何时开始取决于时间如何描述：对于与 UTC 时区距离越远的用户，每天开始和结束得越早；对于与 UTC 时区距离越近的用户，每天开始和结束得越晚。可以使用 spec 和 offsetSeconds 指定要使用的时间表示（除非 spec 是 Qt::OffsetSeconds，则忽略），或者指定时区。

通常，一天的开始是午夜，00:00:然而，如果本地时间转换导致给定日期跳过那个午夜（例如，夏令时春转跳过一天的第一小时），将返回这一天的最早实际时间。

当spec是Qt::OffsetFromUTC时，offsetSeconds表示相对于UTC的隐含时区偏移。由于UTC和此类时区没有转换，在这种情况下，一天的开始是QTime(0, 0)。

在罕见的情况中，如果一个日期完全被跳过（这发生在位于国际日期变更线东部的区域切换到西部的区域时），则返回值应该是无效的。将Qt::TimeZone作为spec（而不是传递QTimeZone）也将产生无效结果，同样对于开始日期位于QDateTime可表示的范围之外的情况。