mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-05 05:28:20 +08:00
014bed6358
* docs: faq How to use dayjs instead of moment * adjust article position * add steps and use cases * change docs * add bisheng config source * translate title * remove customize TimePicker * simplified document * Update docs/react/generate-picker.zh-CN.md Co-Authored-By: 偏右 <afc163@gmail.com> * Update docs/react/generate-picker.zh-CN.md Co-Authored-By: 偏右 <afc163@gmail.com> * add cra demo * init demo refer 'Use in TypeScript' Co-authored-by: 偏右 <afc163@gmail.com>
107 lines
3.3 KiB
Markdown
107 lines
3.3 KiB
Markdown
---
|
||
order: 5
|
||
title: 自定义日期库
|
||
---
|
||
|
||
## 如何在 DatePicker 中使用自定义日期库（如 dayjs ）？
|
||
|
||
考虑到包的大小，你可以用自定义日期库替换 Moment。在这里我们提供了两种方式来实现替换:
|
||
|
||
### 自定义组件
|
||
|
||
第一种方法是使用 `generatePicker`（或 `generateCalendar`）辅助创建 Picker 组件。
|
||
|
||
我们先初始化一个 `create-react-app` 的 antd demo，你可以参考 [在 TypeScript 中使用](/docs/react/use-in-typescript) 进行构建，也可以直接从这里开始[init antd](https://github.com/xiaohuoni/antd4-generate-picker/commit/47fec964e36d48bd15760f8f5abcb9655c259aa6)
|
||
|
||
#### DatePicker.tsx
|
||
|
||
新建 `src/components/DatePicker.tsx`。
|
||
|
||
编写如下代码:
|
||
|
||
```tsx
|
||
import { Dayjs } from 'dayjs';
|
||
import dayjsGenerateConfig from 'rc-picker/lib/generate/dayjs';
|
||
import generatePicker from 'antd/es/date-picker/generatePicker';
|
||
import 'antd/es/date-picker/style/index';
|
||
|
||
const DatePicker = generatePicker<Dayjs>(dayjsGenerateConfig);
|
||
|
||
export default DatePicker;
|
||
```
|
||
|
||
#### TimePicker.tsx
|
||
|
||
新建 `src/components/TimePicker.tsx`。
|
||
|
||
编写如下代码:
|
||
|
||
```tsx
|
||
import { Dayjs } from 'dayjs';
|
||
import * as React from 'react';
|
||
import DatePicker from './DatePicker';
|
||
import { PickerTimeProps } from 'antd/es/date-picker/generatePicker';
|
||
import { Omit } from 'antd/es/_util/type';
|
||
|
||
export interface TimePickerProps extends Omit<PickerTimeProps<Dayjs>, 'picker'> {}
|
||
|
||
const TimePicker = React.forwardRef<any, TimePickerProps>((props, ref) => {
|
||
return <DatePicker {...props} picker="time" mode={undefined} ref={ref} />;
|
||
});
|
||
|
||
TimePicker.displayName = 'TimePicker';
|
||
|
||
export default TimePicker;
|
||
```
|
||
|
||
#### Calendar.tsx
|
||
|
||
新建 `src/components/Calendar.tsx`。
|
||
|
||
编写如下代码:
|
||
|
||
```tsx
|
||
import { Dayjs } from 'dayjs';
|
||
import dayjsGenerateConfig from 'rc-picker/lib/generate/dayjs';
|
||
import generateCalendar from 'antd/es/calendar/generateCalendar';
|
||
import 'antd/es/calendar/style';
|
||
|
||
const Calendar = generateCalendar<Dayjs>(dayjsGenerateConfig);
|
||
|
||
export default Calendar;
|
||
```
|
||
|
||
#### 导出自定义组件
|
||
|
||
新建 `src/components/index.tsx`。
|
||
|
||
编写如下代码:
|
||
|
||
```tsx
|
||
export { default as DatePicker } from './DatePicker';
|
||
export { default as Calendar } from './Calendar';
|
||
export { default as TimePicker } from './TimePicker';
|
||
```
|
||
|
||
#### 使用自定义组件
|
||
|
||
修改 `src/App.tsx`，引入 `dayjs` 和自定义的组件。
|
||
|
||
```diff
|
||
- import { DatePicker, Calendar } from 'antd';
|
||
- import format from 'moment';
|
||
|
||
+ import { DatePicker, TimePicker, Calendar } from './components';
|
||
+ import format from 'dayjs';
|
||
```
|
||
|
||
如果按照上述步骤无法正确运行的话，你可以参考[antd4-generate-picker/antd-ts](https://github.com/xiaohuoni/antd4-generate-picker/tree/master/antd-ts)。
|
||
|
||
如果你需要 JavaScript 代码，你可以参考 [antd4-generate-picker/antd-demo](https://github.com/xiaohuoni/antd4-generate-picker/tree/master/antd-demo)。
|
||
|
||
如果你熟悉 [umi](https://umijs.org/)，你可以参考 [antd4-use-dayjs-replace-moment](https://github.com/xiaohuoni/antd4-use-dayjs-replace-moment)。
|
||
|
||
### Webpack 配置替换
|
||
|
||
我们还提供另一种实现方式。使用 `antd-dayjs-webpack-plugin` 插件，无需对现有代码做任何修改直接替换成 `Day.js`。请参考 [antd-dayjs-webpack-plugin](https://github.com/ant-design/antd-dayjs-webpack-plugin)。
|