En esta página

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:

QDateEdit y QTimeEdit

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

Widget para editar la hora y la fecha

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

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

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):

FormatoResultado
dd.MM.aaaa02.07.1969
MMM d aaa2 de julio de 69
MMMM d aa2 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.