M5Calendar

M5Calendar 是一个可在用户界面中创建日历的控件，可用于显示并选择日期。

UiFlow2 示例

事件日历

在 UiFlow2 中打开 calendar_core2_example.m5f2 项目。

本示例创建了一个日历，当日期更改时会触发事件。

UiFlow2 代码块：

示例输出：

None

MicroPython 示例

事件日历

本示例创建了一个日历，当日期更改时会触发事件。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
import m5ui
import lvgl as lv


page0 = None
calendar0 = None


year = None
month = None
day = None


def calendar0_value_changed_event(date):
    global page0, calendar0, year, month, day
    year = date.year
    month = date.month
    day = date.day
    calendar0.set_today_date(year, month, day)
    print((str("Today is:") + str((str(year) + str((str(month) + str(day)))))))


def calendar0_event_handler(event_struct):
    global page0, calendar0, year, month, day
    event = event_struct.code
    if event == lv.EVENT.VALUE_CHANGED:
        date = lv.calendar_date_t()
        if calendar0.get_pressed_date(date) == lv.RESULT.OK:
            calendar0_value_changed_event(date)
    return


def setup():
    global page0, calendar0, year, month, day

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    calendar0 = m5ui.M5Calendar(
        x=0,
        y=0,
        w=320,
        h=240,
        style="arrow",
        today_date=[2025, 8, 7],
        show_month=[2025, 8],
        parent=page0,
    )

    calendar0.add_event_cb(calendar0_event_handler, lv.EVENT.ALL, None)

    page0.screen_load()


def loop():
    global page0, calendar0, year, month, day
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            m5ui.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

API参考

M5Calendar

class m5ui.calendar.M5Calendar(*args, **kwargs)

基类：calendar

创建一个日历对象。

参数:

x (int) – 日历的 x 坐标。
y (int) – 日历的 y 坐标。
w (int) – 日历的宽度。
h (int) – 日历的高度。
style (str) – 日历的样式，可为 “arrow”、”dropdown” 或 None。
today_date (list) – 要高亮显示为今天的日期，格式为 [year, month, day]。
show_month (list) – 要显示的月份，格式为 [year, month]。
parent (lv.obj) – 要将日历附加到的父对象；若未指定，则附加到默认屏幕。

MicroPython 代码块：

from m5ui import M5Calendar
import lvgl as lv

m5ui.init()
calendar_0 = M5Calendar(x=0, y=0, w=200, h=200, style=None, today_date=[2024, 1, 1], show_month=[2024, 1], parent=page0)

set_month_shown(year, month)

设置日历显示的年份和月份。

参数:

year (int) – 要显示的年份。
month (int) – 要显示的月份。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_month_shown(2023, 3)

set_pos(x, y)

设置日历的位置。

参数:

x (int) – 日历的 x 坐标。
y (int) – 日历的 y 坐标。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_pos(100, 100)

set_x(x)

设置日历的 x 坐标。

参数:: x (int) – 日历的 x 坐标。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_x(100)

set_y(y)

设置日历的 y 坐标。

参数:: y (int) – 日历的 y 坐标。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_y(100)

set_size(width, height)

设置日历的尺寸。

参数:

width (int) – 日历的宽度。
height (int) – 日历的高度。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_size(100, 50)

align_to(obj, align, x, y)

将日历对齐到另一个对象。

参数:

obj (lv.obj) – 要对齐到的对象。
align (int) – 对齐类型。
x (int) – 相对于对齐对象的 x 偏移量。
y (int) – 相对于对齐对象的 y 偏移量。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.align_to(page_0, lv.ALIGN.CENTER, 0, 0)

add_event_cb(handler, event, user_data)

为日历添加事件回调。当指定事件发生时，将调用该回调函数。

参数:

handler (function) – 要调用的回调函数。
event (int) – 要监听的事件。
user_data (Any) – 可选用户数据，将传递给回调函数。

UiFlow2 代码块：

MicroPython 代码块：

def calendar_event_handler(event_struct):
    if event_struct.get_code() == lv.EVENT.VALUE_CHANGED:
        date = lv.calendar_date_t()
        if calendar_0.get_pressed_date(date) == lv.RESULT.OK:
            calendar_0.set_today_date(date.year, date.month, date.day)
            print("Clicked date: %02d.%02d.%02d" % (date.year, date.month, date.day))

calendar_0.add_event_cb(calendar_event_handler, lv.EVENT.ALL, None)

set_calendar_style(style)

设置日历标题的样式。

参数:: style (str) – 日历标题的样式，可为 “arrow”、”dropdown” 或 None。

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_calendar_style("arrow")
calendar_0.set_calendar_style("dropdown")
calendar_0.set_calendar_style(None)

set_highlighted_dates(dates)

设置日历中的高亮日期。

参数:: dates (list) – 要高亮显示的日期列表，格式为 [year, month, day, year, month, day, …]

UiFlow2 代码块：

MicroPython 代码块：

calendar_0.set_highlighted_dates([2024, 1, 1, 2024, 1, 2, 2024, 1, 3])