QDateTimeEdit Class

QDateTimeEdit 클래스는 날짜와 시간을 편집할 수 있는 위젯을 제공합니다. 더 보기...

헤더: #include <QDateTimeEdit>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속합니다: QAbstractSpinBox
상속 대상

QDateEditQTimeEdit

공용 유형

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 setTimeSpec(Qt::TimeSpec spec)
void setTimeZone(const QTimeZone &zone)
QTime time() const
Qt::TimeSpec timeSpec() 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)

보호된 함수

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 상자 내에서 섹션 간을 이동할 수 있습니다. 날짜와 시간은 설정된 형식에 따라 표시됩니다( 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년 말까지 모든 날짜-시간이 유효합니다.

팝업 캘린더 위젯 사용

날짜를 선택하는 데 QCalendarWidget 를 사용하도록 QDateTimeEdit를 구성할 수 있습니다. 이는 calendarPopup 속성을 설정하여 활성화할 수 있습니다. 또한 setCalendarWidget() 함수를 호출하여 캘린더 팝업으로 사용할 사용자 지정 캘린더 위젯을 제공할 수 있습니다. 기존 캘린더 위젯은 calendarWidget()로 검색할 수 있습니다.

키보드 추적

keyboard tracking (기본값)을 활성화하면 필드를 편집할 때마다 키 입력 시 값 변경에 대한 신호가 트리거됩니다.

허용된 range 범위가 끝이 가로지르는 일부 시간 간격보다 좁은 경우 키보드 추적은 사용자가 날짜 또는 시간을 편집하여 간격의 후반부에 액세스하지 못하도록 합니다. 예를 들어 범위가 29.04.2020 ~ 02.05.2020이고 초기 날짜가 30.04.2020인 경우 사용자는 월(5월 30일은 범위 밖에 있음)이나 일(4월 2일은 범위 밖에 있음)을 변경할 수 없습니다.

키보드 추적을 비활성화하면 편집으로 콘텐츠가 수정된 후 초점이 텍스트 필드에서 벗어날 때만 변경 사항이 표시됩니다. 따라서 사용자는 유효하지 않은 날짜/시간을 통해 편집하여 유효한 날짜/시간에 도달할 수 있습니다.

QDateEdit, QTimeEdit, QDate, QTime참조하세요 .

멤버 유형 문서

열거형 QDateTimeEdit::섹션
플래그 QDateTimeEdit::섹션

Constant
QDateTimeEdit::NoSection0x0000
QDateTimeEdit::AmPmSection0x0001
QDateTimeEdit::MSecSection0x0002
QDateTimeEdit::SecondSection0x0004
QDateTimeEdit::MinuteSection0x0008
QDateTimeEdit::HourSection0x0010
QDateTimeEdit::DaySection0x0100
QDateTimeEdit::MonthSection0x0200
QDateTimeEdit::YearSection0x0400

Sections 타입은 QFlags<Section>에 대한 typedef입니다. 섹션 값의 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)

알림 신호:

void dateChanged(QDate date)

timedateTime참조하세요 .

dateTime : QDateTime

이 속성은 QDateTimeEdit 에 설정된 QDateTime 을 보유합니다.

이 속성을 설정하면 새 QDateTimeQDateTimeEdit 의 시간 체계로 변환되므로 변경되지 않습니다.

기본적으로 이 속성은 서기 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일이라고 가정):

Format결과
dd.MM.yyyy02.07.1969
MMM d yy7월 2일 69
MMMM d yy7월 2일 69

두 자리 연도를 지정하면 날짜 시간 편집이 초기화된 세기로 해석됩니다. 기본 세기는 21세기(2000-2099)입니다.

잘못된 형식을 지정하면 형식이 설정되지 않습니다.

함수에 액세스합니다:

QString displayFormat() const
void setDisplayFormat(const QString &format)

QDateTime::toString() 및 displayedSections()도 참조하세요 .

[read-only] displayedSections : const 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

이 속성은 날짜 시간 편집의 최대 날짜 시간을 보유합니다.

이 속성을 변경하면 maximumDatemaximumTime 속성이 이 속성의 날짜 및 시간 부분으로 각각 암시적으로 업데이트됩니다. 이 속성을 설정할 때 필요한 경우 범위가 유효한지 확인하기 위해 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

이 속성은 날짜 시간 편집의 최대 시간을 보유합니다.

이 속성을 변경하면 minimumDatemaximumDate 속성은 그대로 유지하면서 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

이 속성은 날짜 시간 편집의 최소 날짜 시간을 보유합니다.

이 속성을 변경하면 minimumDateminimumTime 속성이 이 속성의 날짜 및 시간 부분으로 각각 암시적으로 업데이트됩니다. 이 속성을 설정할 때 필요한 경우 범위가 유효한지 확인하기 위해 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

이 속성은 날짜 시간 편집의 최소 시간을 보유합니다.

이 속성을 변경하면 minimumDatemaximumDate 속성은 그대로 유지하면서 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 : const int

이 속성은 표시되는 섹션의 수를 보유합니다. 형식이 'yyyy/yy/yyyy'인 경우 sectionCount는 3을 반환합니다.

함수에 액세스합니다:

int sectionCount() const

time : QTime

이 속성에는 위젯에 설정된 QTime 이 저장됩니다.

기본적으로 이 속성에는 00:00:00 및 0밀리초의 시간이 포함됩니다.

함수에 액세스합니다:

QTime time() const
void setTime(QTime time)

알림 신호:

void timeChanged(QTime time)

datedateTime참조하세요 .

[until 6.10] timeSpec : Qt::TimeSpec

이 속성은 버전 6.10에서 더 이상 사용되지 않을 예정입니다.

대신 QDateTimeEdit::timeZone 을 사용하세요.

이 프로퍼티는 날짜 시간 편집에 사용된 현재 타임스펙을 보유합니다.

Qt 6.7부터 이 프로퍼티는 timeZone 프로퍼티에 대한 간접 접근자입니다.

함수에 액세스합니다:

Qt::TimeSpec timeSpec() const
void setTimeSpec(Qt::TimeSpec spec)

QDateTimeEdit::timeZone참조하십시오 .

[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 가 참으로 설정되고 (섹션() & DateSections_Mask) != 0.

이 함수는 캘린더 위젯이 설정되지 않은 경우 캘린더 위젯을 생성하고 반환합니다.

setCalendarWidget()도 참조하세요 .

[override virtual] void QDateTimeEdit::clear()

다시 구현합니다: QAbstractSpinBox::clear().

QDate QDateTimeEdit::date() const

날짜 시간 편집 날짜를 반환합니다.

참고: 속성 날짜에 대한 게터 함수입니다.

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 에 적합한 날짜/시간을 반환합니다.

이 가상 함수는 사용자가 입력한 텍스트를 값으로 해석해야 할 때마다 날짜/시간 편집에서 사용됩니다.

textFromDateTime() 및 validate()도 참조하세요 .

[override virtual] bool QDateTimeEdit::event(QEvent *event)

다시 구현합니다: QAbstractSpinBox::event(QEvent * 이벤트).

[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 * 이벤트).

[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)

다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).

[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const

재구현합니다: QAbstractSpinBox::initStyleOption(Q스타일옵션 스핀박스 *옵션) const.

이 QDataTimeEdit의 값으로 option 를 초기화합니다. 이 메서드는 하위 클래스가 QStyleOptionSpinBox 이 필요하지만 모든 정보를 직접 채우고 싶지 않을 때 유용합니다.

QStyleOption::initFrom()도 참조하세요 .

[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)

다시 구현합니다: QAbstractSpinBox::keyPressEvent(QKeyEvent * 이벤트).

[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)

다시 구현합니다: QAbstractSpinBox::mousePressEvent(QMouseEvent * 이벤트).

[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)

다시 구현합니다: QAbstractSpinBox::paintEvent(QPaintEvent * 이벤트).

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 을 참으로 설정해야 합니다.

calendarWidget() 및 calendarPopup참조하세요 .

void QDateTimeEdit::setDateRange(QDate min, QDate max)

날짜 시간 수정에 허용되는 날짜 범위를 설정합니다.

이 편의 기능은 minimumDatemaximumDate 속성을 설정합니다.

setDateRange(min, max);

와 유사합니다:

setMinimumDate(min);
setMaximumDate(max);

min 또는 max 중 하나가 유효하지 않은 경우 이 함수는 아무 작업도 수행하지 않습니다. 이 함수는 minimumTime 속성을 유지합니다. maxmin 보다 작으면 새 maximumDateTime 속성이 새 minimumDateTime 속성이 됩니다. maxmin 과 같고 maximumTime 속성이 minimumTime 속성보다 작으면 maximumTime 속성이 minimumTime 속성으로 설정됩니다. 그렇지 않으면 maximumTime 속성이 유지됩니다.

범위가 끝이 한 달에 걸쳐 있는 일주일과 같이 범위가 끝나는 시간 간격보다 좁은 경우 키보드 추적을 비활성화하면 사용자는 날짜를 범위의 후반부에 있는 날짜로만 편집할 수 있습니다.

minimumDate, maximumDate, setDateTimeRange(), QDate::isValid() 및 Keyboard Tracking참조하세요 .

void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)

날짜 시간 수정에 허용되는 날짜-시간 범위를 설정합니다.

이 편의 기능은 minimumDateTimemaximumDateTime 속성을 설정합니다.

setDateTimeRange(min, max);

와 유사합니다:

setMinimumDateTime(min);
setMaximumDateTime(max);

min 또는 max 이 유효하지 않은 경우 이 함수는 아무 작업도 수행하지 않습니다. maxmin 보다 작으면 minmax 로 사용됩니다.

범위가 끝이 한 달에 걸쳐 있는 일주일과 같이 범위가 끝나는 시간 간격보다 좁은 경우 키보드 추적을 비활성화하면 사용자는 날짜-시간을 범위의 후반부에 있는 날짜-시간으로만 편집할 수 있습니다.

minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid() 및 Keyboard Tracking참조하세요 .

void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)

section 을 선택합니다. section 이 현재 표시된 섹션에 존재하지 않으면 이 함수는 아무 작업도 수행하지 않습니다. sectionNoSection 인 경우 이 함수는 편집기의 모든 텍스트를 선택 취소합니다. 그렇지 않으면 이 함수는 커서와 현재 섹션을 선택한 섹션으로 이동합니다.

currentSection()도 참조하세요 .

void QDateTimeEdit::setTimeRange(QTime min, QTime max)

날짜 시간 수정에 허용되는 시간 범위를 설정합니다.

이 편의 함수는 minimumTimemaximumTime 속성을 설정합니다.

이는 각각 minimumDatemaximumDate 에서 날짜 시간 편집의 값을 제한한다는 점에 유의하세요. 이러한 날짜 속성이 일치하지 않는 경우 maximumDate 이전 날짜에는 max 이후 시간이 허용되고 min 이전 날짜에는 minimumDate 이후 시간이 허용됩니다.

setTimeRange(min, max);

와 유사합니다:

setMinimumTime(min);
setMaximumTime(max);

min 또는 max 중 하나가 유효하지 않은 경우 이 함수는 아무 작업도 수행하지 않습니다. 이 함수는 minimumDatemaximumDate 속성을 유지합니다. 이러한 속성이 일치하고 maxmin 보다 작은 경우 minmax 로 사용됩니다.

범위가 끝이 같은 시간 간격보다 좁은 경우(예: 10시부터 한 시간까지와 같은 시간 이후 10시까지의 간격) 키보드 추적을 비활성화하면 사용자는 범위의 후반부에 있는 시간으로만 시간을 편집할 수 있습니다.

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

날짜 시간 편집 시간을 반환합니다.

참고: 속성 시간에 대한 게터 함수입니다.

setTime()도 참조하세요 .

[signal] void QDateTimeEdit::timeChanged(QTime time)

이 신호는 시간이 변경될 때마다 발신됩니다. 새 시간은 time 에 전달됩니다.

참고: 속성에 대한 알림 신호 time.

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 * 이벤트).

© 2025 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.