跳到正文
定位、使用者与职责边界
定位、使用者与职责边界
搜索 YUDS 文档

YUDS 文档

指标、数值与时间格式

一个数值要带哪些上下文,零与非数值状态如何区分,以及数字、货币、比例与时间的格式和精度规则。

状态:本页规定指标、数值、货币与时间的表达要求,沿用六条设计原则;不批准业务指标字典或计算规则,确认条件、公式、精度、舍入与汇率由产品定义。验收数据集、DSP-MONEY 夹具,以及四端格式、读屏、复制与实际导出验证均未执行。 更新:2026-10-19(来源核查)。 所属章节:数据表达与分析

本页不批准业务指标字典或计算规则,沿用六条设计原则。共同设计与验收边界见基础组件与交互契约,本页的特殊条件与来源限制就近说明。

1. 一个数值的完整含义

展示数值前,产品应说明指标身份、单位、币种或计量尺度、期间、统计范围、分母或聚合口径、数据性质、精度、质量状态和必要来源。界面可以在共同表头中集中说明,但值被复制、展开、下钻或导出后仍应保有必要上下文。

“收入 12.3”不是完整指标;“9 月已确认收入,人民币万元,组织 A,按产品已批准口径”才具有可判断的范围。具体确认条件、收入计算和组织归属由产品定义,本页不补造公式。

2. 零与非数值状态

显示层不能把空字符串、null、缺少字段、异常或无权限统一转换为 0。底层 null 仅说明一个技术值,不能自动告诉用户它是未录入、不适用还是加载失败。产品与数据接口须提供足以区分的状态。

含义 建议呈现 必须保留的区别
已确认零值 0 或该列规定精度的 0.00 确有定义且结果为零
已知没有记录 0 条;同时明确查询范围 不等于未加载或无查看权限
数据缺失/未上报 未填写、未上报或缺失 不参与计算的规则由产品明确
尚未加载 加载中或有文本语义的占位 不显示 0,不表现为最终空结果
未知 未知,必要时说明原因未知 不冒称缺失原因或实际值
不适用 不适用 该指标对当前对象没有适用含义
受限 无查看权限,或批准的安全文案 不通过隐藏文本泄露值或存在性
已脱敏 已脱敏;若显示掩码则有清楚说明 掩码不成为可计算数字
计算/获取失败 计算失败/加载失败及可行后续路径 不替换为 0,也不抹掉可用旧快照的身份
旧数据 保留值并标注截至时间和旧数据状态 不伪装成当前值
部分数据 保留已知结果,注明覆盖范围 不冒充完整合计或总体比例

紧凑表格如使用“—”等缩写,必须有明确图例或可访问说明,并在有歧义的位置直接写状态词。一个符号不能同时无说明地代表未知、不适用、零和无权限。导出也必须保留状态,不能把它们全部变成空白单元格。

2.1 状态可以并存

“12.4 万元,估算,截至 9 月 30 日,覆盖 8/10 个项目”可以同时是有值、估算、旧数据、部分覆盖。把其中某一个状态当成唯一状态会丢失含义。未加载全部分页数据不一定是业务数据不完整;“只加载了本页”与“上游只上报部分项目”必须区别。

3. 数字格式与本地化

数字格式跟随已明确的区域偏好,使用一致的分组符、小数符号、负号、百分号与数字系统。不同区域的分组和小数规则不同,不能只替换逗号。Unicode CLDR 的数字资料定义数字、货币及相关格式数据,可作为实现参考;所选运行时及版本须记录,不由本页指定。Unicode LDML Numbers

输入、内部值和显示值分开处理。用户看到的格式化字符串不是计算源,也不是所有环境中都能无歧义解析的交换格式。输入允许哪些分隔符、粘贴格式和单位由产品明确;有歧义时提示,而不是静默把“1,234”当成另一个数量。

标识符保留前导零和原有字符,不使用数字千分位或科学计数法。编号“000123”不能显示为“123”,也不能因为表格程序自动识别为数字而改变。排序按值还是按显示文本必须符合该列语义。

4. 精度与舍入

产品明确存储精度、计算精度、显示精度及舍入模式。YUDS 要求用户能理解显示的精度,不统一规定“所有金额两位小数”或“所有比率一位小数”。货币、单价、面积、比例和分析结果可能有不同要求。

  • 同一比较列使用一致精度或清楚标明差异;不能随值大小任意跳动。
  • 汇总由产品定义的原始精度计算,不能由界面加总已舍入的文本。
  • 显示舍入导致分项之和与总计不完全相等时,说明舍入差异;不悄悄修改某一项补齐。
  • 非零小值舍入成 0 可能误导时,使用经过产品确认的更高精度或“小于某阈值”表达,并保留完整值入口。
  • “-0.00”是否归一化为“0.00”须按显示规则处理;不能借此删去对业务判断重要的方向或精度信息。
  • 不用精确到很多位的小数制造假精确。估算的精度应符合数据质量,并显示估算身份。

复制功能说明复制的是“显示值”还是“完整值”;提供两者时分别命名。金额签署、付款核对等高后果场景不得仅提供缩写值,完整值要在任务中可直接核对。

5. DSP-MONEY 单位、倍率与币种

5.1 用途、结构和非用途

货币展示呈现带币种和精度含义的金额,不自行换汇、计算税费、决定账务舍入或推断可支配金额。结构为数值、可辨币种、数量级/单位、必要精度/近似说明、数据时间与状态、可选的获准完整值入口。输入编辑沿用 TXT-SINGLE/PRM-SPIN 的适用边界;展示不是一个伪装成禁用输入框的字段。

普通数字、比例、货币、区间与估计是不同值类型。币种未知不能只套当前 locale 默认符号;相同符号可能对应不同币种,需要币种代码或明确上下文消歧。整列共用币种标题时,表格脱离标题、复制单元格、移动端卡片和导出仍保留含义。不能把“0”“尚未取得”“不适用”“受限”“计算失败”全表示为短横线。

5.2 数据与格式契约

原始精确值、币种、存储尺度、业务精度、显示精度、舍入模式、数据时间与授权版本分开。使用可保留必要精度的表示,不先转有损浮点再用格式化掩盖错误。格式化仅改变文本,不回写原数值。Unicode LDML 规定 locale 相关数字/币种样式,并区分显示舍入与数值本体;这不授权 YUDS 采用某个业务舍入法。LDML Numbers:Currency Formats 与 Rounding

紧凑数值可以在概览中使用,但必须标出数量级/近似并有获准完整值入口;决定性操作、精确比较和用户明确请求的完整值不能只留缩写。列表排序用已声明的真实数值与币种可比性,不按格式化字符串字典序。不同币种未经明确换算不能合计或暗示可直接排名;若产品提供换算值,原值、目标币种、汇率来源时间、精度和估计状态分别可查,换汇能力不由此组件保证。

负号、括号会计格式、零与显示后的负零需有明确策略。微小负值舍入成零时,在影响判断的任务中不能让其原有方向消失;显示明确的“负向、约 0”或直接可见的负向标记及获准精度说明,不无声改变原值。显示精度热更新只改变呈现,不产生保存事件。货币切换若只是显示偏好,不得被误称换汇;实际换算需另有输入与证据。

5.3 状态、键盘与复制

静态金额不无故加入 Tab 序列。展开完整值/复制是独立的普通按钮,名称说明对象和复制格式;复制前明确是当前可见文本还是获准机器值,不能将已舍入数字标为精确原值。受限列的隐藏精确数据、可访问名称、tooltip 和剪贴板同样受授权控制,不能视觉打码却复制原值。

若复制需异步获取完整值,实际写入系统剪贴板前再次核对对象、值版本与当前授权;读取后撤权则不得写入,也不得把旧完整值放进手工复制兜底。撤权前已合法完成的外部复制无法由组件追回,不承诺清除系统剪贴板。复制成功须有真实系统结果,失败时保留手工选择路径(如仍有权限)。

旧数据、更新中、计算未知与权限受限都有邻近说明。更新数字不自动抢焦点,不逐单元格高优先通告;必要摘要遵循 FB-LIVE。用户已选中文本时,刷新不得默默把复制目标替换为另一对象;以稳定 ID 和可见版本处理。若正在查看完整值时被撤权,清除受限内容,焦点移到安全说明;不能让旧的异步完整值回包复活。

5.4 平台、增长与夹具(未执行)

Web/原生格式库版本和 locale 数据需登记;不同端的小数、分组、符号位置可能不同,但币种、原始精确值与含义一致。RTL 用适合的方向隔离处理数值片段,不反转负号和货币代码;大字下允许适当换行,但币种不得与另行的金额错配。等宽数字按 D02 使用系统正文数字字体的 tabular figures;实际缺字/特性回退须验证,不引入未授权品牌字体。

以下夹具均未执行:

  • DSP-MONEY-N:原值 1234.567、币种 CNY、显示 2 位且声明半入;预期显示 1234.57 并可查获准原值;切换 locale 仅改变格式,原值和写入次数不变。
  • DSP-MONEY-F:原值未知、币种已知,格式服务失败;预期显示“金额暂不可用”,不呈现 0/NaN/Infinity,不暗用另一币种。
  • DSP-MONEY-R:完整值面板打开后撤权,复制与旧回包随后到达;预期复制请求 0 次,内容和可访问文本被清理,旧回包不恢复,安全焦点可达。
  • DSP-MONEY-L:长币种说明、超大精确数、RTL 和 200% 文字;预期负号、币种、数量级可辨,完整值可获取,格式化结果不溢出成相邻列的值。
  • DSP-MONEY-Z:原值 -0.004、显示 2 位,任务需要方向;预期声明近零/负向与完整精度,不仅显示普通 0;机器值仍为 -0.004。
  • DSP-MONEY-C:两行相同的“$100”分别为 USD/CAD;预期行或稳定上下文可区分币种,复制单行保留含义,不未经换算求和为“$200”。
  • DSP-MONEY-A:用户复制前获准,异步完整值返回前撤权;预期最终剪贴板写入 0 次、手工兜底无旧值;若写入早于撤权已合法完成,只说明无法追回,不能假称已清除。
  • DSP-MONEY-P:并列 +0.004 与 -0.004,显示 2 位且任务需方向;预期正负近零可区分,二者不都只显示“约 0”,机器值不变。

来源与证据边界见本组来源。

单位可以放在列标题或区块说明,但不能要求用户靠记忆跨页理解。切换“元/万元”“平方米/平方英尺”时,显示值、轴、提示层、汇总、复制及导出必须一致更新,转换规则与精度由产品定义。

混合币种逐项明确币种;仅显示“$”可能不足以区分币种,应使用明确代码或名称。多币种不能直接相加。若提供换算结果,说明原币种、目标币种、汇率日期或期间、来源、适用方式和精度,保留原值查阅路径。YUDS 不选择汇率或汇率计算算法。

“万元”是倍率说明,“人民币”是币种说明,二者不能互相代替。“万”“亿”“K”“M”等缩写格式按语言与场景处理;同一图表不在无提示时混用倍率。数字与单位应作为完整语义读取,不能只让辅助技术读到一个没有单位的数。

6. 比例、变化与分母

百分比、百分点、基点及绝对变化分别命名。例如从 80% 到 82% 是增加 2 个百分点,相对增幅为 2.5%;界面必须说明显示的是哪一种。该例仅解释表达区别,不定义任何产品指标。

比例需要可查阅分子、分母、剔除项及范围。分母为零、缺失或不适用时按产品规则呈现“无法计算”等明确状态,不由界面自行产生 0%、无限大或没有解释的横线。涉及负基数时,是否允许增长率及如何解释由产品定义。

同比、环比、预算差异及目标完成率必须有明确基期或基准。期间长短、组织范围、项目集合或口径版本变化时,在结论附近说明;不等到用户展开详细说明后才发现比较条件不成立。

7. 日期、时间与时区

区分下列基本值;完整类型与边界夹具见第 11 节「时间、数字与语言的确定性规则」:

  1. 日历日期,例如合同生效日。若产品定义它不含时间和时区,不应按时区转换后移到前一天。
  2. 绝对时刻,例如提交时间。需要能够明确其时区或偏移,按显示设置格式化。
  3. 业务期间或窗口,例如“9 月回款”“最近 30 天”。由产品定义起止边界、是否含端点、自然日或滚动时长、业务时区及日历。

数据发生时间、数据截至时间、来源更新时间、计算时间与当前页面读取时间不是同一个字段。“刚刚刷新页面”不能使昨日来源变成今日数据。用户需要做时效判断时,直接呈现相关时间和时区。

语言、区域与时区分别设置;展示时区与统计边界时区也可能不同。用户切换显示时区不应悄悄改变业务月份的计算窗口。跨时区协作或夏令时重复/不存在的本地时刻,应使用足够明确的日期、时区及必要偏移,不假定每个自然日都等于 24 小时。

本地化日期、时间、日历和时区名称可参考 Unicode CLDR,实际格式及兼容性由实现验证。Unicode LDML Dates

相对时间如“5 分钟前”仅作辅助。用户可以获得明确的绝对时刻;导出、审计及跨时区交接不能只有相对描述。仅写“08/09”容易产生歧义,应采用适合区域且足够明确的形式,必要时直接写月份名称或完整年月日。

8. 表格中的表达

数量、金额和比例列右对齐或按小数点对齐,同列使用可比较的数字样式。文本按阅读方向起始对齐,状态按一致的内容策略呈现;不将所有单元格都居中。RTL 下数值对齐需按列和数字方向验证,不能把字符串字符顺序镜像。

表头给出指标与共用单位;混合单位行保留逐项单位。总计说明范围;缺失数量、排除项或仅部分覆盖在相邻位置说明。“所选合计”只能计算明确选择范围,不能偷偷换成当前页。复杂表格交互见数据表与交互网格契约。

9. 正反例

合适

“回款金额,CNY 万元,9 月,数据截至 10 月 2 日 18:00(Asia/Shanghai)”,其中一行显示“未上报”,总计标明“已上报 8 个项目合计”。

不合适

表头写“金额”,有的行是元、有的是万元;未上报显示 0;底部汇总所有文本后显示“总计”。

合适

预测值使用“预测”标识并提供模型/假设版本入口;实际已发生值采用独立列或可辨的视觉标记。

不合适

用同一条实线连接实际与预测,且所有提示层都称“实际值”。

10. 验收数据集

至少构造以下虚构测试值,并核对界面、读屏、复制及导出:

  • 真实 0、负值、极大值、非零极小值、舍入边界及可能出现的负零。
  • null 但原因不同的缺失、不适用、未知、未加载、失败及受限。
  • 两种币种、两种倍率、百分比与百分点、分母为零。
  • 前导零编号、长标识、中文和拉丁名称、RTL 混合文本。
  • 月末、跨年、业务时区与显示时区不同、夏令时转换附近的时刻。
  • 旧数据+后台刷新、预测+部分覆盖、权限变化后仍留在页面的旧值。

通过要求:格式和含义不混淆,所有状态可区分,权限变化不泄露原值,口径与业务确认一致。目前仅形成验收要求,测试全部未执行。

11. 时间、数字与语言的确定性规则

规则 YUDS-100100-01(时间类型)

录入前分别声明时间点、本地日期、本地日期时间、时长和业务期间。时间点可用 UTC 或带偏移的明确表示;本地日期如 2026-10-19 保持日历含义,不补成 UTC 零点后转换;本地日期时间若代表一次实际发生时刻,必须结合指定时区及重复时间的选择才能提交。时长同时说明单位及经过秒数/日历长度语义;24小时 不冒充 下一自然日。期间明确时区、日历、端点和解析时刻,保存“本月”时说明保存的是定义还是固定区间。语言、区域、显示时区的改变只改变其已声明职责,不重写业务窗口。

规则 YUDS-100100-02(DST 与输出)

夏令时造成不存在的本地时刻时,阻止无声提交,要求改时刻或采用产品已公开的解析策略;重复时刻须说明采用哪个偏移或候选时刻。不静默选择“第一个”。任务结果同时保留可核查的绝对时间与原业务时区;导出不能只有“刚刚”。机器交换按接口既有契约提供带类型的日期/时刻/时长值、必要偏移和区域时区,显示文本另列;这不是统一 API 字段或新增日期存储方案。W3C Working with Time and Timezones

规则 YUDS-100100-03(精度与币种)

每个字段明确可输入精度、计算精度、显示精度和产品指定舍入模式;缺少业务精度时不得自行选“两位”。显示舍入后仍有完整值入口,复制与导出命名具体;不同币种显示代码或明确名称,百分数输入说明“12 表示 12%”还是“0.12 表示 12%”。受限、未知、空缺和零保留独立状态;转换失败保留原输入。编号按文本保留前导零,不受数字本地化影响。

规则 YUDS-100100-04(语言与方向)

数量消息作为完整句子使用目标语言的复数规则,不拼接“数字+固定名词”。混合方向的对象名、编号、负数、币种与标点分别保留逻辑顺序,Web 采用适当方向隔离,未知文本方向按内容处理;原生端使用对应文本方向能力并实测。RTL 可镜像布局位置,但不倒转编号、数字或时间字符串。长名称可换行或展开,不能裁掉负号、币种、单位和差异方向。组合输入处理见表单校验、草稿与提交的 YUDS-110100-02。W3C 双向文本、Unicode LDML Numbers

规则夹具

规则 输入与动作 可验预期 反例
YUDS-100100-01 合同本地生效日 2026-10-19;从上海显示区切到纽约 仍为 10 月 19 日;真正提交时刻按所选时区显示,且能追溯原时刻 将合同日转成 10 月 18 日
YUDS-100100-01 业务窗定义为纽约下一个自然日,另有 24 小时倒计时;跨夏令时变更 两者按各自类型计算,业务提供边界,不以同一秒数替代 每个自然日固定 86400 秒
YUDS-100100-02 测试时区 America/New_York:输入 2026-03-08 02:30 与 2026-11-01 01:30 按目标时区数据库核实前者不存在、后者重复;前者需纠正,后者要求明确 -04:00 或 -05:00;导出区分两时刻 自动改到 03:30 不说明,或任选一个 01:30
YUDS-100100-03 字段契约为 CNY、显示 2 位、保留完整值;输入 12.345,旁边有 USD 12.345 和未知值 按产品指定舍入显示且可查 12.345;币种可辨、未知不入零;未提供舍入模式时先提示待配置 界面自定财务舍入;汇总格式化文本;未知变 0
YUDS-100100-04 RTL 页面显示阿拉伯文对象名、编号 000123、金额 -1,234.50 CNY;数量 0、1、2 及长标签 身份、符号、单位和句子含义正确;复制仍为逻辑序;标签增长不隐藏关键含义 倒转编号或只拼英文复数 s;截断负号

来源核查日期为 2026-10-19:CLDR 资料用于本地化,不代替业务公式;所用系统区域库及时区数据库版本需在实现验收记录中固定。上述日期为边界夹具,不是业务截止日。四端格式、读屏、复制与实际导出验证均未执行。

相关:图表选择、交互与可访问等效、来源、快照与依据追溯。