shortscale

README

shortscale

Go.dev github.com/jldec/shortscale-go

Go package to convert numbers into English words.

This was originally written as an exploration of JavaScript and Rust documented here.

The short scale, has different words for each power of 1000.

This library expresses numbers from zero to thousands, millions, billions, trillions, and quadrillions, up to 999_999_999_999_999_999.

Function

func Shortscale(n uint64) string

Example

import (
    "fmt"
    shortscale "github.com/jldec/shortscale-go"
)

// four hundred and twenty billion nine hundred and ninety nine thousand and fifteen
fmt.Println(shortscale.Shortscale(420_000_999_015))

Benchmarks

goos: darwin
goarch: amd64
pkg: github.com/jldec/shortscale-go
cpu: Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz
4053015	       291.8 ns/op	     120 B/op	       4 allocs/op

goos: linux
goarch: amd64
pkg: github.com/jldec/shortscale-go
2569018	       472 ns/op	     120 B/op	       4 allocs/op

Documentation

Index

• func Shortscale(n uint64) string

Examples

• Shortscale

Functions

func Shortscale

func Shortscale(n uint64) string

Shortscale converts numbers into English words. Supports positive integers from 0 to 999_999_999_999_999_999. Larger values return "(big number)".

Example

package main

import (
	"fmt"

	shortscale "github.com/jldec/shortscale-go"
)

func main() {
	fmt.Println(shortscale.Shortscale(420_000_999_015))
}

Output:

four hundred and twenty billion nine hundred and ninety nine thousand and fifteen