DOC: Additions to month_name & day_name

[eduardochaves1]

• closes DOC: dt.month_name & dt.day_name locale parameter needs improvment #51138
• All code checks passed.

In the issue #51138 I was trying to set a column in my DF for the month and day's names in portuguese, then a good guy told me about the locale -a command from terminal to look for the right way to set the locale string parameter for my code to work properly.

So I thought I would be nice if the respective docs, month_name & day_name, had these informations for the user to know about.

So I added these infos plus a quick example for each method in the docstrings from /pandas/core/arrays/datetimes.py

PS.: I just don't know why the validade_docstrings.py don't recognize the changes I made in the method's docstring...

Output: validate_docstrings.py pandas.Series.dt.month_name

Output: validate_docstrings.py pandas.Series.dt.day_name

Output: pre-commit run --files pandas/core/arrays/datetimes.py

[eduardochaves1]

The CI is getting a UNEXPECTED EXCEPTION: Error('unsupported locale setting') error for my example with locale='pt_BR.utf8'. And I don't know exactly why, cause I tried the exact same code on my machine and it worked. Maybe this locale isn't installed on the machine in which does the CI.

[mroeschke]

You will probably need to add # doctest: +SKIP to the example due to the locale being unavailable

[eduardochaves1]

You will probably need to add # doctest: +SKIP to the example due to the locale being unavailable

I added it in the same line where the function was called with locate='pt_BR.utf8 (for both month_name & day_name) and the CI went well.

[mroeschke]

Thanks @eduardochaves1