ritm-date/README.md

Date & time lightweight formatter

# ritm-date

[![npm version](https://badge.fury.io/js/ritm-date.svg)](https://badge.fury.io/js/ritm-date)

Really lightweight, fast date & time formatter.
Typescript friendly

1. npm install ritm-date
2. import rDate from 'ritm-date' at your .js/.ts file
3. use it

```js
rDate(new Date()).format()
// Output: '01.02.2022 • 00:00'

rDate('2022-02-01T00:00:00+03:00').format()
// Output: '01.02.2022 • 00:00'

rDate(new Date()).format('iso')
// Output: '2022-02-01T00:00:00+03:00'

rDate(new Date()).format('DD-MM-YY')
// Output: '01-02-2022'

rDate(new Date()).setLocale('ru').format('DD MMM YY')
// Output: '01 Фев 2022'

rDate(new Date()).setLocale('en').format('DD MMM YY')
// Output: '01 Feb 2022'

rDate(new Date()).setLocale('en').format('DD ** MMMM ** YY')
// Output: '01 ** February ** 2022'

rDate(new Date()).format('DD*MM&YY::HH:mm')
// Output: '01*02&22::00:00'

rDate(new Date()).calc(-10, 'days').calc(1, 'hour').format()
// You can use day/days, hour/hours, minute/minutes
// Output: '22.01.2022 • 02:00'

rDate('2022-02-01T12:34:56+03:00').zeroing().format('iso')
// Zeroing time
// Output: '2022-02-01T00:00:00+03:00'

rDate(new Date()).zone(1).format('iso')
// Output: '2022-01-31T20:00:00-01:00'

rDate(new Date()).format('x')
// Output: 1643662800000 <-- Timestamp

rDate(new Date()).format('l')
// Short format, e.g. for comparing dates
// Output: 1/2/22 <-- Timestamp

rDate(new Date()).isValid()
// Output: true
// DEPRECATED! output will be Error or true. Please use rDate().isValid(someDate) instead

rDate().isValid(new Date('grrr!'))
// Output: false

rDate().isValid('12:13:56')
// Output: false

rDate().isValid('string')
// Output: false
```

## Utils

**Locales**: en/ru

**Available abbreviations for masks:** YYYY, YY, MMMM, MMM, MM, M, DD, D, dd, ddd, HH, h, mm, ss