ҚjDdZddlmZddlmZddlmZd dZd dZd dZ y) u Date utilities — month-end-safe arithmetic using dateutil.relativedelta. Convention (documented here and enforced everywhere in this codebase): Jan 31 + 1 month = Feb 28 (or Feb 29 in a leap year) — NOT Mar 3. This uses dateutil.relativedelta which naturally clamps to month-end. All budget cycles, bill recurrence, and amortization projections MUST use these helpers. No per-module date arithmetic. ) annotations)date relativedeltac |t|zS)a" Add (or subtract) a whole number of months to a date, clamping to month-end. Examples: add_months(date(2026, 1, 31), 1) -> date(2026, 2, 28) add_months(date(2026, 3, 31), -1) -> date(2026, 2, 28) add_months(date(2026, 2, 28), 1) -> date(2026, 3, 28) )monthsr)dtrs 0/var/www/html/financials/app/utils/date_utils.py add_monthsr s  V, ,,c&|jdS)z2Return the first day of the month containing `dt`.day)replacer s r month_startrs ::!: r c |tdzS)z1Return the last day of the month containing `dt`.rrrs r month_endr#s "% %%r N)r rrintreturnr)r rrr) __doc__ __future__rdatetimerdateutil.relativedeltarr rrr r rs$ #0 - &r