gitwtfhub

wtf is duration?

medikoo/duration — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2023-09-06

★ 30JavaScriptAudience · developerComplexity · 1/5DormantSetup · easy

TL;DR

A small JavaScript library that calculates the time between two dates and formats it into readable text like '10y 2m 6d 03:23:08'.

Mindmap

mindmap
  root((duration))
    What it does
      Time between dates
      Readable formatting
      Calendar math
    Access options
      Total days or hours
      Leftover after months
      Custom toString pattern
    Use cases
      Project deadlines
      Fitness tracking
      Backup logs
    Simplicity
      Small library
      No calendar math needed
      Plain JavaScript

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Show a project tracker deadline as 'due in 3 months and 5 days' instead of a raw millisecond count.

REASON 2

Display total workout time in a fitness app, like '45 hours this year'.

REASON 3

Log how long a backup or job took in a human-readable format such as '2 hours and 14 minutes'.

What's in the stack?

JavaScript

How it stacks up

medikoo/durationkappaemme-git/mengtofrontendm2station/m2_git_diff
Stars303030
LanguageJavaScriptJavaScriptJavaScript
Last pushed2023-09-06——
MaintenanceDormant——
Setup difficultyeasyeasyeasy
Complexity1/51/52/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min
License details not mentioned in the explanation.

Yoink these prompts

Prompt 1
Show me how to use the duration library to calculate the time between two JavaScript Date objects and print it as readable text.
Prompt 2
How do I get the total number of months elapsed versus the leftover months after full years using this duration library?
Prompt 3
Write code using this library's toString method with a custom format pattern to display hours and minutes only.
Prompt 4
Help me use this duration library in a project tracker to show how much time remains until a deadline.

Frequently asked questions

wtf is duration?

A small JavaScript library that calculates the time between two dates and formats it into readable text like '10y 2m 6d 03:23:08'.

What language is duration written in?

Mainly JavaScript. The stack also includes JavaScript.

Is duration actively maintained?

Dormant — no commits in 2+ years (last push 2023-09-06).

What license does duration use?

License details not mentioned in the explanation.

How hard is duration to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is duration for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane