QDate Class

Documentación de la función de miembro

[constexpr] QDate::QDate()

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

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

Construye un QDate que representa la misma fecha que date. Esto permite una fácil interoperabilidad entre las clases de calendario de la biblioteca estándar y las clases datetime 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];

Estas funciones se introdujeron en Qt 6.4.

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

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

La fecha se entiende en términos del calendario gregoriano. Si la fecha especificada no es válida, la fecha no se construye y isValid() devuelve false.

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 negativo).

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

Véase 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 negativo).

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

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 suministra, en caso contrario el calendario gregoriano.

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

QDate QDate::addMonths(int nmonths) const

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 suministra, si no, el calendario gregoriano.

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

QDate QDate::addYears(int nyears) const

[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 para esta fecha.

Utiliza cal como calendario si se suministra, de lo contrario el calendario gregoriano (para el que el retorno va de 1 a 31). Devuelve 0 si la fecha no es válida.

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

int QDate::day() const

int QDate::dayOfWeek(QCalendar cal) const

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

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

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

int QDate::dayOfWeek() const

int QDate::dayOfYear(QCalendar cal) const

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

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

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

int QDate::dayOfYear() const

int QDate::daysInMonth(QCalendar cal) const

Devuelve el número de días del mes para esta fecha.

Utiliza cal como calendario si se suministra, en caso contrario el calendario gregoriano (para el que 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

int QDate::daysInYear(QCalendar cal) const

Devuelve el número de días del año para esta fecha.

Utiliza cal como calendario si se suministra, de lo contrario el calendario gregoriano (para el que el resultado es 365 o 366). Devuelve 0 si la fecha no es válida.

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

int QDate::daysInYear() const

qint64 QDate::daysTo(QDate d) const

Devuelve el número de días desde esta fecha hasta d (que 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 final del día.

El momento en que termina un día depende de cómo se describa el tiempo: cada día comienza y termina antes para los que están en zonas horarias más al oeste y más tarde para los que están en zonas horarias más al este. La representación del tiempo a utilizar puede especificarse mediante una hora opcional 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 una transición de zona horaria hace que la fecha dada se salte ese momento (por ejemplo, un adelanto de DST saltándose las 23:00 y la hora siguiente), se devuelve la hora real más tardía del día. Esto sólo 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 raro caso de una fecha que se haya saltado por completo (esto ocurre cuando una zona al este de la línea internacional de fecha pasa a estar al oeste de la misma), el retorno 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 se introdujo en Qt 6.5.

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

Convierte el día juliano jd a QDate.

Véase también toJulianDay().

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

Devuelve un QDate 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.

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 QDate representado por el string, usando el format dado, o una fecha inválida si la cadena no puede ser analizada.

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

Estas expresiones pueden utilizarse para el formato:

Todos los demás caracteres de entrada se tratarán como texto. Cualquier secuencia no vacía de caracteres entre comillas simples también se tratará (sin las comillas) como texto y no se interpretará como una expresión. Por ejemplo:

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

Si no se cumple el formato, se devuelve un QDate no válido. Las expresiones que no esperan ceros a la izquierda (d, M) serán codiciosas. Esto significa que utilizarán dos dígitos aunque esto las sitúe fuera del rango de valores aceptados y deje muy pocos dígitos para otras secciones. Por ejemplo, la siguiente cadena de formato podría haber significado 30 de enero, pero la M cogerá dos dígitos, dando como resultado una fecha no válida:

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

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

Cuando format sólo especifica los dos últimos dígitos de un año, los 100 años que comienzan en baseYear son los candidatos considerados en primer lugar. 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, seleccionando un año desde entonces hasta 1999. Pasando 1976 como baseYear se seleccionará un año desde 1976 hasta 2075, por ejemplo. Cuando el formato también incluye el mes, el día (del mes) y el día de la semana, éstos bastan para dar a entender el siglo. En tal caso, se selecciona una fecha coincidente en el siglo más próximo al indicado por baseYear, prefiriendo más tarde que más temprano. Consulte QCalendar::matchCenturyToWeekday() y Date ambiguities para más detalles,

Los siguientes ejemplos muestran 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

Ambigüedades de fechas

Cada cultura utiliza un formato distinto para las fechas, por lo que los usuarios pueden confundir el orden en el que deben indicarse los campos de fecha. Por ejemplo, "Wed 28-Nov-01" puede significar el 1 de noviembre de 2028 o el 28 de noviembre de 2001 (ambos son miércoles). Utilizando el formato "ddd yy-MMM-dd" se interpretará de la primera manera, utilizando "ddd dd-MMM-yy" de la segunda. Sin embargo, lo que el usuario quiso decir puede depender de la forma en que el usuario escribe normalmente las fechas, más que del formato que el código esperaba.

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

Incluir un día de la semana en el formato también puede resolver el siglo de una fecha especificada utilizando sólo los dos últimos dígitos de su año. Desgraciadamente, 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 sí coincide con la lectura del formato pero que no es la que pretendía su autor. Del mismo modo, si el usuario simplemente se equivoca en el día de la semana, en una fecha por lo demás correcta, esto puede llevar 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 otra muy distinta.

La mejor forma de evitar ambigüedades en las fechas es utilizar años y meses de cuatro dígitos especificados por su nombre (completo o abreviado), idealmente recogidos mediante modismos de interfaz de usuario que dejen bien claro al usuario qué parte de la fecha está seleccionando. Incluir el día de la semana también puede ayudar a comprobar la coherencia de los datos. Cuando los datos proceden del usuario y utilizan un formato suministrado por una configuración regional seleccionada por el usuario, es mejor utilizar 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 de una fuente que no controlas, por ejemplo.

Como consecuencia de estas posibles fuentes de confusión, sobre todo cuando no se puede estar seguro de que se esté utilizando un formato inequívoco, es importante comprobar que el resultado de leer una cadena como fecha no sólo es válido, sino razonable para el propósito para el que se suministró. Si el resultado está fuera de algún rango de valores razonables, puede valer la pena hacer que el usuario confirme su selección de fecha, mostrando la fecha leída de la cadena en un formato largo que sí incluya el nombre del mes y el año de cuatro dígitos, para que le resulte más fácil reconocer 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 se introdujo en Qt 6.0.

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

Devuelve el QDate representado por el string, utilizando el format dado, o una fecha inválida si la cadena no puede ser analizada.

Nota para Qt::TextDate: sólo se reconocen los nombres de mes en inglés (por ejemplo, "Jan" en forma corta o "January" en forma larga).

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

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

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 QCalendar construido por defecto.

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 se introdujo en Qt 6.0.

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

Utiliza un QCalendar construido por defecto.

Esta función se introdujo en Qt 6.7.

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

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

Utiliza un QCalendar construido por defecto.

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 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 se introdujo en Qt 6.0.

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

Extrae el año, mes y 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.

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

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

Devuelve true si el year especificado 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.

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)

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

int QDate::month(QCalendar cal) const

Devuelve el mes-número de la fecha.

Numera los meses del año empezando por 1 para el primero. Utiliza cal como calendario si se suministra, de lo contrario el calendario gregoriano, para el que la 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. Tenga 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

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

Establece esto para representar la fecha, en el calendario gregoriano, con los números dados year, month y day. Devuelve true si la fecha resultante es válida; en caso contrario, hace que represente una fecha no válida y devuelve false.

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

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

Establece esto para representar la fecha, en el calendario dado cal, con los números dados year, month y day. Devuelve true si la fecha resultante es válida; en caso contrario, hace que represente 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 de inicio del día.

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

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

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

En el raro caso de una fecha que se haya omitido por completo (esto ocurre cuando una zona al este de la línea internacional de fecha pasa a estar al oeste de la misma), el retorno 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 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 entre el 1 de enero de 1970 (la época UNIX) y esta fecha, representada como un objeto std::chrono::sys_days. Si esta fecha es anterior a la época, el número de días será negativo.

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

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

Estas expresiones pueden utilizarse en el parámetro format:

Cualquier secuencia de caracteres entre comillas simples se incluirá literalmente en la cadena de salida (sin las comillas), aunque contenga caracteres de formato. Dos comillas simples consecutivas ("''") se sustituyen por una comilla simple en la salida. Todos los demás caracteres de la cadena de formato se incluyen literalmente en la cadena de salida.

Los formatos sin separadores (por ejemplo, "ddMM") son compatibles, pero deben utilizarse con cuidado, ya que las cadenas resultantes no siempre son legibles de forma fiable (por ejemplo, si "dM" produce "212", podría significar tanto el 2 de diciembre como el 21 de febrero).

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

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

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

QString QDate::toString(QStringView format) const

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

Devuelve la fecha en forma de cadena. El parámetro format determina el formato de la cadena.

Si format es Qt::TextDate, la cadena tendrá el formato predeterminado. Los nombres del día y del mes estarán en inglés. Un ejemplo de este formato es "Sat May 20 1995". Para un formato localizado, consulte QLocale::toString().

Si format es Qt::ISODate, el formato de cadena corresponde a la especificación ampliada ISO 8601 para representaciones de fechas y horas, tomando 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 entre 01 y 31.

Si format es Qt::RFC2822Date, la cadena se formatea de manera compatible con 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.

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

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

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

Devuelve el número de semana ISO 8601 (de 1 a 53).

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

De acuerdo con ISO 8601, cada semana cae en el año al que pertenecen la mayoría de sus días, en el calendario gregoriano. Como la semana de ISO 8601 comienza el lunes, éste es el año en el que cae el jueves de la semana. La mayoría de los años tienen 52 semanas, pero algunos tienen 53.

Véase también isValid().

int QDate::year(QCalendar cal) const

Devuelve el año de esta fecha.

Utiliza cal como calendario, si se suministra, de lo contrario el calendario gregoriano.

Devuelve 0 si la fecha no es válida. Para algunos calendarios, las fechas anteriores a su primer año pueden ser todas inválidas.

Si se utiliza un calendario que tiene un año 0, compruebe mediante isValid() si el retorno es 0. Tales calendarios utilizan números de año negativos de la forma obvia, con el año 1 precedido por el año 0, a su vez precedido por el año -1 y así sucesivamente.

Algunos calendarios, a pesar de no tener año 0, tienen una numeración convencional de los años anteriores a su primer año, contando hacia atrás desde 1. Por ejemplo, en el calendario gregoriano proléptico, los años sucesivos anteriores a 1 EC (el primer año) se identifican como 1 BCE, 2 BCE, 3 BCE y así sucesivamente. En este tipo de calendarios, se utilizan números de año negativos para indicar estos años anteriores al año 1, con -1 indicando el año anterior al 1.

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

int QDate::year() const