12. 日历控件

一、日历类

  日历类 QCalendar 主要用于确定纪年法，当前通用的是公历纪年法，这也是默认值。QCalendar 类在 PySide6.QtCore 模块中。

  我们可以在终端中使用 pip 安装 pyside6 模块。

pip install pyside6

  用 QCalendar 类创建日历实例的方法如下：

QCalendar()
QCalendar(name:str)
QCalendar(system:QCalendar.System)

  其中，name 可以取值如下：

'Julian'
'Jalali'
'Islamic Civil'
'Milankovic'
'Gregorian'
'islamicc'
'Islamic'
'gregory'
'Persian'
'islamic-civil'

  system 是 QCalendar.System 的枚举值，可取值如下：

QCalendar.System.Gregorian        # 默认值
QCalendar.System.Julian
QCalendar.System.Milankovic
QCalendar.System.Jalali
QCalendar.System.IslamicCivil

  日历类的常用方法如下：

# 实例方法
name() -> str                                                       # 获取当前使用的日历纪年法
dateFromParts(year:int, month:int, day:int) -> datetime             # 根据年月日创建日期
dayOfWeek(date:QDate) -> int                                        # 获取指定日期在一周的第几天
daysInMonth(month:int, year:int=QCalendar.Unspecified) -> int       # 获取指定年指定月份的总天数
daysInYear(year:int) -> int                                         # 获取指定年份的总天数
isDateValid(year:int, month:int, day:int) -> bool                   # 检查指定年月日是否有效
isGregorian() -> bool                                               # 检查是否是公历
isLeapYear(year) -> bool                                            # 检查是否是闰年
isLunar() -> bool                                                   # 检查是否是农历
isSolar() -> bool                                                   # 检查是否是阳历
minimumDaysInMonth() -> int                                         # 获取月中最小天数
maximumDaysInMonth() -> int                                         # 获取月中最大天数
maximumMonthsInYear() -> int                                        # 获取年中最大月数

# 静态方法
availableCalendars() -> List[str]                                   # 获取可用的日历纪年法

二、日历控件

  日历控件 QCalendarWidget 主要用于显示日期、星期和周数。可以设置日历控件显示的最小日期和最大日期，还可以设置日历表头的样式。

  用 QCalendarWidget 类创建实例对象的方法如下：

QCalendarWidget(parent:QWidget=None)

  其中 parent 是 窗口 或者 容器类控件 。

  CalendarWidget 控件常用的方法及其说明如下：

# 实例方法
selectedDate() -> QDate                                                                 # 获取选中的日期

setCalendar(calendar:QCalendar) -> None                                                 # 设置日历
calendar() -> QCalendar                                                                 # 获取日历

setDateTextFormat(date:QDate, format:QTextFormat) -> None                               # 设置日期的显示格式
dateTextFormat() -> QTextFormat                                                         # 获取日期的显示格式

setFirstDayOfWeek(dayOfWeek:Qt.DayOfWeek) -> None                                       # 设置一周的第一天显示的是哪一天
firstDayOfWeek() -> Qt.DayOfWeek                                                        # 获取一周的第一天显示的是哪一天

isGridVisible() -> bool                                                                 # 是否显示日历网格
isNavigationBarVisible() -> bool                                                        # 是否显示导航栏

setHorizontalHeaderFormat(format:QCalendarWidget.HorizontalHeaderFormat)  -> None       # 设置水平表头的格式
setVerticalHeaderFormat(format:QCalendarWidget.VerticalHeaderFormat) -> None            # 设置垂直表头的格式

setMinimumDate(date:QDate) -> None                                                      # 设置日历控件可选的最小日期
minimumDate() -> QDate                                                                  # 获取日历控件可选的最小日期
setMaximumDate(date:QDate) -> None                                                      # 设置日历控件可选的最大日期
maximumDate() -> QDate                                                                  # 获取日历控件可选的最大日期

setSelectionMode(mode:QCalendarWidget.SelectionMode) -> None                            # 设置选择模式

monthShown() -> int                                                                     # 获取显示的月份
yearShown() -> int                                                                      # 获取显示的年份

# 槽函数
setSelectedDate(date:QDate) -> None                                                     # 设置选中的日期
setCurrentPage(year:int, month:int) -> None                                             # 设置当前显示的年和月
setGridVisible(show:bool) -> None                                                       # 设置日历网格是否可见
setDateRange(min:QDate, max:QDate) -> None                                              # 设置日历控件可选的日期范围
setNavigationBarVisible(visible:bool) -> None                                           # 设置导航栏是否可见
showSelectedDate() -> None                                                              # 显示选中的日期
showPreviousMonth() -> None                                                             # 显示上一个月的日历
showNextMonth() -> None                                                                 # 显示下一个月的日历
showPreviousYear() -> None                                                              # 显示上一年的日历
showNextYear() -> None                                                                  # 显示下一年的日历
showToday() -> None                                                                     # 显示当前日期的日历

  用 setSelectionMode(QCalendarWidget.SelectionMode) 方法可以设置选择日期的模式，其中参数可选值如下：

QCalendarWidget.SelectionMode.NoSelection        # 不允许选择
QCalendarWidget.SelectionMode.SingleSelection    # 单选

  用 setVerticalHeaderFormat(QCalendarWidget.VerticalHeaderFormat) 方法可以设置竖直表头的格式，其中参数QCalendarWidget.VerticalHeaderFormat可以取值如下：

QCalendarWidget.VerticalHeaderFormat.ISOWeekNumbers        # 标准格式的周数
QCalendarWidget.VerticalHeaderFormat.NoVerticalHeader      # 隐藏周数

  用 setHorizontalHeaderFormat(QCalendarWidget.HorizontalHeaderFormat) 方法可以设置水平表头的格式，其中参数QCalendarWidget.HorizontalHeaderFormat可以取值如下：

QCalendarWidget.HorizontalHeaderFormat.SingleLetterDayNames    # 用单个字母代替全拼，如M代表Monday
QCalendarWidget.HorizontalHeaderFormat.ShortDayNames           # 用缩写代替全拼，如Mon代表Monday
QCalendarWidget.HorizontalHeaderFormat.LongDayNames            # 全名
QCalendarWidget.HorizontalHeaderFormat.NoHorizontalHeader      # 隐藏表头

  用 setFirstDayOfWeek(Qt.DayOfWeek) 方法可以设置一周中哪天排在最前面，其中参数 Qt.DayOfWeek 可以取Qt.Monday ~ Qt.Sunday。

  CalendarWidget 控件常用的信号及其说明如下：

activated(date:QDate)                       # 日期激活（双击）时发射信号
clicked(date:QDate)                         # 日期被点击时发送信号
currentPageChanged(year:int, month:int)     # 月视图被切换时发射信号
selectionChanged()                          # 选择日期发生改变发射信号

import sys

from PySide6.QtWidgets import QApplication, QWidget
from PySide6.QtWidgets import QCalendarWidget
from PySide6.QtCore import QDate
from PySide6.QtGui import Qt

class MyWidget(QWidget):
    def __init__(self):
        # 1.调用父类Qwidget类的__init__()方法
        super().__init__()
        # 2.调用setupUi()方法初始化页面
        self.setup_ui()

    def setup_ui(self):
        # 1.设置窗口对象大小
        self.resize(700, 500)

        # 2.创建日历控件
        calendarWidget = QCalendarWidget(self)
        calendarWidget.resize(400, 400)

        # 3.设置最小日期
        calendarWidget.setMinimumDate(QDate(2000, 1, 1))

        # 4.设置最大日期
        calendarWidget.setMaximumDate(QDate(2999, 12, 31))

        # 5.设置一周的第一天
        calendarWidget.setFirstDayOfWeek(Qt.DayOfWeek.Sunday)

        # 6.设置是否显示网格
        calendarWidget.setGridVisible(True)

        # 7.设置选择模式
        calendarWidget.setSelectionMode(QCalendarWidget.SelectionMode.SingleSelection)

        # 8.设置水平头部模式
        calendarWidget.setHorizontalHeaderFormat(QCalendarWidget.HorizontalHeaderFormat.LongDayNames)

        # 9.设置对齐方式
        calendarWidget.setVerticalHeaderFormat(QCalendarWidget.VerticalHeaderFormat.NoVerticalHeader)

        # 10.设置是否显示导航栏
        calendarWidget.setNavigationBarVisible(True)

        # 11.设置是否可以编辑日期
        calendarWidget.setDateEditEnabled(True)

        # 12.设置编辑日期的最大间隔
        calendarWidget.setDateEditAcceptDelay(30)

        # 13.获取选中的日期
        print(calendarWidget.selectedDate())

        # 14.定义信号与槽的连接
        calendarWidget.clicked.connect(self.clicked)
        calendarWidget.activated.connect(self.activated)
        calendarWidget.selectionChanged.connect(self.selectionChanged)
        calendarWidget.currentPageChanged.connect(self.currentPageChanged)

    def clicked(self, date):
        print("你选中的日期为：", date)

    def activated(self, date):
        print("你激活的日期为：", date)

    def selectionChanged(self):
        print("选中的日期发生改变了，")

    def currentPageChanged(self, year, money):
        print(f"你选中的日期在为【{year}】-【{money}】月")

if __name__ == "__main__":
    # 1.创建一个QApplication类的实例
    app = QApplication(sys.argv)
    # 2.创建一个窗口
    window = MyWidget()
    # 3.展示窗口
    window.show()
    # 4.进入程序的主循环并通过exit()函数确保主循环安全结束
    sys.exit(app.exec())