SI
Formats a number with SI prefix (Metric prefix).
Installation
Add this line to your application's Gemfile:
gem 'si'
And then execute:
$ bundle
Or install it yourself as:
$ gem install si
Usage
si
Express a numeric value with SI prefix.
require 'si'
0.9.si # '900m'
9.si # '9'
98.si # '98'
987.si # '987'
9876.si # '9.88k'
98765.si # '98.8k'
987654.si # '988k'
9876543.si # '9.88M'
98765432.si # '98.8M'
987654321.si # '988M'
9876543210.si # '9.88G'
98765432100.si # '98.8G'
987654321000.si # '988G'
9876543210000.si # '9.88T'
# ...Options
| Option | Default | Description |
|---|---|---|
:length |
3 | Number of digits |
:base |
1000 | For binary prefix, set this to 1024 instead of default 1000 |
:space |
'' |
Space between number and prefix. Set to ' ' to get 9.88 T instead of 9.88T
|
:min_exp |
-8 | Down to yocto |
:max_exp |
8 | Up to Yotta |
9876543210000.si(length: 5) # '9.8765T'
# For convenience, a single Fixnum is recognized as :length value
9876543210000.si(5) # '9.8765T'si_bytes
Formats the number of bytes using SI prefixes (base 1000).
13255342817.si_bytes # '13.3GB'bin_bytes
Formats the number of bytes using binary prefixes (base 1024).
13255342817.bin_bytes # '12.3GiB'SI module methods: convert / revert
SI.convert(9876543210000, length: 5) # '9.8765T'
SI.revert('100k', base: 1024) # 102400.0Avoiding monkey-patching
Require 'si/minimal' instead to avoid monkey-patching numeric classes.
require 'si/minimal'
SI.convert(987654321, 3) # 988MContributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request