pandas.tseries.offsets.FY5253Quarter

classpandas.tseries.offsets.FY5253Quarter

Дата-смещение, увеличивающее дату до следующей даты бизнес-квартала для финансового года, состоящего из 52-53 недель.

Также известен как календарь 4-4-5.

Используется компаниями, которые хотят, чтобы их финансовый год всегда заканчивался в один и тот же день недели.

Это метод управления учетными периодами. Это распространенная структура календаря для некоторых отраслей, таких как розничная торговля, производство и индустрия парковок.

Для получения дополнительной информации см.: https://en.wikipedia.org/wiki/4-4-5_calendar

Год может заканчиваться:

• в последний день недели X месяца Y.

• в последний день недели X, ближайший к последнему дню месяца Y.

X - определенный день недели. Y - определенный месяц года.

startingMonth = 1 соответствует датам типа 31.01.2007, 30.04.2007, … startingMonth = 2 соответствует датам типа 28.02.2007, 31.05.2007, … startingMonth = 3 соответствует датам типа 30.03.2007, 29.06.2007, …

Parameters:

n:int

Количество бизнес-кварталов.

normalize:bool, default False

Нормализует начальные/конечные даты до полуночи перед генерацией диапазона дат.

weekday:int {0, 1, …, 6}, default 0

Определенное целое число для дня недели.

• 0 - понедельник

• 1 - вторник

• 2 - среда

• 3 - четверг

• 4 - пятница

• 5 - суббота

• 6 - воскресенье

startingMonth:int {1, 2, …, 12}, default 1

Месяц, в котором заканчиваются финансовые годы.

qtr_with_extra_week:int {1, 2, 3, 4}, default 1

Номер квартала, который имеет дополнительную неделю при необходимости.

variation:str, default “nearest”

Метод применения календаря 4-4-5.

Есть два варианта:

• “nearest” означает, что конец года - это weekday, ближайший к последнему дню месяца в году.

• “last” означает, что конец года - это последний weekday последнего месяца финансового года.

См. также

DateOffset

Стандартный тип приращения даты.

Примеры

В примере ниже значения параметров по умолчанию возвращают следующий бизнес-квартал для финансового года, состоящего из 52-53 недель.

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

С помощью параметра startingMonth можно указать месяц, в котором заканчиваются финансовые годы.

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

Бизнес-кварталы для финансового года, состоящего из 52-53 недель, можно задать с помощью параметров weekday и variation.

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

Атрибуты

base	Возвращает копию объекта смещения вызова с n=1 и всеми другими атрибутами, равными исходным.
freqstr	Возвращает строку, представляющую частоту.
kwds	Возвращает словарь дополнительных параметров для смещения.
n
name	Возвращает строку, представляющую основную частоту.
nanos
normalize
qtr_with_extra_week
rule_code
startingMonth
variation
weekday

Методы

copy()	Возвращает копию частоты.
get_rule_code_suffix()
get_weeks(dt)
is_anchored()	Возвращает булево значение, показывающее, является ли частота единичной частотой (n=1).
is_month_end(ts)	Возвращает булево значение, показывающее, происходит ли отметка времени в конце месяца.
is_month_start(ts)	Возвращает булево значение, показывающее, происходит ли отметка времени в начале месяца.
is_on_offset(dt)	Возвращает булево значение, показывающее, пересекается ли отметка времени с данной частотой.
is_quarter_end(ts)	Возвращает булево значение, показывающее, происходит ли отметка времени в конце квартала.
is_quarter_start(ts)	Возвращает булево значение, показывающее, происходит ли отметка времени в начале квартала.
is_year_end(ts)	Возвращает булево значение, показывающее, происходит ли отметка времени в конце года.
is_year_start(ts)	Возвращает булево значение, показывающее, происходит ли отметка времени в начале года.
rollback(dt)	Перемещает указанную дату назад до следующего смещения только в том случае, если она не на смещении.
rollforward(dt)	Перемещает указанную дату вперед до следующего смещения только в том случае, если она не на смещении.
year_has_extra_week(dt)