#include "qdatetime.h"
#include "qcalendar.h"
#include "qdatastream.h"
#include "qdebug.h"
#include "qlocale.h"
#include "qset.h"
#include "private/qcalendarmath_p.h"
#include "private/qdatetime_p.h"
#include "private/qgregoriancalendar_p.h"
#include "private/qlocale_tools_p.h"
#include "private/qlocaltime_p.h"
#include "private/qnumeric_p.h"
#include "private/qstringconverter_p.h"
#include "private/qstringiterator_p.h"
#include <cmath>
#include <private/qtools_p.h>

Include dependency graph for qdatetime.cpp:

Typedefs
typedef QDateTimePrivate::QDateTimeShortData	ShortData

typedef QDateTimePrivate::QDateTimeData	QDateTimeData

Enumerations
enum class	DaySide { Start , End }

Functions
static QDate	fixedDate (QCalendar::YearMonthDay parts, QCalendar cal)

static QDate	fixedDate (QCalendar::YearMonthDay parts)

static QString	toOffsetString (Qt::DateFormat format, int offset)

static bool	inDateTimeRange (qint64 jd, DaySide side)

static QDateTime	toEarliest (QDate day, const QTimeZone &zone)

static QDateTime	toLatest (QDate day, const QTimeZone &zone)

static qint64	msecsToJulianDay (qint64 msecs)

static QDate	msecsToDate (qint64 msecs)

static QTime	msecsToTime (qint64 msecs)

static bool	daysAndMillisOverflow (qint64 days, qint64 millisInDay, qint64 *sumMillis)

static qint64	timeToMSecs (QDate date, QTime time)

static bool	millisInSystemRange (qint64 millis, qint64 slack=0)

static int	systemTimeYearMatching (int year)

static auto	millisToWithinRange (qint64 millis)

static QDateTimePrivate::ZoneState	stateAtMillis (QTimeZone zone, qint64 millis, QDateTimePrivate::DaylightStatus dst)

static bool	specCanBeSmall (Qt::TimeSpec spec)

static bool	msecsCanBeSmall (qint64 msecs)

static constexpr QDateTimePrivate::StatusFlags	mergeSpec (QDateTimePrivate::StatusFlags status, Qt::TimeSpec spec)

static constexpr Qt::TimeSpec	extractSpec (QDateTimePrivate::StatusFlags status)

static constexpr QDateTimePrivate::StatusFlags	mergeDaylightStatus (QDateTimePrivate::StatusFlags sf, QDateTimePrivate::DaylightStatus status)

static constexpr QDateTimePrivate::DaylightStatus	extractDaylightStatus (QDateTimePrivate::StatusFlags status)

static qint64	getMSecs (const QDateTimeData &d)

static QDateTimePrivate::StatusFlags	getStatus (const QDateTimeData &d)

static Qt::TimeSpec	getSpec (const QDateTimeData &d)

static bool	usesSameOffset (const QDateTimeData &a, const QDateTimeData &b)

static void	refreshZonedDateTime (QDateTimeData &d, const QTimeZone &zone)

static void	refreshSimpleDateTime (QDateTimeData &d)

static void	checkValidDateTime (QDateTimeData &d)

static void	reviseTimeZone (QDateTimeData &d, QTimeZone zone)

static void	setDateTime (QDateTimeData &d, QDate date, QTime time)

static QPair< QDate, QTime >	getDateTime (const QDateTimeData &d)

static void	massageAdjustedDateTime (QDateTimeData &d, QDate date, QTime time)

size_t	qHash (const QDateTime &key, size_t seed)

size_t	qHash (QDate key, size_t seed) noexcept

size_t	qHash (QTime key, size_t seed) noexcept

Typedef Documentation

◆ QDateTimeData

typedef QDateTimePrivate::QDateTimeData QDateTimeData

Definition at line 2564 of file qdatetime.cpp.

◆ ShortData

typedef QDateTimePrivate::QDateTimeShortData ShortData

Definition at line 2563 of file qdatetime.cpp.

Enumeration Type Documentation

◆ DaySide

enum class DaySide

strong

Enumerator
Start
End

Definition at line 831 of file qdatetime.cpp.

Function Documentation

◆ checkValidDateTime()

static void checkValidDateTime ( QDateTimeData & d )

static

Definition at line 2997 of file qdatetime.cpp.

References d, extractSpec(), getStatus(), Qt::LocalTime, Qt::OffsetFromUTC, refreshSimpleDateTime(), refreshZonedDateTime(), Qt::TimeZone, and Qt::UTC.

Referenced by QDateTime::setDate(), and QDateTime::setTime().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ daysAndMillisOverflow()

static bool daysAndMillisOverflow	(	qint64	days,
		qint64	millisInDay,
		qint64 *	sumMillis
	)

inlinestatic

Definition at line 2584 of file qdatetime.cpp.

References qAddOverflow(), and qMulOverflow().

Referenced by millisToWithinRange(), setDateTime(), and timeToMSecs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ extractDaylightStatus()

static constexpr QDateTimePrivate::DaylightStatus extractDaylightStatus ( QDateTimePrivate::StatusFlags status )

inlinestaticconstexpr

Definition at line 2881 of file qdatetime.cpp.

References QDateTimePrivate::DaylightTime, QDateTimePrivate::SetToDaylightTime, QDateTimePrivate::SetToStandardTime, QDateTimePrivate::StandardTime, and QDateTimePrivate::UnknownDaylightTime.

Referenced by QDateTime::isDaylightTime(), massageAdjustedDateTime(), refreshZonedDateTime(), QDateTime::timeZoneAbbreviation(), and QDateTime::toMSecsSinceEpoch().

Here is the caller graph for this function:

◆ extractSpec()

static constexpr Qt::TimeSpec extractSpec ( QDateTimePrivate::StatusFlags status )

inlinestaticconstexpr

Definition at line 2861 of file qdatetime.cpp.

References QDateTimePrivate::TimeSpecMask, QDateTimePrivate::TimeSpecShift, and toInt().

Referenced by checkValidDateTime(), getSpec(), massageAdjustedDateTime(), refreshSimpleDateTime(), refreshZonedDateTime(), QDateTime::setMSecsSinceEpoch(), and usesSameOffset().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fixedDate() [1/2]

static QDate fixedDate ( QCalendar::YearMonthDay parts )

inlinestatic

Definition at line 62 of file qdatetime.cpp.

References QCalendar::YearMonthDay::day, QDate::fromJulianDay(), QGregorianCalendar::julianFromParts(), QCalendar::YearMonthDay::month, QGregorianCalendar::monthLength(), qMin(), and QCalendar::YearMonthDay::year.

Here is the call graph for this function:

◆ fixedDate() [2/2]

static QDate fixedDate	(	QCalendar::YearMonthDay	parts,
		QCalendar	cal
	)

inlinestatic

Definition at line 53 of file qdatetime.cpp.

References QCalendar::dateFromParts(), QCalendar::YearMonthDay::day, QCalendar::daysInMonth(), QCalendar::hasYearZero(), QCalendar::isProleptic(), QCalendar::YearMonthDay::month, qMin(), and QCalendar::YearMonthDay::year.

Referenced by QDate::addMonths(), QDate::addMonths(), QDate::addYears(), and QDate::addYears().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDateTime()

static QPair< QDate, QTime > getDateTime ( const QDateTimeData & d )

static

Definition at line 3112 of file qdatetime.cpp.

References d, QDate::fromJulianDay(), QTime::fromMSecsSinceStartOfDay(), getMSecs(), getStatus(), QtPrivate::DateTimeConstants::JULIAN_DAY_FOR_EPOCH, QDateTimePrivate::ValidDate, and QDateTimePrivate::ValidTime.

Referenced by QDateTime::addDays(), QDateTime::addMonths(), and QDateTime::addYears().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMSecs()

static qint64 getMSecs ( const QDateTimeData & d )

inlinestatic

Definition at line 2890 of file qdatetime.cpp.

References d.

Referenced by QDateTime::addMSecs(), QDateTime::date(), getDateTime(), QDateTime::isDaylightTime(), QDateTime::offsetFromUtc(), refreshZonedDateTime(), QDateTime::time(), QDateTime::timeZoneAbbreviation(), and QDateTime::toMSecsSinceEpoch().

Here is the caller graph for this function:

◆ getSpec()

static Qt::TimeSpec getSpec ( const QDateTimeData & d )

inlinestatic

Definition at line 2910 of file qdatetime.cpp.

References d, extractSpec(), and getStatus().

Referenced by QDateTime::addMSecs(), QDateTime::isDaylightTime(), QDateTime::offsetFromUtc(), QDateTime::timeSpec(), QDateTime::timeZoneAbbreviation(), and QDateTime::toMSecsSinceEpoch().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getStatus()

static QDateTimePrivate::StatusFlags getStatus ( const QDateTimeData & d )

inlinestatic

Definition at line 2900 of file qdatetime.cpp.

References d.

Referenced by checkValidDateTime(), QDateTime::date(), getDateTime(), getSpec(), QDateTime::isDaylightTime(), QDateTime::isNull(), QDateTime::isValid(), massageAdjustedDateTime(), refreshSimpleDateTime(), refreshZonedDateTime(), reviseTimeZone(), QDateTime::setMSecsSinceEpoch(), QDateTime::time(), QDateTime::timeZoneAbbreviation(), QDateTime::toMSecsSinceEpoch(), and usesSameOffset().

Here is the caller graph for this function:

◆ inDateTimeRange()

static bool inDateTimeRange	(	qint64	jd,
		DaySide	side
	)

static

Definition at line 833 of file qdatetime.cpp.

References End, QtPrivate::DateTimeConstants::JULIAN_DAY_FOR_EPOCH, QtPrivate::DateTimeConstants::MSECS_PER_DAY, and Start.

Referenced by QDate::endOfDay(), and QDate::startOfDay().

Here is the caller graph for this function:

◆ massageAdjustedDateTime()

static void massageAdjustedDateTime	(	QDateTimeData &	d,
		QDate	date,
		QTime	time
	)

inlinestatic

Definition at line 4216 of file qdatetime.cpp.

References d, date, extractDaylightStatus(), extractSpec(), getStatus(), QTimeZone::isUtcOrFixedOffset(), mergeDaylightStatus(), Q_ASSERT, refreshSimpleDateTime(), setDateTime(), QDateTimePrivate::ShortData, state, stateAtMillis(), time, timeToMSecs(), QDateTimePrivate::ValidDate, QDateTimePrivate::ValidDateTime, and QDateTimePrivate::ValidTime.

Referenced by QDateTime::addDays(), QDateTime::addMonths(), and QDateTime::addYears().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mergeDaylightStatus()

static constexpr QDateTimePrivate::StatusFlags mergeDaylightStatus	(	QDateTimePrivate::StatusFlags	sf,
		QDateTimePrivate::DaylightStatus	status
	)

inlinestaticconstexpr

Definition at line 2868 of file qdatetime.cpp.

References QDateTimePrivate::DaylightTime, QDateTimePrivate::SetToDaylightTime, QDateTimePrivate::SetToStandardTime, and QDateTimePrivate::StandardTime.

Referenced by massageAdjustedDateTime(), refreshZonedDateTime(), and QDateTime::setMSecsSinceEpoch().

Here is the caller graph for this function:

◆ mergeSpec()

static constexpr QDateTimePrivate::StatusFlags mergeSpec	(	QDateTimePrivate::StatusFlags	status,
		Qt::TimeSpec	spec
	)

inlinestaticconstexpr

Definition at line 2854 of file qdatetime.cpp.

References QDateTimePrivate::TimeSpecShift.

Referenced by reviseTimeZone().

Here is the caller graph for this function:

◆ millisInSystemRange()

static bool millisInSystemRange	(	qint64	millis,
		qint64	slack = `0`
	)

inlinestatic

Tests whether system functions can handle a given time.

The range of milliseconds for which the time_t-based functions work depends somewhat on platform (see computeSystemMillisRange() for details). This function tests whether the UTC time millis milliseconds from the epoch is in the supported range.

To test a local time, pass an upper bound on the magnitude of time-zone correction potentially needed as slack: in this case the range is extended by this many milliseconds at each end (where applicable). The function then returns true precisely if millis is within this (possibly) widened range. This doesn't guarantee that the time_t functions can handle the time, so check their returns to be sure. Values for which the function returns false should be assumed unrepresentable.

Definition at line 2623 of file qdatetime.cpp.

References QLocalTime::computeSystemMillisRange().

Referenced by QDateTimePrivate::expressUtcAsLocal(), QDateTimePrivate::localNameAtMillis(), and QDateTimePrivate::localStateAtMillis().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ millisToWithinRange()

static auto millisToWithinRange ( qint64 millis )

static

Definition at line 2717 of file qdatetime.cpp.

References daysAndMillisOverflow(), QGregorianCalendar::julianFromParts(), msecsToJulianDay(), QGregorianCalendar::partsFromJulian(), R, and systemTimeYearMatching().

Referenced by QDateTimePrivate::localNameAtMillis(), and QDateTimePrivate::localStateAtMillis().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ msecsCanBeSmall()

static bool msecsCanBeSmall ( qint64 msecs )

inlinestatic

Definition at line 2843 of file qdatetime.cpp.

Referenced by QDateTime::addMSecs(), setDateTime(), and QDateTime::setMSecsSinceEpoch().

Here is the caller graph for this function:

◆ msecsToDate()

static QDate msecsToDate ( qint64 msecs )

static

Definition at line 2572 of file qdatetime.cpp.

References QDate::fromJulianDay(), and msecsToJulianDay().

Referenced by QDateTime::date().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ msecsToJulianDay()

static qint64 msecsToJulianDay ( qint64 msecs )

static

Definition at line 2567 of file qdatetime.cpp.

References QtPrivate::DateTimeConstants::JULIAN_DAY_FOR_EPOCH.

Referenced by QDateTimePrivate::expressUtcAsLocal(), millisToWithinRange(), and msecsToDate().

Here is the caller graph for this function:

◆ msecsToTime()

static QTime msecsToTime ( qint64 msecs )

static

Definition at line 2577 of file qdatetime.cpp.

References QTime::fromMSecsSinceStartOfDay().

Referenced by QDateTime::time().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ qHash() [1/3]

size_t qHash	(	const QDateTime &	key,
		size_t	seed
	)

Referenced by QHash< Key, T >::qHash(), QHash< Key, T >::qHash(), and QHash< Key, T >::qHash().

Here is the caller graph for this function:

◆ qHash() [2/3]

size_t qHash	(	QDate	key,
		size_t	seed
	)

◆ qHash() [3/3]

size_t qHash	(	QTime	key,
		size_t	seed
	)

◆ refreshSimpleDateTime()

static void refreshSimpleDateTime ( QDateTimeData & d )

static

Definition at line 2983 of file qdatetime.cpp.

References d, extractSpec(), getStatus(), QTimeZone::isUtcOrFixedOffset(), Q_ASSERT, QDateTimePrivate::ShortData, QDateTimePrivate::ValidDate, QDateTimePrivate::ValidDateTime, and QDateTimePrivate::ValidTime.

Referenced by checkValidDateTime(), QDateTimePrivate::create(), massageAdjustedDateTime(), and reviseTimeZone().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ refreshZonedDateTime()

static void refreshZonedDateTime	(	QDateTimeData &	d,
		const QTimeZone &	zone
	)

static

Definition at line 2946 of file qdatetime.cpp.

References d, extractDaylightStatus(), extractSpec(), getMSecs(), getStatus(), Qt::LocalTime, mergeDaylightStatus(), Q_ASSERT, QtPrivate::DateTimeConstants::SECS_PER_DAY, QDateTimePrivate::ShortData, state, stateAtMillis(), QTimeZone::timeSpec(), Qt::TimeZone, QDateTimePrivate::ValidDate, QDateTimePrivate::ValidDateTime, and QDateTimePrivate::ValidTime.

Referenced by checkValidDateTime(), QDateTimePrivate::create(), and reviseTimeZone().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reviseTimeZone()

static void reviseTimeZone	(	QDateTimeData &	d,
		QTimeZone	zone
	)

static

Definition at line 3015 of file qdatetime.cpp.

References d, QDateTimePrivate::DaylightMask, QTimeZone::fixedSecondsAheadOfUtc(), getStatus(), QTimeZone::isUtcOrFixedOffset(), Qt::LocalTime, mergeSpec(), Qt::OffsetFromUTC, Q_ASSERT, refreshSimpleDateTime(), refreshZonedDateTime(), QTimeZone::timeSpec(), Qt::TimeZone, Qt::UTC, and QDateTimePrivate::ValidDateTime.

Referenced by QDateTime::fromMSecsSinceEpoch(), QDateTime::fromSecsSinceEpoch(), and QDateTime::setTimeZone().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setDateTime()

static void setDateTime	(	QDateTimeData &	d,
		QDate	date,
		QTime	time
	)

static

Definition at line 3057 of file qdatetime.cpp.

References d, date, QDateTimePrivate::DaylightMask, daysAndMillisOverflow(), QTime::fromMSecsSinceStartOfDay(), QDate::isValid(), QTime::isValid(), QtPrivate::DateTimeConstants::JULIAN_DAY_FOR_EPOCH, QtPrivate::DateTimeConstants::MSECS_PER_DAY, msecsCanBeSmall(), QTime::msecsSinceStartOfDay(), Q_ASSERT, time, toInt(), QDate::toJulianDay(), QDateTimePrivate::ValidDate, QDateTimePrivate::ValidityMask, and QDateTimePrivate::ValidTime.

Referenced by QDateTimePrivate::create(), massageAdjustedDateTime(), QDateTime::setDate(), and QDateTime::setTime().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ specCanBeSmall()

static bool specCanBeSmall ( Qt::TimeSpec spec )

inlinestatic

Definition at line 2838 of file qdatetime.cpp.

References Qt::LocalTime, and Qt::UTC.

Referenced by QDateTime::setMSecsSinceEpoch().

Here is the caller graph for this function:

◆ stateAtMillis()

static QDateTimePrivate::ZoneState stateAtMillis	(	QTimeZone	zone,
		qint64	millis,
		QDateTimePrivate::DaylightStatus	dst
	)

inlinestatic

Definition at line 2826 of file qdatetime.cpp.

References QTimeZone::isValid(), QDateTimePrivate::localStateAtMillis(), Qt::LocalTime, QTimeZone::timeSpec(), and Qt::TimeZone.

Referenced by massageAdjustedDateTime(), and refreshZonedDateTime().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ systemTimeYearMatching()

static int systemTimeYearMatching ( int year )

static

Returns a year, in the system range, with the same day-of-week pattern

Returns the number of a year, in the range supported by system time_t functions, that starts and ends on the same days of the week as year. This implies it is a leap year precisely if year is. If year is before the epoch, a year early in the supported range is used; otherwise, one late in that range. For a leap year, this may be as much as 26 years years from the range's relevant end; for normal years at most a decade from the end.

This ensures that any DST rules based on, e.g., the last Sunday in a particular month will select the same date in the returned year as they would if applied to year. Of course, the zone's rules may be different in year than in the selected year, but it's hard to do better.

Definition at line 2646 of file qdatetime.cpp.

References QGregorianCalendar::leapTest(), Q_ASSERT, and QGregorianCalendar::yearStartWeekDay().

Referenced by QDateTimePrivate::expressUtcAsLocal(), and millisToWithinRange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ timeToMSecs()

static qint64 timeToMSecs	(	QDate	date,
		QTime	time
	)

static

Definition at line 2591 of file qdatetime.cpp.

References date, daysAndMillisOverflow(), QtPrivate::DateTimeConstants::JULIAN_DAY_FOR_EPOCH, QtPrivate::DateTimeConstants::MSECS_PER_DAY, QTime::msecsSinceStartOfDay(), time, and QDate::toJulianDay().

Referenced by massageAdjustedDateTime().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toEarliest()

static QDateTime toEarliest	(	QDate	day,
		const QTimeZone &	zone
	)

static

Definition at line 853 of file qdatetime.cpp.

References QTime::addSecs(), QDateTime::date(), QTimeZone::isUtcOrFixedOffset(), QDateTime::isValid(), QTime::msecsSinceStartOfDay(), Q_ASSERT, Q_UNLIKELY, time, and QDateTime::time().

Referenced by QDate::startOfDay().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toLatest()

static QDateTime toLatest	(	QDate	day,
		const QTimeZone &	zone
	)

static

Definition at line 1002 of file qdatetime.cpp.

References QTime::addSecs(), QDateTime::date(), QTimeZone::isUtcOrFixedOffset(), QDateTime::isValid(), QTime::msecsSinceStartOfDay(), Q_ASSERT, Q_UNLIKELY, time, and QDateTime::time().

Referenced by QDate::endOfDay().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toOffsetString()

static QString toOffsetString	(	Qt::DateFormat	format,
		int	offset
	)

static

Definition at line 284 of file qdatetime.cpp.

References QString::asprintf(), qAbs(), QtPrivate::DateTimeConstants::SECS_PER_HOUR, and Qt::TextDate.

Referenced by QDateTime::timeZoneAbbreviation().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ usesSameOffset()

static bool usesSameOffset	(	const QDateTimeData &	a,
		const QDateTimeData &	b
	)

inlinestatic

Definition at line 2920 of file qdatetime.cpp.

References extractSpec(), getStatus(), Qt::LocalTime, Qt::OffsetFromUTC, Q_ASSERT, Qt::TimeZone, and Qt::UTC.

Here is the call graph for this function:

Typedefs

Enumerations

Functions

Typedef Documentation

◆ QDateTimeData

◆ ShortData

Enumeration Type Documentation

◆ DaySide

Function Documentation

◆ checkValidDateTime()

◆ daysAndMillisOverflow()

◆ extractDaylightStatus()

◆ extractSpec()

◆ fixedDate() [1/2]

◆ fixedDate() [2/2]

◆ getDateTime()

◆ getMSecs()

◆ getSpec()

◆ getStatus()

◆ inDateTimeRange()

◆ massageAdjustedDateTime()

◆ mergeDaylightStatus()

◆ mergeSpec()

◆ millisInSystemRange()

◆ millisToWithinRange()

◆ msecsCanBeSmall()

◆ msecsToDate()

◆ msecsToJulianDay()

◆ msecsToTime()

◆ qHash() [1/3]

◆ qHash() [2/3]

◆ qHash() [3/3]

◆ refreshSimpleDateTime()

◆ refreshZonedDateTime()

◆ reviseTimeZone()

◆ setDateTime()

◆ specCanBeSmall()

◆ stateAtMillis()

◆ systemTimeYearMatching()

◆ timeToMSecs()

◆ toEarliest()

◆ toLatest()

◆ toOffsetString()

◆ usesSameOffset()