ts-date-lite

Lightweight, type-safe date utility library for web developers.

Installation

npm install ts-date-lite

Usage

import { Injectable } from '@angular/core';
import { DateUtils } from 'ts-date-lite';

@Injectable({ providedIn: 'root' })
export class MyService {
  constructor(private date: DateUtils) { }
  
  myMethod(): void {
    this.date.format(new Date(), 'YYYY-MM-DD');              // '2026-04-11'
    this.date.relative(new Date(Date.now() - 3600000));     // '1 hour ago'
    this.date.isToday(new Date());                          // true
    this.date.add(new Date(), 7, 'day');                    // +7 days
    this.date.diff(new Date(), new Date(), 'day');          // difference in days
  }
}

Methods

| Method | Description | Example | |--------|-------------|---------| | format | Format date with pattern | format(date, 'YYYY-MM-DD') → '2026-04-11' | | relative | Get relative time | relative(now - 1h) → '1 hour ago' | | isToday | Check if date is today | isToday(date) → true/false | | add | Add time to date | add(date, 7, 'day') → date + 7 days | | diff | Get difference between dates | diff(d1, d2) → number of days | | startOf | Get start of period | startOf(date, 'month') → 1st of month | | endOf | Get end of period | endOf(date, 'year') → Dec 31st | | isBefore | Check if date is before | isBefore(d1, d2) → true/false | | isAfter | Check if date is after | isAfter(d1, d2) → true/false | | isSame | Check if dates are same | isSame(d1, d2) → true/false | | parse | Parse date string | parse('2024-01-01') → Date object | | now | Get current timestamp | now() → 171283... | | timestamp | Get current timestamp | timestamp() → 171283... |

License

MIT