https://github.com/alirezasariri78/rs-abbreviation-number
Abbreviate numbers in Rust
https://github.com/alirezasariri78/rs-abbreviation-number
abbreviations metric number prefix prefix-number
Last synced: about 1 month ago
JSON representation
Abbreviate numbers in Rust
- Host: GitHub
- URL: https://github.com/alirezasariri78/rs-abbreviation-number
- Owner: alirezasariri78
- License: mit
- Created: 2024-04-17T11:56:52.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-14T07:26:00.000Z (9 months ago)
- Last Synced: 2024-10-14T08:49:09.623Z (8 months ago)
- Topics: abbreviations, metric, number, prefix, prefix-number
- Language: Rust
- Homepage:
- Size: 103 KB
- Stars: 9
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## **Abbreviate or Unabbreviate numbers in rust**
## For Numbers Less Then 1
| Input | Output |
|-----------------------------|--------------|
| 0.1 | 100m |
| 0.01 | 10m |
| 0.001 | 1m |
| 0.000_000_001 | 1n |
| 0.000_000_000_000_000_000_000_000_000_1 | 100q |
## For Numbers Greater Then 1
| Input | Output |
|-----------------------------|--------------|
| 1_000 | 1K |
| 1_000_000 | 1M |
| 1_090 | 1.09K |
| 001_090 | 1.09K |
| 123_000_000_000_000_000_000 | 123E |
| -123_000_000_000_000_000_000 | -123E |
| 1_000_000_000_000_000_000_000_000_000_000 | 1Q |
| Input | Output |
|-----------------------------|--------------|
| 1K | 1000 |
| 1.09K | 1090 |
| 1_090 | 1.09K |
| 123E |123_000_000_000_000_000_000|
| 1Q |1_000_000_000_000_000_000_000_000_000_000|
## Usage Example :
```rust
fn main() {
// numbers greater then 1:
println!("{}", 123.abbreviate_number(&Default::default())); // result: 123
println!("{}", 123_000.0.abbreviate_number(&Default::default())); //result: 123K
println!("{}", "1K".unabbreviate_number(&Default::default())); //result: 1000.0
println!("{}", "1M".unabbreviate_number(&Default::default())); //result: 1000000.0
// numbers less then 1:
println!("{}", (0.1).abbreviate_number(&Default::default())); // result: 100m
println!("{}",(0.000_000_001).abbreviate_number(&Default::default())); //result: 1n
println!("{}", "111z".unabbreviate_number(&Default::default())); // result : 0.000000000000000000111
println!("{}", "100n".unabbreviate_number(&Default::default())); // result : 0.0000001
}
```
## Also For Big Int Numbers:
```rust
fn main() {
let big_num: i128 = 999_509_999_999_999_000_123_123_000_000_123;
println!("{}", big_num.abbreviate_number(&Default::default())); // result : 999.5Q
}
```
## Customize Format:
```rust
fn main(){
assert_eq!(
"100-q",
(0.000_000_000_000_000_000_000_000_000_1).abbreviate_number(&AbbreviationOptions {
padding: 0,
separator: "-".to_string()
})
);
assert_eq!(
"-100 q",
(-0.000_000_000_000_000_000_000_000_000_1).abbreviate_number(&AbbreviationOptions {
padding: 3,
..Default::default()
})
);
}
```
## Time Estimate:
```rust
use rs_abbreviation_number::time::*;
fn main() {
let seconds=Time::from_second(34_536_000);
assert_eq!(1,seconds.get_year());
assert_eq!(12,seconds.get_month());
let hours=Time::from_hour(9593);
assert_eq!(1,hours.get_year());
assert_eq!(12,hours.get_month());
assert_eq!(360,hours.get_day());
}
```
## Note:
- Symbols Are Case-Sensitive And
- Program Will Automaticly Remove Leading Zero (001 Will Become 1 and etc)
- Time Estimation Is Not As Accurate As The Name Suggests And It May Differ From The Exact Value
## Table Of Metric Prefix:
| Symbol | Base |
|-----------------------------|--------------|
| q | $`10^ {-30}`$ |
| r | $`10^ {-27}`$ |
| y | $`10^ {-24}`$ |
| z | $`10^ {-21}`$ |
| a | $`10^ {-18}`$ |
| f | $`10^ {-15}`$ |
| p | $`10^ {-12}`$ |
| n | $`10^ {-9}`$ |
| μ | $`10^ {-6}`$ |
| m | $`10^ {-3}`$ |
| | $`10^{0}`$ |
| K | $`10^{3}`$ |
| M | $`10^ {6}`$ |
| G | $`10^ {9}`$ |
| T | $`10^ {12}`$ |
| P | $`10^ {15}`$ |
| E | $`10^ {18}`$ |
| Z | $`10^ {21}`$ |
| Y | $`10^ {24}`$ |
| R | $`10^ {27}`$ |
| Q | $`10^{30}`$ |
## TODO :
```[tasklist]
- [ ] Optimize Code
- [ ] Create Custom Symbols
- [x] Custom separator pass by option
- [ ] Create Unit Conversion
```