# date-difference

> Calculates the difference between two dates

Latest version **1.0.0** (published 2015-05-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install date-difference
pnpm add date-difference
yarn add date-difference
bun add date-difference
```

Provides the command `date-difference`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2015-05-28 |
| First published | 2015-05-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 2 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Rahul Nadella |
| Maintainers | rahulnadella |
| Keywords | date difference, date-difference, difference between dates, difference between two dates |

## Links

- npm: https://www.npmjs.com/package/date-difference
- Repository: https://github.com/rahulnadella/date-difference
- Issues: https://github.com/rahulnadella/date-difference/issues
- npm.io page: https://npm.io/package/date-difference

## Dependencies (2)

- [meow](https://npm.io/package/meow.md) ^3.1.0
- [get-stdin](https://npm.io/package/get-stdin.md) ^3.0.2

## Recent versions

- 1.0.0 (latest) — 2015-05-28

## README

# date-difference [![Build Status](https://travis-ci.org/rahulnadella/date-difference.svg?branch=master)](https://travis-ci.org/rahulnadella/date-difference)

>Most of the solutions don't take into account a case that fails when
the two dates involved go across a daylight saving change. In this case,
the date on which day light saving change happens will have a duration in
milliseconds which != 1000*60*60*24, so the typical calculation will fail.

>This function returns the difference between two dates represented in
a specific format => ``34y 338d 4h 8m 7s``

##Usage

``=> npm install -save date-difference``

```
var dateDifference = require('date-difference');

dateDifference(new Date('7/1/2015'), new Date('7/1/2016'));
=> '1y'

dateDifference(new Date("1980-07-01T03:00:00"), new Date("2015-05-27T07:08:07"));
=> '34y 338d 4h 8m 7s'

// compact option
dateDifference(new Date("2015-04-25T12:00:00"), new Date("2015-04-25T16:01:23"), {compact: true});
=> '~4h'

```

##CLI

``=> npm install --global date-difference``

```
  => date-difference --help
  
  Calculates the difference between two dates
  
  Usage
    date-difference <firstDate> <secondDate> [--compact]
    echo <firstDate> <secondDate> | date-difference
    
  Example
   date1 = new Date("2015-01-25T12:00:00");
   date2 = new Date("2015-03-05T04:01:23");
   
   date-difference date1 date2
   => 38d 16h 1m 23s
   
  Options
    --compact    Only show the first unit
    
```

##License

MIT License --> A short, permissive software license. Basically, you can do whatever you want as long as you include the original copyright and license notice in any copy of the software/source. There are many variations of this license in use.

---
_Source: https://npm.io/package/date-difference · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._