ng-date-interval
TypeScript icon, indicating that this package has built-in type declarations

2.2.0 • Public • Published

NgDateInterval

codecov Build Status

This Angular library provides a pipe that formats date intervals, given two dates. It does NOT display the time past between the two dates, rather it displays them in a more readable way.

From 12 to 14 August, 2020

Until 14 August, 2020

It takes locale into account too (English, French and Russian currently available).

Du 12 au 14 août 2020

С 12 до 14 дек. 2020 г.

Installation

npm install ng-date-interval

Import the module:

import { NgModule } from '@angular/core';
import { CommonModule } from '@angular/common';

import { NgDateIntervalModule } from 'ng-date-interval';


@NgModule({
  declarations: [],
  imports: [
    NgDateIntervalModule
  ]
})
export class YourModule { }

Basic usage

// Component ts
...
date1 = new Date('2020-03-12');
date2 = new Date('2020-03-13');
...
<!-- Component html -->
{{ [date1, date2] | dateInterval }}

<!-- From 12 to 13 Mar, 2020 -->

API

{{ value_expression | dateInterval [ : singleDateOutlook [ : format [ : locale ] ] ] }}

value_expression string | Date | Array<string | date> : the input date(s). Can be a date-like string or a Date instance or an array of them. If the array contains more than 2 dates, it will fallback to the first one in the array.

singleDateOutlook string 'backward' | 'forward' (default 'forward') : in the case of a single date, defines whether that date is a start or an end date (i.e Until <date> or Since <date>)

format string (default 'mediumDate'): a date format string as used in Angular's formatDate method. Setting this will override the default omission of Month/Year if they're the same for both dates.

locale localestring (default the app's locale, e.g en-US): specify the locale when wanting to display one different from that of the app's. Current locale support: en, fr, ru.

Contributing

Feel free to fork/fire up Pull Requests! Before you do though, make sure it's:

  • passing tests: ng test
  • covered by tests: npm run lib:test-coverage
  • passing the linter: ng lint

Issues

Anything missing/wrong? Please submit an issue 👍

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.


This project was generated with Angular CLI version 9.0.1.

Package Sidebar

Install

npm i ng-date-interval

Weekly Downloads

2

Version

2.2.0

License

MIT

Unpacked Size

96.3 kB

Total Files

21

Last publish

Collaborators

  • lamabiker