QDateTimeEdit Class
QDateTimeEdit クラスは、日付や時刻を編集するためのウィジェットを提供します。詳細...
| ヘッダー: | #include <QDateTimeEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 継承元: | QAbstractSpinBox |
| 継承元: |
パブリック型
| enum | Section { NoSection, AmPmSection, MSecSection, SecondSection, MinuteSection, …, YearSection } |
| flags | Sections |
プロパティ
|
|
パブリック関数
| QDateTimeEdit(QWidget *parent = nullptr) | |
| QDateTimeEdit(QDate date, QWidget *parent = nullptr) | |
| QDateTimeEdit(QTime time, QWidget *parent = nullptr) | |
| QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr) | |
| virtual | ~QDateTimeEdit() |
| QCalendar | calendar() const |
| bool | calendarPopup() const |
| QCalendarWidget * | calendarWidget() const |
| void | clearMaximumDate() |
| void | clearMaximumDateTime() |
| void | clearMaximumTime() |
| void | clearMinimumDate() |
| void | clearMinimumDateTime() |
| void | clearMinimumTime() |
| QDateTimeEdit::Section | currentSection() const |
| int | currentSectionIndex() const |
| QDate | date() const |
| QDateTime | dateTime() const |
| QString | displayFormat() const |
| QDateTimeEdit::Sections | displayedSections() const |
| QDate | maximumDate() const |
| QDateTime | maximumDateTime() const |
| QTime | maximumTime() const |
| QDate | minimumDate() const |
| QDateTime | minimumDateTime() const |
| QTime | minimumTime() const |
| QDateTimeEdit::Section | sectionAt(int index) const |
| int | sectionCount() const |
| QString | sectionText(QDateTimeEdit::Section section) const |
| void | setCalendar(QCalendar calendar) |
| void | setCalendarPopup(bool enable) |
| void | setCalendarWidget(QCalendarWidget *calendarWidget) |
| void | setCurrentSection(QDateTimeEdit::Section section) |
| void | setCurrentSectionIndex(int index) |
| void | setDateRange(QDate min, QDate max) |
| void | setDateTimeRange(const QDateTime &min, const QDateTime &max) |
| void | setDisplayFormat(const QString &format) |
| void | setMaximumDate(QDate max) |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | setMaximumTime(QTime max) |
| void | setMinimumDate(QDate min) |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | setMinimumTime(QTime min) |
| void | setSelectedSection(QDateTimeEdit::Section section) |
| void | setTimeRange(QTime min, QTime max) |
| void | setTimeZone(const QTimeZone &zone) |
| QTime | time() const |
| QTimeZone | timeZone() const |
再実装されたパブリック関数
| virtual void | clear() override |
| virtual bool | event(QEvent *event) override |
| virtual QSize | sizeHint() const override |
| virtual void | stepBy(int steps) override |
パブリックスロット
| void | setDate(QDate date) |
| void | setDateTime(const QDateTime &dateTime) |
| void | setTime(QTime time) |
シグナル
| void | dateChanged(QDate date) |
| void | dateTimeChanged(const QDateTime &datetime) |
| void | timeChanged(QTime time) |
protected関数
| virtual QDateTime | dateTimeFromText(const QString &text) const |
| virtual QString | textFromDateTime(const QDateTime &dateTime) const |
再実装されたプロテクト関数
| virtual void | fixup(QString &input) const override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual bool | focusNextPrevChild(bool next) override |
| virtual void | initStyleOption(QStyleOptionSpinBox *option) const override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual QAbstractSpinBox::StepEnabled | stepEnabled() const override |
| virtual QValidator::State | validate(QString &text, int &pos) const override |
| virtual void | wheelEvent(QWheelEvent *event) override |
詳細な説明

QDateTimeEdit を使用すると、ユーザーはキーボードや矢印キーを使って日付や時刻の値を増減させ、日付を編集することができます。矢印キーを使用すると、QDateTimeEdit ボックス内の各セクション間を移動できます。日付と時刻は、設定された形式に従って表示されます。setDisplayFormat() を参照してください。
QDateTimeEdit *dateEdit = new QDateTimeEdit(QDate::currentDate());
dateEdit->setMinimumDate(QDate::currentDate().addDays(-365));
dateEdit->setMaximumDate(QDate::currentDate().addDays(365));
dateEdit->setDisplayFormat("yyyy.MM.dd");ここでは、今日の日付で初期化された新しい QDateTimeEdit オブジェクトを作成し、有効な日付の範囲を今日から±365日以内に制限しました。順序は月、日、年の順に設定しています。
QDateTimeEdit の有効な値の範囲は、minimumDateTime 、maximumDateTime 、およびそれぞれの日付・時刻コンポーネントによって制御されます。デフォルトでは、西暦100年の初めから西暦9999年の終わりまでの日付と時刻が有効です。
ポップアップカレンダーウィジェットの使用
QDateTimeEdit は、QCalendarWidget を使用して日付を選択できるように設定できます。これは、calendarPopup プロパティを設定することで有効になります。さらに、setCalendarWidget() 関数を呼び出すことで、カレンダーのポップアップとして使用するカスタムカレンダーウィジェットを指定できます。既存のカレンダーウィジェットは、calendarWidget() で取得できます。
キーボード追跡
keyboard tracking が有効になっている場合(デフォルト)、フィールドの編集時のすべてのキー入力に対して、値の変更を示すシグナルが発生します。
range で許可された範囲が、その終了時刻をまたぐある時間間隔よりも狭い場合、キーボード追跡機能により、ユーザーが日付や時刻を編集してその間隔の後半部分にアクセスすることを防ぎます。 たとえば、範囲が 2020年4月29日から2020年5月2日までで、初期日付が 2020年4月30日の場合、 ユーザーは月(5月30日は範囲外)も日(4月2日は範囲外)も変更できません。
キーボードトラッキングが無効になっている場合、編集によって内容が変更された後にテキストフィールドからフォーカスが外れたときにのみ、変更が通知されます。これにより、ユーザーは無効な日付・時刻を編集して、有効な日付・時刻に到達することができます。
関連項目: QDateEdit 、QTimeEdit 、QDate 、およびQTime 。
メンバータイプのドキュメント
enum QDateTimeEdit::Section
flags QDateTimeEdit::Sections
| 定数 | 定数 |
|---|---|
QDateTimeEdit::NoSection | 0x0000 |
QDateTimeEdit::AmPmSection | 0x0001 |
QDateTimeEdit::MSecSection | 0x0002 |
QDateTimeEdit::SecondSection | 0x0004 |
QDateTimeEdit::MinuteSection | 0x0008 |
QDateTimeEdit::HourSection | 0x0010 |
QDateTimeEdit::DaySection | 0x0100 |
QDateTimeEdit::MonthSection | 0x0200 |
QDateTimeEdit::YearSection | 0x0400 |
Sections 型は、QFlags<Section> の typedef です。Section 値の論理和(OR)を格納します。
プロパティのドキュメント
calendarPopup : bool
このプロパティは、現在のカレンダーポップアップの表示モードを保持します。
矢印ボタンをクリックすると、カレンダーのポップアップが表示されます。このプロパティは、有効な日付表示形式が設定されている場合にのみ有効です。
アクセス関数:
| bool | calendarPopup() const |
| void | setCalendarPopup(bool enable) |
関連項目: setDisplayFormat()。
currentSection : Section
このプロパティは、スピンボックスの現在のセクションを保持します。
アクセス関数:
| QDateTimeEdit::Section | currentSection() const |
| void | setCurrentSection(QDateTimeEdit::Section section) |
currentSectionIndex : int
このプロパティは、スピンボックスの現在のセクションインデックスを保持します。
形式が「yyyy/MM/dd」で、displayTextが「2001/05/21」、cursorPositionが5の場合、currentSectionIndexは1を返します。cursorPositionが3の場合、currentSectionIndexは0となり、以下同様です。
アクセス関数:
| int | currentSectionIndex() const |
| void | setCurrentSectionIndex(int index) |
setCurrentSection() およびcurrentSection()も参照してください 。
date : QDate
このプロパティには、ウィジェットで設定されたQDate が格納されます。
デフォルトでは、このプロパティには2000年1月1日を指す日付が格納されています。
アクセス関数:
| QDate | date() const |
| void | setDate(QDate date) |
Notifierシグナル:
| void | dateChanged(QDate date) |
「 time 」および「dateTime 」も参照してください 。
dateTime : QDateTime
このプロパティには、QDateTimeEdit で設定されたQDateTime が格納されます。
このプロパティを設定する際、新しいQDateTime はQDateTimeEdit の時間システムに変換されるため、元の は変更されません。
デフォルトでは、このプロパティは西暦 2000 年の初めに設定されています。このプロパティには、有効な `QDateTime ` 値のみを設定できます。何らかの操作によってこのプロパティの値が無効な日時になった場合、minimumDateTime プロパティの値にリセットされます。
QDateTimeEdit に日付フィールドがない場合、このプロパティを設定すると、ウィジェットの日付範囲は、このプロパティの新しい値の日付を起点および終点とするように設定されます。
アクセス関数:
| QDateTime | dateTime() const |
| void | setDateTime(const QDateTime &dateTime) |
通知シグナル:
| void | dateTimeChanged(const QDateTime &datetime) |
関連項目: date 、time 、minimumDateTime 、maximumDateTime 、およびtimeZone 。
displayFormat : QString
このプロパティには、日付時刻編集フィールドの日時を表示する際に使用される形式が格納されます。
この書式については、QDateTime::toString() およびQDateTime::fromString() に説明があります。
フォーマット文字列の例(日付が 1969年7月2日であると仮定した場合):
| フォーマット | 結果 |
|---|---|
| dd.MM.yyyy | 02.07.1969 |
| MMM d yy | 7月 2日 69 |
| MMMM d yy | 69年7月2日 |
2桁の年を指定した場合、その年は日時編集が初期化された世紀に属するものとして解釈されることに注意してください。デフォルトの世紀は21世紀(2000-2099)です。
無効な形式を指定した場合、その形式は設定されません。
Access 関数:
| QString | displayFormat() const |
| void | setDisplayFormat(const QString &format) |
QDateTime::toString() およびdisplayedSections()も参照してください 。
[read-only] displayedSections : Sections
このプロパティには、日時編集フィールドに現在表示されているフィールドが格納されます。
このフォーマットで表示されているセクションのビットセットを返します。
アクセス関数:
| QDateTimeEdit::Sections | displayedSections() const |
setDisplayFormat() およびdisplayFormat()も参照してください 。
maximumDate : QDate
このプロパティは、日時編集フィールドの最大日付を保持します。
このプロパティを変更すると、maximumTime プロパティを維持したまま、maximumDateTime プロパティの日付が更新されます。このプロパティを設定する際、範囲が有効な状態を維持するために、必要に応じてminimumDate が調整されます。この調整が行われる際、minimumTime プロパティがmaximumTime プロパティよりも大きい場合は、 プロパティも調整されます。それ以外の場合は、このプロパティの変更によってminimumDateTime プロパティが維持されます。
このプロパティには、現在のmaximumTime プロパティが有効なQDateTime オブジェクトとなる日付を表す、有効なQDate オブジェクトのみを設定できます。setMaximumDate()が受け入れる最新の日付は、西暦9999年の末日です。これがこのプロパティのデフォルト値です。このデフォルト値は、clearMaximumDateTime() を使用して復元できます。
アクセス関数:
| QDate | maximumDate() const |
| void | setMaximumDate(QDate max) |
| void | clearMaximumDate() |
関連項目: minimumDate 、maximumTime 、maximumDateTime 、setDateRange()、QDate::isValid()、およびKeyboard Tracking 。
maximumDateTime : QDateTime
このプロパティには、日付・時刻編集フィールドの最大日付時刻が格納されます。
このプロパティを変更すると、maximumDate プロパティとmaximumTime プロパティが、それぞれこのプロパティの日付部分および時刻部分に暗黙的に更新されます。このプロパティを設定する際、範囲が有効な状態を維持できるよう、必要に応じてminimumDateTime が調整されます。それ以外の場合、このプロパティを変更してもminimumDateTime プロパティは維持されます。
このプロパティには、有効なQDateTime 値のみを設定できます。setMaximumDateTime()が受け付ける最新の日時は、西暦9999年の末日です。これがこのプロパティのデフォルト値です。このデフォルト値は、clearMaximumDateTime()を使用して復元できます。
アクセス関数:
| QDateTime | maximumDateTime() const |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | clearMaximumDateTime() |
関連項目: minimumDateTime 、maximumTime 、maximumDate()、setDateTimeRange()、QDateTime::isValid()、およびKeyboard Tracking 。
maximumTime : QTime
このプロパティには、日時編集フィールドの最大時間が格納されます。
このプロパティを変更すると、minimumDate およびmaximumDate プロパティの値を維持したまま、maximumDateTime プロパティの時刻が更新されます。これらの日付プロパティが一致している場合、このプロパティを設定すると、範囲の有効性を確保するために必要に応じてminimumTime プロパティが調整されます。それ以外の場合は、このプロパティを変更してもminimumDateTime プロパティの値は維持されます。
このプロパティには、有効なQTime の値を任意に設定できます。デフォルトでは、このプロパティには23:59:59および999ミリ秒の時間が設定されています。このデフォルト値は、clearMaximumTime() を使用して復元できます。
アクセス関数:
| QTime | maximumTime() const |
| void | setMaximumTime(QTime max) |
| void | clearMaximumTime() |
関連項目: minimumTime 、maximumDate 、maximumDateTime 、setTimeRange()、QTime::isValid()、およびKeyboard Tracking 。
minimumDate : QDate
このプロパティは、日時編集フィールドの最小日付を保持します。
このプロパティを変更すると、minimumTime プロパティは維持されたまま、minimumDateTime プロパティの日付が更新されます。このプロパティを設定する際、範囲が有効な状態を維持するために、必要に応じてmaximumDate が調整されます。この調整が行われる際、maximumTime プロパティがminimumTime プロパティよりも小さい場合は、 プロパティも調整されます。それ以外の場合、このプロパティの変更によってmaximumDateTime プロパティは維持されます。
このプロパティには、現在のminimumTime プロパティが有効なQDateTime オブジェクトとなる日付を表す、有効なQDate オブジェクトのみを設定できます。setMinimumDate()が受け付ける最も早い日付は、西暦100年の初めです。このプロパティのデフォルト値は、西暦1752年9月14日です。このデフォルト値は、clearMinimumDateTime() を使用して復元できます。
アクセス関数:
| QDate | minimumDate() const |
| void | setMinimumDate(QDate min) |
| void | clearMinimumDate() |
関連項目: maximumDate 、minimumTime 、minimumDateTime 、setDateRange()、QDate::isValid()、およびKeyboard Tracking 。
minimumDateTime : QDateTime
このプロパティには、日付・時刻編集フィールドの最小の日付時刻が格納されます。
このプロパティを変更すると、minimumDate プロパティとminimumTime プロパティが、それぞれこのプロパティの日付部分および時刻部分に合わせて暗黙的に更新されます。このプロパティを設定する際、範囲の有効性を確保するために、必要に応じてmaximumDateTime が調整されます。それ以外の場合、このプロパティを変更してもmaximumDateTime プロパティは保持されます。
このプロパティには、有効なQDateTime 値のみを設定できます。setMinimumDateTime()が受け入れる最も早い日時が西暦100年の初めです。このプロパティのデフォルト値は、西暦1752年9月14日の初めです。このデフォルト値は、clearMinimumDateTime()を使用して復元できます。
アクセス関数:
| QDateTime | minimumDateTime() const |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | clearMinimumDateTime() |
関連項目: maximumDateTime 、minimumTime 、minimumDate 、setDateTimeRange()、QDateTime::isValid()、およびKeyboard Tracking 。
minimumTime : QTime
このプロパティには、日付・時刻編集フィールドの最小時間が格納されます。
このプロパティを変更すると、minimumDate およびmaximumDate プロパティは保持されたまま、minimumDateTime プロパティの時刻が更新されます。これらの日付プロパティが一致している場合、このプロパティを設定すると、範囲が有効な状態を維持できるよう、必要に応じてmaximumTime プロパティが調整されます。それ以外の場合は、このプロパティを変更してもmaximumDateTime プロパティは保持されます。
このプロパティには、有効なQTime の値を任意に設定できます。デフォルトでは、このプロパティには時刻00:00:00、ミリ秒0が設定されています。このデフォルト値は、clearMinimumTime() を使用して復元できます。
アクセス関数:
| QTime | minimumTime() const |
| void | setMinimumTime(QTime min) |
| void | clearMinimumTime() |
関連項目: maximumTime 、minimumDate 、minimumDateTime 、setTimeRange()、QTime::isValid()、およびKeyboard Tracking 。
[read-only] sectionCount : int
このプロパティは、表示されるセクションの数を保持します。形式が「yyyy/yy/yyyy」の場合、sectionCount は 3 を返します
アクセス関数:
| int | sectionCount() const |
time : QTime
このプロパティには、ウィジェットで設定されたQTime が格納されます。
デフォルトでは、このプロパティには 00:00:00 および 0 ミリ秒の時刻が格納されています。
アクセス関数:
| QTime | time() const |
| void | setTime(QTime time) |
Notifierシグナル:
| void | timeChanged(QTime time) |
「 date 」および「dateTime 」も参照してください 。
[since 6.7] timeZone : QTimeZone
このプロパティには、日時編集ウィジェットで使用されている現在のタイムゾーンが格納されます
使用中の日時フォーマットにタイムゾーンの識別子(つまり、t 、tt 、ttt 、またはtttt といったフォーマット指定子)が含まれている場合、ユーザーが入力したデータは解析されるたびにこのタイムゾーンで再表現され、ユーザーが指定したタイムゾーンは上書きされます。
この列挙型は Qt 6.7 で導入されました。
アクセス関数:
| QTimeZone | timeZone() const |
| void | setTimeZone(const QTimeZone &zone) |
QDateTimeEdit::displayFormatも参照してください 。
メンバ関数のドキュメント
[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)
parent を使用して、空の日時エディタを作成します。
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
parent を使用して、空の日時エディタを作成します。値はdate に設定されます。
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
parent を使用して、空の日時エディタを作成します。値はtime に設定されます。
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
parent を使用して、空の日時エディタを作成します。値はdatetime に設定されます。
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
デストラクタ。
QCalendar QDateTimeEdit::calendar() const
このウィジェットで使用されているカレンダーシステムを報告します。
setCalendar()も参照してください 。
QCalendarWidget *QDateTimeEdit::calendarWidget() const
calendarPopup がtrueに設定されており、かつ(sections() &DateSections_Mask) != 0の場合、エディタ用のカレンダーウィジェットを返します。
この関数は、カレンダーウィジェットが設定されていない場合に、カレンダーウィジェットを作成して返します。
setCalendarWidget()も参照してください 。
[override virtual] void QDateTimeEdit::clear()
QAbstractSpinBox::clear() を再実装しています。
QDate QDateTimeEdit::date() const
日時編集フィールドの日付を取得します。
注: date プロパティのゲッター 関数です。
関連項目: setDate()。
[signal] void QDateTimeEdit::dateChanged(QDate date)
このシグナルは、日付が変更されるたびに発火します。新しい日付は `date` に渡されます。
注: プロパティ `date`の通知 シグナルです。
「Keyboard Tracking」も参照してください 。
[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)
このシグナルは、日付または時刻が変更されるたびに発火します。新しい日付と時刻は、datetime に渡されます。
注: プロパティ `dateTime` に対する通知 シグナルです。
「Keyboard Tracking」も参照してください 。
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
指定されたtext に対して適切なdatetimeを返します。
この仮想関数は、ユーザーが入力したテキストを値として解釈する必要がある場合に、datetime編集フィールドによって使用されます。
textFromDateTime() およびvalidate()も参照してください 。
[override virtual] bool QDateTimeEdit::event(QEvent *event)
QAbstractSpinBox::event(QEvent *event) を再実装しています。
[override virtual protected] void QDateTimeEdit::fixup(QString &input) const
QAbstractSpinBox::fixup (QString &input)const を再実装します。
[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)
QAbstractSpinBox::focusInEvent(QFocusEvent *event) を再実装します。
[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)
QWidget::focusNextPrevChild (bool next)を再実装します。
[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const
QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const の再実装。
この QDataTimeEdit の値を使用して、option を初期化します。このメソッドは、QStyleOptionSpinBox が必要であるが、すべての情報を自分で入力したくないサブクラスにとって有用です。
QStyleOption::initFrom()も参照してください 。
[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)
QAbstractSpinBox::keyPressEvent(QKeyEvent *event) の再実装。
[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
QAbstractSpinBox::mousePressEvent (QMouseEvent *event)を再実装します。
[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)
QAbstractSpinBox::paintEvent(QPaintEvent *event) を再実装します。
QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const
index にあるセクションを返します。
形式が「yyyy/MM/dd」の場合、sectionAt(0) はYearSection を、sectionAt(1) はMonthSection を、sectionAt(2) はYearSection を返します。
QString QDateTimeEdit::sectionText(QDateTimeEdit::Section section) const
指定されたsection のテキストを返します。
currentSection()も参照してください 。
void QDateTimeEdit::setCalendar(QCalendar calendar)
このウィジェットで使用するカレンダーシステムとして、calendar を設定します。
このウィジェットは、サポートされている任意の暦システムを使用できます。デフォルトでは、グレゴリオ暦が使用されます。
calendar()も参照してください 。
void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)
指定されたcalendarWidget を、カレンダーのポップアップに使用するウィジェットとして設定します。エディタは、カレンダーウィジェットの所有権を自動的に取得することはありません。
注: カレンダーウィジェットを設定する前に、calendarPopup を true に設定する必要があります。
関連項目: calendarWidget() およびcalendarPopup 。
void QDateTimeEdit::setDateRange(QDate min, QDate max)
日時編集で許可される日付の範囲を設定します。
この便利関数は、minimumDate およびmaximumDate プロパティを設定します。
setDateRange(min, max);これは、以下と同様の動作をします:
setMinimumDate(min);
setMaximumDate(max);min またはmax のいずれかが無効な場合、この関数は何も行いません。この関数は、minimumTime プロパティを保持します。max がmin より小さい場合、新しいmaximumDateTime プロパティは新しいminimumDateTime プロパティとなります。max がmin に等しく、かつmaximumTime プロパティがminimumTime プロパティより小さかった場合、maximumTime プロパティはminimumTime プロパティに設定されます。それ以外の場合は、maximumTime プロパティが保持されます。
範囲が、その範囲の終わりをまたぐ時間間隔(たとえば、月末をまたぐ1週間など)よりも狭い場合、キーボードトラッキングが無効になっているときのみ、ユーザーは範囲の後半にある日付にのみ編集できます。
関連項目: minimumDate 、maximumDate 、setDateTimeRange()、QDate::isValid()、およびKeyboard Tracking 。
void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)
日時編集で許可される日時範囲を設定します。
この便利関数は、minimumDateTime およびmaximumDateTime プロパティを設定します。
setDateTimeRange(min, max);これは、以下と同等です:
setMinimumDateTime(min);
setMaximumDateTime(max);min またはmax のいずれかが無効な場合、この関数は何もしません。max がmin より小さい場合、min はmax としても使用されます。
範囲が、その範囲の終わりをまたぐ時間間隔(例えば、月末をまたぐ1週間など)よりも狭い場合、キーボードトラッキングが無効になっていると、ユーザーは日時を範囲の後半にある値にしか編集できません。
minimumDateTime 、maximumDateTime 、setDateRange()、setTimeRange()、QDateTime::isValid()、およびKeyboard Trackingも参照してください 。
void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)
section を選択します。現在表示されているセクションにsection が存在しない場合、この関数は何もしません。section がNoSection である場合、この関数はエディタ内のすべてのテキストの選択を解除します。それ以外の場合は、この関数はカーソルと現在のセクションを選択されたセクションに移動させます。
currentSection()も参照してください 。
void QDateTimeEdit::setTimeRange(QTime min, QTime max)
日時編集で許可される時間の範囲を設定します。
この便利関数は、minimumTime およびmaximumTime プロパティを設定します。
なお、これらはそれぞれminimumDate およびmaximumDate においてのみ、日付・時刻編集フィールドの値を制限する点に注意してください。これらの日付プロパティが一致しない場合、max 以降の時刻はmaximumDate 以前の日付で許可され、min 以前の時刻はminimumDate 以降の日付で許可されます。
setTimeRange(min, max);これは以下と同様です:
setMinimumTime(min);
setMaximumTime(max);min またはmax のいずれかが無効な場合、この関数は何も行いません。この関数は、minimumDate およびmaximumDate のプロパティを維持します。これらのプロパティが一致し、かつmax がmin より小さい場合、min はmax として扱われます。
範囲が狭く、その範囲の終わりにまたがる時間間隔(例えば、10時から1時間後までの間隔や、10時からその1時間後の10分後までの間隔など)の場合、キーボード追跡が無効になっているときのみ、ユーザーは範囲の後半部分にある時刻を1つだけ編集できます。
minimumTime 、maximumTime 、setDateTimeRange()、QTime::isValid()、およびKeyboard Trackingも参照してください 。
[override virtual] QSize QDateTimeEdit::sizeHint() const
QAbstractSpinBox::sizeHint() const を再実装します。
[override virtual] void QDateTimeEdit::stepBy(int steps)
QAbstractSpinBox::stepBy(int steps) を再実装します。
[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const
QAbstractSpinBox::stepEnabled() const を再実装します。
[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const
この仮想関数は、日付・時刻編集フィールドがdateTime を表示する必要があるたびに呼び出されます。
これを再実装する場合は、validate() も再実装する必要がある場合があります。
「 dateTimeFromText()」および「validate()」も参照してください 。
QTime QDateTimeEdit::time() const
日付・時刻編集時の時刻を返します。
注: プロパティ「time」のゲッター 関数です。
関連項目: setTime()。
[signal] void QDateTimeEdit::timeChanged(QTime time)
このシグナルは、時刻が変更されるたびに発火します。新しい時刻はtime に渡されます。
注: プロパティ `time` に対するNotifier シグナルです。
Keyboard Trackingも参照してください 。
[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const
QAbstractSpinBox::validate(QString &input, int &pos) const を再実装します。
[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)
QAbstractSpinBox::wheelEvent(QWheelEvent *event) の再実装です。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.