Personnalisation

Day.js est très facile à personnaliser.

Vous pouvez créer une nouvelle locale.

var localeObject = {...} // Objet de locale Day.js, détaillé ci-dessous
dayjs.locale('en-my-settings', localeObject);

Mettre à jour une locale existante.

TIP

Ceci nécessite le plugin UpdateLocale pour fonctionner.

dayjs.extend(updateLocale);

dayjs.updateLocale('en', {
  /**/
});

Modèle d'un objet de locale Day.js.

javascript

const localeObject = {
  name: 'es', // name : chaîne de caractères (nom de la locale)
  weekdays: 'Domingo_Lunes ...'.split('_'), // weekdays : tableau des jours de la semaine
  weekdaysShort: 'Sun_M'.split('_'), // OPTIONAL, short weekdays : tableau abrégé des jours de la semaine. Utilise les trois premières lettres si non fourni.
  weekdaysMin: 'Su_Mo'.split('_'), // OPTIONAL, min weekdays : tableau minimal des jours de la semaine. Utilise les deux premières lettres si non fourni.
  weekStart: 1, // OPTIONAL, définit le début de la semaine (0 pour Dimanche, 1 pour Lundi, etc.). Par défaut : 0.
  yearStart: 4, // OPTIONAL, la semaine contenant le 4 janvier est considérée comme la première semaine de l'année.
  months: 'Enero_Febrero ... '.split('_'), // months : tableau des mois
  monthsShort: 'Jan_F'.split('_'), // OPTIONAL, short months : tableau abrégé des mois. Utilise les trois premières lettres si non fourni.
  ordinal: n => `${n}º`, // ordinal : fonction (nombre) => retourne le nombre ordinal correspondant (ex: 1er, 2ème, 3ème).
  formats: {
    // Formats abrégés permettant la localisation
    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',
    // Formats optionnels en minuscules/courts pour la localisation
    l: 'D/M/YYYY',
    ll: 'D MMM, YYYY',
    lll: 'D MMM, YYYY h:mm A',
    llll: 'ddd, MMM D, YYYY h:mm A',
  },
  relativeTime: {
    // Chaînes de format de temps relatif. Conservez %s et %d.
    future: 'in %s', // ex: dans 2 heures, %s est remplacé par "2 heures"
    past: '%s ago',
    s: 'a few seconds',
    m: 'a minute',
    mm: '%d minutes',
    h: 'an hour',
    hh: '%d hours', // ex: 2 heures, %d est remplacé par "2"
    d: 'a day',
    dd: '%d days',
    M: 'a month',
    MM: '%d months',
    y: 'a year',
    yy: '%d years',
  },
  meridiem: (hour, minute, isLowercase) => {
    // OPTIONAL, AM/PM (matin/soir)
    return hour >= 12 ? 'PM' : 'AM';
  },
};

Modèle d'un fichier de locale Day.js (par exemple dayjs/locale/es.js).

javascript

import dayjs from 'dayjs'

const locale = { ... } // Votre objet de locale Day.js

dayjs.locale(locale, null, true) // Charge la locale pour une utilisation ultérieure.

export default locale

Personnalisation ​

Personnalisation