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

Parameters:
nint

The number of fiscal years represented.

normalizebool, default False

Normalize start/end dates to midnight before generating date range.

weekdayint {0, 1, …, 6}, default 0

A specific integer for the day of the week.

  • 0 is Monday

  • 1 is Tuesday

  • 2 is Wednesday

  • 3 is Thursday

  • 4 is Friday

  • 5 is Saturday

  • 6 is Sunday.

startingMonthint {1, 2, … 12}, default 1

The month in which the fiscal year ends.

variationstr, default “nearest”

Method of employing 4-4-5 calendar.

There are two options:

  • “nearest” means year end is weekday closest to last day of month in year.

  • “last” means year end is final weekday of the final month in fiscal year.

Attributes

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.

Methods

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.

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')
On this page