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.

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`
`name`	Return a string representing the base frequency.
`nanos`
`normalize`
`rule_code`
`startingMonth`
`variation`
`weekday`

Methods

`copy`()	Return a copy of the frequency.
`get_rule_code_suffix`()
`get_year_end`(dt)
`is_anchored`()	Return boolean whether the frequency is a unit frequency (n=1).
`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.