AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Link from QLocale to where date-time formats are explained

Browse Source 
QLocale has various methods that deal in date-time formats, which may
be supplied as strings; but does not document the form of a format
string.  That's documented in QDate, QTime and QDateTime, so link to
them for the details.

Task-number: QTBUG-23307
Change-Id: I6347d80a87dc03f6a4065e3d5bf4d535f05af93f
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
This commit is contained in:
Edward Welbourne 2018-07-30 17:43:05 +02:00
parent 2dfa41e0ea
commit 9a30a8f4fc
2 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/corelib/tools/qlocale.cpp
View File

@ -1773,6 +1773,8 @@ QString QLocale::toString(qulonglong i) const
Returns a localized string representation of the given \a date in the Returns a localized string representation of the given \a date in the
specified \a format. specified \a format.
If \a format is an empty string, an empty string is returned. If \a format is an empty string, an empty string is returned.
\sa QDate::toString()
*/ */
QString QLocale::toString(const QDate &date, const QString &format) const QString QLocale::toString(const QDate &date, const QString &format) const
@ -1787,6 +1789,8 @@ QString QLocale::toString(const QDate &date, const QString &format) const
Returns a localized string representation of the given \a date in the Returns a localized string representation of the given \a date in the
specified \a format. specified \a format.
If \a format is an empty string, an empty string is returned. If \a format is an empty string, an empty string is returned.
\sa QDate::toString()
*/ */
QString QLocale::toString(const QDate &date, QStringView format) const QString QLocale::toString(const QDate &date, QStringView format) const
{ {
@ -1839,6 +1843,8 @@ static bool timeFormatContainsAP(QStringView format)
Returns a localized string representation of the given \a time according Returns a localized string representation of the given \a time according
to the specified \a format. to the specified \a format.
If \a format is an empty string, an empty string is returned. If \a format is an empty string, an empty string is returned.
\sa QTime::toString()
*/ */
QString QLocale::toString(const QTime &time, const QString &format) const QString QLocale::toString(const QTime &time, const QString &format) const
{ {
@ -1852,6 +1858,8 @@ QString QLocale::toString(const QTime &time, const QString &format) const
Returns a localized string representation of the given \a time according Returns a localized string representation of the given \a time according
to the specified \a format. to the specified \a format.
If \a format is an empty string, an empty string is returned. If \a format is an empty string, an empty string is returned.
\sa QTime::toString()
*/ */
QString QLocale::toString(const QTime &time, QStringView format) const QString QLocale::toString(const QTime &time, QStringView format) const
{ {
@ -1865,6 +1873,8 @@ QString QLocale::toString(const QTime &time, QStringView format) const
Returns a localized string representation of the given \a dateTime according Returns a localized string representation of the given \a dateTime according
to the specified \a format. to the specified \a format.
If \a format is an empty string, an empty string is returned. If \a format is an empty string, an empty string is returned.
\sa QDateTime::toString(), QDate::toString(), QTime::toString()
*/ */
QString QLocale::toString(const QDateTime &dateTime, const QString &format) const QString QLocale::toString(const QDateTime &dateTime, const QString &format) const
@ -1879,6 +1889,8 @@ QString QLocale::toString(const QDateTime &dateTime, const QString &format) cons
Returns a localized string representation of the given \a dateTime according Returns a localized string representation of the given \a dateTime according
to the specified \a format. to the specified \a format.
If \a format is an empty string, an empty string is returned. If \a format is an empty string, an empty string is returned.
\sa QDateTime::toString(), QDate::toString(), QTime::toString()
*/ */
QString QLocale::toString(const QDateTime &dateTime, QStringView format) const QString QLocale::toString(const QDateTime &dateTime, QStringView format) const
{ {

4
src/corelib/tools/qlocale.qdoc
View File

@ -939,6 +939,8 @@
locale doesn't support narrow names, so you should avoid using it locale doesn't support narrow names, so you should avoid using it
for date formatting. Also, for the system locale this format is for date formatting. Also, for the system locale this format is
the same as ShortFormat. the same as ShortFormat.
\sa QDateTime::toString(), QDate::toString(), QTime::toString()
*/ */
/*! /*!
@ -1103,6 +1105,8 @@
\value ListToSeparatedString a string that represents a join of a given QStringList with a locale-defined separator. \value ListToSeparatedString a string that represents a join of a given QStringList with a locale-defined separator.
\value NativeLanguageName a string that represents the name of the native language. \value NativeLanguageName a string that represents the name of the native language.
\value NativeCountryName a string that represents the name of the native country. \value NativeCountryName a string that represents the name of the native country.
\sa FormatType
*/ */
/*! /*!