QDateTime Class

Documentación de las funciones miembro

QDateTime::QDateTime(QDate date, QTime time, const QTimeZone &timeZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Construye una fecha-hora con los datos date y time, utilizando la representación de la hora descrita en timeZone.

Si date es válido y time no lo es, la hora será la medianoche. Si timeZone no es válido, la fecha y hora no serán válidas. Si date y time describen un momento cercano a una transición para timeZone, resolve controla cómo se resuelve esa situación.

[noexcept] QDateTime::QDateTime()

Construye un datetime nulo, nominalmente utilizando la hora local.

Un datetime nulo no es válido, ya que su fecha y hora no son válidas.

Véase también isValid(), setMSecsSinceEpoch(), setDate(), setTime() y setTimeZone().

[since 6.5] QDateTime::QDateTime(QDate date, QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Construye una fecha-hora con los datos date y time, utilizando la hora local.

Si date es válido y time no, se utilizará la medianoche como hora. Si date y time describen un momento cercano a una transición para la hora local, resolve controla cómo se resuelve esa situación.

Esta función se introdujo en Qt 6.5.

[noexcept] QDateTime::QDateTime(const QDateTime &other)

Construye una copia de other datetime.

[noexcept] QDateTime::QDateTime(QDateTime &&other)

Mueve el contenido de la fecha y hora temporal other a este objeto y deja other en un estado no especificado (pero adecuado).

[noexcept] QDateTime::~QDateTime()

Destruye el datetime.

QDateTime QDateTime::addDays(qint64 ndays) const

Devuelve un objeto QDateTime que contiene una fecha-hora ndays días posterior a la fecha-hora de este objeto (o anterior si ndays es negativo).

Si timeSpec() es Qt::LocalTime o Qt::TimeZone y la fecha y hora resultantes caen en la hora de transición del horario estándar al horario de verano, entonces el resultado estará justo más allá de este intervalo, en la dirección del cambio. Si la transición es a las 2h y el reloj se adelanta a las 3h, el resultado de apuntar entre las 2h y las 3h se ajustará para que caiga antes de las 2h (si ndays < 0) o después de las 3h (en caso contrario).

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

[since 6.4] QDateTime QDateTime::addDuration(std::chrono::milliseconds msecs) const

Devuelve un objeto QDateTime que contiene un datetime msecs milisegundos posterior al datetime de este objeto (o anterior si msecs es negativo).

Si este datetime no es válido, se devolverá un datetime inválido.

Esta función se introdujo en Qt 6.4.

Véase también addMSecs(), msecsTo(), addDays(), addMonths() y addYears().

QDateTime QDateTime::addMSecs(qint64 msecs) const

Devuelve un objeto QDateTime que contiene un datetime msecs milisegundos posterior al datetime de este objeto (o anterior si msecs es negativo).

Si este datetime es inválido, se devolverá un datetime inválido.

Véase también addSecs(), msecsTo(), addDays(), addMonths() y addYears().

QDateTime QDateTime::addMonths(int nmonths) const

Devuelve un objeto QDateTime que contiene una fecha-hora nmonths meses posterior a la fecha-hora de este objeto (o anterior si nmonths es negativo).

Si timeSpec() es Qt::LocalTime o Qt::TimeZone y la fecha y hora resultantes caen en la hora de transición del horario estándar al horario de verano, el resultado estará justo más allá de este intervalo, en la dirección del cambio. Si la transición es a las 2h y el reloj se adelanta a las 3h, el resultado de apuntar entre las 2h y las 3h se ajustará para que caiga antes de las 2h (si nmonths < 0) o después de las 3h (en caso contrario).

Véase también daysTo(), addDays(), addYears(), addSecs(), y Timezone transitions.

QDateTime QDateTime::addSecs(qint64 s) const

Devuelve un objeto QDateTime que contiene un datetime s segundos más tarde que el datetime de este objeto (o antes si s es negativo).

Si este datetime es inválido, se devolverá un datetime inválido.

Véase también addMSecs(), secsTo(), addDays(), addMonths() y addYears().

QDateTime QDateTime::addYears(int nyears) const

Devuelve un objeto QDateTime que contiene una fecha-hora nyears años posterior a la fecha-hora de este objeto (o anterior si nyears es negativo).

Si timeSpec() es Qt::LocalTime o Qt::TimeZone y la fecha y hora resultantes caen en la hora de transición del horario estándar al horario de verano, el resultado estará justo más allá de este intervalo, en la dirección del cambio. Si la transición es a las 2h y el reloj se adelanta a las 3h, el resultado de apuntar entre las 2h y las 3h se ajustará para que caiga antes de las 2h (si nyears < 0) o después de las 3h (en caso contrario).

Véase también daysTo(), addDays(), addMonths(), addSecs(), y Timezone transitions.

[static, since 6.5] QDateTime QDateTime::currentDateTime(const QTimeZone &zone)

Devuelve la fecha y hora actuales del reloj del sistema, utilizando la representación de la hora descrita en zone. Si se omite zone, se utiliza la hora local.

Esta función se introdujo en Qt 6.5.

Véase también currentDateTimeUtc(), QDate::currentDate(), QTime::currentTime() y toTimeZone().

[static] QDateTime QDateTime::currentDateTime()

[static] QDateTime QDateTime::currentDateTimeUtc()

Devuelve la fecha/hora actual del reloj del sistema, expresada en términos de UTC.

Equivale a currentDateTime(QTimeZone::UTC).

Véase también currentDateTime(), QDate::currentDate(), QTime::currentTime() y toTimeZone().

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

Devuelve el número actual de milisegundos desde el inicio, en UTC, del año 1970.

Este número es como la variable POSIX time_t, pero expresado en milisegundos en lugar de segundos.

Véase también currentDateTime(), currentDateTimeUtc(), y toTimeZone().

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

Devuelve el número de segundos transcurridos desde el inicio, en UTC, del año 1970.

Este número es como la variable POSIX time_t.

Véase también currentMSecsSinceEpoch().

QDate QDateTime::date() const

Devuelve la parte de fecha del datetime.

Véase también setDate(), time() y timeRepresentation().

qint64 QDateTime::daysTo(const QDateTime &other) const

Devuelve el número de días transcurridos desde esta fecha y hora hasta la fecha y hora de other. El número de días se cuenta como el número de veces que se alcanza la medianoche entre esta fecha y la fecha y hora de other. Esto significa que una diferencia de 10 minutos entre las 23:55 y las 0:05 del día siguiente cuenta como un día.

Si la fecha y hora de other es anterior a esta fecha y hora, el valor devuelto es negativo.

Ejemplo:

QDateTime fechaInicio(QDate(2012, 7, 6), QTime(8, 30, 0));QDateTime fechafinal(QDate(2012, 7, 7), QTime(16, 30, 0));qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

fechaInicio = QDateTime(QDate(2012, 7, 6), QTime(23, 55, 0)); endDate = QDateTime(QDate(2012, 7, 7), QTime(0, 5, 0));qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

qSwap(startDate, endDate); // Make endDate before startDate.
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

Véase también addDays(), secsTo() y msecsTo().

[static] QDateTime QDateTime::fromCFDate(CFDateRef date)

Construye un nuevo QDateTime que contiene una copia del CFDate date.

Véase también toCFDate().

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, const QTimeZone &timeZone)

Devuelve un datetime que representa un momento el número dado msecs de milisegundos después del inicio, en UTC, del año 1970, descrito como se especifica en timeZone. La representación horaria por defecto es la hora local.

Tenga en cuenta que existen valores posibles para msecs que se encuentran fuera del rango válido de QDateTime, tanto negativos como positivos. El comportamiento de esta función es indefinido para esos valores.

Véase también fromSecsSinceEpoch(), toMSecsSinceEpoch(), y setMSecsSinceEpoch().

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs)

[static] QDateTime QDateTime::fromNSDate(const NSDate *date)

Construye un nuevo QDateTime que contiene una copia del NSDate date.

Véase también toNSDate().

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, const QTimeZone &timeZone)

Devuelve un datetime que representa un momento el número dado secs de segundos después del inicio, en UTC, del año 1970, descrito como se especifica en timeZone. La representación horaria por defecto es la hora local.

Tenga en cuenta que hay valores posibles para secs que se encuentran fuera del rango válido de QDateTime, tanto negativos como positivos. El comportamiento de esta función es indefinido para esos valores.

Véase también fromMSecsSinceEpoch(), toSecsSinceEpoch(), y setSecsSinceEpoch().

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

[static, since 6.4] QDateTime QDateTime::fromStdLocalTime(const std::chrono::local_time<std::chrono::milliseconds> &time)

Construye un datetime cuya fecha y hora son el número de milisegundos representados por time, contados desde 1970-01-01T00:00:00.000 en hora local (Qt::LocalTime).

Esta función se introdujo en Qt 6.4.

Véase también toStdSysMilliseconds() y fromMSecsSinceEpoch().

[static, since 6.4] template <typename Clock, typename Duration> QDateTime QDateTime::fromStdTimePoint(const std::chrono::time_point<Clock, Duration> &time)

Construye un datetime que representa el mismo punto en el tiempo que time, usando Qt::UTC como su representación de tiempo.

El reloj de time debe ser compatible con std::chrono::system_clock; en particular, debe existir una conversión soportada por std::chrono::clock_cast. Tras la conversión, el tipo de duración del resultado debe ser convertible a std::chrono::milliseconds.

Si este no es el caso, el invocador debe realizar la conversión de reloj necesaria hacia std::chrono::system_clock y la conversión necesaria del tipo de duración (cast/round/floor/ceil/...) para que la entrada a esta función satisfaga las restricciones anteriores.

Esta función se introdujo en Qt 6.4.

Véase también toStdSysMilliseconds() y fromMSecsSinceEpoch().

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(const std::chrono::local_time<std::chrono::milliseconds> &time)

Construye un datetime cuya fecha y hora son el número de milisegundos representados por time, contados desde 1970-01-01T00:00:00.000 en hora local (Qt::LocalTime).

Esta función se introdujo en Qt 6.4.

Véase también toStdSysMilliseconds() y fromMSecsSinceEpoch().

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds> time)

Construye una fecha-hora que representa el mismo punto en el tiempo que time, utilizando Qt::UTC como su representación temporal.

Esta función se introdujo en Qt 6.4.

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const int &time)

Construye una fecha-hora que representa el mismo momento que time. El resultado se expresará en la zona horaria de time.

Esta función se introdujo en Qt 6.4.

Véase también QTimeZone, toStdSysMilliseconds(), y fromMSecsSinceEpoch().

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

Devuelve el QDateTime representado por el string, usando el format dado, o un datetime inválido si la cadena no puede ser analizada.

Utiliza el calendario cal si se proporciona, en caso contrario el gregoriano.

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. En algunos casos, otros campos pueden hacer que se seleccione el siglo siguiente o el anterior, para obtener un resultado coherente con todos los campos dados. Véase QDate::fromString() para más detalles.

Además de las expresiones, reconocidas en la cadena de formato para representar partes de la fecha y la hora, por QDate::fromString() y QTime::fromString(), este método admite:

Si no está presente el especificador de formato 't', se utiliza la zona horaria local del sistema. Para conocer los valores por defecto de todos los demás campos, consulte QDate::fromString() y QTime::fromString().

Por ejemplo:

QDateTime dateTime = QDateTime::fromString("1.30.1", "M.d.s");
// dateTime is January 30 in 1900 at 00:00:01.
dateTime = QDateTime::fromString("12", "yy");
// dateTime is January 1 in 1912 at 00:00:00.

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.

QTime time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time2 = QTime::fromString("1apA", "1amAM");
// time2 is 01:00:00

QDateTime dateTime2 = QDateTime::fromString("M1d1y9800:01:02",
                                            "'M'M'd'd'y'yyhh:mm:ss");
// dateTime is 1 January 1998 00:01:02

Si no se cumple el formato, se devuelve un QDateTime no válido. Si se cumple el formato, pero string representa una fecha y hora no válidas (por ejemplo, en un espacio omitido por una transición de zona horaria), se devuelve un QDateTime válido, que representa una fecha y hora cercanas que sí son válidas.

Las expresiones que no tienen ceros a la izquierda (d, M, h, m, s, z) serán codiciosas. Esto significa que utilizarán dos dígitos (o tres, en el caso de z) aunque esto las sitúe fuera del rango y/o deje muy pocos dígitos para otras secciones.

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // invalid

Esto podría haber significado 1 Enero 00:30.00 pero la M cogerá dos dígitos.

Los campos incorrectamente especificados de string harán que se devuelva un QDateTime inválido. Sólo se admiten las fechas comprendidas entre la hora local del inicio del año 100 y el final del año 9999. Tenga en cuenta que las fechas cercanas a los extremos de este intervalo en otras zonas horarias, incluida UTC, pueden quedar fuera del intervalo (y, por tanto, considerarse no válidas) en función de la zona horaria local.

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

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

Esta función se introdujo en Qt 6.0.

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

Devuelve el QDateTime representado por el string, utilizando el format dado, o un datetime inválido si esto no es posible.

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

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

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

Esta función se introdujo en Qt 6.0.

[static, since 6.7] QDateTime QDateTime::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] QDateTime QDateTime::fromString(const QString &string, QStringView format, QCalendar cal)

Esta función se introdujo en Qt 6.0.

[static, since 6.7] QDateTime QDateTime::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] QDateTime QDateTime::fromString(const QString &string, const QString &format, QCalendar cal)

[static, since 6.7] QDateTime QDateTime::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] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

Esta función se introdujo en Qt 6.7.

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

Esta función se introdujo en Qt 6.0.

bool QDateTime::isDaylightTime() const

Devuelve si esta fecha cae en horario de verano.

Si el Qt::TimeSpec no es Qt::LocalTime o Qt::TimeZone entonces siempre devolverá false.

Véase también timeSpec().

bool QDateTime::isNull() const

Devuelve true si tanto la fecha como la hora son nulas; en caso contrario, devuelve false. Una fecha/hora nula no es válida.

Véase también QDate::isNull(), QTime::isNull() y isValid().

bool QDateTime::isValid() const

Devuelve true si este datetime representa un momento definido, en caso contrario false.

Un datetime es válido si tanto su fecha como su hora son válidas y la representación horaria utilizada da un significado válido a su combinación. Cuando la representación horaria es una zona horaria específica o la hora local, puede haber momentos en algunas fechas que la zona se salte en su representación, como cuando una transición de horario de verano se salta una hora (normalmente durante una noche en primavera). Por ejemplo, si el horario de verano finaliza a las 2 de la madrugada y el reloj avanza hasta las 3 de la madrugada, las horas de ese día comprendidas entre las 02:00:00 y las 02:59:59.999 no serán válidas.

Véase también QDateTime::YearRange, QDate::isValid(), y QTime::isValid().

qint64 QDateTime::msecsTo(const QDateTime &other) const

Devuelve el número de milisegundos transcurridos desde esta fecha y hora hasta la fecha y hora de other. Si la fecha y hora de other es anterior a esta fecha y hora, el valor devuelto es negativo.

Antes de realizar la comparación, las dos fechas se convierten a Qt::UTC para garantizar que el resultado es correcto si el horario de verano (DST) se aplica a una de las dos fechas y no a la otra.

Devuelve 0 si alguna de las dos fechas no es válida.

Véase también addMSecs(), daysTo() y QTime::msecsTo().

int QDateTime::offsetFromUtc() const

Devuelve el desfase de esta fecha respecto a UTC en segundos.

El resultado depende de timeSpec():

• Qt::UTC El offset es 0.
• Qt::OffsetFromUTC El offset es el valor establecido originalmente.
• Qt::LocalTime Se devuelve el desfase de la hora local con respecto a UTC.
• Qt::TimeZone Se devuelve el desfase utilizado por la zona horaria.

Para los dos últimos, se devuelve el desfase en esta fecha y hora, teniendo en cuenta el desfase por horario de verano. El desfase es la diferencia entre la hora local o la hora en la zona horaria dada y la hora UTC; es positivo en las zonas horarias por delante de UTC (al Este del Primer Meridiano), negativo para las que están por detrás de UTC (al Oeste del Primer Meridiano).

Véase también setTimeZone().

qint64 QDateTime::secsTo(const QDateTime &other) const

Devuelve el número de segundos transcurridos desde esta fecha y hora hasta la fecha y hora de other. Si la fecha y hora de other es anterior a esta fecha y hora, el valor devuelto es negativo.

Antes de realizar la comparación, las dos fechas se convierten a Qt::UTC para garantizar que el resultado es correcto si el horario de verano (DST) se aplica a una de las dos fechas pero no a la otra.

Devuelve 0 si alguna de las dos fechas no es válida.

Ejemplo:

QDateTime now = QDateTime::fecha-hora actual();QDateTime xmas(QDate(now.date().year(), 12, 25).startOfDay());qDebug("There are %d seconds to Christmas", now.secsTo(xmas));

Véase también addSecs(), daysTo() y QTime::secsTo().

void QDateTime::setDate(QDate date, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Establece la parte de fecha de esta fecha y hora en date.

Si aún no se ha establecido la hora, se establece a medianoche. Si date es inválido, este QDateTime se convierte en inválido.

Si date y time() describen un momento cercano a una transición para la representación temporal de este datetime, resolve controla cómo se resuelve esa situación.

Véase también date(), setTime(), y setTimeZone().

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

Establece la fecha-hora para representar un momento un número dado, msecs, de milisegundos después del inicio, en UTC, del año 1970.

En sistemas que no soportan zonas horarias, esta función se comportará como si la hora local fuera Qt::UTC.

Tenga en cuenta que si pasa el mínimo de qint64 (std::numeric_limits<qint64>::min()) a msecs se producirá un comportamiento indefinido.

Véase también setSecsSinceEpoch(), toMSecsSinceEpoch(), y fromMSecsSinceEpoch().

void QDateTime::setSecsSinceEpoch(qint64 secs)

Establece la fecha-hora para representar un momento un número dado, secs, de segundos después del inicio, en UTC, del año 1970.

En sistemas que no soportan zonas horarias, esta función se comportará como si la hora local fuera Qt::UTC.

Véase también setMSecsSinceEpoch(), toSecsSinceEpoch(), y fromSecsSinceEpoch().

void QDateTime::setTime(QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Establece la parte de la hora de esta fecha y hora en time. Si time no es válida, esta función la establece en medianoche. Por lo tanto, es posible borrar cualquier hora establecida en QDateTime estableciéndola por defecto en QTime:

QDateTime dt = QDateTime::currentDateTime();
dt.setTime(QTime());

Si date() y time describen un momento cercano a una transición para la representación temporal de esta fecha-hora, resolve controla cómo se resuelve esa situación.

Véase también time(), setDate(), y setTimeZone().

void QDateTime::setTimeZone(const QTimeZone &toZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Establece la zona horaria utilizada en esta fecha y hora en toZone.

El datetime puede referirse a un punto diferente en el tiempo. Utiliza la representación horaria de toZone, lo que puede cambiar el significado de sus invariables date() y time().

Si toZone no es válido, la fecha y hora tampoco lo será. De lo contrario, timeSpec() de este datetime después de la llamada coincidirá con toZone.timeSpec().

Si date() y time() describen un momento cercano a una transición para toZone, resolve controla cómo se resuelve esa situación.

Véase también timeRepresentation(), timeZone(), y Qt::TimeSpec.

[noexcept] void QDateTime::swap(QDateTime &other)

Intercambia esta fecha y hora con other. Esta operación es muy rápida y nunca falla.

QTime QDateTime::time() const

Devuelve la parte de la hora del datetime.

Véase también setTime(), date() y timeRepresentation().

[since 6.5] QTimeZone QDateTime::timeRepresentation() const

Devuelve un QTimeZone que identifica cómo este datetime representa el tiempo.

El timeSpec() del QTimeZone devuelto coincidirá con el de este datetime; si no es Qt::TimeZone entonces el QTimeZone devuelto es una representación del tiempo. Cuando su timeSpec() es Qt::OffsetFromUTC, el QTimeZone's fixedSecondsAheadOfUtc() devuelto proporciona el desplazamiento. Cuando timeSpec() es Qt::TimeZone, el propio objeto QTimeZone es la representación completa de esa zona horaria.

Esta función se introdujo en Qt 6.5.

Véase también timeZone(), setTimeZone() y QTimeZone::asBackendZone().

Qt::TimeSpec QDateTime::timeSpec() const

Devuelve la especificación horaria del datetime.

Clasifica su representación horaria como hora local, UTC, un desfase fijo respecto a UTC (sin indicar el desfase) o una zona horaria (sin dar los detalles de esa zona horaria). Equivale a timeRepresentation().timeSpec().

Véase también setTimeZone(), timeRepresentation(), date() y time().

QTimeZone QDateTime::timeZone() const

Devuelve la zona horaria de la fecha-hora.

El resultado es el mismo que timeRepresentation().asBackendZone(). En todos los casos, timeSpec() del resultado es Qt::TimeZone.

Cuando timeSpec() es Qt::LocalTime, el resultado describirá la hora local en el momento en que se llamó a este método. No reflejará cambios posteriores en la zona horaria del sistema, aunque el QDateTime del que se obtuvo sí lo haga.

Véase también timeRepresentation(), setTimeZone(), Qt::TimeSpec, y QTimeZone::asBackendZone().

QString QDateTime::timeZoneAbbreviation() const

Devuelve la abreviatura de la zona horaria para esta fecha y hora.

La cadena devuelta depende de timeSpec():

• Para Qt::UTC es "UTC".
• Para Qt::OffsetFromUTC tendrá el formato "UTC±00:00".
• Para Qt::LocalTime, se consulta el sistema anfitrión.
• Para Qt::TimeZone, se consulta el objeto QTimeZone asociado.

Véase también timeSpec() y QTimeZone::abbreviation().

CFDateRef QDateTime::toCFDate() const

Crea un CFDate a partir de QDateTime.

El que llama es dueño del objeto CFDate y es responsable de liberarlo.

Véase también fromCFDate().

QDateTime QDateTime::toLocalTime() const

Devuelve una copia de esta fecha y hora convertida a hora local.

El resultado representa el mismo momento en el tiempo y es igual a esta fecha y hora.

Ejemplo:

QDateTime UTC(QDateTime::currentDateTimeUtc());QDateTime local(UTC.toLocalTime());qDebug() << "UTC time is:" << UTC;
qDebug() << "Local time is:" << local;
qDebug() << "No difference between times:" << UTC.secsTo(local);

Véase también toTimeZone(), toUTC() y toOffsetFromUtc().

qint64 QDateTime::toMSecsSinceEpoch() const

Devuelve la fecha-hora como un número de milisegundos después del inicio, en UTC, del año 1970.

En sistemas que no soportan zonas horarias, esta función se comportará como si la hora local fuera Qt::UTC.

El comportamiento de esta función es indefinido si la fecha y hora almacenada en este objeto no es válida. Sin embargo, para todas las fechas válidas, esta función devuelve un valor único.

Véase también toSecsSinceEpoch(), setMSecsSinceEpoch() y fromMSecsSinceEpoch().

NSDate *QDateTime::toNSDate() const

Crea una NSDate a partir de QDateTime.

El objeto NSDate se libera automáticamente.

Véase también fromNSDate().

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

Devuelve una copia de esta fecha y hora convertida a una especificación de Qt::OffsetFromUTC con el valor offsetSeconds. Equivalente a toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)).

Si offsetSeconds es igual a 0, se devolverá una fecha y hora UTC.

El resultado representa el mismo momento en el tiempo que, y es igual a, este datetime.

Véase también offsetFromUtc() y toTimeZone().

qint64 QDateTime::toSecsSinceEpoch() const

Devuelve la fecha-hora como un número de segundos después del inicio, en UTC, del año 1970.

En sistemas que no soportan zonas horarias, esta función se comportará como si la hora local fuera Qt::UTC.

El comportamiento de esta función es indefinido si la fecha y hora almacenada en este objeto no es válida. Sin embargo, para todas las fechas válidas, esta función devuelve un valor único.

Véase también toMSecsSinceEpoch(), fromSecsSinceEpoch() y setSecsSinceEpoch().

[since 6.4] std::chrono::sys_time<std::chrono::milliseconds> QDateTime::toStdSysMilliseconds() const

Convierte este objeto datetime al punto de tiempo equivalente expresado en milisegundos, utilizando std::chrono::system_clock como reloj.

Esta función se introdujo en Qt 6.4.

Véase también fromStdTimePoint() y toMSecsSinceEpoch().

[since 6.4] std::chrono::sys_seconds QDateTime::toStdSysSeconds() const

Convierte este objeto datetime al punto de tiempo equivalente expresado en segundos, utilizando std::chrono::system_clock como reloj.

Esta función se introdujo en Qt 6.4.

Véase también fromStdTimePoint() y toSecsSinceEpoch().

Devuelve la fecha y hora como una 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. Consulte QTime::toString() y QDate::toString() para conocer los especificadores admitidos para la hora y la fecha, respectivamente, 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 QDateTime es 21 de mayo de 2001 14:13:09.120):

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

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

QString QDateTime::toString(QStringView format) const

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

Devuelve la fecha y hora como una cadena en el format dado.

Si el format es Qt::TextDate, la cadena se formatea de la manera predeterminada. Los nombres del día y del mes estarán en inglés. Un ejemplo de este formato es "Wed May 20 03:40:13 1998". Para obtener un formato localizado, consulte QLocale::toString().

Si el format es Qt::ISODate, el formato de la cadena corresponde a la especificación ampliada ISO 8601 para representaciones de fechas y horas, tomando la forma aaaa-MM-ddTHH:mm:ss[Z|±HH:mm], dependiendo del timeSpec() del QDateTime. Si el timeSpec() es Qt::UTC, se añadirá Z a la cadena; si el timeSpec() es Qt::OffsetFromUTC, se añadirá a la cadena el desfase en horas y minutos respecto a UTC. Para incluir milisegundos en la fecha ISO 8601, utilice format Qt::ISODateWithMs , que corresponde a aaaa-MM-ddTHH:mm:ss.zzz[Z|±HH:mm].

Si el format es Qt::RFC2822Date, la cadena se formatea siguiendo el RFC 2822.

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

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

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

QDateTime QDateTime::toTimeZone(const QTimeZone &timeZone) const

Devuelve una copia de esta fecha y hora convertida al formato timeZone.

El resultado representa el mismo momento en el tiempo que, y es igual a, este datetime.

El resultado describe el momento en el tiempo en términos de la representación del tiempo de timeZone. Por ejemplo:

QDateTime local(QDateTime::currentDateTime());QDateTime UTC(local.toTimeZone(QTimeZone::UTC));qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times represented:" << local.secsTo(UTC);

Si timeZone no es válido, la fecha y hora no lo será. En caso contrario, la fecha y hora devuelta timeSpec() coincidirá con timeZone.timeSpec().

Véase también timeRepresentation(), toLocalTime(), toUTC() y toOffsetFromUtc().

QDateTime QDateTime::toUTC() const

Devuelve una copia de esta fecha y hora convertida a UTC.

El resultado representa el mismo momento en el tiempo y es igual a esta fecha y hora.

Ejemplo:

QDateTime local(QDateTime::currentDateTime());QDateTime UTC(local.toUTC());qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);

Véase también toTimeZone(), toLocalTime() y toOffsetFromUtc().

[since 6.4] QDateTime &QDateTime::operator+=(std::chrono::milliseconds duration)

Modifica este objeto datetime añadiendo la fecha duration. El objeto actualizado será posterior si duration es positivo, o anterior si es negativo.

Si este datetime no es válido, esta función no tiene efecto.

Devuelve una referencia a este objeto datetime.

Esta función se introdujo en Qt 6.4.

Véase también addMSecs().

[since 6.4] QDateTime &QDateTime::operator-=(std::chrono::milliseconds duration)

Modifica este objeto datetime restándole el valor dado duration. El objeto actualizado será anterior si duration es positivo, o posterior si es negativo.

Si este datetime no es válido, esta función no tiene efecto.

Devuelve una referencia a este objeto datetime.

Esta función se introdujo en Qt 6.4.

Véase también addMSecs.

[noexcept] QDateTime &QDateTime::operator=(const QDateTime &other)

Copia la fecha y hora de other en esto y devuelve esta copia.