时间日期组件

时间日期组件用于选择日期和时间，包括日期选择器、时间选择器和日期时间选择器。

日期选择器 (DateChooser)

日期选择器用于选择日期。

基本用法

gui_config.add_argument(
    "--date",
    metavar="日期",
    help="选择日期",
    default="2024-06-14",
    widget="DateChooser",
    gooey_options={
        "dateType": "date",  # 日期类型 date/dates/week/month/year/years
        "format": "YYYY-MM-DD",  # 格式化
        "valueFormat": "YYYY-MM-DD",  # 值格式化
        "placeholder": "选择日期",  # 占位文本
        "clearable": True,  # 是否可清空
        "editable": True,  # 是否可编辑
        "size": "large",  # 大小
        "disabled": False  # 是否禁用
    }
)

属性

属性名	说明	类型	默认值
dateType	日期类型	string	'date'
format	显示格式	string	'YYYY-MM-DD'
valueFormat	值格式	string	'YYYY-MM-DD'
placeholder	占位文本	string	'选择日期'
clearable	是否可清空	boolean	true
editable	是否可编辑	boolean	true
size	日期选择器大小	string	'default'
disabled	是否禁用	boolean	false

日期类型 (dateType)

类型	说明
date	单个日期
dates	多个日期
week	周
month	月
year	年
years	多年

时间选择器 (TimeChooser)

时间选择器用于选择时间。

基本用法

gui_config.add_argument(
    "--time",
    metavar="时间",
    help="选择时间",
    default="13:14:22",
    widget="TimeChooser",
    gooey_options={
        "format": "HH:mm:ss",  # 格式化
        "valueFormat": "HH:mm:ss",  # 值格式化
        "placeholder": "选择时间",  # 占位文本
        "clearable": True,  # 是否可清空
        "editable": True,  # 是否可编辑
        "size": "large",  # 大小
        "disabled": False,  # 是否禁用
        "isRange": False,  # 是否为范围选择
        "arrowControl": True  # 是否使用箭头进行时间选择
    }
)

属性

属性名	说明	类型	默认值
format	显示格式	string	'HH:mm:ss'
valueFormat	值格式	string	'HH:mm:ss'
placeholder	占位文本	string	'选择时间'
clearable	是否可清空	boolean	true
editable	是否可编辑	boolean	true
size	时间选择器大小	string	'default'
disabled	是否禁用	boolean	false
isRange	是否为范围选择	boolean	false
arrowControl	是否使用箭头进行时间选择	boolean	true

日期时间选择器 (DateTime)

日期时间选择器用于同时选择日期和时间。

基本用法

gui_config.add_argument(
    "--datetime",
    metavar="日期时间",
    help="选择日期时间",
    default="2024-06-14 13:14:22",
    widget="DateTime",
    gooey_options={
        "dateTimeType": "datetime",  # 日期时间类型 datetime/datetimerange
        "format": "YYYY-MM-DD HH:mm:ss",  # 格式化
        "valueFormat": "YYYY-MM-DD HH:mm:ss",  # 值格式化
        "placeholder": "选择日期和时间",  # 占位文本
        "clearable": True,  # 是否可清空
        "editable": True,  # 是否可编辑
        "size": "large",  # 大小
        "disabled": False  # 是否禁用
    }
)

属性

属性名	说明	类型	默认值
dateTimeType	日期时间类型	string	'datetime'
format	显示格式	string	'YYYY-MM-DD HH:mm:ss'
valueFormat	值格式	string	'YYYY-MM-DD HH:mm:ss'
placeholder	占位文本	string	'选择日期和时间'
clearable	是否可清空	boolean	true
editable	是否可编辑	boolean	true
size	日期时间选择器大小	string	'default'
disabled	是否禁用	boolean	false

日期时间类型 (dateTimeType)

类型	说明
datetime	单个日期时间
datetimerange	日期时间范围

日期时间格式

日期时间组件支持多种格式化选项，以下是常用的格式：

日期格式

格式	描述	例子
YYYY	年	2024
MM	月	01, 12
DD	日	01, 31
YYYY-MM-DD	年-月-日	2024-06-14
MM/DD/YYYY	月/日/年	06/14/2024
DD/MM/YYYY	日/月/年	14/06/2024

时间格式

格式	描述	例子
HH	小时（24小时制）	00, 23
hh	小时（12小时制）	01, 12
mm	分钟	00, 59
ss	秒	00, 59
HH:mm:ss	时:分:秒	13:14:22
hh:mm:ss A	时:分:秒 AM/PM	01:14:22 PM

使用场景

日期选择器

适用于：

• 选择生日
• 选择预约日期
• 选择开始日期

时间选择器

适用于：

• 选择预约时间
• 选择上下班时间
• 选择提醒时间

日期时间选择器

适用于：

• 选择会议时间
• 选择截止时间
• 选择任务开始结束时间

最佳实践

1. 为日期时间选择器设置合理的默认值，如当前日期/时间
2. 使用 format 和 valueFormat 确保用户界面显示和实际值的格式一致
3. 对于特定场景，限制时间选择范围，如工作时间只能在9:00-18:00之间
4. 提供清晰的占位文本，帮助用户理解要选择的内容