dates

A small utility library for managing date objects. Good alternative to Moment and its larger footprint.

Getting Started

To install:

yarn add @janiking/dates

You may also use bower or npm if you prefer. Or, you can clone the repository with your generic clone commands as a standalone repository or submodule.

git clone git://github.com/jani-king-international/dates.git

dates has no dependencies.

Support

dates supports all modern browsers, and is tested on IE11 and up.

Docs

• format(date, delimiterOrPattern) - Formats a date string from a date object, based on the pattern of the third object. If delimiterOrPattern is:

  • One character, it is assumed to be a delimiter, and used to separate the numbers of a default date string (mm/dd/yyyy)
  • Otherwise, the format of the date string is constructed based on some of the common standard patterns, such as what is used in Java Simple Date Format. Examples:

      date based examples:
      'M d, yyyy' => 1 5, 2015
      'MM dd yy' => 01 05 15
      'M-d-yy' => 1-1-15
      'MM-dd-yyyy' => 01-01-2015
      'MM/d/yy' => 12/25/15
         
      day based examples:
      'yyyy/MM/dd, E' => 2016/01/26, Tuesday
      'yyyy/MM/dd, e' => 2016/01/26, Tue
         
      time based examples:
      'yyyy/MM/dd h:m A' => 2016/01/26 04:23 AM
      'h:m:s a' => 4:23:32 pm
      'hh:m:s a' => 04:23:32 pm
      'H:m' => 16:23
         

• toDate(str) - Returns a date object based on the date string.

• getNaturalDay(date, compareDate, noDaysOfWeek) - Returns simple natural dates (Yesterday, Today, Tommorrow) or the date. Will add Mon, Tues, etc, unless noDaysOfWeek is true. compareDate is usually the current date.

• toTimestamp(date) - Returns a timestamp based on the date object.

• fromTimestamp(string) - Returns a date based on the timestamp - although this is used under the hood, prefer use: toDate

• isTimestamp(string) - Returns a boolean on whether the argument is a timestamp.

• subtract(date, amount, dateType) - Subtracts N "something" (day, week, month, year) from a date object.

• add(date, amount, dateType) - Adds N "something" (day, week, month, year) from a date object.

• subtractDate(date1, date2, datepart) - Subtracts date1 from date2 and returns the difference based on the increment of the third parameter (in days, weeks, etc).

• copy(date) - Returns a copy of a date object.

• isLess(date1, date2) - Returns if first date is less than second date.

• isGreater(date1, date2) - Returns if first date is greater than second date.

• min(date1, date2, ...) - Returns the lesser of a number of dates. At least 2 arguments or an array.

• max(date1, date2, ...) - Returns the greater of a number of dates. At least 2 arguments or an array.

• diff(date1, date2) - The difference, in days, between two date objects. Always a positive value.

• isValid(date) - Determines if the date object or date string is a valid date.

• isValidObject(value) - Determines if the value is a valid date object.

• isLeapYear(dateOrYear) - Determines if the date or year is a leap year.

• getMonthIndex(name) - Returns the zero-based index, given a month name, which can be a full name or abbreviation (January or Jan).

• getFirstSunday(date) - For use in building calendars.

• getDaysInMonth(date) - For use in building calendars.

• getDaysInPrevMonth(date) - For use in building calendars.

• getMonthName(date) - Returns the month name of a date.

• zeroTime(date) - Sets the time to zero, leaving date intact.

###is()

The is() functionality has simple chaining to make some statements more clear. For example, with dates.isGreater(date1, date2), it's not obvious in what order the dates should be.

• is(date1).less(date2) - Returns if first date is less than second date.
• is(date1).greater(date2) - Returns if first date is greater than second date.=
• is(date1).valid() - alias to isValid.
• is(date1).timestamp() - alias to isTimestamp.
• is(date1).equal(date2) - Returns is the two dates are equal.
• is(date1).equalTime() - Returns is the two objects have equal times, ignoring the date.
• is(date1).equalDate() - Returns is the two objects have equal dates, ignoring the time.
• is(date1).time() - If passed string is a valid time.
• is(date1).date() - If passed string is a valid date.

License

This uses the MIT license. Feel free to use, and redistribute at will.