PyQt5 QDateEdit – 设置校正模式

首先，PyQt5是Python语言下的图形化界面编程工具包，而QDateEdit则是PyQt5的一个日期时间编辑器。在使用QDateEdit时，校正模式是一个重要的概念，它决定了该控件中输入的日期是否被自动校正。下面，我们将详细介绍QDateEdit的校正模式及如何设置。

校正模式

QDateEdit控件包含两种校正模式：自动校正和手动校正。

自动校正

在自动校正模式下，QDateEdit控件会自动根据用户输入进行校正。比如：

• 用户输入2019年2月31号，则控件会自动将日期修改为2019年3月3号；
• 用户输入2019年2月29号，但实际该年份不是闰年，则控件会自动将日期修改为2019年3月1号。

该模式可以确保用户输入的日期合理，并且可以让程序代码更简洁。

手动校正

在手动校正模式下，QDateEdit控件不会自动根据用户输入进行校正，而是在用户提交时再进行校正。比如：

• 用户输入2019年2月31号，则控件不会自动校正，并在用户提交后显示错误提示；
• 用户输入2019年2月29号，但实际该年份不是闰年，则控件不会自动校正，并在用户提交后显示错误提示。

该模式可以让用户自主选择输入日期，并优化用户体验。但相应地，程序代码需要手动进行校正。

设置校正模式

在PyQt5中，可以通过setCalendarPopup函数设置QDateEdit控件的校正模式。其语法如下：

setCalendarPopup(bool)

其中，bool参数为布尔值，True表示开启手动校正模式，False表示开启自动校正模式。默认值为False。

下面，我们通过两条示例说明如何使用setCalendarPopup函数。

示例一：手动校正模式

在该示例中，我们使用setCalendarPopup函数将QDateEdit控件设置成手动校正模式。如果用户输入的日期不合法，则会在提交时提示。

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QDateEdit, QLabel, QPushButton


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        lbl = QLabel(self)
        lbl.setText('请选择日期：')
        lbl.move(30, 20)

        qde = QDateEdit(self)
        qde.setCalendarPopup(True)
        qde.setGeometry(30, 50, 140, 22)

        btn = QPushButton('提交', self)
        btn.setGeometry(30, 90, 60, 22)
        btn.clicked.connect(lambda: self.submit(qde))

        self.setGeometry(300, 300, 210, 140)
        self.setWindowTitle('QDateEdit校正模式演示')
        self.show()

    def submit(self, qde):
        if not qde.date().isValid():
            print('输入日期不合法！')
        else:
            print(qde.date().toString('yyyy-M-d'))

if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在该示例中，我们使用QLabel、QDateEdit和QPushButton三个控件。其中，QLabel用于显示提示信息，QPushButton用于提交日期值，QDateEdit用于编辑日期。我们对QDateEdit控件调用setCalendarPopup(True)函数，将其校正模式设置为手动校正模式。

在程序运行时，当我们选择一个不合法的日期时，如2月31号，点击提交按钮，就会提示“输入日期不合法！”，而选择合法日期时，如2019年2月28号，点击提交按钮，就会输出“2019-2-28”。这说明该程序已经正确启用了手动校正模式。

示例二：自动校正模式

在该示例中，我们使用setCalendarPopup函数将QDateEdit控件设置成自动校正模式。

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QDateEdit, QLabel, QPushButton


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        lbl = QLabel(self)
        lbl.setText('请选择日期：')
        lbl.move(30, 20)

        qde = QDateEdit(self)
        qde.setCalendarPopup(False)
        qde.setGeometry(30, 50, 140, 22)

        btn = QPushButton('提交', self)
        btn.setGeometry(30, 90, 60, 22)
        btn.clicked.connect(lambda: print(qde.date().toString('yyyy-M-d')))

        self.setGeometry(300, 300, 210, 140)
        self.setWindowTitle('QDateEdit校正模式演示')
        self.show()

if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在该示例中，我们同样使用QLabel、QDateEdit和QPushButton三个控件。其中，QLabel用于显示提示信息，QPushButton用于提交日期值，QDateEdit用于编辑日期。我们对QDateEdit控件调用setCalendarPopup(False)函数，将其校正模式设置为自动校正模式。

在程序运行时，当我们选择一个不合法的日期时，如2月31号，程序不会自动校正，而是将光标停留在当前日期框中。而选择合法日期时，如2019年2月28号，点击提交按钮，就会输出“2019-2-28”。这说明该程序已经正确启用了自动校正模式。

通过以上两条示例，相信大家已经能够对QDateEdit控件的校正模式有了详细的了解和掌握。