refactor(money): 统一金额分为纯整数工具

This commit is contained in:
yml2213
2026-10-30 14:33:35 +08:00
parent 85bff95042
commit 37e1980d2d
7 changed files with 156 additions and 179 deletions
+65 -41
View File
@@ -1,58 +1,83 @@
package money
import (
"errors"
"fmt"
"math"
"strconv"
"strings"
)
// Round 将金额四舍五入到角(0.1元),统一全项目金额精度
// 例如:12.34 -> 12.3, 12.36 -> 12.4, 12.35 -> 12.4
func Round(value float64) float64 {
return math.Round(value*10) / 10
// CentsPerYuan 是人民币元与分的固定换算比例。
const CentsPerYuan int64 = 100
var ErrInvalidYuan = errors.New("金额格式不正确")
// ParseYuan 将用户输入的元字符串精确解析为分,不经过 float64。
// 支持 "12"、"12.3"、"12.34"、"-1.20";超过两位小数直接拒绝。
func ParseYuan(value string) (int64, error) {
trimmed := strings.TrimSpace(value)
if trimmed == "" {
return 0, ErrInvalidYuan
}
sign := int64(1)
if strings.HasPrefix(trimmed, "-") {
sign = -1
trimmed = strings.TrimPrefix(trimmed, "-")
} else if strings.HasPrefix(trimmed, "+") {
trimmed = strings.TrimPrefix(trimmed, "+")
}
if trimmed == "" {
return 0, ErrInvalidYuan
}
parts := strings.Split(trimmed, ".")
if len(parts) > 2 {
return 0, ErrInvalidYuan
}
wholeText := parts[0]
if wholeText == "" {
wholeText = "0"
}
whole, err := strconv.ParseInt(wholeText, 10, 64)
if err != nil || whole < 0 {
return 0, ErrInvalidYuan
}
fraction := int64(0)
if len(parts) == 2 {
fracText := parts[1]
if len(fracText) > 2 {
return 0, ErrInvalidYuan
}
fracText = fracText + strings.Repeat("0", 2-len(fracText))
if fracText == "" {
fracText = "00"
}
fraction, err = strconv.ParseInt(fracText, 10, 64)
if err != nil || fraction < 0 || fraction >= CentsPerYuan {
return 0, ErrInvalidYuan
}
}
if whole > (1<<62)/CentsPerYuan {
return 0, ErrInvalidYuan
}
return sign * (whole*CentsPerYuan + fraction), nil
}
// ToCent 将元转换为分(整数),用于存储。
// 12.34 元 -> 1234 分
func ToCent(yuan float64) int64 {
return int64(math.Round(yuan * 100))
}
// ToDisplayYuan 将分转换为按角精度展示的元值。
// 1234 分 -> 12.3 元
func ToDisplayYuan(cent int64) float64 {
return Round(float64(cent) / 100)
}
// Format 格式化分为字符串(角精度,保留1位小数)
// 1234 分 -> "12.3"
// 1230 分 -> "12.3"
// Format 将分精确格式化为两位小数,例如 1234 -> "12.34"。
// 全程使用整数运算,不经过 float64,也不做四舍五入。
func Format(cent int64) string {
return fmt.Sprintf("%.1f", ToDisplayYuan(cent))
sign := ""
value := cent
if value < 0 {
sign = "-"
value = -value
}
return fmt.Sprintf("%s%d.%02d", sign, value/CentsPerYuan, value%CentsPerYuan)
}
// FormatWithSymbol 格式化分为带符号的字符串
// 123分 -> "¥12.3"
func FormatWithSymbol(cent int64) string {
return "¥" + Format(cent)
}
// Min 返回两个金额中较小的值(角精度,兼容旧代码)
func Min(a, b float64) float64 {
if a < b {
return Round(a)
}
return Round(b)
}
// Max 返回两个金额中较大的值(角精度,兼容旧代码)
func Max(a, b float64) float64 {
if a > b {
return Round(a)
}
return Round(b)
}
// MinCent 返回两个分值中较小的值
func MinCent(a, b int64) int64 {
if a < b {
return a
@@ -60,7 +85,6 @@ func MinCent(a, b int64) int64 {
return b
}
// MaxCent 返回两个分值中较大的值
func MaxCent(a, b int64) int64 {
if a > b {
return a