# @momsfriendlydevco/readable > Utility formatters to take raw data and present it in a readable format Latest version **1.2.1** (published 2020-02-14) · MIT license · 0 weekly downloads ## Install ```sh npm install @momsfriendlydevco/readable pnpm add @momsfriendlydevco/readable yarn add @momsfriendlydevco/readable bun add @momsfriendlydevco/readable ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.2.1 | | Published | 2020-02-14 | | First published | 2018-10-03 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 34.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1 | | Author | Matt Carter | | Maintainers | 1watt, eekthecat, hash-bang, melromero, mr-yellow | | Keywords | readable, formaters, relative, time, filesize, file, size, byte, size, sizeOf, human, readable | ## Links - npm: https://www.npmjs.com/package/@momsfriendlydevco/readable - Repository: https://github.com/MomsFriendlyDevCo/readable - Homepage: https://github.com/MomsFriendlyDevCo/readable#readme - Issues: https://github.com/MomsFriendlyDevCo/readable/issues - npm.io page: https://npm.io/package/@momsfriendlydevco/readable ## Alternatives - [@js-joda/timezone](https://npm.io/package/@js-joda/timezone.md) — 383.4K weekly downloads - [chartjs-adapter-moment](https://npm.io/package/chartjs-adapter-moment.md) — 210.8K weekly downloads - [strftime](https://npm.io/package/strftime.md) — 171.2K weekly downloads - [vue-flatpickr-component](https://npm.io/package/vue-flatpickr-component.md) — 115.8K weekly downloads - [timepicker](https://npm.io/package/timepicker.md) — 51.0K weekly downloads ## Recent versions - 1.2.1 (latest) — 2020-02-14 - 1.2.0 — 2019-05-17 - 1.1.5 — 2018-10-29 - 1.1.4 — 2018-10-24 - 1.1.3 — 2018-10-22 - 1.1.2 — 2018-10-22 - 1.1.1 — 2018-10-22 - 1.1.0 — 2018-10-22 - 1.0.0 — 2018-10-03 - 0.0.1 — 2018-10-03 - 0.0.0 — 2018-10-03 ## README @momsfriendlydevco/readable =========================== Utility formatters to take raw data and present it in a readable format. Features: * No dependencies * Tiny footprint * Customizable time / size units * Code is as small as possible and easily copy/pasteable API === readable.defaults ----------------- Obejct containing all the default settings. These are deep merged with any setting object given to a formatter. readable.fileSize(bytes, [options]) ----------------------------------- Return a human readable file size. ```javascript readable.fileSize(1024) //= "1kb" readable.fileSize(1536) //= "1.5kb" readable.fileSize(1048576) //= "1mb" readable.fileSize(1073741824) //= "1tb" readable.fileSize(1288490188) //= "1.2tb" ``` This function can take the following options: | Option | Type | Default | Description | |-------------------------|--------------------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `decimals` | `number` | `1` | Decimal places to format the number into | | `decimalsAbsolute` | `boolean` | `true` | If true the decimals will be clipped entirely if the number is exactly correct (e.g. if the input is `1024` the output is `1kb` not `1.0kb`) | | `units` | `Object` | (See code) | A list of units to output, each is named in the plural with a boolean indicating if it should be reported e.g. `{units: {years: true}}` to enable years as a usable unit | | `formatters` | `Object` | (See code) | A list of formatters for each named unit, each should be a function taking a single value. e.g. `{formatters: {days: v => \`${v} days\`}}` | | `formatters.fallback` | `Function` or `String` | `""` | The fallback formatter to use, if it is a string its used as is, if it is a function it is called with the value | | `values` | `Object` | (See code) | A list of unit values to work with if the unit is enabled, each is the plural key of the measure with the number of milliseconds within the unit as the key | readable.relativeTime(timestamp, [options]) ------------------------------------------- Return a human readable relative time distance. ```javascript readable.relativeTime(new Date(Date.now() - 50)) //= "Just now" readable.relativeTime(new Date(Date.now() - 50), {units: {milliseconds: true}}) //= "50ms" readable.relativeTime(Date.now() - 5000) //= "5s" readable.relativeTime(new Date(Date.now() - 60000)) //= "1m" readable.relativeTime(new Date(Date.now() - 65000)) //= "1m5s" readable.relativeTime(moment().subtract(1, 'w').subtract(2, 'd')) //= "9D" ``` This function can take the following options: | Option | Type | Default | Description | |-----------------------|------------------------|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `units` | `Object` | (See code) | A list of units to output, each is named in the plural with a boolean indicating if it should be reported e.g. `{units: {years: true}}` to enable years as a usable unit | | `formatters` | `Object` | (See code) | A list of formatters for each named unit, each should be a function taking a single value. e.g. `{formatters: {days: v => \`${v} days\`}}` | | `formatters.fallback` | `Function` or `String` | `"Just now"` | The fallback formatter to use, if it is a string its used as is, if it is a function it is called with the value | | `formatters.input` | `Function` | (See code) | Input mangler, by defaults this converts dates and Moment objects to a millisecond offset from now | | `formatters.combiner` | `Function` | (See code) | Function used to combine all compiled units, by default this joins everything into a string with no spacing and truncates any training spaces | | `values` | `Object` | (See code) | A list of unit values to work with if the unit is enabled, each is the plural key of the measure with the number of milliseconds within the unit as the key | readable.sizeOf(data, [options]) -------------------------------- Calculate the (approximate in some cases) size of a variable as quickly as possible. ```javascript readable.sizeOf(123) //= 4 (JS uses 64bit integers) readable.sizeOf('a') //= 3 (1 byte + enclosing speachmarks) readable.sizeOf({}) //= 2 (enclosing braces only) readable.sizeOf({foo: 'abc'}) //= 14 ``` The following assumptions are made: * Whitespace for stringified data is ignored * Strings are 1 char to 1 byte (unless options.stringDeepScan is specified) * Numbers are 64 bit / 2 bytes * Circular references are resolved to a given byte size (see options.circular) This function can take the following options: | Option | Type | Default | Description | |------------------|-------------------------|------------|-------------------------------------------------------------------------------------------------| | `circular` | `boolean` or `number` | `false` | Calculate circular references as this byte value, if boolean `false` references are not checked | | `stringDeepScan` | `boolean` | `false` | Calculate additional UTf-8 storage space | | `stringOverhead` | `number` | `2` | Additional bytes for string storage, set to `2` to store enclosing speachmarks | | `fallback` | `function` | (See code) | Function to use to calculate all non-handled types (defaults to JSON.stringify length) | --- _Source: https://npm.io/package/@momsfriendlydevco/readable · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._