/date-range-compressor

Helper to compress a date range into full years, full months, and days between

Primary LanguageTypeScriptMIT LicenseMIT

date-range-compressor

Reduces a date range to full years, full months, and days between two dates.

Installation

Using npm, npm i date-range-compressor.

Using yarn, yarn add date-range-compressor.

Usage

Using import

import { compressDateRange } from 'date-range-compressor';

const compressedRange = compressDateRange('20191230', '20210203');

// compressedRange is {years: ['2020'], months: ['202101'], days: ['20191230', '20191231', '20210201', '20210202', '20210203']}

In a CommonJS environment

const { compressDateRange } = require('date-range-compressor');

const compressedRange = compressDateRange('20191230', '20210203');

// compressedRange is {years: ['2020'], months: ['202101'], days: ['20191230', '20191231', '20210201', '20210202', '20210203']}

Table of contents

Interfaces

Functions

Functions

compressDateRange

compressDateRange(start, end): CompressedDateRange

Compresses a date range between two days expressed as string date expressions

Export

Link

https://day.js.org/docs/en/parse/string-format Possible date formats

Parameters

Name Type Description
start string Starting day as any valid date string
end string End day as any valid date string

Returns

CompressedDateRange

The full years, full months and days included in that range

Defined in

index.ts:21


getDaysInRange

getDaysInRange(start, end, excludedMonths?, excludedYears?): string[]

Gets the days in range between to days

Export

Parameters

Name Type Default value Description
start string undefined YYYYMMDD to start the range
end string undefined YYYYMMDD to end the range
excludedMonths? string[] [] The months to exclude in range YYYYMM
excludedYears? string[] [] The years to exclude in range YYYY

Returns

string[]

The days range

Defined in

helpers/days.ts:16


getMonthsInRange

getMonthsInRange(start, end, excludedYears?): string[]

Gets all full months between two dates

Export

Parameters

Name Type Default value Description
start string undefined The start date as YYYYMMDD
end string undefined The end date as YYYYMMDD
excludedYears? string[] [] The list of years to exclude for checking as YYYY

Returns

string[]

The list of full months included in the range

Defined in

helpers/months.ts:53


getYearsInRange

getYearsInRange(start, end): string[]

Gets full years in date range

Export

Parameters

Name Type Description
start string The starting date YYYYMMDD
end string The end date YYYYMMDD

Returns

string[]

Full years between start and end

Defined in

helpers/years.ts:56

Interfaces

CompressedDateRange

Properties

days

Optional days: string[]

Defined in

index.ts:9


months

Optional months: string[]

Defined in

index.ts:8


years

Optional years: string[]

Defined in

index.ts:7