JSPM – little-date@0.0.2

Package Exports

little-date
little-date/dist/format-date-range.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (little-date) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Small & sweet date-range formatting

An opinionated library that makes date-ranges short and readable.

_{Prepared by Timo Lins 👨‍🍳 for a ▲ Vercel Hackathon}

Features

✨ Short & readable output
⚙️ Zero configuration
⏳ Localization support (12 hour & 24-hour)
✅ Supports broad range of cases

Sample Outputs

Jan 1 - 12
Jan 3 - Apr 20
January 2023
Q1 2023

You can find a full list of formatting examples here.

Usage

import { formatDateRange } from "little-date";

const from = new Date("2021-01-01T00:00:00.000Z");
const to = new Date("2021-01-12T23:59:59.999Z");

console.log(formatDateRange(from, to)); // Outputs: "Jan 1 - 12"

Installation

With pnpm

pnpm i little-date

With NPM

npm i little-date

Formatting Examples

Description	Output
Multiple days, same month	`Jan 1 - 12`
Multiple days, different months	`Jan 3 - Apr 20`
Full day	`Sun, Jan 1`
Range spanning different years	`Jan 1 '22 - Jan 20 '23`
Full day, different year	`Sat, Jan 1, 2022`
Special Cases
Full year	`2023`
Quarter range	`Q1 2023`
Entire month	`January 2023`
With time
Today, different hours	`12am - 2:30pm`
Same day, different hours	`Jan 1, 12:11am - 2:30pm`
Same day, different hours, 24-hour format	`Jan 1, 0:11 - 14:30`
Hour difference within a day	`Jan 1, 12pm - 12:59pm`
Different days with time included	`Jan 1, 12:11am - Jan 2, 2:30pm`
Different years with time	`Jan 1 '22, 12:11am - Jan 2 '23, 2:30pm`
Different years, no time	`Jan 1 '22 - Jan 2 '23`

Contribute

We welcome contributions! If you'd like to improve little-date or have any feedback, feel free to open an issue or submit a pull request.

License

MIT