The QJalaliCalendar class provides Jalali (Hijri Shamsi) calendar system implementation. More...

#include <qjalalicalendar_p.h>

Inheritance diagram for QJalaliCalendar:

Collaboration diagram for QJalaliCalendar:

Public Member Functions
QString	name () const override
	Returns the primary name of the calendar.

int	daysInMonth (int month, int year=QCalendar::Unspecified) const override
	Returns number of days in the month number month, in year year.

bool	isLeapYear (int year) const override
	Returns `true` if the specified year is a leap year for this calendar.

bool	isLunar () const override
	Returns `true` if this calendar is a lunar calendar.

bool	isLuniSolar () const override
	Returns `true` if this calendar is a lunisolar calendar.

bool	isSolar () const override
	Returns `true` if this calendar is a solar calendar.

bool	dateToJulianDay (int year, int month, int day, qint64 *jd) const override
	Computes the Julian day number corresponding to the specified year, month, and day.

QCalendar::YearMonthDay	julianDayToDate (qint64 jd) const override
	Computes the year, month, and day in this calendar for the given Julian day number jd.

Public Member Functions inherited from QCalendarBackend
virtual	~QCalendarBackend ()
	Destroys the calendar backend.

virtual QString	name () const =0
	Returns the primary name of the calendar.

QStringList	names () const
	Returns list of names this backend was registered with.

QCalendar::System	calendarSystem () const
	The calendar system of this calendar.

QCalendar::SystemId	calendarId () const

virtual int	daysInMonth (int month, int year=QCalendar::Unspecified) const =0
	Returns number of days in the month number month, in year year.

virtual int	daysInYear (int year) const
	Returns the total number of days in the year number year.

virtual int	monthsInYear (int year) const
	Returns the total number of months in the year number year.

virtual bool	isDateValid (int year, int month, int day) const
	Returns `true` if the date specified by year, month, and day is valid for this calendar; otherwise returns `false`.

virtual bool	isLeapYear (int year) const =0
	Returns `true` if the specified year is a leap year for this calendar.

virtual bool	isLunar () const =0
	Returns `true` if this calendar is a lunar calendar.

virtual bool	isLuniSolar () const =0
	Returns `true` if this calendar is a lunisolar calendar.

virtual bool	isSolar () const =0
	Returns `true` if this calendar is a solar calendar.

virtual bool	isProleptic () const
	Returns `true` if this calendar is a proleptic calendar.

virtual bool	hasYearZero () const
	Returns `true` if year number `0` is considered a valid year in this calendar.

virtual int	maximumDaysInMonth () const
	Returns the maximum number of days in a month for any year.

virtual int	minimumDaysInMonth () const
	Returns the minimum number of days in any valid month of any valid year.

virtual int	maximumMonthsInYear () const
	Returns the maximum number of months possible in any year.

virtual bool	dateToJulianDay (int year, int month, int day, qint64 *jd) const =0
	Computes the Julian day number corresponding to the specified year, month, and day.

virtual QCalendar::YearMonthDay	julianDayToDate (qint64 jd) const =0
	Computes the year, month, and day in this calendar for the given Julian day number jd.

virtual int	dayOfWeek (qint64 jd) const
	Returns the day of the week for the given Julian Day Number jd.

virtual QString	monthName (const QLocale &locale, int month, int year, QLocale::FormatType format) const
	Returns the name of the specified month in the given year for the chosen locale, using the given format to determine how complete the name is.

virtual QString	standaloneMonthName (const QLocale &locale, int month, int year, QLocale::FormatType format) const
	Returns the standalone name of the specified month in the chosen locale, using the specified format to determine how complete the name is.

virtual QString	weekDayName (const QLocale &locale, int day, QLocale::FormatType format) const
	Returns the name of the specified day of the week in the chosen locale, using the specified format to determine how complete the name is.

virtual QString	standaloneWeekDayName (const QLocale &locale, int day, QLocale::FormatType format) const
	Returns the standalone name of the specified day of the week in the chosen locale, using the specified format to determine how complete the name is.

virtual QString	dateTimeToString (QStringView format, const QDateTime &datetime, QDate dateOnly, QTime timeOnly, const QLocale &locale) const
	Returns a string representing a given date, time or date-time.

bool	isGregorian () const

QCalendar::SystemId	registerCustomBackend (const QStringList &names)
	Register this backend as a custom backend.

Static Public Member Functions
static QStringList	nameList ()

Static Public Member Functions inherited from QCalendarBackend
static QStringList	availableCalendars ()
	Returns a list of names of the available calendar systems.

Protected Member Functions
const QCalendarLocale *	localeMonthIndexData () const override

const char16_t *	localeMonthData () const override

virtual const QCalendarLocale *	localeMonthIndexData () const =0

virtual const char16_t *	localeMonthData () const =0

Detailed Description

The QJalaliCalendar class provides Jalali (Hijri Shamsi) calendar system implementation.

Since: 5.14

\inmodule QtCore

Definition at line 24 of file qjalalicalendar_p.h.

Member Function Documentation

◆ dateToJulianDay()

bool QJalaliCalendar::dateToJulianDay	(	int	year,
		int	month,
		int	day,
		qint64 *	jd
	)		const

overridevirtual

Computes the Julian day number corresponding to the specified year, month, and day.

Returns true and sets jd if there is such a date in this calendar; otherwise, returns false.

See also: QCalendar::partsFromDate(), julianDayToDate()

Implements QCalendarBackend.

Definition at line 118 of file qjalalicalendar.cpp.

References cycleYears, daysInMonth(), firstDayOfYear(), i, QCalendarBackend::isDateValid(), and Q_ASSERT.

Here is the call graph for this function:

◆ daysInMonth()

int QJalaliCalendar::daysInMonth	(	int	month,
		int	year = `QCalendar::Unspecified`
	)		const

overridevirtual

Returns number of days in the month number month, in year year.

An implementation should return 0 if the given year had no such month. If year is QCalendar::Unspecified, return the usual number of days for the month, in those years that include it.

Calendars with intercallary days may represent these as extra days of the preceding month, or as short months separate from the usual ones. In the former case, daysInMonth(month, year) should be the number of ordinary days in the month, although {isDateValid(year, month, day)} might return true for some larger values of day.

See also: daysInYear(), monthsInYear(), minimumDaysInMonth(), maximumDaysInMonth()

Implements QCalendarBackend.

Definition at line 156 of file qjalalicalendar.cpp.

References isLeapYear().

Referenced by dateToJulianDay(), and julianDayToDate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isLeapYear()

bool QJalaliCalendar::isLeapYear ( int year ) const

overridevirtual

Returns true if the specified year is a leap year for this calendar.

See also: daysInYear(), isDateValid()

Implements QCalendarBackend.

Definition at line 94 of file qjalalicalendar.cpp.

References QCalendar::Unspecified.

Referenced by daysInMonth().

Here is the caller graph for this function:

◆ isLunar()

bool QJalaliCalendar::isLunar ( ) const

overridevirtual

Returns true if this calendar is a lunar calendar.

Otherwise returns false.

A lunar calendar is a calendar based upon the monthly cycles of the Moon's phases (synodic months). This contrasts with solar calendars, whose annual cycles are based only upon the solar year.

See also: isLuniSolar(), isSolar(), isProleptic()

Implements QCalendarBackend.

Definition at line 103 of file qjalalicalendar.cpp.

◆ isLuniSolar()

bool QJalaliCalendar::isLuniSolar ( ) const

overridevirtual

Returns true if this calendar is a lunisolar calendar.

Otherwise returns false.

A lunisolar calendar is a calendar whose date indicates both the moon phase and the time of the solar year.

See also: isLunar(), isSolar(), isProleptic()

Implements QCalendarBackend.

Definition at line 108 of file qjalalicalendar.cpp.

◆ isSolar()

bool QJalaliCalendar::isSolar ( ) const

overridevirtual

Returns true if this calendar is a solar calendar.

Otherwise returns false.

A solar calendar is a calendar whose dates indicate the season or almost equivalently the apparent position of the sun relative to the fixed stars. The Gregorian calendar, widely accepted as standard in the world, is an example of solar calendar.

See also: isLuniSolar(), isLunar(), isProleptic()

Implements QCalendarBackend.

Definition at line 113 of file qjalalicalendar.cpp.

◆ julianDayToDate()

QCalendar::YearMonthDay QJalaliCalendar::julianDayToDate ( qint64 jd ) const

overridevirtual

Computes the year, month, and day in this calendar for the given Julian day number jd.

If the given day falls outside this calendar's scope (e.g. before the start-date of a non-proleptic calendar), the returned structure's isValid() is false; otherwise, its year, month, and day fields provide this calendar's description of the date.