使用自定义日期库
Ant Design 默认使用 Day.js 来处理时间日期问题。Day.js 相比于 moment 使用了不可变数据结构,性能更快,体积仅 2KB,API 设计完全一致。你可以很方便的改用其他自定义日期库如(moment、date-fns、luxon)。在这里我们提供了两种方式来实现替换:
第一种方法是使用 generatePicker
(或 generateCalendar
)辅助创建 Picker 组件。
我们先初始化一个 create-react-app
的 antd demo,你可以参考 在 create-react-app 中使用 进行构建,也可以直接从这里开始init antd
新建 src/components/DatePicker.tsx
。
编写如下代码:
import { DatePicker } from 'antd';import type { Moment } from 'moment';import momentGenerateConfig from 'rc-picker/lib/generate/moment';const MyDatePicker = DatePicker.generatePicker<Moment>(momentGenerateConfig);export default MyDatePicker;
新建 src/components/TimePicker.tsx
。
编写如下代码:
import * as React from 'react';import type { PickerTimeProps } from 'antd/es/date-picker/generatePicker';import type { Moment } from 'moment';import DatePicker from './DatePicker';export interface TimePickerProps extends Omit<PickerTimeProps<Moment>, 'picker'> {}const TimePicker = React.forwardRef<any, TimePickerProps>((props, ref) => (<DatePicker {...props} picker="time" mode={undefined} ref={ref} />));TimePicker.displayName = 'TimePicker';export default TimePicker;
新建 src/components/Calendar.tsx
。
编写如下代码:
import { Calendar } from 'antd';import type { Moment } from 'moment';import momentGenerateConfig from 'rc-picker/es/generate/moment';const MyCalendar = Calendar.generateCalendar<Moment>(momentGenerateConfig);export default MyCalendar;
新建 src/components/index.tsx
。
编写如下代码:
export { default as Calendar } from './Calendar';export { default as DatePicker } from './DatePicker';export { default as TimePicker } from './TimePicker';
修改 src/App.tsx
,引入 moment
和自定义的组件。
- import { DatePicker, Calendar } from 'antd';- import format from 'dayjs';+ import { DatePicker, TimePicker, Calendar } from './components';+ import format from 'moment';
我们还提供另一种实现方式。使用 @ant-design/moment-webpack-plugin
插件,无需对现有代码做任何修改直接替换成 Moment.js
。请参考 @ant-design/moment-webpack-plugin。
// webpack-config.jsconst AntdMomentWebpackPlugin = require('@ant-design/moment-webpack-plugin');module.exports = {// ...plugins: [new AntdMomentWebpackPlugin()],};
date-fns 目前支持和 dayjs 类似的自定义组件方法,区别在于使用的参数类型不同,在 antd 4.5.0 以上版本提供支持。
做一个简单的例子:
新建 src/components/DatePicker.tsx
。
编写如下代码:
import { DatePicker } from 'antd';import dateFnsGenerateConfig from 'rc-picker/es/generate/dateFns';const MyDatePicker = DatePicker.generatePicker<Date>(dateFnsGenerateConfig);export default MyDatePicker;
自 antd 5.4.0
起,可以使用 luxon 代替 dayjs 并支持同样的功能,但它与 dayjs 有一些差异,我们将在下面解释:
创建一个 DatePicker.tsx
文件,并定义一个基于 luxon 的 DatePicker 组件:
import { DatePicker } from 'antd';import type { DateTime } from 'luxon';import luxonGenerateConfig from 'rc-picker/lib/generate/luxon';const MyDatePicker = DatePicker.generatePicker<DateTime>(luxonGenerateConfig);export default MyDatePicker;
luxon 用户应该悉知,它本身没有 local 的实现。相反,它依赖于原生浏览器的 Intl。
这导致了与其他日期库的一些差异,主要区别是:
可以通过调整 luxon 配置来自定义这些默认的 luxon 行为:
import { DatePicker } from 'antd';import type { DateTime } from 'luxon';import luxonGenerateConfig from 'rc-picker/lib/generate/luxon';const customLuxonConfig = {...luxonGenerateConfig,getWeekFirstDay(locale) {// 在这里编写你的自定义实现},};const MyDatePicker = DatePicker.generatePicker<DateTime>(customLuxonConfig);export default MyDatePicker;
请注意,通过进行此类自定义,生成的 DatePicker 行为可能会以意想不到的方式发生变化,因此请确保你测试过一些边界情况。