parse-duration

Convert a human readable duration string to a duration format

MIT 35 个版本

parse duration time

主页

仓库

提交 Issue

安装

npm install parse-duration

yarn add parse-duration

pnpm add parse-duration

bun add parse-duration

README

parse-duration

Convert a human readable duration to ms.

Usage

import parse from 'parse-duration'

// parse different time units
let ns = parse('1ns')       // => 1 / 1e6
let μs = parse('1μs')       // => 1 / 1000
let ms = parse('1ms')       // => 1
let s = parse('1s')         // => ms * 1000
let m = parse('1m')         // => s * 60
let h = parse('1h')         // => m * 60
let d = parse('1d')         // => h * 24
let w = parse('1w')         // => d * 7
let mo = parse('1mo')       // => y / 12
let y = parse('1y')         // => d * 365.25

// compound expressions
parse('1hr 20mins')         // => 1 * h + 20 * m
parse('1 hr 20 mins')       // => 1 * h + 20 * m

// youtube format
parse('1h20m0s')            // => 1 * h + 20 * m

// comma seperated numbers
parse('27,681 ns')          // => 27681 * ns

// noisy input
parse('duration: 1h:20min') // => 1 * h + 20 * m

// negatives
parse('-1hr 40mins')        // => -1 * h - 40 * m

// exponents
parse('2e3s')               // => 2000 * s

// custom output format
parse('1hr 20mins', 'm')    // => 80

// add units
parse.unit['μs'] = parse.unit.microsecond
parse('5μs')                // => 0.005

Locales

Switch the default en locale to another language (see /locale).

import es from 'parse-duration/locale/es.js'
import parse from 'parse-duration'

parse.unit = es

parse('1 hora 20 minutos', 'm') // 80

Safety

In sensitive APIs make sure input string is reasonably short (under 100 characters).

ॐ

版本列表

2.1.8 2026-07-10

2.1.7 2026-07-10

2.1.6 2026-04-07

2.1.5 2025-12-21

2.1.4 2025-03-28

2.1.3 2025-02-11

2.1.2 2025-01-31

2.1.1 2025-01-31

2.1.0 2025-01-31

2.0.2 2025-01-31

2.0.1 2025-01-26

2.0.0 2025-01-26

1.1.2 2025-01-24

1.1.1 2024-12-01

1.1.0 2023-06-06

1.0.3 2023-03-05

1.0.2 2021-10-15

1.0.1 2021-10-09

1.0.0 2021-03-16

0.5.0 2021-03-16

0.4.4 2020-05-10

0.4.3 2020-05-07

0.4.2 2020-05-05

0.4.1 2020-05-05

0.4.0 2020-05-05

0.3.3 2020-04-30

0.3.2 2020-04-27

0.3.1 2020-04-26

0.3.0 2020-04-22

0.2.1 2020-04-22

0.2.0 2020-04-22

0.1.3 2020-04-22

0.1.2 2019-12-06

0.1.1 2014-06-06

0.1.0 2013-12-19