feat: add fortnightly interval

In some countries (such as Australia), it is very common for wages to be paid on a fortnightly basis, that is, every 2 weeks. As a result, a number of other expenses are also paid on a fortnightly basis. This commit extends the `Interval` enum by adding a `FORTNIGHT` option. I have added a test for that, and have updated the translations where possible (not that other than for English and French, the other translations may be suboptimal). As part of this commit, I have also taken the opportunity to fix some errors with the use of ISO weeks. In particular, the year corresponding to an ISO week is _not_ always the same as the calendar year of the date. Resolves: beancount#1939 Signed-off-by: JP-Ellis <[email protected]>
JP-Ellis · Feb 4, 2025 · f17eb1b · f17eb1b
1 parent ad5412a
commit f17eb1b
Show file tree

Hide file tree

Showing 19 changed files with 242 additions and 78 deletions.
diff --git a/frontend/src/format.ts b/frontend/src/format.ts
@@ -13,31 +13,31 @@ import type { Interval } from "./lib/interval";
  * @param precision - The number of decimal digits to show.
  */
 export function localeFormatter(
-  locale: string | null,
-  precision = 2,
+	locale: string | null,
+	precision = 2,
 ): (num: number) => string {
-  if (locale == null) {
-    return format(`.${precision.toString()}f`);
-  }
-  // this needs to be between 0 and 20
-  const digits = Math.max(0, Math.min(precision, 20));
-  const fmt = new Intl.NumberFormat(locale.replace("_", "-"), {
-    minimumFractionDigits: digits,
-    maximumFractionDigits: digits,
-  });
-  return fmt.format.bind(fmt);
+	if (locale == null) {
+		return format(`.${precision.toString()}f`);
+	}
+	// this needs to be between 0 and 20
+	const digits = Math.max(0, Math.min(precision, 20));
+	const fmt = new Intl.NumberFormat(locale.replace("_", "-"), {
+		minimumFractionDigits: digits,
+		maximumFractionDigits: digits,
+	});
+	return fmt.format.bind(fmt);
 }
 
 const formatterPer = format(".2f");
 export function formatPercentage(number: number): string {
-  return `${formatterPer(Math.abs(number) * 100)}%`;
+	return `${formatterPer(Math.abs(number) * 100)}%`;
 }
 
 export interface FormatterContext {
-  /** Render an amount to a string like "2.00 USD". */
-  amount: (num: number, currency: string) => string;
-  /** Render an number for a currency like "2.00". */
-  num: (num: number, currency: string) => string;
+	/** Render an amount to a string like "2.00 USD". */
+	amount: (num: number, currency: string) => string;
+	/** Render an number for a currency like "2.00". */
+	num: (num: number, currency: string) => string;
 }
 
 type DateFormatter = (date: Date) => string;
@@ -47,27 +47,43 @@ export const day = utcFormat("%Y-%m-%d");
 
 /** Date formatters for human consumption. */
 export const dateFormat: Record<Interval, DateFormatter> = {
-  year: utcFormat("%Y"),
-  quarter: (date) =>
-    `${date.getUTCFullYear().toString()}Q${(Math.floor(date.getUTCMonth() / 3) + 1).toString()}`,
-  month: utcFormat("%b %Y"),
-  week: utcFormat("%YW%W"),
-  day,
+	year: utcFormat("%Y"),
+	quarter: (date) =>
+		`${date.getUTCFullYear().toString()}Q${(Math.floor(date.getUTCMonth() / 3) + 1).toString()}`,
+	month: utcFormat("%b %Y"),
+	// Since fortnights don't have a standard format, we extend the week format.
+	// For example: `2025W01-02` for the first fortnight of 2025, `2025W03-04` for
+	// the second fortnight of 2025, etc.
+	fortnight: (date) => {
+		const year = Number.parseInt(utcFormat("%G")(date));
+		const week = Number.parseInt(utcFormat("%V")(date));
+		const [w1, w2] = week % 2 === 0 ? [week - 1, week] : [week, week + 1];
+		return `${year.toString()}W${w1.toString().padStart(2, "0")}/${w2.toString().padStart(2, "0")}`;
+	},
+	week: utcFormat("%GW%W"),
+	day,
 };
 
 /** Date formatters for the entry filter form. */
 export const timeFilterDateFormat: Record<Interval, DateFormatter> = {
-  year: utcFormat("%Y"),
-  quarter: (date) =>
-    `${date.getUTCFullYear().toString()}-Q${(Math.floor(date.getUTCMonth() / 3) + 1).toString()}`,
-  month: utcFormat("%Y-%m"),
-  week: utcFormat("%Y-W%W"),
-  day,
+	year: utcFormat("%Y"),
+	quarter: (date) =>
+		`${date.getUTCFullYear().toString()}-Q${(Math.floor(date.getUTCMonth() / 3) + 1).toString()}`,
+	month: utcFormat("%Y-%m"),
+	// See `dateFormat` implementation for reasoning of fortnight format.
+	fortnight: (date) => {
+		const year = Number.parseInt(utcFormat("%G")(date));
+		const week = Number.parseInt(utcFormat("%V")(date));
+		const [w1, w2] = week % 2 === 0 ? [week - 1, week] : [week, week + 1];
+		return `${year.toString()}-W${w1.toString().padStart(2, "0")}/${w2.toString().padStart(2, "0")}`;
+	},
+	week: utcFormat("%G-W%V"),
+	day,
 };
 
 const local_day = timeFormat("%Y-%m-%d");
 
 /** Today as a ISO-8601 date string. */
 export function todayAsString(): string {
-  return local_day(new Date());
+	return local_day(new Date());
 }
diff --git a/frontend/src/lib/interval.ts b/frontend/src/lib/interval.ts
@@ -1,28 +1,36 @@
 import { _ } from "../i18n";
 
-export type Interval = "year" | "quarter" | "month" | "week" | "day";
+export type Interval =
+	| "year"
+	| "quarter"
+	| "month"
+	| "fortnight"
+	| "week"
+	| "day";
 
 export const DEFAULT_INTERVAL: Interval = "month";
 
 export const INTERVALS: Interval[] = [
-  "year",
-  "quarter",
-  "month",
-  "week",
-  "day",
+	"year",
+	"quarter",
+	"month",
+	"fortnight",
+	"week",
+	"day",
 ];
 
 export function getInterval(s: string | null): Interval {
-  return INTERVALS.includes(s as Interval) ? (s as Interval) : DEFAULT_INTERVAL;
+	return INTERVALS.includes(s as Interval) ? (s as Interval) : DEFAULT_INTERVAL;
 }
 
 /** Get the translateable label for an interval. */
 export function intervalLabel(s: Interval): string {
-  return {
-    year: _("Yearly"),
-    quarter: _("Quarterly"),
-    month: _("Monthly"),
-    week: _("Weekly"),
-    day: _("Daily"),
-  }[s];
+	return {
+		year: _("Yearly"),
+		quarter: _("Quarterly"),
+		month: _("Monthly"),
+		fortnight: _("Fortnightly"),
+		week: _("Weekly"),
+		day: _("Daily"),
+	}[s];
 }
diff --git a/src/fava/core/budgets.py b/src/fava/core/budgets.py
@@ -103,6 +103,7 @@ def parse_budgets(
     interval_map = {
         "daily": Interval.DAY,
         "weekly": Interval.WEEK,
+        "fortnightly": Interval.FORTNIGHT,
         "monthly": Interval.MONTH,
         "quarterly": Interval.QUARTER,
         "yearly": Interval.YEAR,

diff --git a/src/fava/help/budgets.md b/src/fava/help/budgets.md
@@ -6,17 +6,18 @@ Beancount file:
 <pre><textarea is="beancount-textarea">
 2012-01-01 custom "budget" Expenses:Coffee       "daily"         4.00 EUR
 2013-01-01 custom "budget" Expenses:Books        "weekly"       20.00 EUR
+2013-01-01 custom "budget" Expenses:Fuel         "fortnightly"  60.00 EUR
 2014-02-10 custom "budget" Expenses:Groceries    "monthly"      40.00 EUR
 2015-05-01 custom "budget" Expenses:Electricity  "quarterly"    85.00 EUR
 2016-06-01 custom "budget" Expenses:Holiday      "yearly"     2500.00 EUR</textarea></pre>
 
 If budgets are specified, Fava's reports and charts will display remaining
 budgets and related information.
 
-The budget directives can be specified `daily`, `weekly`, `monthly`, `quarterly`
-and `yearly`. The specified budget is valid until another budget directive for
-the account is specified. The budget is broken down to a daily budget, and
-summed up for a range of dates as needed.
+The budget directives can be specified `daily`, `weekly`, `fortnightly`,
+`monthly`, `quarterly` and `yearly`. The specified budget is valid until another
+budget directive for the account is specified. The budget is broken down to a
+daily budget, and summed up for a range of dates as needed.
 
 This makes the budgets very flexible, allowing for a monthly budget, being taken
 over by a weekly budget, and so on.

diff --git a/src/fava/translations/bg/LC_MESSAGES/messages.po b/src/fava/translations/bg/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Тримесечен"
 msgid "Monthly"
 msgstr "Месечен"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "На всеки две седмици"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Седмичен"
@@ -592,4 +596,3 @@ msgstr "Изтриване..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/ca/LC_MESSAGES/messages.po b/src/fava/translations/ca/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Per trimestre"
 msgid "Monthly"
 msgstr "Per mes"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Per quinzena"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Per setmana"
@@ -592,4 +596,3 @@ msgstr "S'està suprimint..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/de/LC_MESSAGES/messages.po b/src/fava/translations/de/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Quartalsweise"
 msgid "Monthly"
 msgstr "Monatlich"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Zweiwöchentlich"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Wöchentlich"
@@ -592,4 +596,3 @@ msgstr "Wird gelöscht..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr "Journal-Eintrag hinzufügen"
-
diff --git a/src/fava/translations/fa/LC_MESSAGES/messages.po b/src/fava/translations/fa/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "سه‌ماهه"
 msgid "Monthly"
 msgstr "ماهانه"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "هر دو هفته یکبار"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "هفتگی"
@@ -592,4 +596,3 @@ msgstr ""
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/fr/LC_MESSAGES/messages.po b/src/fava/translations/fr/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Trimestriel"
 msgid "Monthly"
 msgstr "Mensuel"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Bimensuel"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Hebdomadaire"
@@ -592,4 +596,3 @@ msgstr "Suppression..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/nl/LC_MESSAGES/messages.po b/src/fava/translations/nl/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Per kwartaal"
 msgid "Monthly"
 msgstr "Maandelijks"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Tweewekelijks"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Wekelijks"
@@ -592,4 +596,3 @@ msgstr ""
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/pt_BR/LC_MESSAGES/messages.po b/src/fava/translations/pt_BR/LC_MESSAGES/messages.po
@@ -432,6 +432,10 @@ msgstr "Trimestral"
 msgid "Monthly"
 msgstr "Mensal"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Quinzenal"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Semanal"
@@ -593,4 +597,3 @@ msgstr "Apagando..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr "Adicionar Entrada"
-
diff --git a/src/fava/translations/ru/LC_MESSAGES/messages.po b/src/fava/translations/ru/LC_MESSAGES/messages.po
@@ -430,6 +430,10 @@ msgstr "По кварталам"
 msgid "Monthly"
 msgstr "По месяцам"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Каждые две недели"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "По неделям"
@@ -591,4 +595,3 @@ msgstr ""
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/sk/LC_MESSAGES/messages.po b/src/fava/translations/sk/LC_MESSAGES/messages.po
@@ -436,6 +436,10 @@ msgstr "Kvartálne"
 msgid "Monthly"
 msgstr "Mesačne"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Dvotýždenne"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Týždenne"
@@ -597,4 +601,3 @@ msgstr ""
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/sv/LC_MESSAGES/messages.po b/src/fava/translations/sv/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Kvartalsvis"
 msgid "Monthly"
 msgstr "Månatligt"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "Var fjortonde dag"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Veckovis"
@@ -592,4 +596,3 @@ msgstr ""
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/uk/LC_MESSAGES/messages.po b/src/fava/translations/uk/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "Щоквартально"
 msgid "Monthly"
 msgstr "Щомісячно"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "двотижневий"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "Щотижнево"
@@ -592,4 +596,3 @@ msgstr ""
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-
diff --git a/src/fava/translations/zh/LC_MESSAGES/messages.po b/src/fava/translations/zh/LC_MESSAGES/messages.po
@@ -431,6 +431,10 @@ msgstr "按季"
 msgid "Monthly"
 msgstr "按月"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "按两周"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "按周"
@@ -592,4 +596,3 @@ msgstr "正在删除..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr "添加日记账条目"
-
diff --git a/src/fava/translations/zh_Hant_TW/LC_MESSAGES/messages.po b/src/fava/translations/zh_Hant_TW/LC_MESSAGES/messages.po
@@ -432,6 +432,10 @@ msgstr "季度"
 msgid "Monthly"
 msgstr "月"
 
+#: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
+msgid "Fortnightly"
+msgstr "兩周"
+
 #: frontend/src/lib/interval.ts:25 src/fava/util/date.py:105
 msgid "Weekly"
 msgstr "週"
@@ -594,4 +598,3 @@ msgstr "正在删除..."
 #: frontend/src/sidebar/AsideContents.svelte:60
 msgid "Add Journal Entry"
 msgstr ""
-