dayjs Replace Moment.js in Ant Design (Antd) with Day.js

在 Ant Design (Antd) 中使用 Day.js 替换 Moment

This is an experimental attempt of replacing Moment.js in Ant Design project (Antd) with Day.js. If your project is not built with Ant Design, you don't have to include all those plugins below.

这是一个实验性的在 Ant Design (Antd) 中使用 Day.js 替换 Moment 的方案，如果你的项目并没有使用 Ant Design 那则不需要引入下面列出的全部插件。

Results 结论

Update: Antd Official doc 更新：antd 官方文档 https://ant.design/docs/react/replace-moment

https://ant.design/docs/react/replace-moment-cn

Only 3 steps to replace Moment.js with Day.js. Bundle size reduced from 65kb -> 4.19 kb. 只需要 3 步就可以快速实现替换，打包体积从 65kb 减小到 4.19 kb

Name	Size	Size gzip
Moment.js	231 kb	65.55 kb
Day.js	11.11 kb	4.19 kb

Steps 步骤

Install Day.js 安装 Day.js

npm install dayjs --save
npm install antd-dayjs-webpack-plugin

Update Webpack config 更新 Webpack 配置 More info 参考 https://github.com/ant-design/antd-dayjs-webpack-plugin

// webpack-config.js
const AntdDayjsWebpackPlugin = require('antd-dayjs-webpack-plugin');

module.exports = {
  plugins: [
    new AntdDayjsWebpackPlugin()
  ]
}

That's it. Done. 就这么简单就完成了。

Notice 说明

Day.js is designed to be immutable, however, in order to make full compatible to moment.js in Antd, we have to use a plugin 🚨 BadMutable 🚨 to make Day.js mutable. This's not good and not what we want, but there's no better option. With this plugin enabled, all setters will update the instance itself.

Day.js 被设计成不可变的对象，但是为了完成对 moment.js 的替换，必须要引入一个 🚨 BadMutable 🚨插件让其变成可变对象，这并不是一个好的选择，但为了兼容也没有更好的办法。当使用这个插件后，所有的 setter 都会更新当前实例。

Day.js is a lightweight library with only 2kb size, but we have to use some other plugins to make full compatible to moment.js in Antd, so the final bundle size is 4.19 kb (Still small 😀)

Day.js 是一个只有 2kb 的轻量级时间库，但为了完成对 moment.js 和 Antd 代码的替换，我们需要引入一些特殊的插件，这会使最终的体积变成 4.19 kb （但仍然很小呀😀 ）

Previous manual solution:

Update Webpack config 更新 Webpack 配置 You don't have to replacemoment to dayjs one by one in your code, Webpack will do this. 无需手动替换 moment 成 dayjs，Webpack 可以自动完成这个事情。

module.exports = { resolve: { alias: { moment: 'dayjs', } } }

Init Day.js in project's main index.js 在项目 index.js 中初始化 Day.js In the main entrance page (usually index.js / main.js), import Day.js core and it's plugins. 在项目的入口文件中（通常是 index.js / main.js ），引入 Day.js 核心库和相关插件

//import moment from 'moment'; //moment.locale('zh-cn'); import dayjs from 'dayjs'; import customParseFormat from 'dayjs/plugin/customParseFormat'; import weekOfYear from 'dayjs/plugin/weekOfYear'; import isMoment from 'dayjs/plugin/isMoment'; import badMutable from 'dayjs/plugin/badMutable'; import localeData from 'dayjs/plugin/localeData'; import advancedFormat from 'dayjs/plugin/advancedFormat'; import weekYear from 'dayjs/plugin/weekYear'; import isSameOrBefore from 'dayjs/plugin/isSameOrBefore'; import isSameOrAfter from 'dayjs/plugin/isSameOrAfter'; import 'dayjs/locale/zh-cn'; dayjs.extend(isSameOrBefore); dayjs.extend(isSameOrAfter); dayjs.extend(advancedFormat); dayjs.extend(customParseFormat); dayjs.extend(weekYear); dayjs.extend(weekOfYear); dayjs.extend(isMoment); dayjs.extend(localeData); dayjs.extend(badMutable); dayjs.locale('zh-cn');

Mar 10 '19 15:03 iamkun

Random idea... even I bundle two dayjs instances(one mutable, one immutable), it's still obviously smaller than using momentjs. It has to be 2 different names if they want to be both bundled.

Mar 11 '19 02:03 chenyong

很棒，尝试一下。如果 antd 能来做这个事情就更好了。

Mar 11 '19 04:03 CyberNika

@snokier https://github.com/ant-design/ant-design/issues/15311 You can join this issue with maintainers from Antd.

Mar 11 '19 05:03 ghost

@chenyong Will that make user confusion? Since mutable and immutable is hard to make it clear for some developer (I think, may be)

Mar 11 '19 05:03 ghost

Since mutable and immutable is hard to make it clear for some developer (I think, may be)

I'm afraid so... when mutable data and immutable data get used together, people get confused.

Mar 11 '19 06:03 chenyong

@chenyong

It would be better if Antd could make a little refactor of the way using moment.js.

Treat moment object as immutable, and call clone each time before changing it's value like moment().clone().xxx.

In this way, there's no need using BadMutable plugin anymore. And Day.js is immutable all the time.

Mar 11 '19 06:03 iamkun

按着您的步骤，引入了dayjs和相关插件，还是说 antd只支持moment The value/defaultValue of DatePicker or MonthPicker must be a moment object after [email protected]

Mar 11 '19 15:03 hytStart

@hytStart Can you provide a test git repo, please?

Mar 11 '19 15:03 iamkun

@hytStart Can you provide a test git repo, please?

Hi, sorry to bother you,please correct me if it's my mistake. index.js datepicker.js

Mar 12 '19 03:03 hytStart

@hytStart You forgot the step 2 section : Update Webpack config.

Mar 12 '19 03:03 iamkun

@iamkun The localeData plugin is incompatible with react-dates. I applied all the steps you provided but I get an error like the screenshot below: DevTools_-_www_dev-myrealtrip_com_accommodations