pandas.DatetimeIndex.strftime — pandas 3.0.0.dev0+2100.gf496acffcc documentation (original) (raw)

DatetimeIndex.strftime(date_format)[source]#

Convert to Index using specified date_format.

Return an Index of formatted strings specified by date_format, which supports the same string format as the python standard library. Details of the string format can be found in python string format doc.

Formats supported by the C strftime API but not by the python string format doc (such as “%R”, “%r”) are not officially supported and should be preferably replaced with their supported equivalents (such as “%H:%M”,“%I:%M:%S %p”).

Note that PeriodIndex support additional directives, detailed inPeriod.strftime.

Parameters:

date_formatstr

Date format string (e.g. “%Y-%m-%d”).

Returns:

ndarray[object]

NumPy ndarray of formatted strings.

Examples

rng = pd.date_range(pd.Timestamp("2018-03-10 09:00"), periods=3, freq="s") rng.strftime("%B %d, %Y, %r") Index(['March 10, 2018, 09:00:00 AM', 'March 10, 2018, 09:00:01 AM', 'March 10, 2018, 09:00:02 AM'], dtype='object')