pandas.core.groupby.DataFrameGroupBy.shift

DataFrameGroupBy.shift(periods=1, freq=None, axis=0, fill_value=None)[source]

Shift each group by periods observations.

If freq is passed, the index will be increased using the periods and the freq.

Parameters:
periodsint, default 1

Number of periods to shift.

freqstr, optional

Frequency string.

axisaxis to shift, default 0

Shift direction.

fill_valueoptional

The scalar value to use for newly introduced missing values.

Returns:
Series or DataFrame

Object shifted within each group.

See also

Index.shift

Shift values of Index.

tshift

Shift the time index, using the index’s frequency if available.