跳转至

数字格式化

数字格式化工具用于把框架里的大数、定点数和普通数值输出为稳定文本。它们不负责本地化、货币符号或业务单位选择。

GFNumberFormatter

GFNumberFormatter 是统一的数字显示格式化工具，支持：

  • FULL：普通十进制
  • COMPACT_SHORT：紧凑缩写，如 12.3k
  • SCIENTIFIC：科学计数法，如 1.23e8
  • ENGINEERING：工程计数法
  • AUTO：自动模式
var coins := GFBigNumber.from_string("12345000")
print(GFNumberFormatter.format_compact(coins, 2)) # 12.35M
print(GFNumberFormatter.format_scientific(coins, 2)) # 1.23e7

GFDecimalStringFormatter

GFDecimalStringFormatter 是小数字符串格式化与校验辅助，主要用于框架内部的 GFNumberFormatter、GFBigNumber 和 GFFixedDecimal 共享同一套舍入、截断、尾零裁剪和纯数字校验规则。

项目层如果也需要这些纯文本规则，可以直接静态调用；纯数字校验要求至少包含一个数字字符。

var rounded := GFDecimalStringFormatter.format_decimal_value(12.345, 2, false, false)
var truncated := GFDecimalStringFormatter.format_decimal_value(12.345, 2, false, true)
var valid := GFDecimalStringFormatter.is_valid_decimal_parts("12", "34", true)