feat: add support for lowercase localizable formats (l, ll, lll, llll)

docs/en/I18n.md

@@ -100,7 +100,12 @@ const localeObject = {
     L: 'MM/DD/YYYY',
     LL: 'MMMM D, YYYY',
     LLL: 'MMMM D, YYYY h:mm A',
-    LLLL: 'dddd, MMMM D, YYYY h:mm A'
+    LLLL: 'dddd, MMMM D, YYYY h:mm A',
+    // lowercase/short, optional formats for localization
+    l: 'D/M/YYYY',
+    ll: 'D MMM, YYYY',
+    lll: 'D MMM, YYYY h:mm A',
+    llll: 'ddd, MMM D, YYYY h:mm A'
   },
   relativeTime: {
     // relative time format strings, keep %s %d as the same

docs/pt-br/I18n.md

@@ -93,6 +93,20 @@ const objetoLocale = {
   months: 'Enero_Febrero ... '.split('_'), // meses: Array
   monthsShort: 'Jan_F'.split('_'), // OPCIONAL, meses com nome curto: Array, utiliza as três primeiras letras se nenhuma for especificada
   ordinal: n => `${n}º`, // ordinal: Function (number) => retorna number + saída
+  formats: {
+    // opções para formatos localizados
+    LTS: 'h:mm:ss A',
+    LT: 'h:mm A',
+    L: 'MM/DD/YYYY',
+    LL: 'MMMM D, YYYY',
+    LLL: 'MMMM D, YYYY h:mm A',
+    LLLL: 'dddd, MMMM D, YYYY h:mm A',
+    // formatos localizados/curtos opcionais
+    l: 'D/M/YYYY',
+    ll: 'D MMM, YYYY',
+    lll: 'D MMM, YYYY h:mm A',
+    llll: 'ddd, MMM D, YYYY h:mm A'
+  },
   relativeTime: {
     // formato relativo de horas, mantém %s %d como o mesmo
     future: 'em %s', // exemplo: em 2 horas, %s será substituído por 2 horas

src/locale/ca.js

@@ -11,7 +11,10 @@ const locale = {
     L: 'DD/MM/YYYY',
     LL: 'D MMMM [de] YYYY',
     LLL: 'D MMMM [de] YYYY [a les] H:mm',
-    LLLL: 'dddd D MMMM [de] YYYY [a les] H:mm'
+    LLLL: 'dddd D MMMM [de] YYYY [a les] H:mm',
+    ll: 'D MMM YYYY',
+    lll: 'D MMM YYYY, H:mm',
+    llll: 'ddd D MMM YYYY, H:mm'
   },
   relativeTime: {
     future: 'en %s',

src/locale/cs.js

@@ -12,7 +12,8 @@ const locale = {
     L: 'DD.MM.YYYY',
     LL: 'D. MMMM YYYY',
     LLL: 'D. MMMM YYYY H:mm',
-    LLLL: 'dddd D. MMMM YYYY H:mm'
+    LLLL: 'dddd D. MMMM YYYY H:mm',
+    l: 'D. M. YYYY'
   },
   relativeTime: {
     future: 'za %s',

src/locale/ja.js

@@ -13,7 +13,11 @@ const locale = {
     L: 'YYYY/MM/DD',
     LL: 'YYYY年M月D日',
     LLL: 'YYYY年M月D日 HH:mm',
-    LLLL: 'YYYY年M月D日 dddd HH:mm'
+    LLLL: 'YYYY年M月D日 dddd HH:mm',
+    l: 'YYYY/MM/DD',
+    ll: 'YYYY年M月D日',
+    lll: 'YYYY年M月D日 HH:mm',
+    llll: 'YYYY年M月D日(ddd) HH:mm'
   },
   relativeTime: {
     future: '%s後',

src/locale/ko.js

@@ -11,7 +11,11 @@ const locale = {
     L: 'YYYY.MM.DD.',
     LL: 'YYYY년 MMMM D일',
     LLL: 'YYYY년 MMMM D일 A h:mm',
-    LLLL: 'YYYY년 MMMM D일 dddd A h:mm'
+    LLLL: 'YYYY년 MMMM D일 dddd A h:mm',
+    l: 'YYYY.MM.DD.',
+    ll: 'YYYY년 MMMM D일',
+    lll: 'YYYY년 MMMM D일 A h:mm',
+    llll: 'YYYY년 MMMM D일 dddd A h:mm'
   },
   relativeTime: {
     future: '%s 후',

src/locale/sv.js

@@ -19,7 +19,9 @@ const locale = {
     L: 'YYYY-MM-DD',
     LL: 'D MMMM YYYY',
     LLL: 'D MMMM YYYY [kl.] HH:mm',
-    LLLL: 'dddd D MMMM YYYY [kl.] HH:mm'
+    LLLL: 'dddd D MMMM YYYY [kl.] HH:mm',
+    lll: 'D MMM YYYY HH:mm',
+    llll: 'ddd D MMM YYYY HH:mm'
   },
   relativeTime: {
     future: 'om %s',

src/locale/zh-cn.js

@@ -15,7 +15,11 @@ const locale = {
     L: 'YYYY/MM/DD',
     LL: 'YYYY年M月D日',
     LLL: 'YYYY年M月D日Ah点mm分',
-    LLLL: 'YYYY年M月D日ddddAh点mm分'
+    LLLL: 'YYYY年M月D日ddddAh点mm分',
+    l: 'YYYY/M/D',
+    ll: 'YYYY年M月D日',
+    lll: 'YYYY年M月D日 HH:mm',
+    llll: 'YYYY年M月D日dddd HH:mm'
   },
   relativeTime: {
     future: '%s内',

src/locale/zh-tw.js

@@ -14,7 +14,11 @@ const locale = {
     L: 'YYYY/MM/DD',
     LL: 'YYYY年M月D日',
     LLL: 'YYYY年M月D日 HH:mm',
-    LLLL: 'YYYY年M月D日dddd HH:mm'
+    LLLL: 'YYYY年M月D日dddd HH:mm',
+    l: 'YYYY/M/D',
+    ll: 'YYYY年M月D日',
+    lll: 'YYYY年M月D日 HH:mm',
+    llll: 'YYYY年M月D日dddd HH:mm'
   },
   relativeTime: {
     future: '%s內',

src/plugin/localizedFormat/index.js

@@ -9,15 +9,19 @@ export default (o, c, d) => {
     L: 'MM/DD/YYYY',
     LL: 'MMMM D, YYYY',
     LLL: 'MMMM D, YYYY h:mm A',
-    LLLL: 'dddd, MMMM D, YYYY h:mm A'
+    LLLL: 'dddd, MMMM D, YYYY h:mm A',
+    l: 'M/D/YYYY',
+    ll: 'MMM D, YYYY',
+    lll: 'MMM D, YYYY h:mm A',
+    llll: 'ddd, MMM D, YYYY h:mm A'
   }
   d.en.formats = englishFormats
   proto.format = function (formatStr) {
     const locale = this.$locale()
     const formats = locale.formats || {}
     const str = formatStr || FORMAT_DEFAULT
-    const result = str.replace(/LTS|LT|L{1,4}/g, match =>
-      formats[match] || englishFormats[match])
+    const result = str.replace(/(\[[^\]]+])|(LTS?|l{1,4}|L{1,4})/g, (_, a, b) =>
+      a || formats[b] || englishFormats[b])
     return oldFormat.call(this, result)
   }
 }

test/locale/keys.test.js

@@ -3,17 +3,17 @@ import path from 'path'
 import dayjs from '../../src'
 
 const localeDir = '../../src/locale'
-const L = []
+const Locale = []
 
 // load all locales from locale dir
 fs.readdirSync(path.join(__dirname, localeDir))
   .forEach((file) => {
     // eslint-disable-next-line
-    L.push(require(path.join(__dirname, localeDir, file)).default)
+    Locale.push(require(path.join(__dirname, localeDir, file)).default)
   })
 
 it('Locale keys', () => {
-  L.forEach((l) => {
+  Locale.forEach((locale) => {
     const {
       name,
       ordinal,
@@ -25,7 +25,7 @@ it('Locale keys', () => {
       monthsShort,
       weekdaysMin,
       weekStart
-    } = l
+    } = locale
     expect(name).toEqual(expect.any(String))
     expect(weekdays).toEqual(expect.any(Array))
 
@@ -44,7 +44,32 @@ it('Locale keys', () => {
 
     expect(dayjs().locale(name).$locale().name).toBe(name)
     if (formats) {
-      expect(Object.keys(formats).sort()).toEqual(['L', 'LL', 'LLL', 'LLLL', 'LT', 'LTS'].sort())
+      const {
+        LT,
+        LTS,
+        L,
+        LL,
+        LLL,
+        LLLL,
+        l,
+        ll,
+        lll,
+        llll,
+        ...remainingFormats
+      } = formats
+      expect(formats).toEqual(expect.objectContaining({
+        L: expect.any(String),
+        LL: expect.any(String),
+        LLL: expect.any(String),
+        LLLL: expect.any(String),
+        LT: expect.any(String),
+        LTS: expect.any(String)
+      }))
+      expect(Object.keys(remainingFormats).length).toEqual(0)
+      if (l) expect(l).toEqual(expect.any(String))
+      if (ll) expect(ll).toEqual(expect.any(String))
+      if (lll) expect(lll).toEqual(expect.any(String))
+      if (llll) expect(llll).toEqual(expect.any(String))
     }
     if (relativeTime) {
       expect(Object.keys(relativeTime).sort()).toEqual(['d', 'dd', 'future', 'h', 'hh', 'm', 'mm', 'M', 'MM',

test/plugin/localizableFormat.test.js

@@ -18,22 +18,33 @@ afterEach(() => {
 it('Declares English localized formats', () => {
   expect(dayjs.en).toBeDefined()
   expect(dayjs.en.formats).toBeDefined();
-  ['LT', 'LTS', 'L', 'LL', 'LLL', 'LLLL'].forEach(option =>
+  ['LT', 'LTS', 'L', 'LL', 'LLL', 'LLLL', 'l', 'll', 'lll', 'llll'].forEach(option =>
     expect(dayjs.en.formats[option]).toBeDefined())
 })
 
+it('Should not interpolate characters inside square brackets', () => {
+  const date = new Date(0)
+  const actualDate = dayjs(date)
+  const expectedDate = moment(date)
+
+  expect(actualDate.format('[l]')).toBe('l')
+  expect(actualDate.format('YYYY [l] YYYY')).toBe('1970 l 1970')
+  expect(actualDate.format('l [l] l')).toBe('1/1/1970 l 1/1/1970')
+  expect(actualDate.format('[L LL LLL LLLL]')).toBe(expectedDate.format('[L LL LLL LLLL]'))
+})
+
 it('Recognizes localized format options', () => {
   const { formats } = dayjs.en
   const date = dayjs();
-  ['LT', 'LTS', 'L', 'LL', 'LLL', 'LLLL'].forEach(option =>
+  ['LT', 'LTS', 'L', 'LL', 'LLL', 'LLLL', 'l', 'll', 'lll', 'llll'].forEach(option =>
     expect(date.format(option)).toBe(date.format(formats[option])))
 })
 
 it('Uses correct English formats', () => {
   const date = new Date()
   const actualDate = dayjs(date)
   const expectedDate = moment(date);
-  ['LT', 'LTS', 'L', 'LL', 'LLL', 'LLLL'].forEach(option =>
+  ['LT', 'LTS', 'L', 'LL', 'LLL', 'LLLL', 'l', 'll', 'lll', 'llll'].forEach(option =>
     expect(actualDate.format(option)).toBe(expectedDate.format(option)))
 })