diff --git a/pandas/_libs/tslibs/period.pyx b/pandas/_libs/tslibs/period.pyx index e954ec9bccd9e..2ec0649110948 100644 --- a/pandas/_libs/tslibs/period.pyx +++ b/pandas/_libs/tslibs/period.pyx @@ -1917,7 +1917,8 @@ cdef class _Period(PeriodMixin): Parameters ---------- freq : str, BaseOffset - The desired frequency. + The desired frequency. If passing a `str`, it needs to be a + valid :ref:`period alias `. how : {'E', 'S', 'end', 'start'}, default 'end' Start or end of the timespan.