WPF 客户卡右上角的“3 天前”:相对时间别用 TotalDays,封面和时间要跟着年份走
做 LeafArchive 时,客户墙上有 529 张客户卡,每张卡右上角只写一行小字:“今天”“3 天前”“2 个月前”。不写完整日期,是因为墙上要扫一眼就知道哪个客户最近有动静,完整日期反而要多想一步。这行小字看起来简单,里面有两层选择值得单独写一篇:相对时间到底按什么算,以及卡片点年份时,封面和时间为什么必须一起换。
## 相对时间按日历天算,不按 24 小时算
相对时间只有一个方法,`RelativeTime.Label`,二十行不到:
```csharp
public static string Label(DateTime time)
{
if (time <= DateTime.MinValue.AddDays(1)) return "";
DateTime today = DateTime.Today;
int days = (today - time.Date).Days;
if (days <= 0) return "今天";
if (days < 30) return days + " 天前";
if (days < 365) return (days / 30) + " 个月前";
return (days / 365) + " 年前";
}
```
关键在第三行:先把时间截成日期再相减。`time.Date` 把时分秒清掉,`DateTime.Today` 本身就是当天的 0 点,相减得到的 `days` 是日历天数,不是 24 小时的倍数。昨天 23 点改的文件,今天 1 点打开就是“1 天前”,哪怕中间只隔了 2 个小时;反过来,今天凌晨 1 点改的、下午 3 点打开,还是“今天”。墙上要的就是这种“昨天 / 今天”的体感,不是精确到小时的计时。
顺手写 `(DateTime.Now - time).TotalDays` 反而会错。`TotalDays` 是个 double,昨天 23 点到今天 1 点只有 0.08 天,取整就是 0 天,显示“今天”;但用户心里那是昨天的事。两种算法只在跨午夜那几个小时里打架,偏偏墙上最常看的就是“昨天刚改的客户”,错的全是高频情况。所以相对时间这种地方,先截日期再相减,别直接拿时间间隔取整。
月份和年份是整除,不是四舍五入:29 天还是“29 天前”,满 30 天才变“1 个月前”;364 天是“12 个月前”,满 365 天才变“1 年前”。`days / 30` 和 `days / 365` 都是整数除法,向下取,边界干净,不会出现“0 个月前”这种怪话。第一行的哨兵值也别漏:时间是 `DateTime.MinValue` 附近就返回空串,不显示时间——没有改动时间的客户,墙上不该凭空出现一个“今天”。
还有一个时区的前提:库里 `mtime` 存的是 UTC 的 tick,读出来要先转本地时间再算。`IndexDatabase.ReadFile` 和 `GetCustomers` 里都是 `new DateTime(ticks, DateTimeKind.Utc).ToLocalTime()`。这一步漏了,`time.Date` 就是 UTC 的日期,北京时间早上 8 点前改的文件,日期会差一天,“今天”变“1 天前”。存 UTC、显示转本地,相对时间算的是本地的日历天,这三步缺一不可。
## 同一个程序里,“30 天”有两个意思
顺带提一句,同一个程序里“30 天”出现了两次,意思并不一样。墙面左侧的“最近”筛选在 `MainViewModel.ApplyWallFilter` 里:
```csharp
q = q.Where(c => !c.Archived && (DateTime.Now - c.LastModified).TotalDays <= 30);
```
这里用的是 `TotalDays`,是滚动的 30×24 小时:30 天零 1 小时前改的客户就被筛掉了。而卡片右上角的“30 天前”用的是日历天,30 个日历天前改的,显示“1 个月前”。筛选要的是精确的窗口,显示要的是人的体感,两个地方各取所需。写的时候别想着“统一成一种算法”,先问清楚这个数字是给机器筛的,还是给人看的。
## 封面和时间要跟着年份一起换
右上角的时间还有第二层:它不是一张卡一个固定值,而是跟着选中的年份走的。`CustomerCardViewModel` 里有两个时间属性:
```csharp
public string RelativeLabel { get { return RelativeTime.Label(Model.LastModified); } }
private string _yearRelativeLabel;
public string YearRelativeLabel
{
get { return _yearRelativeLabel ?? RelativeLabel; }
private set { Set(ref _yearRelativeLabel, value); }
}
```
`Model.LastModified` 是这个客户所有年份里最近的改动时间,`RelativeLabel` 就是全客户口径。墙上真正绑的却是 `YearRelativeLabel`——点年份之前它还没值,`??` 让它先 fallback 到全客户口径;卡片封面一加载完,它就被改成选中年份里最新那个文件的改动时间。也就是说,点 2024 年,封面换成 2024 年最近的 3 个文件,右上角也换成 2024 年最近一次改动的时间;不点年份,默认选中最新年份,显示的就是最新年份的时间。时间跟封面是同一批数据算出来的,不会出现“封面是 2024 年的文件,时间却是 2025 年的”这种错位。
封面本身也是按选中年份现查的,不是从客户汇总里直接拿。`LoadCovers` 里:
```csharp
var files = _db.GetRecentFiles(Model.Name, _selectedYear, 3);
if (files.Count > 0) YearRelativeLabel = RelativeTime.Label(files[0].Modified);
```
`GetRecentFiles` 是 `WHERE customer=$c AND year=$y ORDER BY mtime DESC LIMIT 3`,取的就是这个年份最近改动的 3 个文件,`files[0]` 是其中最新的一个,时间就取它的 `Modified`。然后 3 个文件并行取 480 像素的缩略图(`ThumbnailService.GetAsync(p, 480)`,`Task.WhenAll` 一起等),回 UI 线程再依次赋给 `Cover1`、`Cover2`、`Cover3`。先清掉旧封面再赋值,点年份换封面时不会先闪一下旧图。
墙面刷新时每张卡都会调一次 `LoadCovers`(`MainViewModel.ApplyWallFilter` 里建卡就调),点年份时 `WallView.xaml.cs` 的 `Card_Click` 里也会调——先判 `SelectedYear` 变了才调,没变不重复加载。两个入口调的是同一个方法,封面和时间的口径不会各写一套。
## 容易漏的四个点
一是年份切换没有取消。`LoadCovers` 是 `async void`,里面没有任何取消标记。连续快速点两个年份,两次加载都在跑,后跑完的那次会覆盖先跑完的——如果先点的年份后返回,封面和时间就停在了先点的年份上。529 张卡平时点得慢,这问题撞不上;但写 `async void` 的加载方法时,顺手加个版本号或取消标记,比事后排查“为什么封面和年份对不上”便宜得多。
二是该年份没有文件时,时间不会更新。`YearRelativeLabel` 只在 `files.Count > 0` 时才赋值,查不到文件就保持上一次的值。年份列表里的年份都是客户真实有文件的年份,正常点不到空年份;但“0 = 未分年份”那一档如果某天没有文件,时间就会停在上一个年份的值上。赋值之前先想好空结果时显示什么,别只处理有结果的那条路。
三是封面清掉和时间更新不在同一个时刻。`LoadCovers` 先把 `Cover1` 到 `Cover3` 置空,再等缩略图回来赋值;`YearRelativeLabel` 却在查库回来后立刻就改了。时间先变、封面后变,中间有半拍是“新时间配旧封面”(旧封面已被清掉,实际是空封面配新时间)。半拍很短,但这个顺序写在代码里是固定的:时间是查库就能算的,封面要等图片解码,两个的到达时间本来就不一样。
四是详情页和文件卡用的也是同一个 `Label`。`CustomerDetailViewModel.RelativeLabel` 和 `FileCardViewModel.RelativeLabel` 都调 `RelativeTime.Label`,墙上、详情页、文件行三处显示的是同一套算法。相对时间这种小工具一旦三处各写一份,改天“30 天改成 7 天显示周”就得改三处,迟早漏一处。二十行的方法抽出来共用,比每个 ViewModel 里写一遍便宜。
## 小结
这行小字的取舍就两句:相对时间按本地的日历天算,不按 24 小时算;封面和时间是同一批数据,跟着选中的年份一起换。代码不多,但每个边界都有交代:跨午夜按天算、月份年份整除、UTC 存本地算、筛选和显示各用各的“30 天”、快速点年份没有取消、空年份不更新时间。跟前面几篇一样,WPF 里顺手的那一行,往往就是要多想一步的那一行。
- 点赞
- 收藏
- 关注作者
评论(0)