QDateTimeEdit Class
La clase QDateTimeEdit proporciona un widget para editar fechas y horas. Más...
| Cabecera: | #include <QDateTimeEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 y disminuir los valores de fecha y hora. Las teclas de flecha pueden utilizarse para desplazarse de una sección a otra dentro del cuadro QDateTimeEdit. Las fechas y horas aparecen de acuerdo con el formato establecido; ver 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 restringido el rango de fechas válido a hoy más o menos 365 días. Hemos establecido el orden a mes, día, año.
El rango de valores válidos para un QDateTimeEdit está controlado por las propiedades minimumDateTime, maximumDateTime, y sus respectivos componentes de fecha y hora. Por defecto, cualquier fecha-hora desde el inicio de 100 CE hasta el final de 9999 CE es válida.
Uso de un widget de calendario emergente
QDateTimeEdit puede configurarse para permitir el uso de un QCalendarWidget para seleccionar fechas. Esto se habilita estableciendo la propiedad calendarPopup. Además, puede proporcionar un widget de calendario personalizado para utilizarlo como calendario emergente llamando a la función setCalendarWidget(). El widget de calendario existente puede recuperarse con calendarWidget().
Seguimiento del teclado
Cuando keyboard tracking está habilitado (por defecto), cada pulsación de tecla al editar un campo dispara señales para cambios de valor.
Cuando el range permitido es más estrecho que algún intervalo de tiempo cuyo final atraviesa, 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 intervalo del 29.04.2020 al 02.05.2020 y una fecha inicial del 30.04.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 seguimiento del teclado está desactivado, los cambios sólo se señalan cuando el foco abandona el campo de texto después de haber modificado el contenido. Esto permite al usuario editar a través de una fecha-hora no válida para llegar a una válida.
Véase también QDateEdit, QTimeEdit, QDate, y QTime.
Documentación de tipos de miembros
enum QDateTimeEdit::Sección
flags QDateTimeEdit::Secciones
| 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 un typedef para QFlags<Section>. Almacena una combinación OR de valores Section.
Documentación de Propiedades
calendarPopup : bool
Esta propiedad contiene el modo actual de mostrar el calendario emergente.
El calendario emergente se mostrará al pulsar el botón de la flecha. Esta propiedad sólo es válida si existe un formato de visualización de fecha 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 spinbox.
Funciones de acceso:
| QDateTimeEdit::Section | currentSection() const |
| void | setCurrentSection(QDateTimeEdit::Section section) |
currentSectionIndex : int
Esta propiedad contiene el índice de la sección actual del spinbox.
Si el formato es 'aaaa/MM/dd', el displayText es '2001/05/21', y la cursorPosition es 5, currentSectionIndex devuelve 1. Si cursorPosition es 3, currentSectionIndex devuelve 0, y así sucesivamente. Si cursorPosition es 3, currentSectionIndex es 0, y así sucesivamente.
Funciones de acceso:
| int | currentSectionIndex() const |
| void | setCurrentSectionIndex(int index) |
Véase también setCurrentSection() y currentSection().
date : QDate
Esta propiedad contiene el QDate que se establece 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 del notificador:
| void | dateChanged(QDate date) |
Véase también time y dateTime.
dateTime : QDateTime
Esta propiedad mantiene el QDateTime que se establece en el QDateTimeEdit.
Al establecer esta propiedad, el nuevo QDateTime se convierte al sistema horario del QDateTimeEdit, que por tanto permanece inalterado.
Por defecto, esta propiedad se establece al inicio de 2000 CE. Sólo puede establecerse a un valor válido de QDateTime. Si alguna operación hace que esta propiedad tenga como valor una fecha-hora no válida, se restablece al valor de la propiedad minimumDateTime.
Si QDateTimeEdit no tiene campos de fecha, al establecer esta propiedad se establece el rango 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 del notificador:
| 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/fecha de la edición de fecha/hora.
Este formato se describe en QDateTime::toString() y QDateTime::fromString()
Ejemplo de cadenas de formato (suponiendo que la fecha es 2 de julio de 1969):
| Formato | Resultado |
|---|---|
| dd.MM.aaaa | 02.07.1969 |
| MMM d aa | 02.07.69 |
| MMMM d aa | 02.07.69 |
Tenga en cuenta que si especifica un año de dos dígitos, se interpretará que está en el siglo en el que se inicializó la edición de fecha y hora. El siglo por defecto es el XXI (2000-2099).
Si especifica un formato no válido, el formato no se establecerá.
Funciones de acceso:
| 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 mostrados actualmente de la edición fecha-hora.
Devuelve un conjunto de bits de las secciones mostradas para este formato.
Funciones de acceso:
| QDateTimeEdit::Sections | displayedSections() const |
Véase también setDisplayFormat() y displayFormat().
maximumDate : QDate
Esta propiedad mantiene la fecha máxima de la edición de fecha-hora.
Cambiando esta propiedad se actualiza la fecha de la propiedad maximumDateTime mientras se preserva la propiedad maximumTime. Al establecer esta propiedad, la minimumDate se ajusta, si es necesario, para asegurar que el rango sigue 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 sólo puede ajustarse a un objeto QDate válido que describa una fecha en la que la propiedad actual maximumTime haga un objeto QDateTime válido. La última fecha que setMaximumDate() acepta es el final de 9999 CE. Este es el valor por defecto para esta propiedad. Este valor por defecto puede restaurarse 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-hora máxima de la edición fecha-hora.
Cambiar esta propiedad actualiza implícitamente las propiedades maximumDate y maximumTime a las partes de fecha y hora de esta propiedad, respectivamente. Al establecer esta propiedad, minimumDateTime se ajusta, si es necesario, para asegurar que el rango sigue siendo válido. En caso contrario, al cambiar esta propiedad se conserva la propiedad minimumDateTime.
Esta propiedad sólo puede establecerse a un valor válido de QDateTime. La última fecha-hora que setMaximumDateTime() acepta es el final de 9999 CE. Este es el valor por defecto para esta propiedad. Este valor por defecto puede restaurarse 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 mantiene la hora máxima de la edición de la hora de la fecha.
Cambiando esta propiedad se actualiza la hora de la propiedad maximumDateTime mientras se preservan las propiedades minimumDate y maximumDate. Si esas propiedades de fecha coinciden, al establecer esta propiedad, la propiedad minimumTime se ajusta, si es necesario, para asegurar que el rango sigue siendo válido. En caso contrario, al cambiar esta propiedad se preserva la propiedad minimumDateTime.
Esta propiedad puede establecerse a cualquier valor válido de QTime. Por defecto, esta propiedad contiene una hora de 23:59:59 y 999 milisegundos. Este valor predeterminado puede restaurarse 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 de la edición de la fecha-hora.
Cambiando esta propiedad se actualiza la fecha de la propiedad minimumDateTime mientras se preserva la propiedad minimumTime. Al establecer esta propiedad, la maximumDate se ajusta, si es necesario, para asegurar que el rango sigue siendo válido. Cuando esto ocurre, la propiedad maximumTime también se ajusta si es menor que la propiedad minimumTime. En caso contrario, los cambios en esta propiedad conservan la propiedad maximumDateTime.
Esta propiedad sólo puede ajustarse a un objeto QDate válido que describa una fecha en la que la propiedad minimumTime actual haga un objeto QDateTime válido. La fecha más temprana que setMinimumDate() acepta es el inicio de 100 CE. El valor por defecto para esta propiedad es 14 de septiembre de 1752 EC. Este valor por defecto puede restaurarse 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-hora mínima de la edición fecha-hora.
Cambiar esta propiedad actualiza implícitamente las propiedades minimumDate y minimumTime a las partes de fecha y hora de esta propiedad, respectivamente. Al establecer esta propiedad, maximumDateTime se ajusta, si es necesario, para asegurar que el rango sigue siendo válido. En caso contrario, al cambiar esta propiedad se conserva la propiedad maximumDateTime.
Esta propiedad sólo puede establecerse a un valor válido de QDateTime. La fecha-hora más temprana que setMinimumDateTime() acepta es el inicio de 100 CE. El valor por defecto de la propiedad es el comienzo del 14 de Septiembre de 1752 EC. Este valor por defecto puede restaurarse 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 mantiene la hora mínima de la edición de la hora de la fecha.
Cambiando esta propiedad se actualiza la hora de la propiedad minimumDateTime mientras se preservan las propiedades minimumDate y maximumDate. Si esas propiedades de fecha coinciden, al establecer esta propiedad, la propiedad maximumTime se ajusta, si es necesario, para asegurar que el rango sigue siendo válido. En caso contrario, al cambiar esta propiedad se preserva la propiedad maximumDateTime.
Esta propiedad puede establecerse a cualquier valor válido de QTime. Por defecto, esta propiedad contiene una hora de 00:00:00 y 0 milisegundos. Este valor predeterminado puede restaurarse 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 mostradas. Si el formato es 'yyyy/yy/yyyy', sectionCount devuelve 3
Funciones de acceso:
| int | sectionCount() const |
time : QTime
Esta propiedad contiene el QTime que se establece 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 del notificador:
| void | timeChanged(QTime time) |
Véase también date y dateTime.
[since 6.7] timeZone : QTimeZone
Esta propiedad contiene la zona horaria actual utilizada por el widget de edición datetime
Si el formato datetime en uso incluye un indicador de zona horaria - es decir, un especificador de formato 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 especificado.
Esta propiedad 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)
Construye un editor de fecha y hora vacío con parent.
[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)
Construye un editor de fecha y hora vacío con parent. El valor se establece en date.
[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)
Construye un editor de fecha y hora vacío con parent. El valor se establece en time.
[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)
Construye un editor de fecha y hora vacío con parent. El valor se establece en datetime.
[virtual noexcept] QDateTimeEdit::~QDateTimeEdit()
Destructor.
QCalendar QDateTimeEdit::calendar() const
Informa del sistema de calendario utilizado por este widget.
Véase también setCalendar().
QCalendarWidget *QDateTimeEdit::calendarWidget() const
Devuelve el widget de calendario para el editor si calendarPopup tiene el valor 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 edición fecha-hora.
Nota: Función Getter 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 en date.
Nota: Señal notificadora 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 cambia la fecha o la hora. La nueva fecha y hora se pasa en datetime.
Nota: Señal notificadora para la propiedad dateTime.
Véase también Keyboard Tracking.
[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const
Devuelve una fecha/hora apropiada para la dirección text.
Esta función virtual es utilizada por datetime edit siempre 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 es útil para subclases cuando necesitan un QStyleOptionSpinBox, pero no quieren rellenar toda la información ellos mismos.
Ver 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.
Véase también currentSection().
void QDateTimeEdit::setCalendar(QCalendar calendar)
Establece calendar como el sistema de calendario a utilizar por este widget.
El widget puede utilizar cualquier sistema de calendario soportado. Por defecto, utiliza el calendario gregoriano.
Véase también calendar().
void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)
Establece el calendarWidget dado como el widget a utilizar para el calendario emergente. El editor no se apropia automáticamente del widget de calendario.
Nota: calendarPopup debe tener el valor true antes de establecer el widget de calendario.
Véase también calendarWidget() y calendarPopup.
void QDateTimeEdit::setDateRange(QDate min, QDate max)
Establece el rango 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áloga a:
setMinimumDate(min); setMaximumDate(max);
Si min o max no son válidos, esta función no hace nada. Esta función preserva 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 rango es menor que un intervalo de tiempo cuyo final abarca, por ejemplo una semana que abarca el final de un mes, los usuarios sólo pueden editar la fecha a una en la parte posterior del rango si el seguimiento de 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 fecha y hora.
Esta función de conveniencia establece las propiedades minimumDateTime y maximumDateTime.
setDateTimeRange(min, max);es análoga a:
setMinimumDateTime(min); setMaximumDateTime(max);
Si min o max no son válidos, esta función no hace nada. Si max es menor que min, min se utiliza también como max.
Si el intervalo es más estrecho que un intervalo de tiempo cuyo final abarca, por ejemplo una semana que abarca el final de un mes, los usuarios sólo pueden editar la fecha-hora a una en la parte posterior del intervalo si el seguimiento de 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 en las secciones actualmente visualizadas, esta función no hace nada. Si section es NoSection, esta función deseleccionará todo el texto del editor. De lo 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 rango de horas permitidas para la edición de la hora de la fecha.
Esta función establece las propiedades minimumTime y maximumTime.
Tenga en cuenta que éstas sólo limitan el valor de la edición de fecha y hora en, respectivamente, minimumDate y maximumDate. Cuando estas propiedades de fecha no coinciden, las horas posteriores a max se permiten en fechas anteriores a maximumDate y las horas anteriores a min se permiten 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 hace nada. Esta función preserva las propiedades minimumDate y maximumDate. Si esas propiedades coinciden y max es menor que min, min se utiliza como max.
Si el rango es más estrecho que un intervalo de tiempo cuyo final abarca, por ejemplo el intervalo de diez a una hora a diez pasadas la misma hora, los usuarios sólo pueden editar la hora a una en la parte posterior del rango si el seguimiento de 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(pasos int).
[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const
Reimplementa: QAbstractSpinBox::stepEnabled() const.
[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const
Esta función virtual es utilizada por el editor de fecha y hora siempre que necesita mostrar dateTime.
Si reimplementas esto, puede que también necesites reimplementar validate().
Véase también dateTimeFromText() y validate().
QTime QDateTimeEdit::time() const
Devuelve la hora de la edición de la hora de la fecha.
Nota: Función Getter para la propiedad hora.
Véase también setTime().
[signal] void QDateTimeEdit::timeChanged(QTime time)
Esta señal se emite cada vez que se cambia la hora. La nueva hora se pasa en time.
Nota: Señal notificadora 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.
