[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"
PURPOSE "Provides support for a timezone backend using std::chrono."
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
)
qt_feature("datetimeparser" PRIVATE

View File

@ -24,11 +24,20 @@
representations}, such as the \l
{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}
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,
date and date-time types, along with addition of \l
{https://en.cppreference.com/w/cpp/chrono/duration} {duration
types}. QTimeZone now supports construction from a \l
{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.
*/