elegant-ms

elegant-ms is a simple, beginner-friendly package that helps you convert milliseconds and seconds into various human-readable formats — including Discord timestamps, duration strings, and more.

✅ Features

• Beginner friendly
• Convert MS to Time String
• Convert MS to Date String
• Convert MS to Duration format
• Convert MS to Discord timestamp format
• Convert Seconds to Time String
• Convert Seconds to Date String
• Convert Seconds to Duration format
• Convert Seconds to Discord timestamp format
• Parse strings like 1d 2h 3m into MS or Seconds

📦 Installation

npm install elegant-ms

📘 Usage

CommonJS (CJS)

const {
  discordTimestamps,
  msToDateString,
  msToTimeString,
  msToDuration,
  msToDiscordTimestampString,
  stringToMS,
  secondsToDateString,
  secondsToTimeString,
  secondsToDuration,
  secondsToDiscordTimestampString,
  stringToSeconds
} = require('elegant-ms');
...

ESM (TypeScript)

import {
  discordTimestamps,
  msToDateString,
  msToTimeString,
  msToDuration,
  msToDiscordTimestampString,
  stringToMS,
  secondsToDateString,
  secondsToTimeString,
  secondsToDuration,
  secondsToDiscordTimestampString,
  stringToSeconds,
} from 'elegant-ms';
...

📈 Changelog

v0.0.7

• Added full support for Seconds-based conversion:
  • secondsToDuration
  • secondsToDateString
  • secondsToTimeString
  • secondsToDiscordTimestampString
  • stringToSeconds
• Added secondsToTimeOptions type

v0.0.6

• Improved README formatting

v0.0.5

• Improved error handling in stringToMS

Enjoy using elegant-ms and feel free to contribute or open issues! 🎉