En esta página

QDate Class

La clase QDate ofrece funciones relacionadas con las fechas. Más información...

Encabezado: #include <QDate>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QDate

CategoríaTipos comparablesDescripción
strongQDate
strongstd::chrono::year_month_day, std::chrono::year_month_day_last, std::chrono::year_month_weekday y std::chrono::year_month_weekday_last.Estos operadores de comparación solo están disponibles cuando se utiliza C++20.

Funciones públicas

QDate()
(since 6.4) QDate(std::chrono::year_month_day date)
(since 6.4) QDate(std::chrono::year_month_day_last date)
(since 6.4) QDate(std::chrono::year_month_weekday date)
(since 6.4) QDate(std::chrono::year_month_weekday_last date)
QDate(int y, int m, int d)
QDate addDays(qint64 ndays) const
(since 6.4) QDate addDuration(std::chrono::days ndays) const
QDate addMonths(int nmonths, QCalendar cal) const
QDate addMonths(int nmonths) const
QDate addYears(int nyears, QCalendar cal) const
QDate addYears(int nyears) const
int day(QCalendar cal) const
int day() const
int dayOfWeek(QCalendar cal) const
int dayOfWeek() const
int dayOfYear(QCalendar cal) const
int dayOfYear() const
int daysInMonth(QCalendar cal) const
int daysInMonth() const
int daysInYear(QCalendar cal) const
int daysInYear() const
qint64 daysTo(QDate d) const
QDateTime endOfDay(const QTimeZone &zone) const
(since 6.5) QDateTime endOfDay() const
void getDate(int *year, int *month, int *day) const
bool isNull() const
bool isValid() const
int month(QCalendar cal) const
int month() const
bool setDate(int year, int month, int day)
bool setDate(int year, int month, int day, QCalendar cal)
QDateTime startOfDay(const QTimeZone &zone) const
(since 6.5) QDateTime startOfDay() const
qint64 toJulianDay() const
std::chrono::sys_days toStdSysDays() const
QString toString(const QString &format, QCalendar cal) const
QString toString(QStringView format) const
QString toString(Qt::DateFormat format = Qt::TextDate) const
QString toString(const QString &format) const
QString toString(QStringView format, QCalendar cal) const
int weekNumber(int *yearNumber = nullptr) const
int year(QCalendar cal) const
int year() const

Miembros públicos estáticos

QDate currentDate()
QDate fromJulianDay(qint64 jd)
(since 6.4) QDate fromStdSysDays(const std::chrono::sys_days &days)
QDate fromString(const QString &string, const QString &format, int baseYear, QCalendar cal)
(since 6.0) QDate fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)
QDate fromString(const QString &string, Qt::DateFormat format = Qt::TextDate)
(since 6.0) QDate fromString(QStringView string, QStringView format, QCalendar cal)
(since 6.7) QDate fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)
(since 6.0) QDate fromString(const QString &string, QStringView format, QCalendar cal)
(since 6.7) QDate fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)
QDate fromString(const QString &string, const QString &format, QCalendar cal)
(since 6.7) QDate fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)
(since 6.7) QDate fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)
(since 6.0) QDate fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)
bool isLeapYear(int year)
bool isValid(int year, int month, int day)
bool operator!=(const QDate &lhs, const QDate &rhs)
(since 6.11) QDate &operator++(QDate &date)
(since 6.11) QDate operator++(QDate &date, int)
(since 6.11) QDate &operator--(QDate &date)
(since 6.11) QDate operator--(QDate &date, int)
bool operator<(const QDate &lhs, const QDate &rhs)
QDataStream &operator<<(QDataStream &out, QDate date)
bool operator<=(const QDate &lhs, const QDate &rhs)
bool operator==(const QDate &lhs, const QDate &rhs)
bool operator>(const QDate &lhs, const QDate &rhs)
bool operator>=(const QDate &lhs, const QDate &rhs)
QDataStream &operator>>(QDataStream &in, QDate &date)

Descripción detallada

Un objeto QDate representa un día concreto, independientemente del calendario, la configuración regional u otros ajustes utilizados al crearlo o proporcionados por el sistema. Puede indicar el año, el mes y el día del mes que representan ese día con respecto al calendario gregoriano proleptico o a cualquier calendario proporcionado como un objeto de tipo « QCalendar ». Los objetos QDate deben pasarse por valor en lugar de por referencia a const; simplemente empaquetan un qint64.

Un objeto QDate se crea normalmente indicando explícitamente los números del año, el mes y el día. Tenga en cuenta que QDate interpreta los números de año inferiores a 100 tal y como se presentan, es decir, como los años del 1 al 99, sin añadir ningún desplazamiento. La función estática currentDate() crea un objeto QDate que contiene la fecha leída del reloj del sistema. También se puede establecer una fecha explícita mediante ` setDate()`. La función ` fromString()` devuelve un objeto `QDate` a partir de una cadena y un formato de fecha que se utiliza para interpretar la fecha contenida en la cadena.

Las funciones year(), month() y day() permiten acceder a los números de año, mes y día. Cuando se necesita más de uno de estos valores, resulta más eficiente llamar a QCalendar::partsFromDate(), para evitar repetir cálculos calendáricos (que pueden resultar costosos).

Además, se proporcionan las funciones dayOfWeek() y dayOfYear(). La misma información se proporciona en formato textual mediante toString(). QLocale puede asignar nombres a los números de día, mientras que QCalendar puede asignar nombres a los números de mes.

QDate proporciona un conjunto completo de operadores para comparar dos objetos QDate, en los que un valor menor significa una fecha anterior y un valor mayor, una fecha posterior.

Se puede incrementar (o decrementar) una fecha en un número determinado de días utilizando addDays(). Del mismo modo, se puede utilizar addMonths() y addYears(). La función daysTo() devuelve el número de días que hay entre dos fechas.

Las funciones daysInMonth() y daysInYear() devuelven el número de días que hay en el mes y el año de esta fecha, respectivamente. La función isLeapYear() indica si una fecha corresponde a un año bisiesto. QCalendar también puede proporcionar esta información, en algunos casos de forma más cómoda.

Observaciones

Nota: Todas las conversiones a y desde formatos de cadena se realizan utilizando la configuración regional de C. Para conversiones localizadas, véase QLocale.

En el calendario gregoriano no existe el año 0. Las fechas de ese año se consideran inválidas. El año -1 es el año «1 antes de Cristo» o «1 antes de la era común». El día anterior al 1 de enero del año 1 d. C., QDate(1, 1, 1), es el 31 de diciembre del año 1 a. C., QDate(-1, 12, 31). Otros calendarios se comportan de manera similar; véase QCalendar::hasYearZero().

Rango de fechas válidas

Las fechas se almacenan internamente como un número de día juliano modificado, un recuento entero de cada día en un rango contiguo, siendo el 24 de noviembre del 4714 a. C. en el calendario gregoriano el día juliano 0 (1 de enero del 4713 a. C. en el calendario juliano). Además de ser una forma eficaz y precisa de almacenar una fecha absoluta, resulta adecuada para convertir una fecha a otros sistemas de calendario, como el hebreo, el islámico o el chino. A efectos de QDate, los días julianos se delimitan a medianoche y, en el caso de QDateTime, en la zona horaria utilizada por datetime. (Esto se aparta de la definición formal, que delimita los días julianos al mediodía UTC). El número de día juliano se puede obtener mediante QDate::toJulianDay() y se puede establecer mediante QDate::fromJulianDay().

El rango de números de día juliano que QDate puede representar está, por razones técnicas, limitado a un intervalo comprendido entre -784350574879 y 784354017364, lo que significa desde antes de 2.000 millones a. C. hasta después de 2.000 millones d. C. Este rango es más de siete veces mayor que el rango de fechas que puede representar un « QDateTime ».

Véase también QTime, QDateTime, QCalendar, QDateTime::YearRange, QDateEdit, QDateTimeEdit y QCalendarWidget.

Documentación de funciones de miembro

[constexpr] QDate::QDate()

Crea una fecha nula. Las fechas nulas no son válidas.

Véase también isNull() y isValid().

[constexpr noexcept, since 6.4] QDate::QDate(std::chrono::year_month_day date)

[constexpr noexcept, since 6.4] QDate::QDate(std::chrono::year_month_day_last date)

[constexpr noexcept, since 6.4] QDate::QDate(std::chrono::year_month_weekday date)

[constexpr noexcept, since 6.4] QDate::QDate(std::chrono::year_month_weekday_last date)

Crea un objeto ` QDate ` que representa la misma fecha que ` date`. Esto facilita la interoperabilidad entre las clases de calendario de la biblioteca estándar y las clases de fecha y hora de Qt.

Por ejemplo:

// 23 April 2012:
QDate date = std::chrono::year_month_day(std::chrono::year(2012),
                                        std::chrono::month(4),
                                        std::chrono::day(23));

// Same, under `using std::chrono` convenience:
QDate dateWithLiterals1 = 23d / April / 2012y;
QDate dateWithLiterals2 = 2012y / April / 23;

// Last day of February 2000
QDate lastDayFeb2020 = 2000y / February / last;

// First Monday of January 2020:
QDate firstMonday = 2020y / January / Monday[0];

// Last Monday of January 2020:
QDate lastMonday = 2020y / January / Monday[last];

Nota: A diferencia de QDate, std::chrono::year y las clases relacionadas incluyen el año cero. Esto significa que, si date corresponde al año cero o anterior, el objeto QDate resultante tendrá un año menos que el especificado por date.

Nota: Esta función requiere C++20.

Estas funciones se introdujeron en Qt 6.4.

QDate::QDate(int y, int m, int d)

Crea una fecha con el año y, el mes m y el día d.

La fecha se interpreta según el calendario gregoriano. Si la fecha especificada no es válida, no se establece y isValid() devuelve false.

Advertencia: Los años del 1 al 99 se interpretan tal cual. El año 0 no es válido.

Véase también isValid() y QCalendar::dateFromParts().

QDate QDate::addDays(qint64 ndays) const

Devuelve un objeto ` QDate ` que contiene una fecha ` ndays ` posterior a la fecha de este objeto (o anterior, si ` ndays ` es un valor negativo).

Devuelve una fecha nula si la fecha actual no es válida o si la nueva fecha está fuera del rango.

Véanse también addMonths(), addYears() y daysTo().

[since 6.4] QDate QDate::addDuration(std::chrono::days ndays) const

Devuelve un objeto ` QDate ` que contiene una fecha ` ndays ` posterior a la fecha de este objeto (o anterior, si ` ndays ` es un valor negativo).

Devuelve una fecha nula si la fecha actual no es válida o si la nueva fecha está fuera de rango.

Nota: Sumar duraciones expresadas en std::chrono::months o std::chrono::years no da el mismo resultado que se obtiene al utilizar addMonths() o addYears(). Las primeras son duraciones fijas, calculadas en relación con el año solar; las segundas utilizan las definiciones de meses y años del calendario gregoriano.

Nota: Esta función requiere C++20.

Esta función se introdujo en Qt 6.4.

Véase también addMonths(), addYears() y daysTo().

QDate QDate::addMonths(int nmonths, QCalendar cal) const

Devuelve un objeto ` QDate ` que contiene una fecha ` nmonths ` posterior a la fecha de este objeto (o anterior, si ` nmonths ` es negativo).

Utiliza cal como calendario, si se proporciona; de lo contrario, utiliza el calendario gregoriano.

Nota: Si la combinación de día y mes final no existe en el mes y año resultantes, esta función devolverá la fecha válida más tardía del mes seleccionado.

Véanse también addDays() y addYears().

QDate QDate::addMonths(int nmonths) const

Esta función sobrescribe la función « QDate::addMonths()».

QDate QDate::addYears(int nyears, QCalendar cal) const

Devuelve un objeto ` QDate ` que contiene una fecha ` nyears ` posterior a la fecha de este objeto (o anterior, si ` nyears ` es negativo).

Utiliza cal como calendario, si se proporciona; de lo contrario, utiliza el calendario gregoriano.

Nota: Si la combinación de día y mes finales no existe en el año resultante (por ejemplo, en el calendario gregoriano, si la fecha fuera el 29 de febrero y el año final no fuera bisiesto), esta función devolverá la última fecha válida del mes dado (en el ejemplo, el 28 de febrero).

Véase también addDays() y addMonths().

QDate QDate::addYears(int nyears) const

Esta función sobrecarga la función « QDate::addYears()».

[static] QDate QDate::currentDate()

Devuelve la fecha actual del reloj del sistema.

Véase también QTime::currentTime() y QDateTime::currentDateTime().

int QDate::day(QCalendar cal) const

Devuelve el día del mes correspondiente a esta fecha.

Utiliza cal como calendario si se proporciona; de lo contrario, utiliza el calendario gregoriano (para el que el valor devuelto oscila entre 1 y 31). Devuelve 0 si la fecha no es válida.

Véanse también year(), month(), dayOfWeek() y QCalendar::partsFromDate().

int QDate::day() const

Esta función sobrecarga la función « QDate::day()».

int QDate::dayOfWeek(QCalendar cal) const

Devuelve el día de la semana (1 = lunes a 7 = domingo) correspondiente a esta fecha.

Utiliza cal como calendario si se proporciona; de lo contrario, utiliza el calendario gregoriano. Devuelve 0 si la fecha no es válida. Algunos calendarios pueden otorgar un significado especial (por ejemplo, días intercalares) a los valores superiores a 7.

Véanse también day(), dayOfYear(), QCalendar::dayOfWeek() y Qt::DayOfWeek.

int QDate::dayOfWeek() const

Esta función sobrecarga la función « QDate::dayOfWeek()».

int QDate::dayOfYear(QCalendar cal) const

Devuelve el día del año (1 para el primer día) correspondiente a esta fecha.

Utiliza cal como calendario si se proporciona; de lo contrario, utiliza el calendario gregoriano. Devuelve 0 si la fecha o el primer día de su año no son válidos.

Véanse también day(), dayOfWeek() y QCalendar::daysInYear().

int QDate::dayOfYear() const

Esta función sobrecarga la función ` QDate::dayOfYear()`.

int QDate::daysInMonth(QCalendar cal) const

Devuelve el número de días que tiene el mes en esa fecha.

Utiliza cal como calendario si se proporciona; de lo contrario, utiliza el calendario gregoriano (en cuyo caso el resultado oscila entre 28 y 31). Devuelve 0 si la fecha no es válida.

Véase también day(), daysInYear(), QCalendar::daysInMonth(), QCalendar::maximumDaysInMonth() y QCalendar::minimumDaysInMonth().

int QDate::daysInMonth() const

Esta función sobrecarga la función « QDate::daysInMonth()».

int QDate::daysInYear(QCalendar cal) const

Devuelve el número de días que hay en el año correspondientes a esta fecha.

Utiliza cal como calendario si se proporciona; de lo contrario, utiliza el calendario gregoriano (en cuyo caso el resultado es 365 o 366). Devuelve 0 si la fecha no es válida.

Véanse también day(), daysInMonth(), QCalendar::daysInYear() y QCalendar::maximumMonthsInYear().

int QDate::daysInYear() const

Esta función sobrecarga la función « QDate::daysInYear()».

qint64 QDate::daysTo(QDate d) const

Devuelve el número de días que hay desde esta fecha hasta d.

Esto equivale a d.toJulianDay() - toJulianDay(). El resultado es negativo si d es anterior a esta fecha. Devuelve 0 si alguna de las fechas no es válida.

Ejemplo:

QDate d1(1995, 5, 17);  // May 17, 1995
QDate d2(1995, 5, 20);  // May 20, 1995
d1.daysTo(d2);          // returns 3
d2.daysTo(d1);          // returns -3

Véase también addDays().

QDateTime QDate::endOfDay(const QTimeZone &zone) const

Devuelve el momento en que termina el día.

El momento en que termina un día depende de cómo se describa la hora: cada día comienza y termina antes para quienes se encuentran en zonas horarias más al oeste y más tarde para quienes se encuentran en zonas horarias más al este. La representación horaria que se va a utilizar se puede especificar mediante un parámetro opcional de hora zone. La representación horaria por defecto es la hora local del sistema.

Normalmente, el final del día es un milisegundo antes de la medianoche, las 24:00; sin embargo, si un cambio de zona horaria hace que la fecha dada se salte ese momento (por ejemplo, el cambio al horario de verano que salta las 23:00 y la hora siguiente), se devuelve la hora más tardía real del día. Esto solo puede ocurrir cuando la representación de la hora es una zona horaria o la hora local.

Cuando zone tiene un timeSpec() de Qt::OffsetFromUTC o Qt::UTC, la representación de la hora no tiene transiciones, por lo que el final del día es QTime(23, 59, 59, 999).

En el caso excepcional de que se haya omitido por completo una fecha (esto ocurre cuando una zona situada al este de la línea internacional de cambio de fecha pasa a situarse al oeste de la misma), el resultado será inválido. Pasar una zona horaria inválida como zone también producirá un resultado inválido, al igual que las fechas que terminen fuera del rango representable por QDateTime.

Véase también startOfDay().

[since 6.5] QDateTime QDate::endOfDay() const

Esta función sobrescribe « QDate::endOfDay()».

Esta función se introdujo en Qt 6.5.

[static constexpr] QDate QDate::fromJulianDay(qint64 jd)

Convierte el día juliano jd en un QDate.

Véase también toJulianDay().

[static constexpr noexcept, since 6.4] QDate QDate::fromStdSysDays(const std::chrono::sys_days &days)

Devuelve un objeto de tipo ` QDate ` correspondiente a la fecha « days » días después del 1 de enero de 1970 (la época UNIX). Si ` days ` es negativo, la fecha devuelta será anterior a la época.

Nota: Esta función requiere C++20.

Esta función se introdujo en Qt 6.4.

Véase también toStdSysDays().

[static] QDate QDate::fromString(const QString &string, const QString &format, int baseYear, QCalendar cal)

Devuelve el objeto « QDate » representado por la cadena « string », utilizando el formato « format » indicado, o una fecha no válida si no se puede analizar la cadena.

Utiliza cal como calendario si se proporciona; de lo contrario, se utiliza el calendario gregoriano. Los rangos de valores indicados en las descripciones de formato que figuran a continuación corresponden a este último; pueden ser diferentes para otros calendarios.

Estas expresiones pueden utilizarse para el formato:

ExpresiónSalida
dEl día como número sin ceros a la izquierda (del 1 al 31)
ddEl día como número con un cero inicial (del 01 al 31)
dddEl nombre abreviado del día («Lun» a «Dom»).
ddddEl nombre completo del día («Monday» a «Sunday»).
MEl mes como número sin ceros a la izquierda (del 1 al 12)
MMEl mes como número con un cero inicial (del 01 al 12)
MMMEl nombre del mes abreviado («Jan» a «Dec»).
MMMMEl nombre completo del mes («enero» a «diciembre»).
yyEl año expresado como un número de dos dígitos (de 00 a 99)
yyyyEl año como número, con ceros a la izquierda si es necesario hasta completar al menos cuatro dígitos. Se acepta un signo menos al principio para representar un año negativo. Se requiere un signo más cuando se indican más de cuatro dígitos.

Nota: Los nombresde los días y los meses deben indicarse en inglés (configuración regional «C»). Si se desea que se reconozcan los nombres de los meses y los días localizados, utilice QLocale::system().toDate().

Cualquier secuencia de caracteres no vacía entre comillas simples también se tratará (una vez eliminadas las comillas) como texto y no se interpretará como expresiones. Dos comillas simples consecutivas («''») se interpretan como una sola comilla que debe coincidir con la entrada, en lugar de indicar el inicio o el final de una secuencia literal. Todos los demás caracteres de la entrada se tratarán como texto literal que debe coincidir con la cadena de entrada. Por ejemplo:

QDate date = QDate::fromString("1MM12car2003", "d'MM'MMcaryyyy");
// date is 1 December 2003

Si no se cumple el formato, se devuelve un valor « QDate » no válido.

Cuando los campos numéricos están yuxtapuestos, sin separadores que dividan las secuencias de dígitos, puede haber ambigüedad en cuanto a si algunos campos que pueden tener un solo dígito utilizan dos dígitos (debido a que el valor que representan es superior a 9). Cuando asignar dos dígitos a dicho campo dejaría muy pocos para otros campos, y la lectura de un solo dígito es coherente con los demás campos, esta ambigüedad puede resolverse. En caso contrario (cuando se permite que más de un campo tenga solo un dígito y sobraran dígitos si cada uno tuviera solo uno), se prefiere una resolución que asigne dígitos adicionales a los campos anteriores a una que los asigne a los campos posteriores, siempre que los datos sigan siendo coherentes. Por ejemplo:

QDate date = QDate::fromString("130", "Md"); // Janary 30

Para cualquier campo que no esté representado en el formato, se utilizan los siguientes valores por defecto:

CampoValor por defecto
AñobaseYear (o 1900)
Mes1 (enero)
Día1

Cuando format solo especifica los dos últimos dígitos de un año, se tienen en cuenta en primer lugar los 100 años que comienzan en baseYear. Antes de la versión 6.7 no existía el parámetro « baseYear » y siempre se utilizaba 1900. Este es el valor por defecto para « baseYear », que selecciona un año desde entonces hasta 1999. Si se pasa 1976 como « baseYear », se seleccionará un año comprendido entre 1976 y 2075, por ejemplo. Cuando el formato incluye también el mes, el día (del mes) y el día de la semana, estos datos bastan para dar a entender el siglo. En tal caso, se selecciona una fecha coincidente en el siglo más cercano al indicado por baseYear, dando preferencia a los años posteriores frente a los anteriores. Véanse QCalendar::matchCenturyToWeekday() y Date ambiguities para más detalles.

Los siguientes ejemplos ilustran los valores por defecto:

QDate::fromString("1.30", "M.d");           // January 30 1900
QDate::fromString("20000110", "yyyyMMdd");  // January 10, 2000
QDate::fromString("20000110", "yyyyMd");    // January 10, 2000

Nota: Si un carácter de formato se repite más veces que la expresión más larga de la tabla anterior que lo utiliza, esta parte del formato se interpretará como varias expresiones sin separador entre ellas; la más larga de las anteriores, posiblemente repetida tantas veces como copias haya de ella, terminando con un residuo que puede ser una expresión más corta. Así, « 'MMMMMMMMMM' » coincidiría con « "MayMay05" » y establecería el mes en mayo. Del mismo modo, « 'MMMMMM' » coincidiría con « "May08" » y lo consideraría incoherente, lo que daría lugar a una fecha no válida.

Ambigüedades en las fechas

Las diferentes culturas utilizan distintos formatos para las fechas y, como resultado, los usuarios pueden confundir el orden en el que deben indicarse los campos de fecha. Por ejemplo, "Wed 28-Nov-01" podría significar tanto el 1 de noviembre de 2028 como el 28 de noviembre de 2001 (ambas fechas son miércoles). Si se utiliza el formato "ddd yy-MMM-dd", se interpretará de la primera forma; si se utiliza "ddd dd-MMM-yy", de la segunda. Sin embargo, lo que el usuario haya querido decir puede depender de la forma en que suele escribir las fechas, más que del formato que esperaba el código.

El ejemplo anterior mezclaba el día del mes y un año de dos dígitos. Puede surgir una confusión similar al intercambiar el mes y el día del mes, cuando ambos se indican como números. En estos casos, incluir un campo con el día de la semana en el formato de fecha puede aportar cierta redundancia, lo que puede ayudar a detectar errores de este tipo. Sin embargo, como en el ejemplo anterior, esto no siempre es eficaz: la inversión de dos campos (o de sus significados) puede dar lugar a fechas con el mismo día de la semana.

Incluir el día de la semana en el formato también puede resolver el problema del siglo de una fecha especificada utilizando únicamente los dos últimos dígitos del año. Lamentablemente, cuando se combina con una fecha en la que el usuario (u otra fuente de datos) ha confundido dos de los campos, esta resolución puede llevar a encontrar una fecha que, aunque coincida con la lectura del formato, no es la que pretendía su autor. Del mismo modo, si el usuario simplemente se equivoca con el día de la semana, en una fecha por lo demás correcta, esto puede dar lugar a una fecha en un siglo diferente. En cada caso, encontrar una fecha en un siglo diferente puede convertir una fecha introducida erróneamente en una totalmente distinta.

La mejor forma de evitar ambigüedades en las fechas es utilizar años de cuatro dígitos y meses especificados por su nombre (ya sea completo o abreviado), a ser posible mediante elementos de la interfaz de usuario que dejen muy claro al usuario qué parte de la fecha está seleccionando. Incluir el día de la semana también puede ayudar, ya que proporciona un medio para comprobar la coherencia de los datos. Cuando los datos proceden del usuario, utilizando un formato proporcionado por una configuración regional seleccionada por él, es mejor emplear un formato largo, ya que los formatos cortos suelen utilizar años de dos dígitos. Por supuesto, no siempre es posible controlar el formato; los datos pueden proceder, por ejemplo, de una fuente que no esté bajo tu control.

Debido a estas posibles fuentes de confusión, especialmente cuando no se puede estar seguro de que se utilice un formato inequívoco, es importante comprobar que el resultado de interpretar una cadena como fecha no solo sea válido, sino también razonable para el fin para el que se ha facilitado. Si el resultado se encuentra fuera de un rango de valores razonables, puede merecer la pena pedir al usuario que confirme su selección de fecha, mostrándole la fecha leída de la cadena en un formato largo que incluya el nombre del mes y el año de cuatro dígitos, para que le resulte más fácil detectar cualquier error.

Véase también toString(), QDateTime::fromString(), QTime::fromString() y QLocale::toDate().

[static, since 6.0] QDate QDate::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

Esta función sobrescribe la función ` QDate::fromString()`.

Esta función se introdujo en Qt 6.0.

[static] QDate QDate::fromString(const QString &string, Qt::DateFormat format = Qt::TextDate)

Devuelve el objeto « QDate » representado por la cadena « string », utilizando la fecha « format » proporcionada, o una fecha no válida si no se puede analizar la cadena.

Nota sobre Qt::TextDate: solo se reconocen los nombres de los meses en inglés (por ejemplo, «Jan» en su forma abreviada o «January» en su forma completa).

Esta es una función sobrecargada.

Véanse también toString() y QLocale::toDate().

[static, since 6.0] QDate QDate::fromString(QStringView string, QStringView format, QCalendar cal)

Esta función sobrescribe la función « QDate::fromString()».

Esta función se introdujo en Qt 6.0.

[static, since 6.7] QDate QDate::fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Utiliza un objeto ` QCalendar` creado con el constructor por defecto.

Esta función sobrecarga QDate::fromString().

Esta función se introdujo en Qt 6.7.

[static, since 6.0] QDate QDate::fromString(const QString &string, QStringView format, QCalendar cal)

Esta función sobreescribe la función « QDate::fromString()».

Esta función se introdujo en Qt 6.0.

[static, since 6.7] QDate QDate::fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Utiliza un objeto ` QCalendar` construido de forma predeterminada.

Esta función sobrecarga QDate::fromString().

Esta función se introdujo en Qt 6.7.

[static] QDate QDate::fromString(const QString &string, const QString &format, QCalendar cal)

Esta función sobrecarga la función « QDate::fromString()».

[static, since 6.7] QDate QDate::fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Utiliza un objeto ` QCalendar` creado con el constructor por defecto.

Esta función sobrecarga QDate::fromString().

Esta función se introdujo en Qt 6.7.

[static, since 6.7] QDate QDate::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

Esta función sobrescribe la función « QDate::fromString()».

Esta función se introdujo en Qt 6.7.

[static, since 6.0] QDate QDate::fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)

Esta función sobrescribe la función ` QDate::fromString()`.

Esta función se introdujo en Qt 6.0.

void QDate::getDate(int *year, int *month, int *day) const

Extrae el año, el mes y el día de la fecha, y los asigna a *year, *month y *day. Los punteros pueden ser nulos.

Devuelve 0 si la fecha no es válida.

Nota: En las versiones de Qt anteriores a la 5.7, esta función está marcada como noconst.

Véase también year(), month(), day(), isValid() y QCalendar::partsFromDate().

[static] bool QDate::isLeapYear(int year)

Devuelve « true » si el año especificado « year » es un año bisiesto en el calendario gregoriano; en caso contrario, devuelve « false ».

Véase también QCalendar::isLeapYear().

[constexpr] bool QDate::isNull() const

Devuelve ` true ` si la fecha es nula; en caso contrario, devuelve ` false`. Una fecha nula no es válida.

Nota: El comportamiento de esta función es equivalente al de isValid().

Véase también isValid().

[constexpr] bool QDate::isValid() const

Devuelve « true » si esta fecha es válida; en caso contrario, devuelve « false ».

Véase también isNull() y QCalendar::isDateValid().

[static] bool QDate::isValid(int year, int month, int day)

Devuelve « true » si la fecha especificada (year, month y day) es válida en el calendario gregoriano; en caso contrario, devuelve « false ».

Ejemplo:

QDate::isValid(2002, 5, 17);  // true
QDate::isValid(2002, 2, 30);  // false (Feb 30 does not exist)
QDate::isValid(2004, 2, 29);  // true (2004 is a leap year)
QDate::isValid(2000, 2, 29);  // true (2000 is a leap year)
QDate::isValid(2006, 2, 29);  // false (2006 is not a leap year)
QDate::isValid(2100, 2, 29);  // false (2100 is not a leap year)
QDate::isValid(1202, 6, 6);   // true (even though 1202 is pre-Gregorian)

Esta función sobrecarga QDate::isValid().

Véase también isNull(), setDate() y QCalendar::isDateValid().

int QDate::month(QCalendar cal) const

Devuelve el número del mes correspondiente a la fecha.

Numera los meses del año empezando por 1 para el primero. Utiliza cal como calendario si se proporciona; de lo contrario, utiliza el calendario gregoriano, cuya numeración de los meses es la siguiente:

  • 1 = «enero»
  • 2 = «febrero»
  • 3 = «marzo»
  • 4 = «abril»
  • 5 = «mayo»
  • 6 = «junio»
  • 7 = «julio»
  • 8 = «agosto»
  • 9 = «septiembre»
  • 10 = «octubre»
  • 11 = «noviembre»
  • 12 = «diciembre»

Devuelve 0 si la fecha no es válida. Ten en cuenta que algunos calendarios pueden tener más de 12 meses en algunos años.

Véase también year(), day() y QCalendar::partsFromDate().

int QDate::month() const

Esta función sobrecarga la función « QDate::month()».

bool QDate::setDate(int year, int month, int day)

Establece este valor para representar la fecha, según el calendario gregoriano, con los números indicados en year, month y day. Devuelve «true» si la fecha resultante es válida; en caso contrario, establece este valor para representar una fecha no válida y devuelve «false».

Véanse también isValid() y QCalendar::dateFromParts().

bool QDate::setDate(int year, int month, int day, QCalendar cal)

Establece este valor para representar la fecha, en el calendario especificado cal, con los valores indicados para year, month y day. Devuelve «true» si la fecha resultante es válida; en caso contrario, establece este valor para representar una fecha no válida y devuelve «false».

Véase también isValid() y QCalendar::dateFromParts().

QDateTime QDate::startOfDay(const QTimeZone &zone) const

Devuelve el momento en que comienza el día.

El momento en que comienza un día depende de cómo se describa la hora: cada día empieza y termina antes para quienes se encuentran en zonas horarias más al oeste y más tarde para quienes se encuentran en zonas horarias más al este. La representación horaria que se va a utilizar se puede especificar mediante un parámetro opcional «time zone ». La representación horaria por defecto es la hora local del sistema.

Normalmente, el inicio del día es la medianoche, las 00:00; sin embargo, si un cambio de zona horaria hace que la fecha dada se salte esa medianoche (por ejemplo, el cambio al horario de verano, que omite la primera hora del día), se devuelve la hora más temprana real del día. Esto solo puede ocurrir cuando la representación de la hora es una zona horaria o la hora local.

Cuando zone tiene un timeSpec() que es Qt::OffsetFromUTC o Qt::UTC, la representación de la hora no tiene transiciones, por lo que el inicio del día es QTime(0, 0).

En el caso excepcional de que se haya omitido por completo una fecha (esto ocurre cuando una zona situada al este de la línea internacional de cambio de fecha pasa a estar al oeste de la misma), el resultado será inválido. Pasar una zona horaria inválida como ` zone ` también producirá un resultado inválido, al igual que las fechas que comiencen fuera del rango representable por ` QDateTime`.

Véase también endOfDay().

[since 6.5] QDateTime QDate::startOfDay() const

Esta función sobrecarga la función « QDate::startOfDay()».

Esta función se introdujo en Qt 6.5.

[constexpr] qint64 QDate::toJulianDay() const

Convierte la fecha en un día juliano.

Véase también fromJulianDay().

[constexpr noexcept] std::chrono::sys_days QDate::toStdSysDays() const

Devuelve el número de días transcurridos entre el 1 de enero de 1970 (la época UNIX) y esta fecha, representado como un objeto ` std::chrono::sys_days `. Si esta fecha es anterior a la época, el número de días será negativo.

Nota: Esta función requiere C++20.

Véase también ` fromStdSysDays()` y ` daysTo()`.

QString QDate::toString(const QString &format, QCalendar cal) const

QString QDate::toString(QStringView format, QCalendar cal) const

Devuelve la fecha como una cadena. El parámetro ` format ` determina el formato de la cadena resultante. Si se especifica ` cal `, este parámetro determina el calendario utilizado para representar la fecha; el valor por defecto es el calendario gregoriano. Antes de Qt 5.14, no existía el parámetro ` cal ` y siempre se utilizaba el calendario gregoriano.

En el parámetro ` format ` se pueden utilizar las siguientes expresiones:

ExpresiónSalida
dEl día como número sin cero inicial (del 1 al 31)
ddEl día como número con un cero inicial (del 01 al 31)
dddEl nombre abreviado del día («Lun» a «Dom»).
ddddEl nombre completo del día («Monday» a «Sunday»).
MEl mes como número sin ceros iniciales (del 1 al 12)
MMEl mes como número con un cero inicial (del 01 al 12)
MMMEl nombre del mes abreviado («Jan» a «Dec»).
MMMMEl nombre completo del mes («enero» a «diciembre»).
yyEl año expresado como un número de dos dígitos (de 00 a 99)
yyyyEl año completo como número, rellenado si es necesario hasta al menos cuatro dígitos. Si el año es negativo, se antepone un signo menos. Si un año positivo necesita más de cuatro dígitos, se antepone un signo más.

Cualquier secuencia de caracteres no vacía entre comillas simples se incluirá tal cual en la cadena de salida (sin las comillas), incluso si contiene caracteres de formato. Dos comillas simples consecutivas («''») se sustituyen por una sola comilla simple en la salida, en lugar de marcar el inicio o el final de una secuencia tal cual. Todos los demás caracteres de la cadena de formato se incluyen tal cual en la cadena de salida.

Se admiten formatos sin separadores (p. ej., «ddMM»), pero deben utilizarse con precaución, ya que las cadenas resultantes no siempre son legibles de forma fiable (p. ej., si «dM» produce «212», podría referirse tanto al 2 de diciembre como al 21 de febrero).

Ejemplos de cadenas de formato (suponiendo que el QDate sea el 20 de julio de 1969):

FormatoResultado
dd.MM.aaaa20.07.1969
ddd MMMM d aaaaDomingo, 20 de julio de 69
«El día es» ddddEl día es domingo

Si la fecha y hora no son válidas, se devolverá una cadena vacía.

Nota: Los nombresde los días y los meses se indican en inglés (configuración regional C). Para obtener los nombres de los meses y los días localizados, utiliza QLocale::system().toString().

Nota: Si un carácter de formato se repite más veces que la expresión más larga de la tabla anterior que lo utiliza, esta parte del formato se interpretará como varias expresiones sin separador entre ellas; la más larga de las anteriores, posiblemente repetida tantas veces como haya copias de la misma, terminando con un resto que puede ser una expresión más corta. Así, 'MMMMMMMMMM' para una fecha en mayo aportará "MayMay05" a la salida.

Véase también fromString(), QDateTime::toString(), QTime::toString() y QLocale::toString().

QString QDate::toString(QStringView format) const

Esta función sobrecarga la función « QDate::toString()».

QString QDate::toString(Qt::DateFormat format = Qt::TextDate) const

Devuelve la fecha como una cadena. El parámetro ` format ` determina el formato de la cadena.

Si el parámetro ` format ` es ` Qt::TextDate`, la cadena se formatea de forma predeterminada. Los nombres de los días y los meses aparecerán en inglés. Un ejemplo de este formato es «Sat May 20 1995». Para obtener información sobre el formato localizado, consulte ` QLocale::toString()`.

Si el parámetro « format » es « Qt::ISODate », el formato de la cadena se ajusta a la especificación ampliada de la norma ISO 8601 para la representación de fechas y horas, adoptando la forma aaaa-MM-dd, donde aaaa es el año, MM es el mes del año (entre 01 y 12), y dd es el día del mes, comprendido entre 01 y 31.

Si el parámetro « format » es ` Qt::RFC2822Date`, la cadena se formatea de acuerdo con la norma RFC 2822. Un ejemplo de este formato es «20 de mayo de 1995».

Si la fecha no es válida, se devolverá una cadena vacía.

Advertencia: El formato Qt::ISODate solo es válido para años comprendidos entre 0 y 9999.

Esta función sobrescribe a QDate::toString().

Véase también fromString() y QLocale::toString().

QString QDate::toString(const QString &format) const

Esta función sobrecarga la función « QDate::toString()».

int QDate::weekNumber(int *yearNumber = nullptr) const

Devuelve el número de semana según la norma ISO 8601 (del 1 al 53).

Devuelve 0 si la fecha no es válida. En caso contrario, devuelve el número de semana correspondiente a la fecha. Si yearNumber no es nullptr (su valor por defecto), almacena el año como *yearNumber.

De acuerdo con la norma ISO 8601, cada semana se incluye en el año al que pertenecen la mayoría de sus días, según el calendario gregoriano. Dado que la semana de la norma ISO 8601 comienza el lunes, se trata del año en el que cae el jueves de dicha semana. La mayoría de los años tienen 52 semanas, pero algunos tienen 53.

Nota: * yearNumber no siempre es igual a year(). Por ejemplo, el 1 de enero de 2000 corresponde a la semana número 52 del año 1999, y el 31 de diciembre de 2002 corresponde a la semana número 1 del año 2003.

Véase también isValid().

int QDate::year(QCalendar cal) const

Devuelve el año de esta fecha.

Utiliza cal como calendario, si se proporciona; de lo contrario, utiliza el calendario gregoriano.

Devuelve 0 si la fecha no es válida. En algunos calendarios, es posible que todas las fechas anteriores a su primer año sean inválidas.

Si se utiliza un calendario que tiene un año 0, compruébalo utilizando ` isValid()` si el resultado es 0. Dichos calendarios utilizan números de año negativos de forma obvia, de modo que al año 1 le precede el año 0, al que a su vez le precede el año -1, y así sucesivamente.

Algunos calendarios, a pesar de no tener un año 0, cuentan de forma convencional los años anteriores a su primer año, contando hacia atrás a partir del 1. Por ejemplo, en el calendario gregoriano proleptico, los años sucesivos anteriores al 1 d. C. (el primer año) se identifican como 1 a. C., 2 a. C., 3 a. C. y así sucesivamente. En dichos calendarios, los números de año negativos se utilizan para indicar estos años anteriores al año 1, donde -1 indica el año anterior al 1.

Véase también month(), day(), QCalendar::hasYearZero(), QCalendar::isProleptic() y QCalendar::partsFromDate().

int QDate::year() const

Esta función sobrescribe la función « QDate::year()».

Elementos no miembros relacionados

[constexpr noexcept] bool operator!=(const QDate &lhs, const QDate &rhs)

Devuelve « true » si « lhs » y « rhs » representan días distintos; en caso contrario, devuelve « false ».

Véase también operator==().

[since 6.11] QDate &operator++(QDate &date)

El operador « ++ » añade un día a « date » y devuelve una referencia al objeto de fecha modificado.

Esta función se introdujo en Qt 6.11.

Véase también addDays() y operator--().

[since 6.11] QDate operator++(QDate &date, int)

El operador postfijo « ++ » añade un día a « date » y devuelve una copia de « date » con la fecha anterior.

Esta función se introdujo en Qt 6.11.

Véanse también addDays() y operator--().

[since 6.11] QDate &operator--(QDate &date)

El operador « -- » resta un día a « date » y devuelve una referencia al objeto de fecha modificado.

Esta función se introdujo en Qt 6.11.

Véase también addDays() y operator++().

[since 6.11] QDate operator--(QDate &date, int)

El operador postfijo « -- » resta un día a « date » y devuelve una copia de « date » con la fecha siguiente.

Esta función se introdujo en Qt 6.11.

Véase también addDays() y operator++().

[constexpr noexcept] bool operator<(const QDate &lhs, const QDate &rhs)

Devuelve « true » si « lhs » es anterior a « rhs »; en caso contrario, devuelve « false ».

QDataStream &operator<<(QDataStream &out, QDate date)

Escribe el objeto ` date ` en el flujo ` out`.

Véase también «Serialización detipos de datos de Qt».

[constexpr noexcept] bool operator<=(const QDate &lhs, const QDate &rhs)

Devuelve « true » si « lhs » es anterior o igual a « rhs »; en caso contrario, devuelve « false ».

[constexpr noexcept] bool operator==(const QDate &lhs, const QDate &rhs)

Devuelve « true » si « lhs » y « rhs » corresponden al mismo día; en caso contrario, devuelve « false ».

[constexpr noexcept] bool operator>(const QDate &lhs, const QDate &rhs)

Devuelve « true » si « lhs » es posterior a « rhs »; en caso contrario, devuelve « false ».

[constexpr noexcept] bool operator>=(const QDate &lhs, const QDate &rhs)

Devuelve « true » si « lhs » es posterior o igual a « rhs »; en caso contrario, devuelve « false ».

QDataStream &operator>>(QDataStream &in, QDate &date)

Lee una fecha del flujo « in » y la introduce en « date ».

Véase también «Serialización detipos de datos de Qt».

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