QDateTimeEdit Class
La clase QDateTimeEdit ofrece un widget para editar fechas y horas. Más información...
| Encabezado: | #include <QDateTimeEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QAbstractSpinBox |
| Heredado por: |
Tipos públicos
| enum | Section { NoSection, AmPmSection, MSecSection, SecondSection, MinuteSection, …, YearSection } |
| flags | Sections |
Propiedades
|
|
Funciones públicas
| 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 |
Funciones públicas reimplementadas
| virtual void | clear() override |
| virtual bool | event(QEvent *event) override |
| virtual QSize | sizeHint() const override |
| virtual void | stepBy(int steps) override |
Ranuras públicas
| void | setDate(QDate date) |
| void | setDateTime(const QDateTime &dateTime) |
| void | setTime(QTime time) |
Señales
| void | dateChanged(QDate date) |
| void | dateTimeChanged(const QDateTime &datetime) |
| void | timeChanged(QTime time) |
Funciones protegidas
| virtual QDateTime | dateTimeFromText(const QString &text) const |
| virtual QString | textFromDateTime(const QDateTime &dateTime) const |
Funciones protegidas reimplementadas
| 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 |
Descripción detallada

QDateTimeEdit permite al usuario editar fechas utilizando el teclado o las teclas de flecha para aumentar o disminuir los valores de fecha y hora. Las teclas de flecha se pueden utilizar para desplazarse de una sección a otra dentro del cuadro de QDateTimeEdit. Las fechas y horas aparecen según el formato establecido; véase setDisplayFormat().
QDateTimeEdit *dateEdit = new QDateTimeEdit(QDate::currentDate());
dateEdit->setMinimumDate(QDate::currentDate().addDays(-365));
dateEdit->setMaximumDate(QDate::currentDate().addDays(365));
dateEdit->setDisplayFormat("yyyy.MM.dd");Aquí hemos creado un nuevo objeto QDateTimeEdit inicializado con la fecha de hoy y hemos restringido el intervalo de fechas válido a hoy más o menos 365 días. Hemos establecido el orden en mes, día, año.
El rango de valores válidos para un QDateTimeEdit se controla mediante las propiedades minimumDateTime, maximumDateTime y sus respectivos componentes de fecha y hora. Por defecto, cualquier fecha y hora comprendida entre el año 100 d. C. y el año 9999 d. C. es válida.
Uso de un widget de calendario emergente
QDateTimeEdit se puede configurar para permitir el uso de un QCalendarWidget a la hora de seleccionar fechas. Esto se habilita configurando la propiedad calendarPopup. Además, puedes proporcionar un widget de calendario personalizado para utilizarlo como ventana emergente de calendario llamando a la función setCalendarWidget(). El widget de calendario existente se puede recuperar con calendarWidget().
Seguimiento del teclado
Cuando se habilita « keyboard tracking » (por defecto), cada pulsación de tecla al editar un campo desencadena señales de cambio de valor.
Cuando el intervalo permitido « range » es más estrecho que un intervalo de tiempo cuyo final se solapa con él, el seguimiento del teclado impide que el usuario edite la fecha o la hora para acceder a la parte posterior del intervalo. Por ejemplo, para un rango que va del 29 de abril de 2020 al 2 de mayo de 2020 y una fecha inicial del 30 de abril de 2020, el usuario no puede cambiar ni el mes (el 30 de mayo está fuera del intervalo) ni el día (el 2 de abril está fuera del intervalo).
Cuando el bloqueo de teclado está desactivado, los cambios solo se señalan cuando el foco abandona el campo de texto después de que las modificaciones hayan alterado el contenido. Esto permite al usuario editar a través de una fecha y hora no válidas para llegar a una válida.
Véase también QDateEdit, QTimeEdit, QDate y QTime.
Documentación sobre tipos de miembros
enum QDateTimeEdit::Section
flags QDateTimeEdit::Sections
| Constante | Valor |
|---|---|
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 |
El tipo «Sections» es una definición de tipo (typedef) para QFlags<Section>. Almacena una combinación OR de valores de «Section».
Documentación de la propiedad
calendarPopup : bool
Esta propiedad almacena el modo de visualización actual de la ventana emergente del calendario.
La ventana emergente del calendario se mostrará al hacer clic en el botón de flecha. Esta propiedad solo es válida si existe un formato de visualización de fechas válido.
Funciones de acceso:
| bool | calendarPopup() const |
| void | setCalendarPopup(bool enable) |
Véase también setDisplayFormat().
currentSection : Section
Esta propiedad contiene la sección actual del cuadro de selección.
Funciones de acceso:
| QDateTimeEdit::Section | currentSection() const |
| void | setCurrentSection(QDateTimeEdit::Section section) |
currentSectionIndex : int
Esta propiedad contiene el índice de sección actual del cuadro de selección.
Si el formato es «aaaa/MM/dd», el texto que se muestra es «2001/05/21» y la posición del cursor es 5, currentSectionIndex devuelve 1. Si la posición del cursor es 3, currentSectionIndex es 0, y así sucesivamente.
Funciones de acceso:
| int | currentSectionIndex() const |
| void | setCurrentSectionIndex(int index) |
Véanse también setCurrentSection() y currentSection().
date : QDate
Esta propiedad contiene el valor de « QDate » establecido en el widget.
Por defecto, esta propiedad contiene una fecha que hace referencia al 1 de enero de 2000.
Funciones de acceso:
| QDate | date() const |
| void | setDate(QDate date) |
Señal de notificador:
| void | dateChanged(QDate date) |
Véase también « time » y « dateTime ».
dateTime : QDateTime
Esta propiedad contiene el valor « QDateTime » establecido en la propiedad « QDateTimeEdit ».
Al configurar esta propiedad, el nuevo « QDateTime » se convierte al sistema de tiempo del « QDateTimeEdit », que, por lo tanto, permanece inalterado.
Por defecto, esta propiedad está establecida en el inicio del año 2000 d. C. Solo se puede establecer en un valor válido de « QDateTime ». Si alguna operación hace que esta propiedad tenga como valor una fecha y hora no válidas, se restablece al valor de la propiedad « minimumDateTime ».
Si el objeto ` QDateTimeEdit ` no tiene campos de fecha, al establecer esta propiedad se configura el intervalo de fechas del widget para que comience y termine en la fecha del nuevo valor de esta propiedad.
Funciones de acceso:
| QDateTime | dateTime() const |
| void | setDateTime(const QDateTime &dateTime) |
Señal de notificación:
| void | dateTimeChanged(const QDateTime &datetime) |
Véase también « date », « time », « minimumDateTime », « maximumDateTime » y « timeZone ».
displayFormat : QString
Esta propiedad contiene el formato utilizado para mostrar la hora y la fecha en el campo de edición de fecha y hora.
Este formato se describe en QDateTime::toString() y QDateTime::fromString()
Ejemplos de cadenas de formato (suponiendo que la fecha es el 2 de julio de 1969):
| Formato | Resultado |
|---|---|
| dd.MM.aaaa | 02.07.1969 |
| MMM d aaa | 2 de julio de 69 |
| MMMM d aa | 2 de julio de 69 |
Ten en cuenta que, si especificas un año de dos dígitos, se interpretará como perteneciente al siglo en el que se inicializó la edición de fecha y hora. El siglo predeterminado es el XXI (2000-2099).
Si se especifica un formato no válido, el formato no se establecerá.
Funciones de Access:
| QString | displayFormat() const |
| void | setDisplayFormat(const QString &format) |
Véase también QDateTime::toString() y displayedSections().
[read-only] displayedSections : Sections
Esta propiedad contiene los campos que se muestran actualmente en el campo de edición de fecha y hora.
Devuelve un conjunto de bits correspondiente a las secciones mostradas para este formato.
Funciones de acceso:
| QDateTimeEdit::Sections | displayedSections() const |
Véase también setDisplayFormat() y displayFormat().
maximumDate : QDate
Esta propiedad contiene la fecha máxima del campo de edición de fecha y hora.
Al modificar esta propiedad, se actualiza la fecha de la propiedad maximumDateTime, conservando al mismo tiempo la propiedad maximumTime. Al establecer esta propiedad, el minimumDate se ajusta, si es necesario, para garantizar que el intervalo siga siendo válido. Cuando esto ocurre, la propiedad minimumTime también se ajusta si es mayor que la propiedad maximumTime. En caso contrario, los cambios en esta propiedad conservan la propiedad minimumDateTime.
Esta propiedad solo puede establecerse en un objeto QDate válido que describa una fecha en la que la propiedad maximumTime actual dé lugar a un objeto QDateTime válido. La fecha más tardía que acepta setMaximumDate() es el final del año 9999 d. C. Este es el valor por defecto de esta propiedad. Este valor por defecto puede restablecerse con clearMaximumDateTime().
Funciones de acceso:
| QDate | maximumDate() const |
| void | setMaximumDate(QDate max) |
| void | clearMaximumDate() |
Véase también minimumDate, maximumTime, maximumDateTime, setDateRange(), QDate::isValid() y Keyboard Tracking.
maximumDateTime : QDateTime
Esta propiedad contiene la fecha y hora máximas del campo de edición de fecha y hora.
Al modificar esta propiedad, se actualizan implícitamente las propiedades « maximumDate » y « maximumTime » con la parte de fecha y la parte de hora de esta propiedad, respectivamente. Al establecer esta propiedad, se ajusta la propiedad « minimumDateTime », si es necesario, para garantizar que el intervalo siga siendo válido. De lo contrario, al modificar esta propiedad se conserva la propiedad « minimumDateTime ».
Esta propiedad solo puede establecerse en un valor válido de QDateTime. La fecha y hora más recientes que acepta setMaximumDateTime() es el final del año 9999 d. C. Este es el valor por defecto de esta propiedad. Este valor por defecto puede restablecerse con clearMaximumDateTime().
Funciones de acceso:
| QDateTime | maximumDateTime() const |
| void | setMaximumDateTime(const QDateTime &dt) |
| void | clearMaximumDateTime() |
Véase también minimumDateTime, maximumTime, maximumDate(), setDateTimeRange(), QDateTime::isValid() y Keyboard Tracking.
maximumTime : QTime
Esta propiedad contiene el tiempo máximo del campo de edición de fecha y hora.
Al modificar esta propiedad, se actualiza la hora de la propiedad « maximumDateTime », conservando al mismo tiempo las propiedades « minimumDate » y « maximumDate ». Si dichas propiedades de fecha coinciden, al establecer esta propiedad, la propiedad « minimumTime » se ajusta, si es necesario, para garantizar que el intervalo siga siendo válido. De lo contrario, al modificar esta propiedad se conserva la propiedad « minimumDateTime ».
Esta propiedad se puede establecer en cualquier valor válido de QTime. Por defecto, esta propiedad contiene una hora de 23:59:59 y 999 milisegundos. Este valor por defecto se puede restablecer con clearMaximumTime().
Funciones de acceso:
| QTime | maximumTime() const |
| void | setMaximumTime(QTime max) |
| void | clearMaximumTime() |
Véase también minimumTime, maximumDate, maximumDateTime, setTimeRange(), QTime::isValid() y Keyboard Tracking.
minimumDate : QDate
Esta propiedad contiene la fecha mínima del campo de edición de fecha y hora.
Al modificar esta propiedad, se actualiza la fecha de la propiedad minimumDateTime, conservándose al mismo tiempo la propiedad minimumTime. Al establecer esta propiedad, el maximumDate se ajusta, si es necesario, para garantizar que el rango siga siendo válido. Cuando esto ocurre, la propiedad maximumTime también se ajusta si es menor que la propiedad minimumTime. De lo contrario, los cambios en esta propiedad conservan la propiedad maximumDateTime.
Esta propiedad solo puede establecerse en un objeto QDate válido que describa una fecha en la que la propiedad minimumTime actual dé lugar a un objeto QDateTime válido. La fecha más temprana que acepta setMinimumDate() es el inicio del año 100 d. C. El valor por defecto de esta propiedad es el 14 de septiembre de 1752 d. C. Este valor por defecto puede restablecerse con clearMinimumDateTime().
Funciones de acceso:
| QDate | minimumDate() const |
| void | setMinimumDate(QDate min) |
| void | clearMinimumDate() |
Véase también maximumDate, minimumTime, minimumDateTime, setDateRange(), QDate::isValid() y Keyboard Tracking.
minimumDateTime : QDateTime
Esta propiedad contiene la fecha y hora mínimas del campo de edición de fecha y hora.
Al modificar esta propiedad, se actualizan implícitamente las propiedades « minimumDate » y « minimumTime » con la fecha y la hora de esta propiedad, respectivamente. Al establecer esta propiedad, se ajusta el « maximumDateTime », si es necesario, para garantizar que el intervalo siga siendo válido. De lo contrario, al modificar esta propiedad se conserva la propiedad « maximumDateTime ».
Esta propiedad solo puede establecerse en un valor válido de QDateTime. La fecha y hora más tempranas que acepta setMinimumDateTime() es el inicio del año 100 d. C. El valor por defecto de la propiedad es el inicio del 14 de septiembre de 1752 d. C. Este valor por defecto puede restablecerse con clearMinimumDateTime().
Funciones de acceso:
| QDateTime | minimumDateTime() const |
| void | setMinimumDateTime(const QDateTime &dt) |
| void | clearMinimumDateTime() |
Véase también maximumDateTime, minimumTime, minimumDate, setDateTimeRange(), QDateTime::isValid() y Keyboard Tracking.
minimumTime : QTime
Esta propiedad contiene la hora mínima del campo de edición de fecha y hora.
Al modificar esta propiedad, se actualiza la hora de la propiedad « minimumDateTime », conservando al mismo tiempo las propiedades « minimumDate » y « maximumDate ». Si esas propiedades de fecha coinciden, al establecer esta propiedad, la propiedad « maximumTime » se ajusta, si es necesario, para garantizar que el intervalo siga siendo válido. De lo contrario, al modificar esta propiedad se conserva la propiedad « maximumDateTime ».
Esta propiedad se puede establecer en cualquier valor válido de QTime. Por defecto, esta propiedad contiene una hora de 00:00:00 y 0 milisegundos. Este valor por defecto se puede restablecer con clearMinimumTime().
Funciones de acceso:
| QTime | minimumTime() const |
| void | setMinimumTime(QTime min) |
| void | clearMinimumTime() |
Véase también « maximumTime» , « minimumDate », « minimumDateTime », « setTimeRange()», « QTime::isValid()» y « Keyboard Tracking ».
[read-only] sectionCount : int
Esta propiedad contiene el número de secciones que se muestran. Si el formato es «aaaa/aa/aaaa», sectionCount devuelve 3
Funciones de acceso:
| int | sectionCount() const |
time : QTime
Esta propiedad contiene el valor de « QTime » establecido en el widget.
Por defecto, esta propiedad contiene una hora de 00:00:00 y 0 milisegundos.
Funciones de acceso:
| QTime | time() const |
| void | setTime(QTime time) |
Señal de notificador:
| void | timeChanged(QTime time) |
Véase también « date » y « dateTime ».
[since 6.7] timeZone : QTimeZone
Esta propiedad contiene la zona horaria actual que utiliza el widget de edición de fecha y hora
Si el formato de fecha y hora utilizado incluye un indicador de zona horaria —es decir, un especificador de formato del tipo t, tt, ttt o tttt —, la entrada del usuario se reexpresa en esta zona horaria cada vez que se analiza, anulando cualquier zona horaria que el usuario haya podido especificar.
Esta enumeración se introdujo en Qt 6.7.
Funciones de acceso:
| QTimeZone | timeZone() const |
| void | setTimeZone(const QTimeZone &zone) |
Véase también QDateTimeEdit::displayFormat.
Documentación de las funciones miembro
[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)
Crea un editor de fecha y hora vacío con un ` parent`.
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
Crea un editor de fecha y hora vacío con un valor de « parent ». El valor se establece en « date ».
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
Crea un editor de fecha y hora vacío con un ` parent`. El valor se establece en ` time`.
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
Crea un editor de fecha y hora vacío con un ` parent`. El valor se establece en ` datetime`.
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
Destructor.
QCalendar QDateTimeEdit::calendar() const
Indica el sistema de calendario que utiliza este widget.
Véase también setCalendar().
QCalendarWidget *QDateTimeEdit::calendarWidget() const
Devuelve el widget de calendario para el editor si ` calendarPopup ` está establecido en `true` y `(sections() & DateSections_Mask)` ≠ 0.
Esta función crea y devuelve un widget de calendario si no se ha establecido ninguno.
Véase también setCalendarWidget().
[override virtual] void QDateTimeEdit::clear()
Reimplementa: QAbstractSpinBox::clear().
QDate QDateTimeEdit::date() const
Devuelve la fecha de la entrada de fecha y hora.
Nota: Funcióngetter para la propiedad «date».
Véase también setDate().
[signal] void QDateTimeEdit::dateChanged(QDate date)
Esta señal se emite cada vez que se cambia la fecha. La nueva fecha se pasa a través de ` date`.
Nota: Señalde notificación para la propiedad date.
Véase también Keyboard Tracking.
[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)
Esta señal se emite cada vez que se modifica la fecha o la hora. La nueva fecha y hora se transmiten en ` datetime`.
Nota: Señalde notificación para la propiedad dateTime.
Véase también Keyboard Tracking.
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
Devuelve una fecha y hora adecuadas para el valor dado en ` text`.
Esta función virtual es utilizada por el campo de edición de fecha y hora cada vez que necesita interpretar el texto introducido por el usuario como un valor.
Véase también textFromDateTime() y validate().
[override virtual] bool QDateTimeEdit::event(QEvent *event)
Reimplementa: ` QAbstractSpinBox::event(QEvent *event)`.
[override virtual protected] void QDateTimeEdit::fixup(QString &input) const
Reimplementa: ` QAbstractSpinBox::fixup` (`QString &input`) const.
[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)
Reimplementa: QAbstractSpinBox::focusInEvent(QFocusEvent *event).
[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)
Reimplementa: ` QWidget::focusNextPrevChild` (bool next).
[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const
Reimplementa: ` QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const`.
Inicializa option con los valores de este QDataTimeEdit. Este método resulta útil para las subclases cuando necesitan un QStyleOptionSpinBox, pero no desean rellenar toda la información por sí mismas.
Véase también QStyleOption::initFrom().
[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)
Reimplementa: ` QAbstractSpinBox::keyPressEvent(QKeyEvent *event)`.
[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)
Reimplementa: QAbstractSpinBox::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)
Reimplementa: QAbstractSpinBox::paintEvent(QPaintEvent *event).
QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const
Devuelve la sección en index.
Si el formato es «aaaa/MM/dd», sectionAt(0) devuelve YearSection, sectionAt(1) devuelve MonthSection y sectionAt(2) devuelve YearSection,
QString QDateTimeEdit::sectionText(QDateTimeEdit::Section section) const
Devuelve el texto de la dirección section indicada.
Véase también currentSection().
void QDateTimeEdit::setCalendar(QCalendar calendar)
Establece calendar como el sistema de calendario que utilizará este widget.
El widget puede utilizar cualquier sistema de calendario compatible. Por defecto, utiliza el calendario gregoriano.
Véase también calendar().
void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)
Establece el « calendarWidget » indicado como el widget que se utilizará para la ventana emergente del calendario. El editor no asume automáticamente la propiedad del widget del calendario.
Nota: Se debe establecercalendarPopup en «true» antes de configurar el widget del calendario.
Véase también calendarWidget() y calendarPopup.
void QDateTimeEdit::setDateRange(QDate min, QDate max)
Establece el intervalo de fechas permitidas para la edición de fecha y hora.
Esta función de conveniencia establece las propiedades « minimumDate » y « maximumDate ».
setDateRange(min, max);Es análogo a:
setMinimumDate(min);
setMaximumDate(max);Si min o max no son válidas, esta función no realiza ninguna acción. Esta función conserva la propiedad minimumTime. Si max es menor que min, la nueva propiedad maximumDateTime será la nueva propiedad minimumDateTime. Si max es igual a min y la propiedad maximumTime era menor que la propiedad minimumTime, la propiedad maximumTime se establece en la propiedad minimumTime. En caso contrario, se conserva la propiedad maximumTime.
Si el intervalo es más corto que el intervalo de tiempo cuyo final abarca —por ejemplo, una semana que abarca el final de un mes—, los usuarios solo podrán editar la fecha para que corresponda a una fecha comprendida en la parte posterior del intervalo si el seguimiento del teclado está desactivado.
Véase también minimumDate, maximumDate, setDateTimeRange(), QDate::isValid() y Keyboard Tracking.
void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)
Establece el rango de fechas y horas permitidas para la edición de la fecha y la hora.
Esta función de conveniencia establece las propiedades « minimumDateTime » y « maximumDateTime ».
setDateTimeRange(min, max);Es análogo a:
setMinimumDateTime(min);
setMaximumDateTime(max);Si alguna de las propiedades min o max no es válida, esta función no realiza ninguna acción. Si max es menor que min, min se utiliza también como max.
Si el intervalo es más corto que el intervalo de tiempo cuyo final abarca —por ejemplo, una semana que abarca el final de un mes—, los usuarios solo podrán editar la fecha y hora para que corresponda a un valor situado en la parte posterior del intervalo si el seguimiento del teclado está desactivado.
Véase también minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid() y Keyboard Tracking.
void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)
Selecciona « section ». Si « section » no existe entre las secciones que se muestran actualmente, esta función no realiza ninguna acción. Si « section » es « NoSection », esta función deseleccionará todo el texto del editor. En caso contrario, esta función moverá el cursor y la sección actual a la sección seleccionada.
Véase también currentSection().
void QDateTimeEdit::setTimeRange(QTime min, QTime max)
Establece el intervalo de horas permitidas para la edición de la fecha y la hora.
Esta función de conveniencia establece las propiedades minimumTime y maximumTime.
Ten en cuenta que estas propiedades solo limitan el valor de la edición de fecha y hora, respectivamente, en minimumDate y maximumDate. Cuando estas propiedades de fecha no coinciden, se permiten horas posteriores a max en fechas anteriores a maximumDate y horas anteriores a min en fechas posteriores a minimumDate.
setTimeRange(min, max);es análogo a:
setMinimumTime(min);
setMaximumTime(max);Si min o max no son válidos, esta función no realiza ninguna acción. Esta función conserva las propiedades minimumDate y maximumDate. Si dichas propiedades coinciden y max es menor que min, se utiliza min como max.
Si el rango es más estrecho que un intervalo de tiempo cuyo final abarca —por ejemplo, el intervalo comprendido entre las diez y una hora y las diez y diez de la misma hora—, los usuarios solo podrán editar la hora a un valor comprendido en la parte posterior del rango si el seguimiento del teclado está desactivado.
Véase también minimumTime, maximumTime, setDateTimeRange(), QTime::isValid() y Keyboard Tracking.
[override virtual] QSize QDateTimeEdit::sizeHint() const
Reimplementa: QAbstractSpinBox::sizeHint() const.
[override virtual] void QDateTimeEdit::stepBy(int steps)
Reimplementa: QAbstractSpinBox::stepBy(int steps).
[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const
Reimplementa: ` QAbstractSpinBox::stepEnabled()` const.
[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const
El campo de edición de fecha y hora utiliza esta función virtual cada vez que necesita mostrar « dateTime ».
Si la reimplementas, es posible que también tengas que reimplementar validate().
Véase también dateTimeFromText() y validate().
QTime QDateTimeEdit::time() const
Devuelve la hora del campo de edición de fecha y hora.
Nota: Funcióngetter para la propiedad «time».
Véase también setTime().
[signal] void QDateTimeEdit::timeChanged(QTime time)
Esta señal se emite cada vez que se modifica la hora. La nueva hora se transmite a través de ` time`.
Nota: Señalde notificación para la propiedad time.
Véase también Keyboard Tracking.
[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const
Reimplementa: ` QAbstractSpinBox::validate` (`QString &input, int &pos) const`.
[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)
Reimplementa: ` 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.