Gathering detailed insights and metrics for enhanced-ms
Installations
npm install enhanced-msDeveloper Guide
BETA
Typescript
Yes
Module System
ESM
Node Version
23.6.0
NPM Version
10.9.2
Releases
Unable to fetch releases
Contributors
3
Unable to fetch Contributors
Languages
2
TypeScript
Shell
TypeScript (99.74%)
Shell (0.26%)
validate.email 🚀
Verify real, reachable, and deliverable emails with instant MX records, SMTP checks, and disposable email detection.
Developer
Download Statistics
Total Downloads
229,674
Last Day
842
Last Week
5,657
Last Month
26,466
Last Year
187,570
GitHub Statistics
MIT License
15 Stars
80 Commits
6 Forks
1 Watchers
1 Branches
3 Contributors
Updated on Feb 28, 2025
Bundle Size
11.63 kB
Minified
3.62 kB
Minified + Gzipped
Maintainers
1
Package Meta Information
Latest Version
4.0.0
Package Id
enhanced-ms@4.0.0
Unpacked Size
77.52 kB
Size
16.00 kB
File Count
6
NPM Version
10.9.2
Node Version
23.6.0
Published on
Feb 09, 2025
Total Downloads
Cumulative downloads
Total Downloads
229,674
Last Day
-13.6%
842
Compared to previous day
Last Week
-6.3%
5,657
Compared to previous week
Last Month
-20.2%
26,466
Compared to previous month
Last Year
507.8%
187,570
Compared to previous year
Daily Downloads
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 |
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
19 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10
Reason
no binaries found in the repo
Reason
no dangerous workflow patterns detected
Reason
3 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-9crc-q9x8-hgqq
Reason
Found 1/17 approved changesets -- score normalized to 0
Reason
no effort to earn an OpenSSF best practices badge detected
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: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/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:130: 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/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
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
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
project is not fuzzed
Details
- Warn: no fuzzer integrations found
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 16 are checked with a SAST tool
Score
3.8
/10
Last Scanned on 2025-03-10
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