pandas.tseries.offsets.FY5253#

class pandas.tseries.offsets.FY5253#

Describes 52-53 week fiscal year. This is also known as a 4-4-5 calendar.

It is used by companies that desire that their fiscal year always end on the same day of the week.

It is a method of managing accounting periods. It is a common calendar structure for some industries, such as retail, manufacturing and parking industry.

For more information see: https://en.wikipedia.org/wiki/4-4-5_calendar

The year may either:

  • end on the last X day of the Y month.

  • end on the last X day closest to the last day of the Y month.

X is a specific day of the week. Y is a certain month of the year

Attributes

n

Return the count of the number of periods.

normalize

Return boolean whether the frequency can align with midnight.

weekday

Return the weekday used by the fiscal year.

startingMonth

Return the starting month of the fiscal year.

variation

Return the variation of the fiscal year.

See also

DateOffset

Standard kind of date increment.

Examples

In the example below the default parameters give the next 52-53 week fiscal year.

>>> ts = pd.Timestamp(2022, 1, 1)
>>> ts + pd.offsets.FY5253()
Timestamp('2022-01-31 00:00:00')

By the parameter startingMonth we can specify the month in which fiscal years end.

>>> ts = pd.Timestamp(2022, 1, 1)
>>> ts + pd.offsets.FY5253(startingMonth=3)
Timestamp('2022-03-28 00:00:00')

52-53 week fiscal year can be specified by weekday and variation parameters.

>>> ts = pd.Timestamp(2022, 1, 1)
>>> ts + pd.offsets.FY5253(weekday=5, startingMonth=12, variation="last")
Timestamp('2022-12-31 00:00:00')

Attributes

base

Returns a copy of the calling offset object with n=1 and all other attributes equal.

freqstr

Return a string representing the frequency.

kwds

Return a dict of extra parameters for the offset.

n

Return the count of the number of periods.

name

Return a string representing the base frequency.

nanos

Returns an integer of the total number of nanoseconds for fixed frequencies.

normalize

Return boolean whether the frequency can align with midnight.

rule_code

Return a string representing the frequency with fiscal year suffix.

startingMonth

Return the starting month of the fiscal year.

variation

Return the variation of the fiscal year.

weekday

Return the weekday used by the fiscal year.

Methods

copy()

Return a copy of the frequency.

get_rule_code_suffix()

Return the suffix component of the rule code.

get_year_end(dt)

Get the fiscal year end date for the given datetime.

is_month_end(ts)

Return boolean whether a timestamp occurs on the month end.

is_month_start(ts)

Return boolean whether a timestamp occurs on the month start.

is_on_offset(dt)

Return boolean whether a timestamp intersects with this frequency.

is_quarter_end(ts)

Return boolean whether a timestamp occurs on the quarter end.

is_quarter_start(ts)

Return boolean whether a timestamp occurs on the quarter start.

is_year_end(ts)

Return boolean whether a timestamp occurs on the year end.

is_year_start(ts)

Return boolean whether a timestamp occurs on the year start.

rollback(dt)

Roll provided date backward to next offset only if not on offset.

rollforward(dt)

Roll provided date forward to next offset only if not on offset.