@lpm.dev/neo.ms

Pool

ms

Zero-dependency time conversion library - Modern, tree-shakeable alternative to ms package

install @lpm.dev/neo.ms@v1.0.0

@lpm.dev/neo.ms

Zero-dependency time conversion library. Modern, tree-shakeable alternative to the ms package. 2-3x faster, 100% API compatible.

Install

lpm install @lpm.dev/neo.ms

Quick Start

import ms from '@lpm.dev/neo.ms'

// Parse string → milliseconds
ms('2 days')   // 172800000
ms('1h')       // 3600000
ms('30m')      // 1800000
ms('2.5s')     // 2500

// Format milliseconds → string
ms(172800000)          // '2d'
ms(172800000, { long: true })  // '2 days'

API

Default export — ms(value)

Drop-in replacement for the ms package:

import ms from '@lpm.dev/neo.ms'
// or
import { ms } from '@lpm.dev/neo.ms'

// Parse
ms('1d')     // 86400000
ms('1 day')  // 86400000
ms('1.5h')   // 5400000

// Format
ms(60000)               // '1m'
ms(60000, { long: true }) // '1 minute'

parse(str)

import { parse } from '@lpm.dev/neo.ms'

parse('2d')      // 172800000
parse('1 hour')  // 3600000
parse('30min')   // 1800000
parse('500ms')   // 500

format(ms, options?)

import { format, formatShort, formatLong } from '@lpm.dev/neo.ms'

format(172800000)              // '2d'
format(172800000, { long: true }) // '2 days'

formatShort(3600000)   // '1h'
formatLong(3600000)    // '1 hour'

Constants

import { MILLISECOND, SECOND, MINUTE, HOUR, DAY, WEEK, YEAR } from '@lpm.dev/neo.ms'

SECOND  // 1000
MINUTE  // 60000
HOUR    // 3600000
DAY     // 86400000
WEEK    // 604800000
YEAR    // 31557600000

Supported Units

Input Milliseconds
1ms, 1 millisecond 1
1s, 1 sec, 1 second 1,000
1m, 1 min, 1 minute 60,000
1h, 1 hr, 1 hour 3,600,000
1d, 1 day 86,400,000
1w, 1 wk, 1 week 604,800,000
1y, 1 yr, 1 year 31,557,600,000

Decimal values are supported: '1.5h' → 5400000

Migration from ms

// Before
import ms from 'ms'

// After — exact same API
import ms from '@lpm.dev/neo.ms'

That's it. No other changes needed.

License

MIT