Gathering detailed insights and metrics for enhanced-ms
Gathering detailed insights and metrics for enhanced-ms
Convert human readable time-frame strings to milliseconds and vice versa, with support for i10n and operators!
Installations
npm install enhanced-msDeveloper Guide
BETA
Typescript
Yes
Module System
ESM
Node Version
20.19.0
NPM Version
10.8.2
Releases
Unable to fetch releases
Languages
2
TypeScript
Shell
TypeScript (99.82%)
Shell (0.18%)
Developer
Download Statistics
Total Downloads
274,441
Last Day
906
Last Week
5,985
Last Month
23,484
Last Year
222,218
GitHub Statistics
MIT License
16 Stars
88 Commits
6 Forks
1 Watchers
1 Branches
5 Contributors
Updated on Apr 09, 2025
Bundle Size
16.77 kB
Minified
4.47 kB
Minified + Gzipped
Maintainers
1
Package Meta Information
Latest Version
4.1.0
Package Id
enhanced-ms@4.1.0
Unpacked Size
93.83 kB
Size
18.33 kB
File Count
6
NPM Version
10.8.2
Node Version
20.19.0
Published on
Mar 20, 2025
Total Downloads
Cumulative downloads
Total Downloads
274,441
Last Day
12.4%
906
Compared to previous day
Last Week
8.2%
5,985
Compared to previous week
Last Month
-1.7%
23,484
Compared to previous month
Last Year
508.2%
222,218
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Enhanced MS
Convert milliseconds to human-readable duration strings and vice versanpm install enhanced-ms
🤔 About
enhanced-ms is a flexible library for formatting milliseconds into human-readable durations and vice versa. It is an enhanced version of the popular ms with support for multiple inputs, localization, and more options.
🏓 Table of Contents
📦 Installation
Install using your preferred package manager:
1npm install enhanced-ms 2pnpm add enhanced-ms 3yarn add enhanced-ms
🧭 Comparison
As mentioned above, enhanced-ms is an enhanced version of the popular ms, so how does it compare?
| Feature | enhanced-ms | ms | pretty-ms | itty-time |
|---|---|---|---|---|
| Convert Milliseconds to Duration | ✅ | ✅ | ✅ | ✅ |
| Convert Milliseconds to Multiple Duration Units | ✅ | ❌ | ❌ | ❌ |
| Convert Duration to Milliseconds | ✅ | ✅ | ❌ | ✅ |
| Convert Multiple Duration Units to Milliseconds | ✅ | ❌ | ❌ | ❌ |
| Localization Support | ✅ | ❌ | ❌ | ❌ |
🌐 Languages
The currently supported languages include:
| Language | Key |
|---|---|
| English (default) | en |
| German | de |
| Russian | ru |
| Māori | mi |
| Spanish | es |
| Dutch | nl |
| Italian | it |
| French | fr |
You can help by adding support for more languages.
Make a pull request here.
🚀 Usage
Language and Default Options
The createMs function allows you to create a new instance of ms with a custom language and custom default options. This is useful if you want to use a different language or prefer different default options for parsing and formatting.
1function createMs(options?: CreateMsOptions): typeof ms;
| Option | Type | Description | Default |
|---|---|---|---|
language | Locale | LanguageDefinition | The language to use for parsing and formatting, if your preferred isn't supported, you can directly pass a language definition. | en |
formatOptions | FormatOptions | FormatOptionsPreset | The options to use for formatting. | see below |
Formatting Milliseconds to Duration
The ms function allows you to format a number of milliseconds to a duration string. Passing a number of milliseconds will return a duration string, if the number is invalid, it will return null. The milliseconds overloads also allows you to pass a FormatOptions object or a FormatOptionsPreset to customise the formatting.
1function ms(milliseconds: number): string | null; 2function ms(milliseconds: number, options: FormatOptions): string | null; 3function ms(milliseconds: number, preset: FormatOptionsPreset): string | null;
| Option | Type | Description | Default |
|---|---|---|---|
extends | FormatOptionsPreset | Extends the preset with the given options. | none |
hideUnitNames | boolean | Hide unit names from the output. | false |
useAbbreviations | boolean | Use abbreviations for unit names. | false |
includeZero | boolean | Include units with the value 0 in the output. | false |
includeMs | boolean | Include milliseconds in the output. | false |
includeSubMs | boolean | Include sub-millisecond units in the output. | false |
includedUnits | ParseUnit[] | Which units should be included in the output. | ['year', 'day', 'hour', 'minute', 'second'] |
unitLimit | number | The maximum number of units to include in the output. | -1 |
unitSeparator | string | The separator to use between units. | |
minimumDigits | number | The minimum number of digits for a unit, aka will pad with zeroes. | 0 |
| Preset | Example |
|---|---|
short | 1m 30s |
fullPrecision | 10 seconds 100 milliseconds 100 microseconds 100 nanoseconds |
colonNotation | 00:01:30 |
Parsing Duration to Milliseconds
The ms function also allows you to parse a duration string (1 day, 3 weeks 4 days, etc). Passing a duration string will return a number of milliseconds, if no valid duration units are found, it will return 0.
1function ms(duration: string): number;
No vulnerabilities found.
Reason
no binaries found in the repo
Reason
no dangerous workflow patterns detected
Reason
18 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Reason
Found 3/13 approved changesets -- score normalized to 2
Reason
8 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
- Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99
- Warn: Project is vulnerable to: GHSA-x574-m823-4x7w
- Warn: Project is vulnerable to: GHSA-4r4m-qw57-chr8
- Warn: Project is vulnerable to: GHSA-xcj6-pq6g-qj4x
- Warn: Project is vulnerable to: GHSA-356w-63v5-8wf4
- Warn: Project is vulnerable to: GHSA-859w-5945-r5v3
- Warn: Project is vulnerable to: GHSA-9crc-q9x8-hgqq
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Info: jobLevel 'contents' permission set to 'read': .github/workflows/label-sync.yml:14
- Info: jobLevel 'contents' permission set to 'read': .github/workflows/pull-request-triage.yml:13
- Warn: no topLevel permission defined: .github/workflows/label-sync.yml:1
- Warn: no topLevel permission defined: .github/workflows/pipeline.yml:1
- Warn: no topLevel permission defined: .github/workflows/pull-request-triage.yml:1
- Info: no jobLevel write permissions found
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/label-sync.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/label-sync.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/label-sync.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/label-sync.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pipeline.yml:67: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pipeline.yml:85: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/pipeline.yml:92: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pipeline.yml:134: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pipeline.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pipeline.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pipeline.yml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pipeline.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pull-request-triage.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/apteryxxyz/enhanced-ms/pull-request-triage.yml/main?enable=pin
- Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 2 third-party GitHubAction dependencies pinned
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
license file not detected
Details
- Warn: project does not have a license file
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'main'
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 23 are checked with a SAST tool
Score
3.5
/10
Last Scanned on 2025-05-05
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More