date-extensions v3.0.2
JavaScript DateExtended Extensions
JavaScript Date class extensions that allows one to easily interact with Dates.
Prerequisites
None :).
Installation
yarn add date-extensions
yarn install
Features
Localized day and month names
Default locale is en-us.
date = new DateExtended('2018-09-01');
date.getDayName(); // Saturday
date.getDayShortName(); // Sat
date.getMonthName(); // September
date.getMonthShortName(); // Sep
You can add other locales by including selected locale file from dist/i18n/*.js
. Locale can be changed at runtime using DateExtended.setDefaultLocale
or (DateExtendedInstance).setLocale
functions.
date = new DateExtended('2018-09-01');
date.getDayName(); // Saturday
date.setLocale('pl');
date.getDayName(); // Sobota
DateExtended.add & DateExtended.sub
Supported interval types are: day week month year hour minute second
date = new DateExtended('2018-09-01');
date.add(1, 'year'); // Sun Sep 01 2019 02:00:00 GMT+0200 (CEST)
date.sub(1, 'week'); // Sat Aug 25 2018 02:00:00 GMT+0200 (CEST)
DateExtended.format
Allows one to easily format date object into a string in PHP way.
date = new DateExtended('2018-09-01');
date.format('Y-m-d H:i:s l F'); // 2018-09-01 02:00:00, Sobota Wrzesień
DateExtended.clone
Clones date object into new one.
date = new DateExtended('2018-09-01');
date.clone().add(1, 'month'); // Mon Oct 01 2018 02:00:00 GMT+0200 (CEST)
// date is still Sat Sep 01 2018 02:00:00 GMT+0200 (CEST)
DateExtended.isValid
Checks if DateExtended object is valid
(new DateExtended('2018-09-01')).isValid(); // true
(new DateExtended('0000-00-00')).isValid(); // false
DateExtended.createFromFormat
Parses a date string according to a specified format. Supported format tokens are: d, j, F, M, m, n, Y, y, G, g, H, h, i, s. Any other characters are being ignored. Token meanings are the same as in PHP language.
DateExtended.createFromFormat('H:i:s j F Y', '12:59:03 4 Listopad 2017'); // Sat Nov 04 2017 12:59:03 GMT+0100 (CET)
DateExtended.createFromDate
You can create DateExtended instance from Date instance.
DateExtended.createFromDate(new Date);