https://github.com/pvoznyuk/short-numbers
Convert numbers like 23700 to 23.7k and parse converted strings back to numbers
https://github.com/pvoznyuk/short-numbers
formatting numbers python
Last synced: about 1 year ago
JSON representation
Convert numbers like 23700 to 23.7k and parse converted strings back to numbers
- Host: GitHub
- URL: https://github.com/pvoznyuk/short-numbers
- Owner: pvoznyuk
- License: mit
- Created: 2017-11-25T18:37:18.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-07T17:12:50.000Z (almost 8 years ago)
- Last Synced: 2025-06-15T02:03:02.769Z (about 1 year ago)
- Topics: formatting, numbers, python
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 3
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Short numbers
A Python package to display big numbers in a short format and vice-versa: parse short format and return an origin value.
e.g. it can format number `25300` as `25.3k` and convert `25.3k` back to `25300`
## Installation
```bash
pip install shortnumbers
```
## Usage
### Format numbers in short format
```python
from shortnumbers import millify
millify(1000); # -> '1k'
millify(5678000); # -> '6M'
millify(-2000); # -> '-2k'
millify(-30000000000.12); # -> '-30B'
millify(12345, precision=2); # -> '12.35k'
millify(12345, precision=2, suffix=" ", ending="B"); # -> '12.35 kB'
millify(12345, precision=2, prefix="$"); # -> '$12.35k'
```
### Parse short format as an origina value
```python
from shortnumbers import parse_millify
parse_millify("0"); # -> 0.0
parse_millify("1"); # -> 1.0
parse_millify("1k"); # -> 1000.0
parse_millify("-1.56k"); # -> -1560.0
parse_millify("24.5MB"); # -> 24500000.0
parse_millify("24.5B"); # -> 24500000000.0
```