@arcjet/duration

@arcjet/duration

Arcjet utilities for parsing duration strings.

• npm package (@arcjet/duration)
• GitHub source code (duration/ in arcjet/arcjet-js)

What is this?

This is an internal utility that exists so our users can pass meaningful duration strings such as 1h instead of having to manually calculate seconds or milliseconds. We turned the Go [ParseDuration][go-parser] into TypeScript so that we have the exact same functionality in both languages.

When should I use this?

You should not use this but use one of the many alternatives such as vercel/ms. This package matches our current needs which are likely different from yours.

Install

This package is ESM only. Install with npm in Node.js:

npm install @arcjet/duration

Example

import { parse } from "@arcjet/duration";

const seconds = parse("1h");
console.log(seconds); // prints 3600

License

Apache License, Version 2.0 © Arcjet Labs, Inc.

Derivative work based on time.ParseDuration from golang/go licensed under BSD-3.0 © The Go Authors. Our work ports to TypeScript.

Changelog

1.0.0-beta.12 (2025-09-22)

🚀 New Features

• add React Router integration (#5199) (498292e)
• analye-wasm, redact-wasm: ignore dashes in card numbers (#5210) (5c414d6)
• arcjet: add IP-related fields to filters (#5170) (d0aeb84)
• filters: add limit to 10 expressions, 1024 bytes (#5212) (502288a)
• stable-hash, transport: support workerd (#5077) (13c90d6)

🪲 Bug Fixes

• arcjet: show error about incorrect characteristics in logs (#5078) (9839c9c)
• astro: fix types, zod validation (#5052) (ea82f8f)
• examples: add styles to remix-express (#5115) (783db87)

📝 Documentation

• add JSDocs examples to filter rule (#5208) (c4e506a)

🧹 Miscellaneous Chores

• ci: Remove dependabot groups on examples and apply cooldown to direct deps (#5202) (9058a24)
• examples: remove experimental.nodeMiddleware from example (#5124) (408a26e)

📚 Tests

• astro: add tests (#5069) (e6d9980)