Documentation incorrect: lang().months returns function rather than months array

[JasonCust]

Documentation states:

var fr = moment().lang('fr');
fr.lang().months // ["janvier", "février", "mars", ...]

but on a Node.js REPL:

var fr = moment().lang('fr');
fr.lang().months // [Function]

Side note: executing the function throws an error

fr.lang().months()
TypeError: Cannot call method 'month' of undefined
    at Object.Language.months (./node_modules/moment/moment.js:352:35)
    at repl:1:12
    at REPLServer.self.eval (repl.js:109:21)
    at Interface.<anonymous> (repl.js:248:12)
    at Interface.EventEmitter.emit (events.js:96:17)
    at Interface._onLine (readline.js:200:10)
    at Interface._line (readline.js:518:8)
    at Interface._ttyWrite (readline.js:736:14)
    at ReadStream.onkeypress (readline.js:97:10)
    at ReadStream.EventEmitter.emit (events.js:126:20)
    at emitKey (readline.js:1058:12)
    at ReadStream.onData (readline.js:807:7)

[ichernev]

You're correct, the docs are wrong.
If you want to retrieve months in the latest version of node, please use

moment().lang('fr');  // set language
var fr = moment().lang();  // get language
fr._months; // access months array

You can post issues with the documentation to: https://github.com/timrwood/momentjs.com. https://github.com/timrwood/momentjs.com/issues/25 here's one :)

[terrapass]

@ichernev, while this works for most languages, for some, such as Ukrainian and Russian (maybe a few other languages as well), _months just appears to contain English month names, defined in Language.prototype:

moment().lang('ru');
var ru = moment().lang();
ru._months; //["January", "February", ... ] instead of ["январь", "февраль", ...]

[timrwood]

The Language#months method should be called like so. The first argument should be a moment, the second arg should be a formatting string.

This was added to allow languages to change between different cases of the month name depending on where in the formatting string the month name fell.

Perhaps that should be outlined in the docs as well.

[terrapass]

If I'm not mistaken, by looking at the code, so far only 3 translations (Russian, Ukrainian and Georgian (ka)) actually override this method. The rest just use nominative case all the time (for now).

Anyway, IMO, using _months should be avoided, as it won't work for languages where months() is overridden.

[timrwood]

Yeah, its probably best to use something like this instead of directly trying to access the array.

moment.lang().months(moment([0, monthIndex]), "");

[CHenrie]

So how should one get the list of weekdays or months to populate a list for selection?
This was closed with out giving a correct way of using the API. The docs are wrong so what is the solution so I can write a multilingual application with out hacking in ru.js

[mikegleasonjr]

2 years later and the doc is still wrong...