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 | 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::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입니다. 섹션 값의 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) |
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일이라고 가정):
Format | 결과 |
---|---|
dd.MM.yyyy | 02.07.1969 |
MMM d yy | 7월 2일 69 |
MMMM d yy | 7월 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
이 속성은 날짜 시간 편집의 최대 날짜 시간을 보유합니다.
이 속성을 변경하면 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 : 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) |
[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)
날짜 시간 수정에 허용되는 날짜 범위를 설정합니다.
이 편의 기능은 minimumDate 및 maximumDate 속성을 설정합니다.
setDateRange(min, max);
와 유사합니다:
setMinimumDate(min); setMaximumDate(max);
min 또는 max 중 하나가 유효하지 않은 경우 이 함수는 아무 작업도 수행하지 않습니다. 이 함수는 minimumTime 속성을 유지합니다. max 이 min 보다 작으면 새 maximumDateTime 속성이 새 minimumDateTime 속성이 됩니다. max 가 min 과 같고 maximumTime 속성이 minimumTime 속성보다 작으면 maximumTime 속성이 minimumTime 속성으로 설정됩니다. 그렇지 않으면 maximumTime 속성이 유지됩니다.
범위가 끝이 한 달에 걸쳐 있는 일주일과 같이 범위가 끝나는 시간 간격보다 좁은 경우 키보드 추적을 비활성화하면 사용자는 날짜를 범위의 후반부에 있는 날짜로만 편집할 수 있습니다.
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 로 사용됩니다.
범위가 끝이 한 달에 걸쳐 있는 일주일과 같이 범위가 끝나는 시간 간격보다 좁은 경우 키보드 추적을 비활성화하면 사용자는 날짜-시간을 범위의 후반부에 있는 날짜-시간으로만 편집할 수 있습니다.
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 에서 날짜 시간 편집의 값을 제한한다는 점에 유의하세요. 이러한 날짜 속성이 일치하지 않는 경우 maximumDate 이전 날짜에는 max 이후 시간이 허용되고 min 이전 날짜에는 minimumDate 이후 시간이 허용됩니다.
setTimeRange(min, max);
와 유사합니다:
setMinimumTime(min); setMaximumTime(max);
min 또는 max 중 하나가 유효하지 않은 경우 이 함수는 아무 작업도 수행하지 않습니다. 이 함수는 minimumDate 및 maximumDate 속성을 유지합니다. 이러한 속성이 일치하고 max 가 min 보다 작은 경우 min 는 max 로 사용됩니다.
범위가 끝이 같은 시간 간격보다 좁은 경우(예: 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.