本文讲解如何修改时间类设计，避免因归一化处理（如取模）丢失原始输入值，从而确保 getSeconds() 方法返回基于用户原始输入而非归一化后时间的总秒数。
本文讲解如何修改时间类设计，避免因归一化处理（如取模）丢失原始输入值，从而确保 `getseconds()` 方法返回基于用户原始输入而非归一化后时间的总秒数。
在开发时间处理类（如 CHTime）时，一个常见误区是：将归一化逻辑（如 hour % 24、进位修正）直接写入构造函数并覆盖原始输入字段，导致后续无法还原用户原始输入意图。正如示例中所示——当用户输入 331 小时 34 分钟 674 秒 时，构造函数立即执行：
this.chSec = chSec % 60; // 674 % 60 → 14 this.chHr = chHr % 24; // 331 % 24 → 19 this.chMin = (chMin + chSec / 60) % 60; // (34 + 11) % 60 → 45
这使得 chHr、chMin、chSec 字段永久丢失了原始值（331、34、674），而 getSeconds() 仅能基于归一化后的 19:45:14 计算出 71114 秒——这并非用户期望的“原始输入对应的总秒数”（即 331×3600 + 34×60 + 674 = 1194314）。
✅ 正确解决方案：分离存储与展示逻辑
核心原则是：保留原始输入数据用于业务计算，仅在需要格式化显示时进行归一化。推荐两种实现方式：
方案一：新增私有字段存储原始输入（推荐）
在 CHTime 类中增加 originalHours、originalMinutes、originalSeconds 字段，在构造函数中保存原始值，并让 getSeconds() 基于它们计算：
public class CHTime implements Comparable<CHTime> {
private int chHr, chMin, chSec; // 归一化后用于显示的值（0–23, 0–59, 0–59）
private final int originalHours, originalMinutes, originalSeconds; // 原始输入，只读
public CHTime(int hours, int minutes, int seconds) {
this.originalHours = hours;
this.originalMinutes = minutes;
this.originalSeconds = seconds;
// 归一化逻辑（仅用于 toString / getHour 等展示方法）
int totalSec = seconds + minutes * 60 + hours * 3600;
this.chSec = totalSec % 60;
int totalMin = totalSec / 60;
this.chMin = totalMin % 60;
this.chHr = (totalMin / 60) % 24;
}
// ✅ 此处返回原始输入换算的总秒数（关键修复！）
public long getSeconds() {
return (long) originalHours * 3600 + originalMinutes * 60 + originalSeconds;
}
// 展示用方法仍基于归一化值
public int getHour() { return chHr; }
public int getMinute() { return chMin; }
public int getSecond() { return chSec; }
@Override
public String toString() {
return chHr + " hours " + chMin + " minutes " + chSec + " seconds";
}
}方案二：重构为“单源真相”——仅存总秒数（更简洁）
彻底放弃分别存储 chHr/chMin/chSec，内部统一以总秒数（long totalSeconds）为核心字段，所有 getter 和 toString() 均动态计算：
public class CHTime implements Comparable<CHTime> {
private final long totalSeconds; // 唯一真实数据源
public CHTime(int hours, int minutes, int seconds) {
this.totalSeconds = (long) hours * 3600 + minutes * 60L + seconds;
}
public long getSeconds() {
return totalSeconds; // 直接返回，零误差
}
public int getHour() {
return (int) ((totalSeconds / 3600) % 24);
}
public int getMinute() {
return (int) ((totalSeconds / 60) % 60);
}
public int getSecond() {
return (int) (totalSeconds % 60);
}
@Override
public String toString() {
int h = getHour(), m = getMinute(), s = getSecond();
return h + " hours " + m + " minutes " + s + " seconds";
}
}✅ 优势：逻辑更清晰、无状态冗余、天然支持任意大小输入（如 10000 小时）、getSeconds() 永远准确。
⚠️ 注意事项与最佳实践
- 不要在构造函数中破坏性修改输入值：若需归一化，应通过临时变量或新字段完成，避免覆盖原始语义。
- 明确字段职责：区分“存储字段”（source of truth）与“缓存字段”（performance optimization）。若使用缓存，务必保证其与源头严格同步。
- 对 long 运算保持警惕：hours * 3600 可能溢出 int，务必显式使用 long 字面量（如 3600L）或强制类型转换。
- 单元测试覆盖边界值：验证 getSeconds() 对 24:0:0、1000:0:0、0:0:61 等输入是否返回预期结果。
通过以上重构，你的 CHTime 类既能正确显示归一化后的时间（如 19:45:14），又能精准提供原始输入对应的总秒数（1194314），真正满足“接受原始输入而非仅处理归一化结果”的设计目标。
