System.Decimal 结构

项目
01/11/2024

本文提供了此 API 参考文档的补充说明。

Decimal 值类型表示介于正 79,228,162,514,264,337,593,543,950,335 和负 79,228,162,514,264,337,593,543,950,335 之间的十进制数字。 Decimal 的默认值为 0。值 Decimal 类型适用于需要大量重要整数和小数位数且没有舍入错误的财务计算。 Decimal 类型仍需要舍入，但它最大限度地减少了因舍入而导致的错误。相反，它最大限度地减少了因舍入而导致的错误。例如，下面的代码生成 0.9999999999999999999999999999 的结果，而不是 1。

decimal dividend = Decimal.One;
decimal divisor = 3;
// The following displays 0.9999999999999999999999999999 to the console
Console.WriteLine(dividend/divisor * divisor);

let dividend = Decimal.One
let divisor = 3m
// The following displays 0.9999999999999999999999999999 to the console
printfn $"{dividend/divisor * divisor}"

Dim dividend As Decimal = Decimal.One
Dim divisor As Decimal = 3
' The following displays 0.9999999999999999999999999999 to the console
Console.WriteLine(dividend/divisor * divisor)

当除法和乘法的结果传递给 Round 方法时，结果不会丢失精度，如以下代码所示。

decimal dividend = Decimal.One;
decimal divisor = 3;
// The following displays 1.00 to the console
Console.WriteLine(Math.Round(dividend/divisor * divisor, 2));

let dividend = Decimal.One
let divisor = 3m
// The following displays 1.00 to the console
printfn $"{Math.Round(dividend/divisor * divisor, 2)}"

Dim dividend As Decimal = Decimal.One
Dim divisor As Decimal = 3
' The following displays 1.00 to the console
Console.WriteLine(Math.Round(dividend/divisor * divisor, 2))

小数是一个浮点值，它由一个符号、一个数值组成，其中值中的每个数字范围为 0 到 9，以及一个缩放因子，指示浮点的位置，用于分隔数值的整型和小数部分。

值的二进制表示形式 Decimal 为 128 位，由 96 位整数组成，以及一组 32 位标志，表示用于指定小数部分的符号和缩放因子。因此，形式的值的二进制表示形式 Decimal （（-2⁹⁶ 到 2⁹⁶） / 10^{（0 到 28），}其中 -（2^96-1） MinValue等于，2^96-1 等于 MaxValue。有关值的二进制表示形式 Decimal 和示例的详细信息，请参阅 Decimal(Int32[]) 构造函数和 GetBits 方法。

缩放因子还会保留数字 Decimal 中的任何尾随零。尾随零不会影响算术或比较运算中数字的值 Decimal 。但是，如果应用了适当的格式字符串，方法可能会显示 ToString 尾随零。

转换注意事项

此类型提供用于将值与、SByte、、Int16、Int32、、Int64 Byte、、UInt16和UInt64 UInt32值相转换Decimal的方法。从这些整型类型转换到 Decimal 扩大从不丢失信息或引发异常的转换。

从 Decimal 任意整型类型的转换是将值舍 Decimal 入到最接近的整数值向零的转换范围缩小。某些语言（如 C#）还支持将值转换为Decimal Char值。如果这些转换的结果不能在目标类型中表示， OverflowException 则会引发异常。

该 Decimal 类型还提供用于将值与值转换 Decimal 到和传 Single 出和 Double 值的方法。从 Decimal 转换到 Single 或 Double 缩小转换范围，可能会丢失精度，但不知道转换后的值的大小的信息。转换不会引发异常。

如果转换的结果不能表示为 Decimal，则从Single或Double Decimal引发OverflowException异常。

对十进制值执行操作

该 Decimal 类型支持标准数学运算，例如加法、减法、除法、乘法和一元求反。还可以通过调用GetBits方法直接处理值的Decimal二进制表示形式。

若要比较两个 Decimal 值，可以使用标准数值比较运算符，也可以调用 CompareTo 或 Equals 方法。

还可以调用类的成员 Math 来执行各种数值运算，包括获取数字的绝对值、确定两 Decimal 个值的最大值或最小值、获取数字的符号和舍入数字。

示例

以下代码示例演示了 Decimal 的用法。

/// <summary>
/// Keeping my fortune in Decimals to avoid the round-off errors.
/// </summary>
class PiggyBank {
    protected decimal MyFortune;

    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public decimal Capacity {
        get {
            return Decimal.MaxValue;
        }
    }

    public decimal Dollars {
        get {
            return Decimal.Floor(MyFortune);
        }
    }

    public decimal Cents {
        get {
            return Decimal.Subtract(MyFortune, Decimal.Floor(MyFortune));
        }
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }
}

/// Keeping my fortune in Decimals to avoid the round-off errors.
type PiggyBank() =
    let mutable myFortune = 0m

    member _.AddPenny() =
        myFortune <- Decimal.Add(myFortune, 0.01m)

    member _.Capacity =
        Decimal.MaxValue

    member _.Dollars =
        Decimal.Floor myFortune

    member _.Cents =
        Decimal.Subtract(myFortune, Decimal.Floor myFortune)

    override _.ToString() =
        $"{myFortune:C} in piggy bank"

' Keeping my fortune in Decimals to avoid the round-off errors.
Class PiggyBank
    Protected MyFortune As Decimal

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public ReadOnly Property Capacity() As Decimal
        Get
            Return [Decimal].MaxValue
        End Get
    End Property

    Public ReadOnly Property Dollars() As Decimal
        Get
            Return [Decimal].Floor(MyFortune)
        End Get
    End Property

    Public ReadOnly Property Cents() As Decimal
        Get
            Return [Decimal].Subtract(MyFortune, [Decimal].Floor(MyFortune))
        End Get
    End Property

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function
End Class

通过

System.Decimal 结构

转换注意事项

对十进制值执行操作

示例

其他资源