QCalendar Class
La clase QCalendar describe los sistemas de calendario. Más información...
| Encabezado: | #include <QCalendar> |
| 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.
Tipos públicos
(since 6.2) class | SystemId |
| enum class | System { Gregorian, Julian, Milankovic, Jalali, IslamicCivil } |
Funciones públicas
| QCalendar() | |
| QCalendar(QAnyStringView name) | |
| QCalendar(QCalendar::System system) | |
(since 6.2) | QCalendar(QCalendar::SystemId id) |
| QDate | dateFromParts(const QCalendar::YearMonthDay &parts) const |
| QDate | dateFromParts(int year, int month, int day) const |
| QString | dateTimeToString(QStringView format, const QDateTime &datetime, QDate dateOnly, QTime timeOnly, const QLocale &locale) const |
| int | dayOfWeek(QDate date) const |
| int | daysInMonth(int month, int year = Unspecified) const |
| int | daysInYear(int year) const |
| bool | hasYearZero() const |
| bool | isDateValid(int year, int month, int day) const |
| bool | isGregorian() const |
| bool | isLeapYear(int year) const |
| bool | isLunar() const |
| bool | isLuniSolar() const |
| bool | isProleptic() const |
| bool | isSolar() const |
| bool | isValid() const |
(since 6.7) QDate | matchCenturyToWeekday(const QCalendar::YearMonthDay &parts, int dow) const |
| int | maximumDaysInMonth() const |
| int | maximumMonthsInYear() const |
| int | minimumDaysInMonth() const |
| QString | monthName(const QLocale &locale, int month, int year = Unspecified, QLocale::FormatType format = QLocale::LongFormat) const |
| int | monthsInYear(int year) const |
| QString | name() const |
| QCalendar::YearMonthDay | partsFromDate(QDate date) const |
| QString | standaloneMonthName(const QLocale &locale, int month, int year = Unspecified, QLocale::FormatType format = QLocale::LongFormat) const |
| QString | standaloneWeekDayName(const QLocale &locale, int day, QLocale::FormatType format = QLocale::LongFormat) const |
| QString | weekDayName(const QLocale &locale, int day, QLocale::FormatType format = QLocale::LongFormat) const |
Miembros públicos estáticos
| QStringList | availableCalendars() |
Descripción detallada
Un objeto QCalendar asigna un año, un mes y un número de día a un día concreto (identificado en última instancia por su número de día juliano), utilizando las reglas de un sistema determinado.
El QCalendar() predeterminado es un calendario gregoriano proleptico, que no tiene año cero. Se pueden admitir otros calendarios activando las funciones adecuadas o cargando complementos. Los calendarios admitidos como funciones se pueden crear pasando la enumeración ` QCalendar::System ` al constructor. Todos los calendarios compatibles pueden crearse por su nombre, una vez que se hayan creado. (Por lo tanto, los complementos instancian su backend de calendario para registrarlo). Los backends integrados, a los que se accede a través de ` QCalendar::System`, también están siempre disponibles por su nombre. Los calendarios que utilizan backends personalizados también pueden crearse utilizando un identificador único asignado al backend en el momento de su creación.
Un valor de `QCalendar` es inmutable.
Véase también QDate y QDateTime.
Documentación sobre los tipos de miembros
enum class QCalendar::System
Este tipo enumerado se utiliza para especificar una opción de sistema de calendario.
| Constante | Valor | Descripción |
|---|---|---|
QCalendar::System::Gregorian | 0 | El calendario predeterminado, utilizado a nivel internacional. |
QCalendar::System::Julian | 8 | Un antiguo calendario romano. |
QCalendar::System::Milankovic | 9 | Un calendario juliano revisado utilizado por algunas iglesias ortodoxas. |
QCalendar::System::Jalali | 10 | El calendario solar hijri (también llamado persa). |
QCalendar::System::IslamicCivil | 11 | El calendario civil islámico (tabular). |
Véase también QCalendar y QCalendar::SystemId.
Documentación de funciones de miembro
[explicit] QCalendar::QCalendar()
[explicit] QCalendar::QCalendar(QAnyStringView name)
[explicit] QCalendar::QCalendar(QCalendar::System system)
Crea un objeto de calendario.
La elección del calendario que se va a utilizar puede indicarse mediante ` system`, utilizando la enumeración ` QCalendar::System`, o mediante ` name`, utilizando una cadena (ya sea Unicode o Latin 1). La creación por nombre puede depender de que se haya creado primero, por otros medios, una instancia del calendario dado. Sin argumentos, el constructor por defecto devuelve el calendario gregoriano.
Nota: En las versiones de Qt anteriores a la 6.4, el constructor mediante name solo aceptaba QStringView y QLatin1String, pero no QAnyStringView.
Véanse también ` QCalendar`, ` System` y ` isValid()`.
[explicit, since 6.2] QCalendar::QCalendar(QCalendar::SystemId id)
Crea un objeto de calendario.
Cuando se utiliza una implementación de calendario personalizada, a su backend se le asigna un identificador único al crearse; al pasar ese identificador como parámetro d id o a este constructor, se obtendrá un QCalendar que utilice ese backend. Esto puede resultar útil cuando el backend no está registrado por su nombre.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.2.
[static] QStringList QCalendar::availableCalendars()
Devuelve una lista con los nombres de los sistemas de calendario disponibles.
Estos pueden ser proporcionados por complementos u otro código vinculado a una aplicación, además de los que proporciona Qt, algunos de los cuales están controlados por funciones.
QDate QCalendar::dateFromParts(const QCalendar::YearMonthDay &parts) const
QDate QCalendar::dateFromParts(int year, int month, int day) const
Convierte un año, un mes y un día en un « QDate ».
Los valores « year », « month » y « day » pueden pasarse como números independientes o agrupados como miembros de « parts ». Devuelve un objeto « QDate » con el año, el mes y el día del mes indicados en este calendario, si existe. En caso contrario, incluido el caso en el que cualquiera de los valores sea QCalendar::Unspecified, devuelve un QDate cuyo isNull() es true. Si la fecha representada queda fuera del rango admitido por QDate, el isValid() del QDate devuelto será false.
Véase también isDateValid() y partsFromDate().
QString QCalendar::dateTimeToString(QStringView format, const QDateTime &datetime, QDate dateOnly, QTime timeOnly, const QLocale &locale) const
Devuelve una cadena que representa una fecha, una hora o una fecha y hora determinadas.
Si datetime es válido, se representa y se reconocen los especificadores de formato tanto para los campos de fecha como para los de hora; de lo contrario, si dateOnly es válido, se representa y solo se reconocen los especificadores de formato para los campos de fecha; por último, si timeOnly es válido, se representa y solo se reconocen los especificadores de formato para los campos de hora. Si ninguno de ellos es válido, se devuelve una cadena vacía.
Consulte QDate::toString y QTime::toString() para conocer los especificadores de campo admitidos. Los caracteres de format que se reconocen como especificadores de campo se sustituyen por texto que representa los datos correspondientes de la fecha y/o la hora que se representan. Los textos que los representan pueden depender de la locale especificada. El resto de caracteres de format se copian tal cual en la cadena devuelta.
Véanse también monthName(), weekDayName(), QDate::toString() y QTime::toString().
int QCalendar::dayOfWeek(QDate date) const
Devuelve el número correspondiente al día de la semana para la fecha indicada date.
Devuelve cero si el calendario no puede representar la fecha indicada. Devuelve 1 para el lunes y hasta 7 para el domingo. Los calendarios con días intercalares pueden utilizar otros números para representarlos.
Véanse también partsFromDate() y Qt::DayOfWeek.
int QCalendar::daysInMonth(int month, int year = Unspecified) const
Devuelve el número de días que contiene el month especificado del year especificado.
Los meses se numeran de forma consecutiva, empezando por 1 para el primer mes de cada año. Si year es Unspecified (su valor por defecto, si no se especifica), se devuelve la duración máxima del mes en cualquier año.
Véanse también maximumDaysInMonth() y minimumDaysInMonth().
int QCalendar::daysInYear(int year) const
Devuelve el número de días de la fecha dada year.
El comportamiento de « Unspecified » cuando se trata como « year » no está definido.
bool QCalendar::hasYearZero() const
Devuelve « true » si este calendario tiene un año cero.
Un calendario puede representar los años a partir de su primer año, pero no ofrece ninguna forma de describir los años anteriores a este; un calendario así no tiene año cero y no es proléptico.
Un calendario que represente años anteriores a su primer año puede numerar dichos años simplemente siguiendo el conteo habitual de números enteros, de modo que el año anterior al primero sea el año cero, precedido por años con números negativos; un calendario de este tipo es proléptico y tiene un año cero. Un calendario también podría tener un año cero (por ejemplo, el año de algún gran acontecimiento, siendo los años posteriores el primer año tras ese acontecimiento, el segundo año tras él, y así sucesivamente) sin describir los años anteriores a su año cero. Un calendario de este tipo tendría un año cero sin ser proléptico.
Sin embargo, algunos calendarios representan los años anteriores a su primer año mediante una numeración alternativa; por ejemplo, el primer año del calendario gregoriano proleptico es el 1 d. C. y el año anterior es el 1 a. C., precedido por el 2 a. C. y así sucesivamente. En este caso, utilizamos números de año negativos para esta numeración alternativa, siendo el año -1 el año anterior al año 1, el año -2 el año anterior al año -1, y así sucesivamente. Un calendario de este tipo es proléptico, pero no tiene año cero.
Véase también « isProleptic » ().
bool QCalendar::isDateValid(int year, int month, int day) const
Devuelve « true » exactamente si los valores proporcionados « year », « month » y « day » especifican una fecha válida en este calendario.
Normalmente, esto significa que 1 <= mes <= monthsInYear(año) y 1 <= día <= daysInMonth(mes, año). Sin embargo, los calendarios con días o meses intercalares pueden complicar esta regla.
bool QCalendar::isGregorian() const
Devuelve « true » si este objeto de calendario es el objeto de calendario gregoriano que utilizan como calendario predeterminado otras API de Qt, por ejemplo, en QDate.
bool QCalendar::isLeapYear(int year) const
Devuelve « true » si el año year indicado es bisiesto.
Dado que el año no tiene una duración de un número entero de días, algunos años son más largos que otros. La diferencia puede ser de un mes entero o de un solo día; los detalles varían según el calendario.
Véase también isDateValid().
bool QCalendar::isLunar() const
Devuelve « true » si este calendario es lunar.
Un calendario lunar es aquel que se basa principalmente en las fases de la luna.
bool QCalendar::isLuniSolar() const
Devuelve « true » si este calendario es lunisolar.
Un calendario lunisolar muestra las fases de la Luna, pero se adapta para registrar también la posición variable del Sol en el cielo, en relación con las estrellas fijas.
bool QCalendar::isProleptic() const
Devuelve « true » si este calendario es proleptico.
Un calendario proléptico permite describir años que se sitúan arbitrariamente antes de su primer año. Estos se representan mediante números de año negativos y, posiblemente, mediante un año cero.
Véase también hasYearZero().
bool QCalendar::isSolar() const
Devuelve « true » si este calendario es solar.
Un calendario solar se basa principalmente en la posición variable del Sol en el cielo, en relación con las estrellas fijas.
bool QCalendar::isValid() const
Devuelve «true» si se trata de un objeto de calendario válido.
Crear un calendario con un nombre no reconocido puede dar lugar a un objeto no válido. Utiliza este método para comprobarlo tras crear un calendario por su nombre.
[since 6.7] QDate QCalendar::matchCenturyToWeekday(const QCalendar::YearMonthDay &parts, int dow) const
Ajusta el siglo de una fecha para que coincida con un día concreto de la semana.
Se utiliza cuando se proporcionan el día de la semana, el día del mes, el mes y los dos últimos dígitos del año de una fecha. Devuelve una instancia de ` QDate ` con el ` dow ` dado como su ` dayOfWeek()` (), que coincida con el ` parts ` dado en el mes y el día del mes. El ` year()` del ` QDate` devuelto diferirá del ` parts.year ` en un múltiplo de 100, dando preferencia a los múltiplos pequeños sobre los grandes y a los múltiplos positivos sobre sus negaciones.
Si ninguna fecha cumple estas condiciones, se devuelve un QDate no válido: el día de la semana es incompatible con el resto de datos proporcionados. Esto ocurre, por ejemplo, con el calendario gregoriano, cuyo ciclo de 400 años tiene una duración de un número entero de semanas, por lo que cualquier mes y día de ese mes solo puede caer, en los años con unas dos últimas cifras determinadas, en cuatro días de la semana. (En el caso especial del 29 de febrero en el cambio de siglo, cuando se trata de un año bisiesto, solo es posible un día de la semana: el martes.)
Esta función se introdujo en Qt 6.7.
int QCalendar::maximumDaysInMonth() const
Devuelve el número de días que tiene el mes más largo del calendario, en cualquier año.
Véase también daysInMonth() y minimumDaysInMonth().
int QCalendar::maximumMonthsInYear() const
Devuelve el mayor número de meses que puede tener cualquier año.
Véase también monthName(), standaloneMonthName() y monthsInYear().
int QCalendar::minimumDaysInMonth() const
Devuelve el número de días que tiene el mes más corto del calendario, en cualquier año.
Véanse también daysInMonth() y maximumDaysInMonth().
QString QCalendar::monthName(const QLocale &locale, int month, int year = Unspecified, QLocale::FormatType format = QLocale::LongFormat) const
Devuelve el nombre de un mes debidamente adaptado a la configuración regional.
El mes se indica mediante un número, donde « month = 1» significa el primer mes del año y los meses siguientes se numeran en consecuencia. Devuelve una cadena vacía si no se reconoce el número « month ».
El year puede ser «Unspecified»; en ese caso, se debe utilizar la correspondencia entre números y nombres de los meses de un año típico. Algunos calendarios tienen meses bisiestos que no siempre se sitúan al final del año; en ese caso, la correspondencia entre los números de los meses y sus nombres puede depender de la ubicación del mes bisiesto. Por lo tanto, normalmente se debe especificar el año, si se conoce.
El nombre se devuelve en el formato que se utilizaría normalmente en una fecha completa, en el « locale » especificado; el « format » determina el grado de detalle con el que se expresará (es decir, en qué medida se abreviará).
Véanse también standaloneMonthName(), maximumMonthsInYear() y dateTimeToString().
int QCalendar::monthsInYear(int year) const
Devuelve el número de meses de la fecha dada year.
Si year es Unspecified, devuelve el número máximo de meses de un año.
Véase también maximumMonthsInYear().
QString QCalendar::name() const
El nombre principal de este calendario.
El calendario también puede ser conocido por algunos alias. Un calendario instanciado por su nombre puede utilizar uno de esos alias; en ese caso, su método name() no tiene por qué coincidir con el alias con el que se instanció.
QCalendar::YearMonthDay QCalendar::partsFromDate(QDate date) const
Convierte un objeto ` QDate ` en un año, un mes y un día del mes.
El método ` isValid()` de la estructura devuelta dará como resultado `false` si el calendario no puede representar el ` date ` proporcionado (o si su año se encuentra fuera del rango que ` int ` puede representar). En caso contrario, sus miembros «año», «mes» y «día» registran las partes de su representación con los nombres indicados.
Véase también dateFromParts(), isProleptic() y hasYearZero().
QString QCalendar::standaloneMonthName(const QLocale &locale, int month, int year = Unspecified, QLocale::FormatType format = QLocale::LongFormat) const
Devuelve un nombre independiente y debidamente localizado para un mes.
El mes se indica mediante un número, donde « month = 1» significa el primer mes del año y los meses siguientes se numeran en consecuencia. Devuelve una cadena vacía si no se reconoce el número « month ».
El year puede ser «Unspecified»; en ese caso, debe utilizarse la correspondencia entre números y nombres para los meses de un año típico. Algunos calendarios tienen meses bisiestos que no siempre se sitúan al final del año; en ese caso, la correspondencia entre los números de los meses y sus nombres puede depender de la ubicación del mes bisiesto. Por lo tanto, normalmente debe especificarse el año, si se conoce.
El nombre se devuelve en la forma en que se utilizaría de forma aislada en el « locale » especificado; el « format » determina el grado de detalle con el que se expresará (es decir, en qué medida se abreviará).
Véanse también monthName(), maximumMonthsInYear() y dateTimeToString().
QString QCalendar::standaloneWeekDayName(const QLocale &locale, int day, QLocale::FormatType format = QLocale::LongFormat) const
Devuelve un nombre independiente y debidamente adaptado al contexto local para un día de la semana.
Los días de la semana se numeran del 1 (lunes) al 7 (domingo). Algunos calendarios pueden admitir números más altos para otros días (por ejemplo, días intercalares, que no forman parte de ninguna semana). Devuelve una cadena vacía si no se reconoce el número « day ».
El nombre se devuelve en la forma que se utilizaría de forma aislada (por ejemplo, como encabezado de columna en la visualización tabular de un mes en un calendario, con las semanas sucesivas como filas) en el locale especificado; el format determina el grado de detalle con el que se expresará (es decir, en qué medida se abreviará).
Véanse también weekDayName() y dayOfWeek().
QString QCalendar::weekDayName(const QLocale &locale, int day, QLocale::FormatType format = QLocale::LongFormat) const
Devuelve el nombre de un día de la semana debidamente adaptado a la configuración regional.
Los días de la semana se numeran del 1 (lunes) al 7 (domingo). Algunos calendarios pueden admitir números más altos para otros días (por ejemplo, días intercalares, que no forman parte de ninguna semana). Devuelve una cadena vacía si no se reconoce el número de day.
El nombre se devuelve en el formato que se utilizaría normalmente en una fecha completa, en el locale especificado; el format determina el grado de detalle con el que se expresará (es decir, en qué medida se abreviará).
Véanse también standaloneWeekDayName() y dayOfWeek().
© 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.