pandas.Series.dt.month_name — pandas 2.2.3 documentation (original) (raw)

Series.dt.month_name(*args, **kwargs)[source]#

Return the month names with specified locale.

Parameters:

localestr, optional

Locale determining the language in which to return the month name. Default is English locale ('en_US.utf8'). Use the commandlocale -a on your terminal on Unix systems to find your locale language code.

Returns:

Series or Index

Series or Index of month names.

Examples

s = pd.Series(pd.date_range(start='2018-01', freq='ME', periods=3)) s 0 2018-01-31 1 2018-02-28 2 2018-03-31 dtype: datetime64[ns] s.dt.month_name() 0 January 1 February 2 March dtype: object

idx = pd.date_range(start='2018-01', freq='ME', periods=3) idx DatetimeIndex(['2018-01-31', '2018-02-28', '2018-03-31'], dtype='datetime64[ns]', freq='ME') idx.month_name() Index(['January', 'February', 'March'], dtype='object')

Using the locale parameter you can set a different locale language, for example: idx.month_name(locale='pt_BR.utf8') will return month names in Brazilian Portuguese language.

idx = pd.date_range(start='2018-01', freq='ME', periods=3) idx DatetimeIndex(['2018-01-31', '2018-02-28', '2018-03-31'], dtype='datetime64[ns]', freq='ME') idx.month_name(locale='pt_BR.utf8')
Index(['Janeiro', 'Fevereiro', 'Março'], dtype='object')