date-and-time
Advanced tools
Comparing version 0.1.4 to 0.1.5
{ | ||
"name": "date-and-time", | ||
"version": "0.1.4", | ||
"description": "Date and time utilities for Node.js and a browser", | ||
"version": "0.1.5", | ||
"description": "Date and time utilities for Node.js and browser", | ||
"main": "src/date-and-time.js", | ||
@@ -6,0 +6,0 @@ "scripts": { |
# date-and-time [![Circle CI](https://circleci.com/gh/knowledgecode/date-and-time.svg?style=svg)](https://circleci.com/gh/knowledgecode/date-and-time) | ||
Date-and-time is date and time utilities for Node.js and browser. | ||
## WHY? | ||
Probably the most famous date library is [Moment.js](http://momentjs.com/). It is so great, but has been bloated (11.3k gz). It needs more simple one. | ||
Date and time utilities for Node.js and browser. | ||
## WHY | ||
Probably the most famous date library is [Moment.js](http://momentjs.com/). That is so great but has been bloated (11.3k gz). Required for us another simpler one. | ||
## Features | ||
- Simple and Small (1k gz). | ||
- Simple and slim (only 1.3k gz). | ||
- Not extending built-in objects. | ||
@@ -20,7 +20,7 @@ - Legacy IE support (IE6+). | ||
## Usage | ||
via require(): | ||
Node.js: | ||
```JavaScript | ||
var date = require('date-and-time'); | ||
``` | ||
via window or self object: | ||
browser: | ||
```JavaScript | ||
@@ -33,4 +33,4 @@ var date = window.date; | ||
var now = new Date(); | ||
date.format(now, 'YYYY/MM/DD HH:mm:ss'); // '2015/01/02 23:14:05' | ||
date.format(now, 'E MMM DD YYYY'); // 'Fri Jan 02 2015' | ||
date.format(now, 'YYYY/MM/DD HH:mm:ss'); // => '2015/01/02 23:14:05' | ||
date.format(now, 'E MMM DD YYYY'); // => 'Fri Jan 02 2015' | ||
``` | ||
@@ -49,3 +49,3 @@ | formatString | meaning | examples | | ||
| H | hour-24 | 23, 8 | | ||
| A | meridian | p.m., a.m. | | ||
| A | meridian | a.m., p.m. | | ||
| hh | hour-12 | 11, 08 | | ||
@@ -62,4 +62,4 @@ | h | hour-12 | 11, 8 | | ||
```JavaScript | ||
date.parse('2015/01/02 23:14:05', 'YYYY/MM/DD HH:mm:ss'); // Date object | ||
date.parse('02-01-2015', 'DD-MM-YYYY'); // Date object | ||
date.parse('2015/01/02 23:14:05', 'YYYY/MM/DD HH:mm:ss'); // => Date object | ||
date.parse('02-01-2015', 'DD-MM-YYYY'); // => Date object | ||
``` | ||
@@ -86,3 +86,3 @@ | formatString | meaning | examples | | ||
var now = new Date(); | ||
var next_year = date.addYears(now, 1); // Date object | ||
var next_year = date.addYears(now, 1); // => Date object | ||
``` | ||
@@ -92,3 +92,3 @@ ### addMonths(date, months) | ||
var now = new Date(); | ||
var next_month = date.addMonths(now, 1); // Date object | ||
var next_month = date.addMonths(now, 1); // => Date object | ||
``` | ||
@@ -98,3 +98,3 @@ ### addDays(date, days) | ||
var now = new Date(); | ||
var yesterday = date.addDays(now, -1); // Date object | ||
var yesterday = date.addDays(now, -1); // => Date object | ||
``` | ||
@@ -104,3 +104,3 @@ ### addHours(date, hours) | ||
var now = new Date(); | ||
var an_hour_ago = date.addHours(now, -1); // Date object | ||
var an_hour_ago = date.addHours(now, -1); // => Date object | ||
``` | ||
@@ -110,3 +110,3 @@ ### addMinutes(date, minutes) | ||
var now = new Date(); | ||
var two_minutes_later = date.addMinutes(now, 2); // Date object | ||
var two_minutes_later = date.addMinutes(now, 2); // => Date object | ||
``` | ||
@@ -116,3 +116,3 @@ ### addSeconds(date, seconds) | ||
var now = new Date(); | ||
var three_seconds_ago = date.addSeconds(now, -3); // Date object | ||
var three_seconds_ago = date.addSeconds(now, -3); // => Date object | ||
``` | ||
@@ -122,3 +122,3 @@ ### addMilliseconds(date, milliseconds) | ||
var now = new Date(); | ||
var a_millisecond_later = date.addMilliseconds(now, 1); // Date object | ||
var a_millisecond_later = date.addMilliseconds(now, 1); // => Date object | ||
``` | ||
@@ -129,12 +129,12 @@ ### subtract(date1, date2) | ||
var yesterday = new Date(2015, 0, 1); | ||
date.subtract(today, yesterday).toDays(); // 1 | ||
date.subtract(today, yesterday).toHours(); // 24 | ||
date.subtract(today, yesterday).toMinutes(); // 1440 | ||
date.subtract(today, yesterday).toSeconds(); // 86400 | ||
date.subtract(today, yesterday).toMilliseconds(); // 86400000 | ||
date.subtract(today, yesterday).toDays(); // => 1 | ||
date.subtract(today, yesterday).toHours(); // => 24 | ||
date.subtract(today, yesterday).toMinutes(); // => 1440 | ||
date.subtract(today, yesterday).toSeconds(); // => 86400 | ||
date.subtract(today, yesterday).toMilliseconds(); // => 86400000 | ||
``` | ||
### isValid(dateString, formatString) | ||
```JavaScript | ||
date.isValid('2015/01/02 23:14:05', 'YYYY/MM/DD HH:mm:ss'); // true | ||
date.isValid('02-29-2015', 'DD-MM-YYYY'); // false | ||
date.isValid('2015/01/02 23:14:05', 'YYYY/MM/DD HH:mm:ss'); // => true | ||
date.isValid('02-29-2015', 'DD-MM-YYYY'); // => false | ||
``` | ||
@@ -146,4 +146,4 @@ `formatString` is the same as one of `parse`. | ||
var date2 = new Date(2012, 0, 2); | ||
date.isLeapYear(date1); // false | ||
date.isLeapYear(date2); // true | ||
date.isLeapYear(date1); // => false | ||
date.isLeapYear(date2); // => true | ||
``` | ||
@@ -159,3 +159,3 @@ ## Locale | ||
date.format(new Date(), 'E MMM DD YYYY'); // ven. janv. 02 2015 | ||
date.format(new Date(), 'E MMM DD YYYY'); // => ven. janv. 02 2015 | ||
@@ -166,3 +166,3 @@ // Japanese | ||
date.format(new Date(), 'YYYY年MM月DD日(E) Ahh時'); // 2015年01月02日(金) 午前10時 | ||
date.format(new Date(), 'YYYY年MM月DD日(E) Ahh時'); // => 2015年01月02日(金) 午前10時 | ||
``` | ||
@@ -192,4 +192,4 @@ ## For developers in Japan (about [12-hour clock](http://en.wikipedia.org/wiki/12-hour_clock)) | ||
## Browser Support | ||
Chrome, Android, Firefox, Safari, Mobile Safari, Opera, and Internet Explorer 6+. | ||
Chrome, Firefox, Safari, Opera, and Internet Explorer 6+. | ||
## License | ||
MIT |
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
154729
14