pandas.PeriodIndex.strftime#

PeriodIndex.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 in Period.strftime.

Parameters:
date_formatstr

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

Returns:
ndarray[object]

NumPy ndarray of formatted strings.

See also

to_datetime

Convert the given argument to datetime.

DatetimeIndex.normalize

Return DatetimeIndex with times to midnight.

DatetimeIndex.round

Round the DatetimeIndex to the specified freq.

DatetimeIndex.floor

Floor the DatetimeIndex to the specified freq.

Timestamp.strftime

Format a single Timestamp.

Period.strftime

Format a single Period.

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')