| /**************************************************************************** |
| ** |
| ** Copyright (C) 2019 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtCore module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QDATETIMEPARSER_P_H |
| #define QDATETIMEPARSER_P_H |
| |
| // |
| // W A R N I N G |
| // ------------- |
| // |
| // This file is not part of the Qt API. It exists purely as an |
| // implementation detail. This header file may change from version to |
| // version without notice, or even be removed. |
| // |
| // We mean it. |
| // |
| |
| #include <QtCore/private/qglobal_p.h> |
| #include "qplatformdefs.h" |
| #include "QtCore/qatomic.h" |
| #include "QtCore/qdatetime.h" |
| #include "QtCore/qstringlist.h" |
| #include "QtCore/qlocale.h" |
| #include "QtCore/qcalendar.h" |
| #ifndef QT_BOOTSTRAPPED |
| # include "QtCore/qvariant.h" |
| #endif |
| #include "QtCore/qvector.h" |
| #include "QtCore/qcoreapplication.h" |
| |
| QT_REQUIRE_CONFIG(datetimeparser); |
| |
| #define QDATETIMEEDIT_TIME_MIN QTime(0, 0) // Prefer QDate::startOfDay() |
| #define QDATETIMEEDIT_TIME_MAX QTime(23, 59, 59, 999) // Prefer QDate::endOfDay() |
| #define QDATETIMEEDIT_DATE_MIN QDate(100, 1, 1) |
| #define QDATETIMEEDIT_COMPAT_DATE_MIN QDate(1752, 9, 14) |
| #define QDATETIMEEDIT_DATE_MAX QDate(9999, 12, 31) |
| #define QDATETIMEEDIT_DATE_INITIAL QDate(2000, 1, 1) |
| |
| QT_BEGIN_NAMESPACE |
| |
| class Q_CORE_EXPORT QDateTimeParser |
| { |
| Q_DECLARE_TR_FUNCTIONS(QDateTimeParser) |
| public: |
| enum Context { |
| FromString, |
| DateTimeEdit |
| }; |
| QDateTimeParser(QMetaType::Type t, Context ctx, const QCalendar &cal = QCalendar()) |
| : currentSectionIndex(-1), cachedDay(-1), parserType(t), |
| fixday(false), context(ctx), calendar(cal) |
| { |
| defaultLocale = QLocale::system(); |
| first.type = FirstSection; |
| first.pos = -1; |
| first.count = -1; |
| first.zeroesAdded = 0; |
| last.type = LastSection; |
| last.pos = -1; |
| last.count = -1; |
| last.zeroesAdded = 0; |
| none.type = NoSection; |
| none.pos = -1; |
| none.count = -1; |
| none.zeroesAdded = 0; |
| } |
| virtual ~QDateTimeParser(); |
| |
| enum Section { |
| NoSection = 0x00000, |
| AmPmSection = 0x00001, |
| MSecSection = 0x00002, |
| SecondSection = 0x00004, |
| MinuteSection = 0x00008, |
| Hour12Section = 0x00010, |
| Hour24Section = 0x00020, |
| TimeZoneSection = 0x00040, |
| HourSectionMask = (Hour12Section | Hour24Section), |
| TimeSectionMask = (MSecSection | SecondSection | MinuteSection | |
| HourSectionMask | AmPmSection | TimeZoneSection), |
| |
| DaySection = 0x00100, |
| MonthSection = 0x00200, |
| YearSection = 0x00400, |
| YearSection2Digits = 0x00800, |
| YearSectionMask = YearSection | YearSection2Digits, |
| DayOfWeekSectionShort = 0x01000, |
| DayOfWeekSectionLong = 0x02000, |
| DayOfWeekSectionMask = DayOfWeekSectionShort | DayOfWeekSectionLong, |
| DaySectionMask = DaySection | DayOfWeekSectionMask, |
| DateSectionMask = DaySectionMask | MonthSection | YearSectionMask, |
| |
| Internal = 0x10000, |
| FirstSection = 0x20000 | Internal, |
| LastSection = 0x40000 | Internal, |
| CalendarPopupSection = 0x80000 | Internal, |
| |
| NoSectionIndex = -1, |
| FirstSectionIndex = -2, |
| LastSectionIndex = -3, |
| CalendarPopupIndex = -4 |
| }; // extending qdatetimeedit.h's equivalent |
| Q_DECLARE_FLAGS(Sections, Section) |
| |
| struct Q_CORE_EXPORT SectionNode { |
| Section type; |
| mutable int pos; |
| int count; |
| int zeroesAdded; |
| |
| static QString name(Section s); |
| QString name() const { return name(type); } |
| QString format() const; |
| int maxChange() const; |
| }; |
| |
| enum State { // duplicated from QValidator |
| Invalid, |
| Intermediate, |
| Acceptable |
| }; |
| |
| struct StateNode { |
| StateNode() : state(Invalid), padded(0), conflicts(false) {} |
| StateNode(const QDateTime &val, State ok=Acceptable, int pad=0, bool bad=false) |
| : value(val), state(ok), padded(pad), conflicts(bad) {} |
| QString input; |
| QDateTime value; |
| State state; |
| int padded; |
| bool conflicts; |
| }; |
| |
| enum AmPm { |
| AmText, |
| PmText |
| }; |
| |
| enum Case { |
| UpperCase, |
| LowerCase |
| }; |
| |
| #if QT_CONFIG(datestring) |
| StateNode parse(QString input, int position, const QDateTime &defaultValue, bool fixup) const; |
| bool fromString(const QString &text, QDate *date, QTime *time) const; |
| bool fromString(const QString &text, QDateTime* datetime) const; |
| #endif |
| bool parseFormat(const QString &format); |
| |
| enum FieldInfoFlag { |
| Numeric = 0x01, |
| FixedWidth = 0x02, |
| AllowPartial = 0x04, |
| Fraction = 0x08 |
| }; |
| Q_DECLARE_FLAGS(FieldInfo, FieldInfoFlag) |
| |
| FieldInfo fieldInfo(int index) const; |
| |
| void setDefaultLocale(const QLocale &loc) { defaultLocale = loc; } |
| virtual QString displayText() const { return text; } |
| void setCalendar(const QCalendar &calendar); |
| |
| private: |
| int sectionMaxSize(Section s, int count) const; |
| QString sectionText(const QString &text, int sectionIndex, int index) const; |
| #if QT_CONFIG(datestring) |
| StateNode scanString(const QDateTime &defaultValue, |
| bool fixup, QString *input) const; |
| struct ParsedSection { |
| int value; |
| int used; |
| int zeroes; |
| State state; |
| Q_DECL_CONSTEXPR ParsedSection(State ok = Invalid, |
| int val = 0, int read = 0, int zs = 0) |
| : value(ok == Invalid ? -1 : val), used(read), zeroes(zs), state(ok) |
| {} |
| }; |
| ParsedSection parseSection(const QDateTime ¤tValue, int sectionIndex, |
| int offset, QString *text) const; |
| int findMonth(const QString &str1, int monthstart, int sectionIndex, |
| int year, QString *monthName = nullptr, int *used = nullptr) const; |
| int findDay(const QString &str1, int intDaystart, int sectionIndex, |
| QString *dayName = nullptr, int *used = nullptr) const; |
| ParsedSection findUtcOffset(QStringRef str) const; |
| ParsedSection findTimeZoneName(QStringRef str, const QDateTime &when) const; |
| ParsedSection findTimeZone(QStringRef str, const QDateTime &when, |
| int maxVal, int minVal) const; |
| // Implemented in qdatetime.cpp: |
| static int startsWithLocalTimeZone(const QStringRef name); |
| |
| enum AmPmFinder { |
| Neither = -1, |
| AM = 0, |
| PM = 1, |
| PossibleAM = 2, |
| PossiblePM = 3, |
| PossibleBoth = 4 |
| }; |
| AmPmFinder findAmPm(QString &str, int index, int *used = nullptr) const; |
| #endif // datestring |
| |
| bool potentialValue(const QStringRef &str, int min, int max, int index, |
| const QDateTime ¤tValue, int insert) const; |
| bool potentialValue(const QString &str, int min, int max, int index, |
| const QDateTime ¤tValue, int insert) const |
| { |
| return potentialValue(QStringRef(&str), min, max, index, currentValue, insert); |
| } |
| |
| protected: // for the benefit of QDateTimeEditPrivate |
| int sectionSize(int index) const; |
| int sectionMaxSize(int index) const; |
| int sectionPos(int index) const; |
| int sectionPos(const SectionNode &sn) const; |
| |
| const SectionNode §ionNode(int index) const; |
| Section sectionType(int index) const; |
| QString sectionText(int sectionIndex) const; |
| int getDigit(const QDateTime &dt, int index) const; |
| bool setDigit(QDateTime &t, int index, int newval) const; |
| |
| int absoluteMax(int index, const QDateTime &value = QDateTime()) const; |
| int absoluteMin(int index) const; |
| |
| bool skipToNextSection(int section, const QDateTime ¤t, const QStringRef §ionText) const; |
| bool skipToNextSection(int section, const QDateTime ¤t, const QString §ionText) const |
| { |
| return skipToNextSection(section, current, QStringRef(§ionText)); |
| } |
| QString stateName(State s) const; |
| virtual QDateTime getMinimum() const; |
| virtual QDateTime getMaximum() const; |
| virtual int cursorPosition() const { return -1; } |
| virtual QString getAmPmText(AmPm ap, Case cs) const; |
| virtual QLocale locale() const { return defaultLocale; } |
| |
| mutable int currentSectionIndex; |
| Sections display; |
| /* |
| This stores the most recently selected day. |
| It is useful when considering the following scenario: |
| |
| 1. Date is: 31/01/2000 |
| 2. User increments month: 29/02/2000 |
| 3. User increments month: 31/03/2000 |
| |
| At step 1, cachedDay stores 31. At step 2, the 31 is invalid for February, so the cachedDay is not updated. |
| At step 3, the month is changed to March, for which 31 is a valid day. Since 29 < 31, the day is set to cachedDay. |
| This is good for when users have selected their desired day and are scrolling up or down in the month or year section |
| and do not want smaller months (or non-leap years) to alter the day that they chose. |
| */ |
| mutable int cachedDay; |
| mutable QString text; |
| QVector<SectionNode> sectionNodes; |
| SectionNode first, last, none, popup; |
| QStringList separators; |
| QString displayFormat; |
| QLocale defaultLocale; |
| QMetaType::Type parserType; |
| bool fixday; |
| Context context; |
| QCalendar calendar; |
| }; |
| Q_DECLARE_TYPEINFO(QDateTimeParser::SectionNode, Q_PRIMITIVE_TYPE); |
| |
| Q_CORE_EXPORT bool operator==(const QDateTimeParser::SectionNode &s1, const QDateTimeParser::SectionNode &s2); |
| |
| Q_DECLARE_OPERATORS_FOR_FLAGS(QDateTimeParser::Sections) |
| Q_DECLARE_OPERATORS_FOR_FLAGS(QDateTimeParser::FieldInfo) |
| |
| QT_END_NAMESPACE |
| |
| #endif // QDATETIME_P_H |