diff -r 923ff622b8b9 -r 4633027730f5 src/hbwidgets/widgets/hbdatetimepicker.cpp
--- a/src/hbwidgets/widgets/hbdatetimepicker.cpp Tue Jul 06 14:36:53 2010 +0300
+++ b/src/hbwidgets/widgets/hbdatetimepicker.cpp Wed Aug 18 10:05:37 2010 +0300
@@ -30,62 +30,157 @@
/*!
@beta
\class HbDateTimePicker
- \brief HbDateTimePicker class provides a widget for picking the date, time, date and time.
+ \brief The HbDateTimePicker class provides a widget that has multiple vertical tumblers
+ for selecting a date, time, or date and time by flick, drag and tap gestures.
+
+ The number of tumblers depends on the display format. The default constructor creates
+ a widget for selecting a date by internally setting the display format to the default
+ locale's short date format. Other constructors enable you to create a widget
+ for selecting a time or date and time by passing a QTime or QDateTime variable as an
+ argument. Internally these constructors set the display format to the default locale's
+ short time or date and time format, respectively.
+
+ Use setDisplayFormat() to set the display format. Be aware that changing the display format
+ can change the widget from one for selecting the date to one for selecting the time, for
+ example.
+
+ Looping is enabled in the tumblers. The general appearance of the widget depends on the
+ theme that is in use.
+
+
- Expression | Output |
- d | The day as a number without a leading zero (1 to 31) |
- dd | The day as a number with a leading zero (01 to 31) |
- ddd |
- The abbreviated localized day name (e.g. 'Mon' to 'Sun').
- Uses QDate::shortDayName(). |
- dddd |
- The long localized day name (e.g. 'Monday' to 'Sunday').
- Uses QDate::longDayName(). |
- M | The month as a number without a leading zero (1 to 12) |
- MM | The month as a number with a leading zero (01 to 12) |
- MMM |
- The abbreviated localized month name (e.g. 'Jan' to 'Dec').
- Uses QDate::shortMonthName(). |
- MMMM |
- The long localized month name (e.g. 'January' to 'December').
- Uses QDate::longMonthName(). |
- yy | The year as two digit number (00 to 99) |
- yyyy | The year as four digit number. If the year is negative,
- a minus sign is prepended in addition. |
+ Expression | Output |
+ d | The day as a number without a leading zero (1 to 31). |
+ dd | The day as a number with a leading zero (01 to 31). |
+ ddd | The abbreviated localized day name (such as Mon to Sun).
+ Uses QDate::shortDayName(). |
+ dddd | The long localized day name (such as Monday to Sunday).
+ Uses QDate::longDayName(). |
+ M | The month as a number without a leading zero (1 to 12). |
+ MM | The month as a number with a leading zero (01 to 12). |
+ MMM | The abbreviated localized month name (such as Jan to Dec).
+ Uses QDate::shortMonthName(). |
+ MMMM | The long localized month name (such as January to December).
+ Uses QDate::longMonthName(). |
+ yy | The year as a two digit number (00 to 99). |
+ yyyy | The year as a four digit number. If the year is negative,
+ a minus sign is prepended. |
+
+
+ These expressions may be used for the time:
+
+
+ Expression | Output |
+ h | The hour without a leading zero (0 to 23 or 1 to 12). |
+ hh | The hour with a leading zero (00 to 23 or 01 to 12). |
+ H | The hour without a leading zero (0 to 23, even with AM/PM display). |
+ HH | The hour with a leading zero (00 to 23, even with AM/PM display). |
+ m | The minute without a leading zero (0 to 59). |
+ mm | The minute with a leading zero (00 to 59). |
+ s | The second without a leading zero (0 to 59). |
+ ss | The second with a leading zero (00 to 59). |
+ AP or A | Displays AM and PM. |
+ ap or a | Displays am and pm. |
- NOTE:setDisplayFormat works only when the separators are mentioned in the format like 'dd.mm.yy' or 'dd mm yy', this
- will be fixed in the future versions.
-
- \param format is the display format, for datetime picker widget, in QString format.
+ \note Currently you must include separators in the format; for example, 'dd.mm.yy'.
\sa displayFormat()
*/
@@ -235,25 +338,20 @@
}
/*!
- Returns the current date in QDate format.
-
- \return current selected date in datetime picker.
-
-