Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

decimal

package module

Go to main page

Versions in this module

v1

v1.5.1

May 23, 2026

v1.5.0

May 23, 2026

Changes in this version

+ var PowPrecisionNegativeExponent = 16

+ var TrimTrailingZeros = true

+ var UseScientificNotation = false

type Decimal

+ func NewFromBigRat(value *big.Rat, precision int32) Decimal

+ func NewFromUint64(value uint64) Decimal

+ func (d *Decimal) DecodeSpanner(val interface{}) error

+ func (d Decimal) Compare(d2 Decimal) int

+ func (d Decimal) EncodeSpanner() (interface{}, error)

+ func (d Decimal) Ln(precision int32) (Decimal, error)

+ func (d Decimal) PowBigInt(exp *big.Int) (Decimal, error)

+ func (d Decimal) PowInt32(exp int32) (Decimal, error)

+ func (d Decimal) PowWithPrecision(d2 Decimal, precision int32) (Decimal, error)

+ func (d Decimal) ScientificNotationString() string

type NullDecimal

+ func (d *NullDecimal) DecodeSpanner(value interface{}) error

+ func (d NullDecimal) EncodeSpanner() (interface{}, error)

v1.4.1

Dec 1, 2022

v1.4.0

Jun 5, 2022

v1.1.0

Jul 9, 2018

v1.0.1

Mar 1, 2018

v1.0.0

Nov 8, 2017

v0

v0.1.0

Jun 5, 2022

Changes in this version

+ var DivisionPrecision = 16

+ var ExpMaxIterations = 1000

+ var MarshalJSONWithoutQuotes = false

+ var Zero = New(0, 1)

+ func GetStorageDecimals() int

+ func RescalePair(d1 Decimal, d2 Decimal) (Decimal, Decimal)

+ func SetMaxSafeValue(max Decimal)

+ func SetStorageDecimals(decimals int)

+ type Decimal struct

+ func Avg(first Decimal, rest ...Decimal) Decimal

+ func GetMaxSafeValue() Decimal

+ func Max(first Decimal, rest ...Decimal) Decimal

+ func Min(first Decimal, rest ...Decimal) Decimal

+ func New(value int64, exp int32) Decimal

+ func NewFromBigInt(value *big.Int, exp int32) Decimal

+ func NewFromFloat(value float64) Decimal

+ func NewFromFloat32(value float32) Decimal

+ func NewFromFloatWithExponent(value float64, exp int32) Decimal

+ func NewFromFormattedString(value string, replRegexp *regexp.Regexp) (Decimal, error)

+ func NewFromInt(value int64) Decimal

+ func NewFromInt32(value int32) Decimal

+ func NewFromShiftedInt(nr int64) (Decimal, error)

+ func NewFromShiftedIntWithShiftCount(nr int64, shiftCount int) (Decimal, error)

+ func NewFromString(value string) (Decimal, error)

+ func NewWithSift(value int64, exp int32, decShift int) Decimal

+ func RequireFromString(value string) Decimal

+ func Sum(first Decimal, rest ...Decimal) Decimal

+ func (d *Decimal) GobDecode(data []byte) error

+ func (d *Decimal) Scan(value interface{}) error

+ func (d *Decimal) UnmarshalBinary(data []byte) error

+ func (d *Decimal) UnmarshalGQL(v interface{}) error

+ func (d *Decimal) UnmarshalJSON(decimalBytes []byte) error

+ func (d *Decimal) UnmarshalText(text []byte) error

+ func (d Decimal) Abs() Decimal

+ func (d Decimal) Add(d2 Decimal) Decimal

+ func (d Decimal) Atan() Decimal

+ func (d Decimal) BigFloat() *big.Float

+ func (d Decimal) BigInt() *big.Int

+ func (d Decimal) Ceil() Decimal

+ func (d Decimal) Cmp(d2 Decimal) int

+ func (d Decimal) Coefficient() *big.Int

+ func (d Decimal) CoefficientInt64() int64

+ func (d Decimal) Copy() Decimal

+ func (d Decimal) Cos() Decimal

+ func (d Decimal) Div(d2 Decimal) Decimal

+ func (d Decimal) DivRound(d2 Decimal, precision int32) Decimal

+ func (d Decimal) Equal(d2 Decimal) bool

+ func (d Decimal) Equals(d2 Decimal) bool

+ func (d Decimal) ExpHullAbrham(overallPrecision uint32) (Decimal, error)

+ func (d Decimal) ExpTaylor(precision int32) (Decimal, error)

+ func (d Decimal) Exponent() int32

+ func (d Decimal) Float32() (f float32, exact bool)

+ func (d Decimal) Float64() (f float64, exact bool)

+ func (d Decimal) Floor() Decimal

+ func (d Decimal) GobEncode() ([]byte, error)

+ func (d Decimal) GreaterThan(d2 Decimal) bool

+ func (d Decimal) GreaterThanOrEqual(d2 Decimal) bool

+ func (d Decimal) InexactFloat64() float64

+ func (d Decimal) IntPart() int64

+ func (d Decimal) IsInteger() bool

+ func (d Decimal) IsNegative() bool

+ func (d Decimal) IsPositive() bool

+ func (d Decimal) IsZero() bool

+ func (d Decimal) LessThan(d2 Decimal) bool

+ func (d Decimal) LessThanOrEqual(d2 Decimal) bool

+ func (d Decimal) MarshalBinary() (data []byte, err error)

+ func (d Decimal) MarshalGQL(w io.Writer)

+ func (d Decimal) MarshalJSON() ([]byte, error)

+ func (d Decimal) MarshalText() (text []byte, err error)

+ func (d Decimal) Mod(d2 Decimal) Decimal

+ func (d Decimal) Mul(d2 Decimal) Decimal

+ func (d Decimal) Neg() Decimal

+ func (d Decimal) NumDigits() int

+ func (d Decimal) Pow(d2 Decimal) Decimal

+ func (d Decimal) QuoRem(d2 Decimal, precision int32) (Decimal, Decimal)

+ func (d Decimal) Rat() *big.Rat

+ func (d Decimal) Round(places int32) Decimal

+ func (d Decimal) RoundBank(places int32) Decimal

+ func (d Decimal) RoundCash(interval uint8) Decimal

+ func (d Decimal) RoundCeil(places int32) Decimal

+ func (d Decimal) RoundDown(places int32) Decimal

+ func (d Decimal) RoundFloor(places int32) Decimal

+ func (d Decimal) RoundUp(places int32) Decimal

+ func (d Decimal) Shift(shift int32) Decimal

+ func (d Decimal) Sign() int

+ func (d Decimal) Sin() Decimal

+ func (d Decimal) String() string

+ func (d Decimal) StringFixed(places int32) string

+ func (d Decimal) StringFixedBank(places int32) string

+ func (d Decimal) StringFixedCash(interval uint8) string

+ func (d Decimal) StringScaled(exp int32) string

+ func (d Decimal) Sub(d2 Decimal) Decimal

+ func (d Decimal) Tan() Decimal

+ func (d Decimal) ToShiftedInt() int64

+ func (d Decimal) Truncate(precision int32) Decimal

+ func (d Decimal) Value() (driver.Value, error)

+ type NullDecimal struct

+ Decimal Decimal

+ Valid bool

+ func NewNullDecimal(d Decimal) NullDecimal

+ func (d *NullDecimal) Scan(value interface{}) error

+ func (d *NullDecimal) UnmarshalJSON(decimalBytes []byte) error

+ func (d *NullDecimal) UnmarshalText(text []byte) error

+ func (d NullDecimal) MarshalJSON() ([]byte, error)

+ func (d NullDecimal) MarshalText() (text []byte, err error)

+ func (d NullDecimal) Value() (driver.Value, error)