日期工具的输入边界:把天数偏移、区间差与界面状态分开
日期工具看起来只是选择日期、输入天数、显示结果,但“相差几天”和“向后移动几天”其实回答不同的问题。阅读鸿蒙实践中心的计算器应用模板后,可以把这类组件的设计拆成三部分:先定义日期规则,再集中处理计算,最后维护界面状态。本文是设计分析,不代表已在设备上运行或完成性能验证。
一、先写清楚产品中的“天”
日期间隔有多种表达方式:两个日历日期之间相隔几天、包含首尾日期的天数、带方向的日期差。它们不能共用一个含糊的“天数”标签。例如,11月10日到11月11日的日期差为1;若产品要求首尾都计入,则覆盖2个日历日期。同一天的日期差为0,覆盖日期数为1。界面应在结果旁说明规则,避免使用者凭经验猜测。
偏移计算则是给定起始日期和整数偏移量,得到目标日期。通常可约定偏移0天仍为原日期,向后1天为下一日,向前1天为上一日。负数是否允许、最大范围有多大,都需要作为输入规则说明。日期间隔是否取绝对值,也要独立决定,不能因为另一个功能支持负数就自动沿用。
二、让快捷项复用同一条计算路径
新增“7天”“30天”按钮时,按钮只负责更新偏移量,再调用原有日期计算函数。不要为每个按钮单独拼接结果字符串,也不要把月份长度写成固定30天。手动输入和快捷选择应经过相同的类型校验、范围校验和结果格式化,否则同样输入可能得到不同结果。
一种清晰的数据流是:起始日期与偏移量组成输入状态;校验通过后形成计算参数;纯计算函数返回目标日期;显示层负责格式化和提示。快捷按钮只改变输入状态。这样修改默认值、补充新快捷项时,不必同步维护多份算法。
三、区分日历日期与时间点
如果业务只处理年月日,数据模型应明确表示日历日期;如果还处理预约时间、时区和时间戳,则需要补充时间语义。不要把二者混为一个字符串,再靠运行环境猜测解析方式。接收输入时逐项检查年月日是否合法,拒绝空值、非整数偏移和超出支持范围的日期。
对于包含时间点的功能,固定毫秒数的加减与日历日期的前后移动可能有不同语义。实现前应先确定用户希望保持的是当地日期、当地时刻还是经过时长,再选择与平台能力匹配的算法。只有日期的工具,也应避免把无关的设备时区带入持久化格式。
四、把取消、重置和错误当作正式状态
用户打开日期选择器后取消,应保留取消前的已提交日期;点击重置,应明确恢复哪个起始日期、哪个偏移量,以及是否清除旧结果。无效输入出现时,不能继续展示一个看似属于新输入的旧结果。可以清空结果,或明确标为“上次有效结果”,同时显示当前校验错误。
输入状态与已计算结果最好分别保存。只有输入有效且计算成功,才更新结果。若计算过程异步化,还需要防止较早请求覆盖较晚输入对应的结果;本地同步计算则不必为此增加无用的网络层。
五、用少量边界用例覆盖规则
验证计划至少应覆盖:偏移0、正负1、7和30;跨月、跨年、闰年2月边界;同一天、相邻日期和反向区间;空输入、小数、超范围整数;取消选择、重置后再次计算。每条用例都同时记录输入、所选计日规则、期望值和实际值,不能只写“日期功能正常”。
例如,在“不额外计入起始日”的规则下,2026年12月31日向后1天应得到2027年1月1日;2028年2月28日向后1天应得到2月29日。这些是预期值示例,仍需在实际实现和目标设备上验证。确认计算规则后,再补充界面回归,比只检查按钮是否能点击更有价值。
阅读入口:https://harmonybp.developer.huaweicloud.com/cases/ee08ba32e1f14631b37a4596f8011d29
本文使用AI辅助整理,未引用账号、账单或个人信息。
- 点赞
- 收藏
- 关注作者
评论(0)