Accessing locale specific functionality2.8.0+

  1. localeData = moment.localeData()
  2. localeData.months(Moment)
  3. localeData.months()
  4. localeData.monthsShort(Moment)
  5. localeData.monthsShort()
  6. localeData.monthsParse(String)
  7. localeData.weekdays(Moment)
  8. localeData.weekdays()
  9. localeData.weekdays(Boolean)      ## Added 2.24.0, sorts weekdays by locale
  10. localeData.weekdaysShort(Moment)
  11. localeData.weekdaysShort()
  12. localeData.weekdaysShort(Boolean) ## Added 2.24.0, sorts weekdays by locale
  13. localeData.weekdaysMin(Moment)
  14. localeData.weekdaysMin()
  15. localeData.weekdaysMin(Boolean)   ## Added 2.24.0, sorts weekdays by locale
  16. localeData.weekdaysParse(String)
  17. localeData.longDateFormat(String)
  18. localeData.isPM(String)
  19. localeData.meridiem(Number, Number, Boolean)
  20. localeData.calendar(String, Moment)
  21. localeData.relativeTime(Number, Boolean, String, Boolean)
  22. localeData.pastFuture(Number, String)
  23. localeData.ordinal(Number)
  24. localeData.preparse(String)
  25. localeData.postformat(String)
  26. localeData.week(Moment)
  27. localeData.invalidDate()
  28. localeData.firstDayOfWeek()
  29. localeData.firstDayOfYear()

You can access the properties of the currently loaded locale through themoment.localeData(key) function. It returns the current locale or a localewith the given key:

  1. // get current locale
  2. var currentLocaleData = moment.localeData();
  3. var frLocaleData = moment.localeData('fr');

The returned object has the following methods:

  1. localeData.months(aMoment);  // full month name of aMoment
  2. localeData.monthsShort(aMoment);  // short month name of aMoment
  3. localeData.monthsParse(longOrShortMonthString);  // returns month id (0 to 11) of input
  4. localeData.weekdays(aMoment);  // full weekday name of aMoment
  5. localeData.weekdaysShort(aMoment);  // short weekday name of aMoment
  6. localeData.weekdaysMin(aMoment);  // min weekday name of aMoment
  7. localeData.weekdaysParse(minShortOrLongWeekdayString);  // returns weekday id (0 to 6) of input
  8. localeData.longDateFormat(dateFormat);  // returns the full format of abbreviated date-time formats LT, L, LL and so on
  9. localeData.isPM(amPmString);  // returns true iff amPmString represents PM
  10. localeData.meridiem(hours, minutes, isLower);  // returns am/pm string for particular time-of-day in upper/lower case
  11. localeData.calendar(key, aMoment);  // returns a format that would be used for calendar representation. Key is one of 'sameDay', 'nextDay', 'lastDay', 'nextWeek', 'prevWeek', 'sameElse'
  12. localeData.relativeTime(number, withoutSuffix, key, isFuture);  // returns relative time string, key is on of 's', 'm', 'mm', 'h', 'hh', 'd', 'dd', 'M', 'MM', 'y', 'yy'. Single letter when number is 1.
  13. localeData.pastFuture(diff, relTime);  // convert relTime string to past or future string depending on diff
  14. localeData.ordinal(number);  // convert number to ordinal string 1 -> 1st
  15. localeData.preparse(str);  // called before parsing on every input string
  16. localeData.postformat(str);  // called after formatting on every string
  17. localeData.week(aMoment);  // returns week-of-year of aMoment
  18. localeData.invalidDate();  // returns a translation of 'Invalid date'
  19. localeData.firstDayOfWeek();  // 0-6 (Sunday to Saturday)
  20. localeData.firstDayOfYear();  // 0-15 Used to determine first week of the year.

Details about firstDayOfYear can be found in the customization section.