Product
Introducing Socket Optimize
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.
@visulima/humanizer
Advanced tools
Humanizer is a library for humanizing data in a human-readable form.
Humanizer is a library for humanizing data in a human-readable form.
Daniel Bannert's open source work is supported by the community on GitHub Sponsors
npm install @visulima/humanizer
yarn add @visulima/humanizer
pnpm add @visulima/humanizer
Convert bytes to human-readable strings and vice versa: 1024 → 1KB and 1KB → 1024
import { formatBytes, p } from "@visulima/humanizer";
console.log(formatBytes(123412341, { decimals: 2 })); // "117.70 MB"
console.log(parseBytes("117.70 MB")); // 123417395.2
// Localization support in both directions
console.log(formatBytes(123412341, { decimals: 2, locale: "de" })); // "117,70 MB"
console.log(parseBytes("117,70 MB", { locale: "de" })); // 123417395.2
// Use a specified unit
console.log(formatBytes(123412341, { decimals: 2, unit: "KB" })); // "120,519.86 KB"
// Use a long unit
console.log(formatBytes(123412341, { decimals: 2, unit: "GB", long: true })); // "0.11 Gigabytes"
// Use a differnet base
console.log(formatBytes(123412341, { decimals: 2, base: 10 })); // "123.41 MB"
Default: "en".
formatBytes
and parseBytes
supports the following locales:
duration
use a modified version of HumanizeDuration.
I have the time in milliseconds and I want it to become "30 minutes" or "3 days, 1 hour".
import { duration } from "@visulima/humanizer";
duration(3000);
// => "3 seconds"
duration(2250);
// => "2.25 seconds"
duration(97320000);
// => "1 day, 3 hours, 2 minutes"
You can change the settings by passing options as the second argument.
Array of possible units to use. Units are y
, mo
, w
, d
, h
, m
, s
, and ms
.
Units are skipped if their count is zero. For example, if you pass a duration of 1000
and units ["h", "m", "s"]
, the output will be "1 second".
Must be in descending order of unit size. For example, ["h", "m"]
is valid but ["m", "h"]
is not.
Default: ["y", "mo", "w", "d", "h", "m", "s"]
duration(69000, { units: ["h", "m", "s", "ms"] });
// => "1 minute, 9 seconds"
duration(3600000, { units: ["h"] });
// => "1 hour"
duration(3600000, { units: ["m"] });
// => "60 minutes"
duration(3600000, { units: ["d", "h"] });
// => "1 hour"
Integer representing the maximum number of units to use.
Default: Infinity
duration(1000000000000);
// => "31 years, 8 months, 1 week, 19 hours, 46 minutes, 40 seconds"
duration(1000000000000, { largest: 2 });
// => "31 years, 8 months"
A boolean that, if true
, rounds the smallest unit.
Default: false
duration(1200);
// => "1.2 seconds"
duration(1200, { round: true });
// => "1 second"
duration(1600, { round: true });
// => "2 seconds"
String to display between units.
Default: ", "
in most languages, " ﻭ "
for Arabic
duration(22140000);
// => "6 hours, 9 minutes"
duration(22140000, { delimiter: " and " });
// => "6 hours and 9 minutes"
String to display between the count and the word.
Default: " "
duration(260040000);
// => "3 days, 14 minutes"
duration(260040000, { spacer: " whole " });
// => "3 whole days, 14 whole minutes"
String to display between the integer and decimal parts of a count, if relevant.
Default depends on the language.
duration(1200);
// => "1.2 seconds"
duration(1200, { decimal: " point " });
// => "1 point 2 seconds"
String to include before the final unit.
You can also set serialComma
to false
to eliminate the final comma.
Default: ""
duration(22140000, { conjunction: " and " });
// => "6 hours and 9 minutes"
duration(22141000, { conjunction: " and " });
// => "6 hours, 9 minutes, and 1 second"
duration(22140000, { conjunction: " and ", serialComma: false });
// => "6 hours and 9 minutes"
duration(22141000, { conjunction: " and ", serialComma: false });
// => "6 hours, 9 minutes and 1 second"
Integer that defines the maximum number of decimal points to show, if relevant. If undefined
, the count will be converted to a string using Number.prototype.toString()
.
This does not round any numbers. See the round
option.
Default: undefined
duration(8123.456789);
// => "8.123456789 seconds"
duration(8123.456789, { maxDecimalPoints: 3 });
// => "8.123 seconds"
duration(8100, { maxDecimalPoints: 99 });
// => "8.1 seconds"
duration(8000, { maxDecimalPoints: 99 });
// => "8 seconds"
duration(7999, { maxDecimalPoints: 2 });
// => "7.99 seconds"
Array of ten strings to which will replace the numerals 0-9. Useful if a language uses different numerals.
Default: undefined
for most languages, ["۰", "١", "٢", "٣", "٤", "٥", "٦", "٧", "٨", "٩"]
for Arabic
duration(1234);
// => "1.234 seconds"
duration(1234, {
digitReplacements: ["Zero", "One", "Two", "Three", "Four", "Five", "Six", "Seven", "Eight", "Nine"],
});
// => "One.TwoThreeFour seconds"
Use this option with care. It is an advanced feature.
Object used to customize the value used to calculate each unit of time. Most useful when you want to update the length of years or months, which have ambiguous lengths.
Default: { y: 31557600000, mo: 2629800000, w: 604800000, d: 86400000, h: 3600000, m: 60000, s: 1000, ms: 1 }
duration(2629800000);
// => "1 month"
duration(2629800000, {
unitMeasures: {
y: 31557600000,
mo: 30 * 86400000,
w: 604800000,
d: 86400000,
h: 3600000,
m: 60000,
s: 1000,
ms: 1,
},
});
// => "1 month, 10 hours, 30 minutes"
Language for unit display. Accepts an ISO 639-1 code from one of the supported languages.
Default: "en"
.
import { duration } from "@visulima/humanizer";
import { durationLanguage as es } from "@visulima/humanizer/language/es";
import { durationLanguage as ko } from "@visulima/humanizer/language/ko";
duration(3000, { language: es });
// => "3 segundos"
duration(5000, { language: ko });
// => "5 초"
duration
supports the following languages:
Language | Code |
---|---|
Afrikaans | af |
Albanian | sq |
Amharic | am |
Arabic | ar |
Basque | eu |
Bengali | bn |
Bulgarian | bg |
Catalan | ca |
Central Kurdish | ckb |
Chinese, simplified | zh_CN |
Chinese, traditional | zh_TW |
Croatian | hr |
Czech | cs |
Danish | da |
Dutch | nl |
English | en |
Esperanto | eo |
Estonian | et |
Faroese | fo |
Farsi/Persian | fa |
Finnish | fi |
French | fr |
German | de |
Greek | el |
Hebrew | he |
Hindi | hi |
Hungarian | hu |
Icelandic | is |
Indonesian | id |
Italian | it |
Japanese | ja |
Kannada | kn |
Khmer | km |
Korean | ko |
Kurdish | ku |
Lao | lo |
Latvian | lv |
Lithuanian | lt |
Macedonian | mk |
Mongolian | mn |
Malay | ms |
Marathi | mr |
Norwegian | no |
Polish | pl |
Portuguese | pt |
Romanian | ro |
Russian | ru |
Serbian | sr |
Slovak | sk |
Slovenian | sl |
Spanish | es |
Swahili | sw |
Swedish | sv |
Tamil | ta |
Telugu | te |
Thai | th |
Turkish | tr |
Ukrainian | uk |
Urdu | ur |
Uzbek | uz |
Uzbek (Cyrillic) | uz_CYR |
Vietnamese | vi |
Welsh | cy |
1337
→ 1.34 kB
1337000000
→ 15d 11h 23m 20s
Libraries in this ecosystem make the best effort to track Node.js’ release schedule. Here’s a post on why we think this is important.
If you would like to help take a look at the list of issues and check our Contributing guidelines.
Note: please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
The visulima humanizer is open-sourced software licensed under the MIT
FAQs
Humanizer is a library for humanizing data in a human-readable form.
The npm package @visulima/humanizer receives a total of 754 weekly downloads. As such, @visulima/humanizer popularity was classified as not popular.
We found that @visulima/humanizer demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
We're excited to introduce Socket Optimize, a powerful CLI command to secure open source dependencies with tested, optimized package overrides.
Product
We're excited to announce that Socket now supports the Java programming language.
Security News
Socket detected a malicious Python package impersonating a popular browser cookie library to steal passwords, screenshots, webcam images, and Discord tokens.