1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
/* This file is part of the KDE project
Copyright (C) 2006 Jaroslaw Staniek <js@iidea.pl>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this program; see the file COPYING. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KEXIDATETIMEFORMATTER_H
#define KEXIDATETIMEFORMATTER_H
#include <qdatetimeedit.h>
#include <qregexp.h>
//! @short Date formatter used by KexiDateTableEdit and KexiDateTimeTableEdit
class KEXIGUIUTILS_EXPORT KexiDateFormatter
{
public:
//! Creates new formatter with KDE setting for "short date"
KexiDateFormatter();
//! Creates new formatter with given settings
//! @todo KexiDateFormatter(... settings ...);
~KexiDateFormatter();
//! Converts string \a str to date using predefined settings.
//! \return invalid date if the conversion is impossible
QDate stringToDate( const QString& str ) const;
/*! Converts string \a str to date using predefined settings
and returns QVariant containing the date value.
This method does the same as stringToDate() but if \a string
contains invalid date representation, e.g. contains only spaces
and separators, null QVariant() is returned. */
QVariant stringToVariant( const QString& str ) const;
//! Converts \a date to string using predefined settings.
//! \return null string if \a date is invalid
QString dateToString( const QDate& date ) const;
//! \return Input mask generated using the formatter settings.
//! Can be used in QLineEdit::setInputMask().
QString inputMask() const { return m_inputMask; }
//! \return separator for this date format, a single character like "-" or "/"
QString separator() const { return m_separator; }
//! \return true if \a str contains only spaces
//! and separators according to the date format.
bool isEmpty( const QString& str ) const;
protected:
//! Input mask generated using the formatter settings. Can be used in QLineEdit::setInputMask().
QString m_inputMask;
//! Order of date sections
QDateEdit::Order m_order;
//! 4 or 2 digits
bool m_longYear;
bool m_monthWithLeadingZero, m_dayWithLeadingZero;
//! Date format used in dateToString()
QString m_qtFormat;
//! Used in stringToDate() to convert string back to QDate
int m_yearpos, m_monthpos, m_daypos;
QString m_separator;
};
/*! @short Time formatter used by KexiTimeTableEdit and KexiDateTimeTableEdit
Following time formats are allowed: HH:MM:SS (24h), HH:MM (24h), HH:MM AM/PM (12h)
Separator MUST be ":" */
class KEXIGUIUTILS_EXPORT KexiTimeFormatter
{
public:
//! Creates new formatter with KDE setting for time
KexiTimeFormatter();
//! Creates new formatter with given settings
//! @todo KexiDateFormatter(... settings ...);
~KexiTimeFormatter();
//! converts string \a str to time using predefined settings
//! \return invalid time if the conversion is impossible
QTime stringToTime( const QString& str ) const;
/*! Converts string \a str to time using predefined settings
and returns QVariant containing the time value.
This method does the same as stringToTime() but if \a string
contains invalid time representation, e.g. contains only spaces
and separators, null QVariant() is returned. */
QVariant stringToVariant( const QString& str );
//! converts \a time to string using predefined settings
//! \return null string if \a time is invalid
QString timeToString( const QTime& time ) const;
//! \return Input mask generated using the formatter settings.
//! Can be used in QLineEdit::setInputMask().
QString inputMask() const { return m_inputMask; }
//! \return true if \a str contains only spaces
//! and separators according to the time format.
bool isEmpty( const QString& str ) const;
protected:
//! Input mask generated using the formatter settings. Can be used in QLineEdit::setInputMask().
QString m_inputMask;
// //! Order of date sections
// QDateEdit::Order m_order;
//! 12 or 12h
bool m_24h;
bool m_hoursWithLeadingZero;
//! Time format used in timeToString(). Notation from KLocale::setTimeFormat() is used.
QString m_outputFormat;
//! Used in stringToTime() to convert string back to QTime
int m_hourpos, m_minpos, m_secpos, m_ampmpos;
QRegExp *m_hmsRegExp, *m_hmRegExp;
};
//! \return a date/time input mask using date and time formatter.
//! Date is separated from time by one space character.
KEXIGUIUTILS_EXPORT QString dateTimeInputMask(
const KexiDateFormatter& dateFormatter, const KexiTimeFormatter& timeFormatter);
/*! \return a QDateTime value converted from string using \a dateFormatter and \a timeFormatter.
A single space between date and time is assumed.
Invalid value is returned when \a str contains no valid date or \a str contains invalid time.
Value with time equal 00:00:00 is returned if \a str contains empty time part. */
KEXIGUIUTILS_EXPORT QDateTime stringToDateTime(
const KexiDateFormatter& dateFormatter, const KexiTimeFormatter& timeFormatter, const QString& str);
/*! \return true if \a str contains only spaces and separators according to formats provided by
\a dateFormatter and \a timeFormatter. */
KEXIGUIUTILS_EXPORT bool dateTimeIsEmpty( const KexiDateFormatter& dateFormatter,
const KexiTimeFormatter& timeFormatter, const QString& str );
/*! \return true if \a str gives valid date/time value according to formats provided by
\a dateFormatter and \a timeFormatter. */
KEXIGUIUTILS_EXPORT bool dateTimeIsValid( const KexiDateFormatter& dateFormatter,
const KexiTimeFormatter& timeFormatter, const QString& str );
#endif
|
