[docs] Add timezone details to overview of C++20 features

Briefly mention the new tzdb-based backend for QTimeZone.
Reference this on the AUTODETECT OFF line for the feature that controls it.

Task-number: QTBUG-128837
Change-Id: Ia13fbd08a9d62c3cd2f32bf6e5b77c69eb01e055
Reviewed-by: Ivan Solovev <ivan.solovev@qt.io>
This commit is contained in:
Edward Welbourne 2024-11-05 14:25:14 +01:00 committed by Ivan Solovev
parent 856aaa4c0c
commit ebb2658242
2 changed files with 12 additions and 1 deletions

View File

@ -1017,6 +1017,8 @@ qt_feature("timezone_tzdb" PUBLIC
LABEL "std::chrono::tzdb QTZ backend" LABEL "std::chrono::tzdb QTZ backend"
PURPOSE "Provides support for a timezone backend using std::chrono." PURPOSE "Provides support for a timezone backend using std::chrono."
CONDITION TEST_chrono_tzdb CONDITION TEST_chrono_tzdb
# See QTBUG-127598 for gcc's libstdc++'s deficiencies.
# Update src/corelib/doc/src/cpp20-overview.qdoc before enabling this:
AUTODETECT OFF AUTODETECT OFF
) )
qt_feature("datetimeparser" PRIVATE qt_feature("datetimeparser" PRIVATE

View File

@ -24,11 +24,20 @@
representations}, such as the \l representations}, such as the \l
{https://en.cppreference.com/w/cpp/chrono/system_clock} {system_clock} and {https://en.cppreference.com/w/cpp/chrono/system_clock} {system_clock} and
its \l {https://en.cppreference.com/w/cpp/chrono/time_point} {time_point} its \l {https://en.cppreference.com/w/cpp/chrono/time_point} {time_point}
types. When Qt is built with C++20, it can now make use of these additions. types. It also now provides access to the IANA database of \l
{https://en.cppreference.com/w/cpp/chrono#Time_zone} {timezone-related
information}. When Qt is built with C++20, it can now make use of these
additions.
QDate and QDateTime now support conversion to and from the various calendar, QDate and QDateTime now support conversion to and from the various calendar,
date and date-time types, along with addition of \l date and date-time types, along with addition of \l
{https://en.cppreference.com/w/cpp/chrono/duration} {duration {https://en.cppreference.com/w/cpp/chrono/duration} {duration
types}. QTimeZone now supports construction from a \l types}. QTimeZone now supports construction from a \l
{https://en.cppreference.com/w/cpp/chrono/time_zone} {time_zone}. {https://en.cppreference.com/w/cpp/chrono/time_zone} {time_zone}.
QTimeZone can also, when built with feature \c timezone_tzdb enabled, use
the C++20 \l {https://en.cppreference.com/w/cpp/chrono/tzdb} {tzdb}
facilities in place of platform-specific backends to access timezone
information. This remains experimental in Qt 6.9 as some standard library
implementations do not faithfully represent the IANA data for timezones.
*/ */