跳到内容
+

日期时间选择器

日期时间选择器组件允许用户选择日期和时间。

基本用法

Enter 开始编辑

组件构成

该组件使用 DateTimeField 进行键盘编辑,DateCalendar 进行日期视图编辑,DigitalClock 进行桌面视图编辑,以及 TimeClock 进行移动时间视图编辑构建。

查看其文档页面以获取更多信息

您可以在专门的 API 页面 上查看组合组件的可用 props。某些 DateTimeField props 在 Picker 组件上不可用,您可以使用 slotProps.field 将它们传递给字段。

非受控 vs. 受控值

组件的值可以是受控的或非受控的。

Enter 开始编辑

可用组件

该组件有四种变体

  • DesktopDateTimePicker 组件最适合鼠标设备和大屏幕。它在弹出窗口中渲染视图,并允许直接在字段内编辑值。

  • MobileDateTimePicker 组件最适合触摸设备和小屏幕。它在模态框中渲染视图,并且不允许直接在字段内编辑值。

  • DateTimePicker 组件根据其运行的设备渲染 DesktopDateTimePickerMobileDateTimePicker

  • StaticDateTimePicker 组件在没有弹出窗口/模态框和字段的情况下渲染。

桌面变体

移动变体

响应式变体

静态变体

选择日期和时间
:
Enter 开始编辑

默认情况下,如果媒体查询 @media (pointer: fine) 匹配,则 DateTimePicker 组件会渲染桌面版本。可以使用 desktopModeMediaQuery prop 自定义此行为。

表单 props

组件可以被禁用或只读。

Enter 开始编辑

视图

该组件支持六种视图:daymonthyearhoursminutesseconds

默认情况下,启用 yeardayhoursminutes 视图。使用 views prop 更改此行为

"year"、"month"、"day"、"hours"、"minutes" 和 "seconds"

"day"、"hours"

"year"、"day"、"hours"、"minutes"、"seconds"

Enter 开始编辑

默认情况下,组件在挂载时渲染 day 视图。使用 openTo prop 更改此行为

Enter 开始编辑

横向方向

默认情况下,日期时间选择器组件根据 window.orientation 值自动设置方向。

您可以使用 orientation prop 强制指定方向。

选择日期和时间
:
Enter 开始编辑

选择时间视图渲染器

您可以使用 viewRenderers prop 更改用于渲染视图的视图。您可能对使用 时间时钟 而不是 数字时钟 感兴趣,或者完全删除时间视图渲染,而仅使用字段输入时间。

Enter 开始编辑

本地化

有关更多详细信息,请参阅日期格式和本地化已翻译组件文档页面。

验证

有关更多详细信息,请参阅验证文档页面。

API

请参阅下面的文档,以获取此处提及的组件的所有可用 props 和类的完整参考。