pandas.Timestamp.to_period — pandas 3.0.0.dev0+2104.ge637b4290d documentation (original) (raw)

Timestamp.to_period(freq=None)#

Return an period of which this timestamp is an observation.

This method converts the given Timestamp to a Period object, which represents a span of time,such as a year, month, etc., based on the specified frequency.

Parameters:

freqstr, optional

Frequency string for the period (e.g., ‘Y’, ‘M’, ‘W’). Defaults to None.

See also

Timestamp

Represents a specific timestamp.

Period

Represents a span of time.

to_period

Converts an object to a Period.

Examples

ts = pd.Timestamp('2020-03-14T15:32:52.192548651')

Year end frequency

ts.to_period(freq='Y') Period('2020', 'Y-DEC')

Month end frequency

ts.to_period(freq='M') Period('2020-03', 'M')

Weekly frequency

ts.to_period(freq='W') Period('2020-03-09/2020-03-15', 'W-SUN')

Quarter end frequency

ts.to_period(freq='Q') Period('2020Q1', 'Q-DEC')