QCalendar ¶

概要 ¶

详细描述 ¶

A QCalendar object maps a year, month, and day-number to a specific day (ultimately identified by its Julian day number), using the rules of a particular system.

默认 QCalendar() is a proleptic Gregorian calendar, which has no year zero. Other calendars may be supported by enabling suitable features or loading plugins. Calendars supported as features can be constructed by passing the 系统 enumeration to the constructor. All supported calendars may be constructed by name, once they have been constructed. (Thus plugins instantiate their calendar backend to register it.) Built-in backends, accessible via 系统 , are also always available by name.

A QCalendar value is immutable.

另请参阅

QDate QDateTime

class QCalendar ¶

QCalendar(system)

参数

system – 系统

PySide2.QtCore.QCalendar. 系统 ¶

This enumerated type is used to specify a choice of calendar system.

常量	描述
QCalendar.System.Gregorian	The default calendar, used internationally.
QCalendar.System.Julian	An ancient Roman calendar with too few leap years.
QCalendar.System.Milankovic	A revised Julian calendar used by some Orthodox churches.
QCalendar.System.Jalali	The Solar Hijri calendar (also called Persian).
QCalendar.System.IslamicCivil	The (tabular) Islamic Civil calendar.

另请参阅

QCalendar

static PySide2.QtCore.QCalendar. availableCalendars ( ) ¶

返回类型

字符串列表

Returns a list of names of the available calendar systems.

These may be supplied by plugins or other code linked into an application, in addition to the ones provided by Qt, some of which are controlled by features.

PySide2.QtCore.QCalendar. dateFromParts ( parts ) ¶

参数

parts – YearMonthDay

返回类型

QDate

PySide2.QtCore.QCalendar. dateFromParts ( year , month , day ) ¶

参数

• year – int

• month – int

• day – int

返回类型

QDate

PySide2.QtCore.QCalendar. dayOfWeek ( date ) ¶

参数

date – QDate

返回类型

int

Returns the day of the week number for the given date .

Returns zero if the calendar is unable to represent the indicated date. Returns 1 for Monday through 7 for Sunday. Calendars with intercallary days may use other numbers to represent these.

另请参阅

partsFromDate() DayOfWeek

PySide2.QtCore.QCalendar. daysInMonth ( month [ , year=Unspecified ] ) ¶

参数

• month – int

• year – int

返回类型

int

Returns the number of days in the given month 为给定 year .

Months are numbered consecutively, starting with 1 for the first month of each year. If year is Unspecified (its default, if not passed), the month’s length in a normal year is returned.

另请参阅

maximumDaysInMonth() minimumDaysInMonth()

PySide2.QtCore.QCalendar. daysInYear ( year ) ¶

参数

year – int

返回类型

int

Returns the number of days in the given year .

Handling of Unspecified as year is undefined.

PySide2.QtCore.QCalendar. hasYearZero ( ) ¶

返回类型

bool

返回 true if this calendar has a year zero.

A calendar may represent years from its first year onwards but provide no way to describe years before its first; such a calendar has no year zero and is not proleptic.

A calendar which represents years before its first may number these years simply by following the usual integer counting, so that the year before the first is year zero, with negative-numbered years preceding this; such a calendar is proleptic and has a year zero. A calendar might also have a year zero (for example, the year of some great event, with subsequent years being the first year after that event, the second year after, and so on) without describing years before its year zero. Such a calendar would have a year zero without being proleptic.

Some calendars, however, represent years before their first by an alternate numbering; for example, the proleptic Gregorian calendar’s first year is 1 CE and the year before it is 1 BCE, preceded by 2 BCE and so on. In this case, we use negative year numbers for this alternate numbering, with year -1 as the year before year 1, year -2 as the year before year -1 and so on. Such a calendar is proleptic but has no year zero.

另请参阅

isProleptic()

PySide2.QtCore.QCalendar. isDateValid ( year , month , day ) ¶

参数

• year – int

• month – int

• day – int

返回类型

bool

返回 true precisely if the given year , month ，和 day specify a valid date in this calendar.

Usually this means 1 <= month <= monthsInYear (year) and 1 <= day <= daysInMonth (month, year). However, calendars with intercallary days or months may complicate that.

PySide2.QtCore.QCalendar. isGregorian ( ) ¶

返回类型

bool

返回 true if this calendar object is the Gregorian calendar object used as default calendar by other Qt APIs, e.g. in QDate .

PySide2.QtCore.QCalendar. isLeapYear ( year ) ¶

参数

year – int

返回类型

bool

返回 true 若给定 year is a leap year.

Since the year is not a whole number of days long, some years are longer than others. The difference may be a whole month or just a single day; the details vary between calendars.

另请参阅

isDateValid()

PySide2.QtCore.QCalendar. isLunar ( ) ¶

返回类型

bool

返回 true if this calendar is a lunar calendar.

A lunar calendar is one based primarily on the phases of the moon.

PySide2.QtCore.QCalendar. isLuniSolar ( ) ¶

返回类型

bool

返回 true if this calendar is luni-solar.

A luni-solar calendar expresses the phases of the moon but adapts itself to also keep track of the Sun’s varying position in the sky, relative to the fixed stars.

PySide2.QtCore.QCalendar. isProleptic ( ) ¶

返回类型

bool

返回 true if this calendar is proleptic.

A proleptic calendar is able to describe years arbitrarily long before its first. These are represented by negative year numbers and possibly by a year zero.

另请参阅

hasYearZero()

PySide2.QtCore.QCalendar. isSolar ( ) ¶

返回类型

bool

返回 true if this calendar is solar.

A solar calendar is based primarily on the Sun’s varying position in the sky, relative to the fixed stars.

PySide2.QtCore.QCalendar. isValid ( ) ¶

返回类型

bool

Returns true if this is a valid calendar object.

Constructing a calendar with an unrecognised calendar name may result in an invalid object. Use this method to check after creating a calendar by name.

PySide2.QtCore.QCalendar. maximumDaysInMonth ( ) ¶

返回类型

int

Returns the number of days in the longest month in the calendar, in any year.

另请参阅

daysInMonth() minimumDaysInMonth()

PySide2.QtCore.QCalendar. maximumMonthsInYear ( ) ¶

返回类型

int

Returns the largest number of months that any year may contain.

另请参阅

monthName() standaloneMonthName() monthsInYear()

PySide2.QtCore.QCalendar. minimumDaysInMonth ( ) ¶

返回类型

int

Returns the number of days in the shortest month in the calendar, in any year.

另请参阅

daysInMonth() maximumDaysInMonth()

PySide2.QtCore.QCalendar. monthName ( locale , month [ , year=Unspecified [ , format=QLocale.LongFormat ] ] ) ¶

参数

• locale – QLocale

• month – int

• year – int

• format – FormatType

返回类型

unicode

Returns a suitably localised name for a month.

The month is indicated by a number, with month = 1 meaning the first month of the year and subsequent months numbered accordingly. Returns an empty string if the month number is unrecognized.

year may be Unspecified, in which case the mapping from numbers to names for a typical year’s months should be used. Some calendars have leap months that aren’t always at the end of the year; their mapping of month numbers to names may then depend on the placement of a leap month. Thus the year should normally be specified, if known.

The name is returned in the form that would normally be used in a full date, in the specified locale ; the format determines how fully it shall be expressed (i.e. to what extent it is abbreviated).

另请参阅

standaloneMonthName() maximumMonthsInYear() dateTimeToString()

PySide2.QtCore.QCalendar. monthsInYear ( year ) ¶

参数

year – int

返回类型

int

Returns the number of months in the given year .

若 year is Unspecified , returns the maximum number of months in a year.

另请参阅

maximumMonthsInYear()

PySide2.QtCore.QCalendar. name ( ) ¶

返回类型

unicode

The primary name of this calendar.

PySide2.QtCore.QCalendar. partsFromDate ( date ) ¶

参数

date – QDate

返回类型

YearMonthDay

转换 QDate to a year, month, and day of the month.

The returned structure’s isValid() shall be false if the calendar is unable to represent the given date . Otherwise its year, month, and day members record the so-named parts of its representation.

另请参阅

dateFromParts() isProleptic() hasYearZero()

PySide2.QtCore.QCalendar. standaloneMonthName ( locale , month [ , year=Unspecified [ , format=QLocale.LongFormat ] ] ) ¶

参数

• locale – QLocale

• month – int

• year – int

• format – FormatType

返回类型

unicode

Returns a suitably localised standalone name for a month.

The month is indicated by a number, with month = 1 meaning the first month of the year and subsequent months numbered accordingly. Returns an empty string if the month number is unrecognized.

year may be Unspecified, in which case the mapping from numbers to names for a typical year’s months should be used. Some calendars have leap months that aren’t always at the end of the year; their mapping of month numbers to names may then depend on the placement of a leap month. Thus the year should normally be specified, if known.

The name is returned in the form that would be used in isolation in the specified locale ; the format determines how fully it shall be expressed (i.e. to what extent it is abbreviated).

另请参阅

monthName() maximumMonthsInYear() dateTimeToString()

PySide2.QtCore.QCalendar. standaloneWeekDayName ( locale , day [ , format=QLocale.LongFormat ] ) ¶

参数

• locale – QLocale

• day – int

• format – FormatType

返回类型

unicode

Returns a suitably localised standalone name for a day of the week.

The days of the week are numbered from 1 for Monday through 7 for Sunday. Some calendars may support higher numbers for other days (e.g. intercallary days, that are not part of any week). Returns an empty string if the day number is unrecognized.

The name is returned in the form that would be used in isolation (for example as a column heading in a calendar’s tabular display of a month with successive weeks as rows) in the specified locale ; the format determines how fully it shall be expressed (i.e. to what extent it is abbreviated).

另请参阅

weekDayName() dayOfWeek()

PySide2.QtCore.QCalendar. weekDayName ( locale , day [ , format=QLocale.LongFormat ] ) ¶

参数

• locale – QLocale

• day – int

• format – FormatType

返回类型

unicode

Returns a suitably localised name for a day of the week.

The days of the week are numbered from 1 for Monday through 7 for Sunday. Some calendars may support higher numbers for other days (e.g. intercallary days, that are not part of any week). Returns an empty string if the day number is unrecognized.

The name is returned in the form that would normally be used in a full date, in the specified locale ; the format determines how fully it shall be expressed (i.e. to what extent it is abbreviated).

另请参阅

standaloneWeekDayName() dayOfWeek()