doc: ECMAScript 2015 (ES6) description added to plugins pages (#126)

* ECMAScript 2015 (ES6) description added to plugins pages for importing plugins.

* lock file removed

---------

Co-authored-by: Ali Mirzaei <[email protected]>

Author: 4limirzaei

docs/durations/locale.md

@@ -8,8 +8,11 @@ You can get or set the locale of a duration using `locale`. The locale will affe
 @>RelativeTime
 
 ```javascript
-require('dayjs/locale/es')
+require("dayjs/locale/es");
+// import es from 'dayjs/plugin/es' // ES 2015
 
 dayjs.duration(1, "minutes").locale("en").humanize(); // a minute
+
 dayjs.duration(1, "minutes").locale("es").humanize(); // un minuto
+// dayjs.duration(1, "minutes").locale(es).humanize(); // ES 2015
 ```

docs/plugin/advanced-format.md

@@ -2,33 +2,36 @@
 id: advanced-format
 title: AdvancedFormat
 ---
+
 AdvancedFormat extends `dayjs().format` API to supply more format options.
 
 ```javascript
-var advancedFormat = require('dayjs/plugin/advancedFormat')
-dayjs.extend(advancedFormat)
+var advancedFormat = require("dayjs/plugin/advancedFormat");
+// import advancedFormat from 'dayjs/plugin/advancedFormat' // ES 2015
+
+dayjs.extend(advancedFormat);
 
-dayjs().format('Q Do k kk X x')
+dayjs().format("Q Do k kk X x");
 ```
 
 Note: some of the format options like `z` and `zzz` in the table below require additional plugins.
 
 List of added formats:
 
-| Format | Output                | Description                                           |
-| ------ | --------------------- | ----------------------------------------------------- |
-| `Q`    | 1-4                   | Quarter                                               |
-| `Do`   | 1st 2nd ... 31st      | Day of Month with ordinal                             |
-| `k`    | 1-24                  | The hour, beginning at 1                              |
-| `kk`   | 01-24                 | The hour, 2-digits, beginning at 1                    |
-| `X`    | 1360013296            | Unix Timestamp in second                              |
-| `x`    | 1360013296123         | Unix Timestamp in millisecond                         |
-| `w`    | 1 2 ... 52 53         | Week of year @>>WeekOfYear                 |
-| `ww`   | 01 02 ... 52 53       | Week of year, 2-digits @>>WeekOfYear       |
-| `W`    | 1 2 ... 52 53         | ISO Week of year @>>IsoWeek     |
-| `WW`   | 01 02 ... 52 53       | ISO Week of year, 2-digits @>>IsoWeek |
-| `wo`   | 1st 2nd ... 52nd 53rd | Week of year with ordinal @>>WeekOfYear    |
-| `gggg` | 2017                  | Week Year @>>WeekYear                      |
-| `GGGG` | 2017                  | ISO Week Year @>>IsoWeek   |
-| `z`    | EST                   | Abbreviated named offset @>>Timezone                   |
-| `zzz`  | Eastern Standard Time | Unabbreviated named offset @>>Timezone                 |
+| Format | Output                | Description                             |
+| ------ | --------------------- | --------------------------------------- |
+| `Q`    | 1-4                   | Quarter                                 |
+| `Do`   | 1st 2nd ... 31st      | Day of Month with ordinal               |
+| `k`    | 1-24                  | The hour, beginning at 1                |
+| `kk`   | 01-24                 | The hour, 2-digits, beginning at 1      |
+| `X`    | 1360013296            | Unix Timestamp in second                |
+| `x`    | 1360013296123         | Unix Timestamp in millisecond           |
+| `w`    | 1 2 ... 52 53         | Week of year @>>WeekOfYear              |
+| `ww`   | 01 02 ... 52 53       | Week of year, 2-digits @>>WeekOfYear    |
+| `W`    | 1 2 ... 52 53         | ISO Week of year @>>IsoWeek             |
+| `WW`   | 01 02 ... 52 53       | ISO Week of year, 2-digits @>>IsoWeek   |
+| `wo`   | 1st 2nd ... 52nd 53rd | Week of year with ordinal @>>WeekOfYear |
+| `gggg` | 2017                  | Week Year @>>WeekYear                   |
+| `GGGG` | 2017                  | ISO Week Year @>>IsoWeek                |
+| `z`    | EST                   | Abbreviated named offset @>>Timezone    |
+| `zzz`  | Eastern Standard Time | Unabbreviated named offset @>>Timezone  |

docs/plugin/array-support.md

@@ -7,6 +7,8 @@ ArraySupport extends `dayjs()`, `dayjs.utc` APIs to support array argument.
 
 ```javascript
 var arraySupport = require("dayjs/plugin/arraySupport");
+// import arraySupport from 'dayjs/plugin/arraySupport' // ES 2015
+
 dayjs.extend(arraySupport);
 
 dayjs([2010, 1, 14, 15, 25, 50, 125]);

docs/plugin/bad-mutable.md

@@ -5,15 +5,17 @@ title: BadMutable
 
 Day.js is designed to be immutable, however, in order to make it fully compatible with moment.js in some legacy projects we introduced a plugin 🚨 BadMutable 🚨 to make Day.js mutable.
 
-> This is __NOT__ good and __NOT__ recommended for most projects.
+> This is **NOT** good and **NOT** recommended for most projects.
 
 With this plugin enabled, all setters will update the instance itself.
 
 ```javascript
-var badMutable = require('dayjs/plugin/badMutable')
-dayjs.extend(badMutable)
+var badMutable = require("dayjs/plugin/badMutable");
+// import badMutable from 'dayjs/plugin/badMutable' // ES 2015
+
+dayjs.extend(badMutable);
 // with 🚨 BadMutable 🚨 plugin
-const today = dayjs()
-today.add(1, 'day')
-console.log(today) // update itself, value will be tomorrow
+const today = dayjs();
+today.add(1, "day");
+console.log(today); // update itself, value will be tomorrow
 ```

docs/plugin/bigint-support.md

@@ -7,6 +7,8 @@ BigIntSupport extends `dayjs()`, `dayjs.unix` APIs to support [BigInt](https://d
 
 ```javascript
 var bigIntSupport = require("dayjs/plugin/bigIntSupport");
+// import bigIntSupport from 'dayjs/plugin/bigIntSupport' // ES 2015
+
 dayjs.extend(bigIntSupport);
 
 dayjs(BigInt(1666310421101));

docs/plugin/buddhist-era.md

@@ -10,10 +10,12 @@ Buddhist Era is a year numbering system that primarily used in mainland Southeas
 To calculate BE year manually, just add 543 to year. For example 26 May 1977 AD/CE should display as 26 May 2520 BE (1977 + 543).
 
 ```javascript
-var buddhistEra = require('dayjs/plugin/buddhistEra')
-dayjs.extend(buddhistEra)
+var buddhistEra = require("dayjs/plugin/buddhistEra");
+// import buddhistEra from 'dayjs/plugin/buddhistEra' // ES 2015
 
-dayjs().format('BBBB BB')
+dayjs.extend(buddhistEra);
+
+dayjs().format("BBBB BB");
 ```
 
 List of added formats:

docs/plugin/calendar.md

@@ -2,19 +2,22 @@
 id: calendar
 title: Calendar
 ---
+
 Calendar adds `.calendar` API to return a `string` to display calendar time
 
 ```javascript
-var calendar = require('dayjs/plugin/calendar')
-dayjs.extend(calendar)
+var calendar = require("dayjs/plugin/calendar");
+// import calendar from 'dayjs/plugin/calendar' // ES 2015
+
+dayjs.extend(calendar);
 
-dayjs().calendar(dayjs('2008-01-01'))
+dayjs().calendar(dayjs("2008-01-01"));
 dayjs().calendar(null, {
-  sameDay: '[Today at] h:mm A', // The same day ( Today at 2:30 AM )
-  nextDay: '[Tomorrow at] h:mm A', // The next day ( Tomorrow at 2:30 AM )
-  nextWeek: 'dddd [at] h:mm A', // The next week ( Sunday at 2:30 AM )
-  lastDay: '[Yesterday at] h:mm A', // The day before ( Yesterday at 2:30 AM )
-  lastWeek: '[Last] dddd [at] h:mm A', // Last week ( Last Monday at 2:30 AM )
-  sameElse: 'DD/MM/YYYY' // Everything else ( 17/10/2011 )
-})
+  sameDay: "[Today at] h:mm A", // The same day ( Today at 2:30 AM )
+  nextDay: "[Tomorrow at] h:mm A", // The next day ( Tomorrow at 2:30 AM )
+  nextWeek: "dddd [at] h:mm A", // The next week ( Sunday at 2:30 AM )
+  lastDay: "[Yesterday at] h:mm A", // The day before ( Yesterday at 2:30 AM )
+  lastWeek: "[Last] dddd [at] h:mm A", // Last week ( Last Monday at 2:30 AM )
+  sameElse: "DD/MM/YYYY", // Everything else ( 17/10/2011 )
+});
 ```

docs/plugin/custom-parse-format.md

@@ -2,19 +2,22 @@
 id: custom-parse-format
 title: CustomParseFormat
 ---
+
 CustomParseFormat extends `dayjs()` constructor to support custom formats of input strings.
 
 ```javascript
-var customParseFormat = require('dayjs/plugin/customParseFormat')
-dayjs.extend(customParseFormat)
+var customParseFormat = require("dayjs/plugin/customParseFormat");
+// import customParseFormat from 'dayjs/plugin/customParseFormat' // ES 2015
+
+dayjs.extend(customParseFormat);
 
-dayjs('05/02/69 1:02:03 PM -05:00', 'MM/DD/YY H:mm:ss A Z')
+dayjs("05/02/69 1:02:03 PM -05:00", "MM/DD/YY H:mm:ss A Z");
 // Returns an instance containing '1969-05-02T18:02:03.000Z'
 
-dayjs('2018 Enero 15', 'YYYY MMMM DD', 'es')
+dayjs("2018 Enero 15", "YYYY MMMM DD", "es");
 // Returns an instance containing '2018-01-15T00:00:00.000Z'
 
-dayjs('1970-00-00', 'YYYY-MM-DD', true) // strict parsing
+dayjs("1970-00-00", "YYYY-MM-DD", true); // strict parsing
 ```
 
 [List of all available parsing tokens](../parse/string-format#list-of-all-available-parsing-tokens)

docs/plugin/day-of-year.md

@@ -2,12 +2,15 @@
 id: day-of-year
 title: DayOfYear
 ---
+
 DayOfYear adds `.dayOfYear()` API to returns a `number` indicating the `Dayjs`'s day of the year, or to set the day of the year.
 
 ```javascript
-var dayOfYear = require('dayjs/plugin/dayOfYear')
-dayjs.extend(dayOfYear)
+var dayOfYear = require("dayjs/plugin/dayOfYear");
+// import dayOfYear from 'dayjs/plugin/dayOfYear' // ES 2015
+
+dayjs.extend(dayOfYear);
 
-dayjs('2010-01-01').dayOfYear() // 1
-dayjs('2010-01-01').dayOfYear(365) // 2010-12-31
+dayjs("2010-01-01").dayOfYear(); // 1
+dayjs("2010-01-01").dayOfYear(365); // 2010-12-31
 ```

docs/plugin/dev-helper.md

@@ -8,9 +8,10 @@ DevHelper adds some helper function to give you more hints and warnings while us
 Note, you can set `process.env.NODE_ENV` to `production` to disable the DevHelper in your production environment. And if you have enabled a JavaScript minifier like UglifyJS, it can remove the plugin from your production bundle automatically to save some bytes.
 
 ```js
-var devHelper = require('dayjs/plugin/devHelper')
+var devHelper = require("dayjs/plugin/devHelper");
+// import devHelper from 'dayjs/plugin/devHelper' // ES 2015
 
-dayjs.extend(devHelper)
+dayjs.extend(devHelper);
 ```
 
 You can also load this plugin on demand yourself.