- Material UI 简介
- Material UI 组件库详解
- 使用 Material UI 的 Autocomplete 组件详解
- 使用 Material UI 的 Button 组件详解
- 使用 Material UI 创建按钮组(Button Group)的详细指南
- 使用 Material UI 创建复选框(Checkbox)的详细指南
- Material UI 中 Floating Action Button 的使用详解
- Material UI 中 Radio Group 的使用详解
- Material UI 中 Rating 组件的使用详解
- Material UI 中 Select 组件的使用详解
- Material UI 中 Slider 组件的使用详解
- Material UI Switch 组件使用详解
- Material UI Text Field 组件使用详解
- Material UI Transfer List 使用详解
- Material UI Toggle Button 使用详解
- Material UI Avatar 组件使用详解
- Material UI Badge 组件使用详解
- Material UI Chip 组件使用详解
- Material UI Divider 组件使用详解
- Material UI Icons 组件使用详解
- Material UI 中 Material Icons 的使用详解
- Material UI 框架中 Lists 的使用详解
- Material UI 框架中 Table 的使用详解
- Material UI 框架中 Tooltip 的使用详解
- Material UI 框架中 Typography 的使用详解
- Material UI 框架中 Alert 组件的使用详解
- Material UI 框架中 Backdrop 组件的详细使用教程
- Material UI 框架中 Dialog 组件的详细使用教程
- Material UI Progress 组件详解及示例
- Material UI 框架中的 Skeleton 组件详解
- Material UI 框架中的 Snackbar 组件详解
- Material UI 框架中的 Accordion 组件详解
- Material UI 框架中的 App Bar 组件详解
- Material UI 框架中的 Card 组件详解
- Material UI 框架中的 Paper 组件详解
- 使用 Material UI 框架中的 Bottom Navigation 组件
- 使用 Material UI 框架中的 Breadcrumbs 组件
- 使用 Material UI 框架中的 Drawer 组件
- 使用 Material UI 框架中的 Links 组件
- 使用 Material UI 框架中的 Menu 组件
- 使用 Material UI 框架中的 Pagination 组件
- 使用 Material UI 框架中的 Speed Dial 组件
- 使用 Material UI 框架中的 Stepper 组件
- 使用 Material UI 框架中的 Tabs 组件
- 使用 Material UI 框架中的 Layout Box 组件
- 使用 Material UI 框架中的 Layout Container
- 使用 Material UI 框架中的 Layout Grid
- 使用 Material UI 框架中的 Layout Grid Version 2
- 使用 Material UI 框架中的 Layout Stack
- 使用 Material UI 框架中的 Layout Image List
- 使用 Material UI 框架中的 Layout Hidden
- 使用 Material UI 框架中的 Click-Away Listener
- 使用 Material UI 框架中的 CSS Baseline
- 使用 Material UI 框架中的 Utils Modal
- 使用 Material UI 框架中的 Utils No SSR
- 使用 Material UI 框架中的 Utils Popover
- 使用 Material UI 框架中的 Utils Popper
- 使用 Material UI 框架中的 Utils Portal
- 使用 Material UI 框架中的 Utils Textarea Autosize
- 使用 Material UI 框架中的 Utils Transitions
- 使用 Material UI 框架中的 `useMediaQuery`
- 使用 Material UI 框架中的 MUI X Data Grid
- 使用 Material UI 框架中的 Data Grid - Layout
- 使用 Material UI 框架中的 Data Grid:深入探索列定义与管理
- 深入探索 Material UI 框架中的 Data Grid:行定义与管理
- 深入探索 Material UI 框架中的 Data Grid 编辑功能
- 深入探索 Material UI 框架中的 Data Grid 排序功能
- 深入探索 Material UI 框架中的 Data Grid 过滤功能
- 深入探索 Material UI 框架中的 Data Grid 分页功能
- 深入探索 Material UI 框架中的 Data Grid 行选择和单元格选择功能
- 深入探索 Material UI 框架中的 Data Grid 导出功能
- 深入探索 Material UI 框架中的 Data Grid - Copy and Paste 功能
- 深入探索 Material UI 框架中的 Data Grid - Overlays 功能
- 深入探索 Material UI 框架中的 Data Grid - Custom Slots and Subcomponents
- 深入探索 Material UI 框架中的 Data Grid - Styling 和 Styling Recipes
- 深入探索 Material UI 框架中的 Data Grid - Translated Components
- 使用 Material UI 的 Data Grid - Scrolling 功能
- 使用 Material UI 的 Data Grid - Virtualization 功能
- 使用 Material UI 的 Data Grid - 可访问性(Accessibility)功能
- 使用 Material UI 的 Data Grid - 性能(Performance)优化
- 使用 Material UI 的 Data Grid - 树形数据(Tree Data)
- 使用 Material UI 的 Data Grid - 行分组(Row Grouping)
- 使用 Material UI 的 Data Grid - 数据聚合(Aggregation)
- 使用 Material UI 的 Data Grid - 数据透视(Pivoting)
- 使用 Material UI 的 Data Grid - 服务器端数据(Server-side Data)
- 使用 Material UI 的 Data Grid - 服务器端树形数据(Server-side Tree Data)
- 使用 Material UI 的 Data Grid - 服务器端懒加载(Server-side Lazy Loading)
- 使用 Material UI 的 Data Grid - 服务器端行分组(Server-side Row Grouping)
- 使用 Material UI 的 Data Grid - 服务器端聚合(Server-side Aggregation)
- 使用 Material UI 的 Data Grid - API Object
- 使用 Material UI 的 Data Grid - 事件处理(Events)
- 使用 Material UI 的 Data Grid - State 管理
- Material UI Data Grid - 编辑功能详解与使用示例
- Material UI Data Grid - Row Grouping 使用指南与示例
- Material UI DataGrid API 使用指南
- Material UI DataGridPremium API 使用指南
- Material UI 框架 DataGridPro API 使用指南
- Material UI 框架 GridFilterForm API 使用指南
- Material UI 框架 GridFilterPanel API 使用指南
- Material UI 框架 GridApi API 使用指南
- Material UI 框架 GridCellParams API 使用指南
- Material UI 框架 GridColDef API 使用指南
- Material UI 框架 GridSingleSelectColDef API 使用指南
- Material UI 框架 GridActionsColDef API 使用指南
- Material UI 框架 GridExportStateParams API 使用指南
- Material UI 框架 GridFilterItem API 使用指南
- Material UI 框架 GridFilterModel API 使用指南
- Material UI 框架:GridToolbarQuickFilter API 使用详解
- Material UI 框架:GridApi 接口详解及其使用
- Material UI 框架:Interface `GridCellParams` API 使用详解
- Material UI 框架:Interface `GridColDef` API 使用详解
- Material UI 框架:Interface `GridSingleSelectColDef` API 使用详解
- Material UI 框架:Interface `GridActionsColDef` API 使用详解
- Material UI 框架:Interface `GridExportStateParams` API 使用详解
- Material UI 框架:`GridFilterItem` API 使用详解
- Material UI 框架:`GridFilterModel` API 使用详解
- Material UI 框架:`Interface GridFilterOperator` API 使用详解
- Material UI 框架:`GridRowClassNameParams` 接口详解及使用指南
- Material UI 框架:`GridRowParams` 接口详解及使用指南
- Material UI 框架:`GridRowSpacingParams` 接口详解及使用指南
- Material UI 框架:`GridAggregationFunction` 接口详解及使用指南
- Material UI 框架:`GridCsvExportOptions` 接口详解及使用指南
- Material UI 框架:`GridPrintExportOptions` 接口详解及使用指南
- Material UI 框架:`GridExcelExportOptions` 接口详解及使用指南
- Material UI 框架:MUI X 日期和时间选择器使用指南
- Material UI 框架:日期和时间选择器 - 入门指南
- Material UI 框架:日期和时间选择器 - 基本概念
- Material UI 框架:日期和时间选择器 - 可访问性
- Material UI 框架之 Date Picker 组件详解
- Material UI 框架之 Date Field 组件详解
- Material UI 框架之 Date Calendar 组件详解
- Material UI 框架之 Time Picker 组件详解
- Material UI 框架之 Time Field 组件详解
- Material UI 框架之 Time Clock 组件详解
- Material UI 框架之 Digital Clock 组件详解
- Material UI 框架之 DateTime Picker 组件详解
- Material UI 框架之 DateTime Field 组件详解
- Material UI 组件 Date Range Picker 使用详解
- Material UI 组件 Date Range Field 使用详解
- Material UI 组件 Date Range Calendar 使用详解
- Material UI 组件 Time Range Picker 使用详解
- Material UI 组件 Time Range Field 使用详解
- Material UI 组件 Date Time Range Picker 使用详解
- Material UI 组件 Date Time Range Field 使用详解
- 使用 Material-UI 的 Fields 组件详解
- 使用 Material-UI 的 DateCalendar 组件详解
- 使用 Material-UI 的 DateField 组件详解
- 使用 Material-UI 的 DatePicker 组件详解
- 使用 Material-UI 的 DatePickerToolbar API 详解
- 使用 Material-UI 的 DateRangeCalendar API 详解
- 使用 Material-UI 的 DateRangePicker API 详解
- 使用 Material-UI 的 DateRangePickerDay API 详解
- 使用 Material UI DateRangePickerToolbar API 详解
- 深入了解 Material UI DateTimeField API 使用
- 深入了解 Material UI DateTimePicker API 使用
Material UI 框架之 DateTime Picker 组件详解
class DateTime PickerMaterial UI 提供的 DateTime Picker
组件用于同时选择日期和时间。它可以直观显示当前日期时间,且支持定制化选项,适合用户在预约系统、倒计时等需要精确选择日期时间的场景中使用。本文将详细介绍 DateTime Picker
的使用,涵盖组件的基本用法、属性、方法及与其他组件的结合应用。
1. 基础用法
1.1 安装依赖
首先,确保已经安装了 @mui/x-date-pickers
和 date-fns
,用于日期时间格式的处理:
npm install @mui/material @mui/x-date-pickers date-fns
1.2 基础用法示例
在基础用法中,DateTimePicker
用于选择当前的日期和时间,通过 onChange
更新时间值。
import React, { useState } from 'react';
import { LocalizationProvider } from '@mui/x-date-pickers/LocalizationProvider';
import { DateTimePicker } from '@mui/x-date-pickers/DateTimePicker';
import { AdapterDateFns } from '@mui/x-date-pickers/AdapterDateFns';
export default function BasicDateTimePicker() {
const [selectedDateTime, setSelectedDateTime] = useState(new Date());
return (
<LocalizationProvider dateAdapter={AdapterDateFns}>
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
label="选择日期和时间"
/>
</LocalizationProvider>
);
}
以上代码展示了 DateTimePicker
的基本用法,通过 LocalizationProvider
包裹 DateTimePicker
组件,提供时间适配器 AdapterDateFns
。
2. 组件属性详解
2.1 value
和 onChange
value
:用于指定日期和时间的默认值,通常为Date
对象。onChange
:选择日期时间后触发的回调函数,用于更新日期时间值。
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
/>
2.2 minDateTime
和 maxDateTime
minDateTime
和maxDateTime
:用于限制用户可以选择的日期时间范围。
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
minDateTime={new Date(2024, 0, 1, 9, 0)} // 最早 2024-01-01 09:00
maxDateTime={new Date(2024, 11, 31, 18, 0)} // 最晚 2024-12-31 18:00
/>
2.3 ampm
ampm
:设定时间格式,true
为 12 小时制,false
为 24 小时制。
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
ampm={false} // 24 小时制
/>
2.4 disabled
disabled
:布尔值,用于禁用组件,防止用户交互。
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
disabled
/>
2.5 readOnly
readOnly
:将组件设置为只读模式,允许用户查看但不能更改日期时间。
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
readOnly
/>
2.6 openTo
openTo
:设置初次打开时显示的视图,day
、month
、year
和hours
可选。
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
openTo="year"
/>
3. 进阶用法
3.1 错误提示
通过 FormHelperText
显示错误信息,防止用户选择无效日期时间。例如:限制选择时间在工作日内。
import { FormHelperText } from '@mui/material';
export default function DateTimePickerWithValidation() {
const [selectedDateTime, setSelectedDateTime] = useState(new Date());
const [error, setError] = useState(false);
const handleChange = (newValue) => {
setSelectedDateTime(newValue);
setError(newValue.getHours() < 9 || newValue.getHours() > 18);
};
return (
<LocalizationProvider dateAdapter={AdapterDateFns}>
<DateTimePicker
value={selectedDateTime}
onChange={handleChange}
label="选择日期和时间"
/>
{error && <FormHelperText error>请选择工作时间(9:00-18:00)</FormHelperText>}
</LocalizationProvider>
);
}
3.2 多语言支持
通过 LocalizationProvider
的 locale
属性切换到其他语言,例如中文:
import { zhCN } from 'date-fns/locale';
export default function DateTimePickerWithLocalization() {
const [selectedDateTime, setSelectedDateTime] = useState(new Date());
return (
<LocalizationProvider dateAdapter={AdapterDateFns} locale={zhCN}>
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
label="选择日期和时间"
/>
</LocalizationProvider>
);
}
3.3 与表单组件结合
可以将 DateTimePicker
与表单组件结合,完成表单数据的提交处理:
import { Button } from '@mui/material';
export default function FormWithDateTimePicker() {
const [selectedDateTime, setSelectedDateTime] = useState(new Date());
const handleSubmit = (event) => {
event.preventDefault();
alert(`提交的时间是: ${selectedDateTime}`);
};
return (
<form onSubmit={handleSubmit}>
<LocalizationProvider dateAdapter={AdapterDateFns}>
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
label="选择日期和时间"
/>
</LocalizationProvider>
<Button type="submit" variant="contained" color="primary">
提交
</Button>
</form>
);
}
3.4 自定义外观
可以通过 sx
属性自定义组件样式,使其适应页面的整体设计风格:
<DateTimePicker
value={selectedDateTime}
onChange={(newValue) => setSelectedDateTime(newValue)}
sx={{
width: '100%',
backgroundColor: 'lightgray',
'& .MuiInputBase-input': {
color: 'blue',
},
}}
/>
3.5 Grid 布局结合使用
使用 Grid
布局将多个 DateTimePicker
组件排列在页面中,例如创建一个选择起始时间和结束时间的表单:
import Grid from '@mui/material/Grid';
export default function DateTimePickerGridExample() {
const [startDateTime, setStartDateTime] = useState(new Date());
const [endDateTime, setEndDateTime] = useState(new Date());
return (
<LocalizationProvider dateAdapter={AdapterDateFns}>
<Grid container spacing={2}>
<Grid item xs={6}>
<DateTimePicker
value={startDateTime}
onChange={(newValue) => setStartDateTime(newValue)}
label="开始时间"
/>
</Grid>
<Grid item xs={6}>
<DateTimePicker
value={endDateTime}
onChange={(newValue) => setEndDateTime(newValue)}
label="结束时间"
/>
</Grid>
</Grid>
</LocalizationProvider>
);
}
4. 总结
DateTimePicker
组件是 Material UI 提供的一个强大且灵活的日期时间选择器,适用于各种应用场景。本文介绍了其核心属性与方法,并结合了多种 Material UI 组件,实现了自定义样式、错误提示、国际化、表单交互等丰富的用法。
chat评论区
评论列表
{{ item.user.nickname || item.user.username }}