first commit

2026-09-21 17:37:53 +08:00
commit 67d4dd5b7c
141 changed files with 8558 additions and 0 deletions
@@ -0,0 +1,68 @@
+import 'package:intl/intl.dart';
+
+/// billDate 标准格式 yyyy-MM-dd
+String formatDate(DateTime date) => DateFormat('yyyy-MM-dd').format(date);
+
+/// 解析后端日期字段，兼容 yyyy-MM-dd 与 yyyy-MM-ddTHH:mm:ss（LocalDateTime）两种格式
+String parseBillDate(String? raw) {
+  if (raw == null || raw.isEmpty) return formatDate(DateTime.now());
+  final tIndex = raw.indexOf('T');
+  if (tIndex > 0) return raw.substring(0, tIndex);
+  final spaceIndex = raw.indexOf(' ');
+  if (spaceIndex > 0) return raw.substring(0, spaceIndex);
+  return raw;
+}
+
+/// 解析后端日期为 DateTime，失败返回 null
+DateTime? tryParseDate(String? raw) {
+  if (raw == null || raw.isEmpty) return null;
+  return DateTime.tryParse(raw);
+}
+
+// ---------------- 月份 / 周 相关（首页、统计页用） ----------------
+
+/// 当月 1 日 00:00，作为月份锚点使用
+DateTime monthStart(DateTime date) => DateTime(date.year, date.month, 1);
+
+/// 当月最后一天 00:00。
+/// 用 day = 0 让 DateTime 自动回退到上个月最后一天，避免手算 28/30/31。
+DateTime monthEnd(DateTime date) => DateTime(date.year, date.month + 1, 0);
+
+/// 月份平移（delta 为月数，可为负），跨年由 DateTime 自动归一
+DateTime shiftMonth(DateTime month, int delta) =>
+    DateTime(month.year, month.month + delta, 1);
+
+/// 本周一 00:00（以周一为一周起点，对齐 uniApp 的 getWeekStart）
+DateTime weekStart(DateTime date) {
+  final d = DateTime(date.year, date.month, date.day);
+  return d.subtract(Duration(days: d.weekday - DateTime.monday));
+}
+
+/// 是否为同一个自然月
+bool isSameMonth(DateTime a, DateTime b) => a.year == b.year && a.month == b.month;
+
+/// 月份标题：2026年9月
+String formatMonthTitle(DateTime month) => '${month.year}年${month.month}月';
+
+const List<String> _weekdayNames = ['周一', '周二', '周三', '周四', '周五', '周六', '周日'];
+
+/// 分组头日期：今天 / 昨天 / 09-21 周一
+///
+/// 注意：不要用 DateFormat('EEEE', 'zh_CN')——本项目未调用
+/// initializeDateFormatting，会抛 LocaleDataException，所以手写星期名。
+String formatGroupDate(String billDate) {
+  final parsed = tryParseDate(billDate);
+  if (parsed == null) return billDate;
+
+  final today = DateTime.now();
+  final todayStart = DateTime(today.year, today.month, today.day);
+  final target = DateTime(parsed.year, parsed.month, parsed.day);
+  final diff = todayStart.difference(target).inDays;
+
+  if (diff == 0) return '今天';
+  if (diff == 1) return '昨天';
+
+  final mm = target.month.toString().padLeft(2, '0');
+  final dd = target.day.toString().padLeft(2, '0');
+  return '$mm-$dd ${_weekdayNames[target.weekday - 1]}';
+}