Early Preview

This is currently very much a preview. Please feel free to try things out, but don't be upset if anything is not yet working. Feedback is welcome over on our GitHub Dicussions page.

struct System.Decimal

Assembly: System.Runtime

Represents a decimal floating-point number.

Fields and Constants

public static readonly decimal

MaxValue

Represents the largest possible value of <see cref="T:System.Decimal" /> . This field is constant and read-only.

public static readonly decimal

MinusOne

Represents the number negative one (-1).

public static readonly decimal

MinValue

Represents the smallest possible value of <see cref="T:System.Decimal" /> . This field is constant and read-only.

public static readonly decimal

One

Represents the number one (1).

public static readonly decimal

Zero

Represents the number zero (0).

Properties

public byte

Scale

Gets the scaling factor of the decimal, which is a number from 0 to 28 that represents the number of decimal digits.

Methods

public int

CompareTo(decimal value)

value The object to compare with this instance.

Returns A signed number indicating the relative values of this instance and <paramref name="value" /> . <list type="table"> <listheader> <term> Return value</term> <description> Meaning</description> </listheader> <item> <term> Less than zero</term> <description> This instance is less than <paramref name="value" />.</description> </item> <item> <term> Zero</term> <description> This instance is equal to <paramref name="value" />.</description> </item> <item> <term> Greater than zero</term> <description> This instance is greater than <paramref name="value" />.</description> </item> </list>

Compares this instance to a specified <see cref="T:System.Decimal" /> object and returns a comparison of their relative values.

public int

CompareTo(object value)

value The object to compare with this instance, or <see langword="null" /> .

Returns A signed number indicating the relative values of this instance and <paramref name="value" /> . <list type="table"> <listheader> <term> Return value</term> <description> Meaning</description> </listheader> <item> <term> Less than zero</term> <description> This instance is less than <paramref name="value" />.</description> </item> <item> <term> Zero</term> <description> This instance is equal to <paramref name="value" />.</description> </item> <item> <term> Greater than zero</term> <description> This instance is greater than <paramref name="value" />, or <paramref name="value" /> is <see langword="null" />.</description> </item> </list>

Compares this instance to a specified object and returns a comparison of their relative values.

public bool

Equals(decimal value)

value An object to compare to this instance.

Returns <see langword="true" /> if <paramref name="value" /> is equal to this instance; otherwise, <see langword="false" /> .

Returns a value indicating whether this instance and a specified <see cref="T:System.Decimal" /> object represent the same value.

public bool

Equals(object value)

value The object to compare with this instance.

Returns <see langword="true" /> if <paramref name="value" /> is a <see cref="T:System.Decimal" /> and equal to this instance; otherwise, <see langword="false" /> .

Returns a value indicating whether this instance and a specified <see cref="T:System.Object" /> represent the same type and value.

public int

GetHashCode()

Returns A 32-bit signed integer hash code.

Returns the hash code for this instance.

public TypeCode

GetTypeCode()

Returns The enumerated constant <see cref="F:System.TypeCode.Decimal" /> .

Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Decimal" /> .

public string

ToString()

Returns A string that represents the value of this instance.

Converts the numeric value of this instance to its equivalent string representation.

public string

ToString(IFormatProvider provider)

provider An object that supplies culture-specific formatting information.

Returns The string representation of the value of this instance as specified by <paramref name="provider" /> .

Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public string

ToString(string format)

format A standard or custom numeric format string.

Returns The string representation of the value of this instance as specified by <paramref name="format" /> .

Converts the numeric value of this instance to its equivalent string representation, using the specified format.

public string

ToString(string format, IFormatProvider provider)

format A numeric format string.

provider An object that supplies culture-specific formatting information.

Returns The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" /> .

Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public bool

TryFormat(Span`1 utf8Destination, Int32& bytesWritten, ReadOnlySpan`1 format = null, IFormatProvider provider = null)

public bool

TryFormat(Span`1 destination, Int32& charsWritten, ReadOnlySpan`1 format = null, IFormatProvider provider = null)

protected void

Finalize()

Inherited from object

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

public Type

GetType()

Inherited from object

Returns The exact runtime type of the current instance.

Gets the <see cref="T:System.Type" /> of the current instance.

protected object

MemberwiseClone()

Inherited from object

Returns A shallow copy of the current <see cref="T:System.Object" /> .

Creates a shallow copy of the current <see cref="T:System.Object" /> .