date-and-time
Advanced tools
Comparing version 0.1.2 to 0.1.3
{ | ||
"name": "date-and-time", | ||
"version": "0.1.2", | ||
"version": "0.1.3", | ||
"description": "Date and time utilities for Node.js and a browser", | ||
@@ -5,0 +5,0 @@ "main": "src/date-and-time.js", |
# date-and-time | ||
Date-and-time is date and time utilities for Node.js and a browser. | ||
# WHY? | ||
## 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. | ||
# Features | ||
## Features | ||
- Simple and Small (1k gz). | ||
@@ -10,3 +10,3 @@ - Not extend built-in objects. | ||
# Installation | ||
## Installation | ||
Node.js: | ||
@@ -20,3 +20,3 @@ ```Shell | ||
``` | ||
# Usage | ||
## Usage | ||
via require(): | ||
@@ -30,4 +30,4 @@ ```JavaScript | ||
``` | ||
# Functions | ||
## format(date, formatString) | ||
## Functions | ||
### format(date, formatString) | ||
```JavaScript | ||
@@ -60,3 +60,3 @@ var now = new Date(); | ||
| S | millisecond | 7, 0 | | ||
## parse(dateString, formatString) | ||
### parse(dateString, formatString) | ||
```JavaScript | ||
@@ -83,3 +83,3 @@ date.parse('2015/01/02 23:14:05', 'YYYY/MM/DD HH:mm:ss'); // Date object | ||
| S | millisecond | 7, 0 | | ||
## addYears(date, years) | ||
### addYears(date, years) | ||
```JavaScript | ||
@@ -89,3 +89,3 @@ var now = new Date(); | ||
``` | ||
## addMonths(date, months) | ||
### addMonths(date, months) | ||
```JavaScript | ||
@@ -95,3 +95,3 @@ var now = new Date(); | ||
``` | ||
## addDays(date, days) | ||
### addDays(date, days) | ||
```JavaScript | ||
@@ -101,3 +101,3 @@ var now = new Date(); | ||
``` | ||
## addHours(date, hours) | ||
### addHours(date, hours) | ||
```JavaScript | ||
@@ -107,3 +107,3 @@ var now = new Date(); | ||
``` | ||
## addMinutes(date, minutes) | ||
### addMinutes(date, minutes) | ||
```JavaScript | ||
@@ -113,3 +113,3 @@ var now = new Date(); | ||
``` | ||
## addSeconds(date, seconds) | ||
### addSeconds(date, seconds) | ||
```JavaScript | ||
@@ -119,3 +119,3 @@ var now = new Date(); | ||
``` | ||
## addMilliseconds(date, milliseconds) | ||
### addMilliseconds(date, milliseconds) | ||
```JavaScript | ||
@@ -125,3 +125,3 @@ var now = new Date(); | ||
``` | ||
## subtract(date1, date2) | ||
### subtract(date1, date2) | ||
```JavaScript | ||
@@ -136,9 +136,9 @@ var today = new Date(2015, 0, 2); | ||
``` | ||
## isValid(dateString, formatString) | ||
### isValid(dateString, formatString) | ||
```JavaScript | ||
date.parse('2015/01/02 23:14:05', 'YYYY/MM/DD HH:mm:ss'); // true | ||
date.parse('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 | ||
``` | ||
`formatString` is the same as one of `parse`. | ||
## isLeapYear(date) | ||
### isLeapYear(date) | ||
```JavaScript | ||
@@ -150,3 +150,3 @@ var date1 = new Date(2015, 0, 2); | ||
``` | ||
# Locale | ||
## Locale | ||
Months, day of week, and meridian are written in English. If you want to change language, rewrite them. | ||
@@ -168,7 +168,8 @@ ```JavaScript | ||
``` | ||
# For developers in Japan (about [12-hour clock](http://en.wikipedia.org/wiki/12-hour_clock)) | ||
## For developers in Japan (about [12-hour clock](http://en.wikipedia.org/wiki/12-hour_clock)) | ||
日本では時刻を午前と午後に分ける12時間制の表現が英米式と異なるばかりでなく、それ自体に曖昧さがあり、しばしば混乱が生じます。 | ||
そのため日本のシステム開発の現場では多くの場合24時間制が用いられるかと思いますが、念のため12時間制を用いる必要が生じた場合の対策方法について説明します。 | ||
まず、日本での12時間制についてはWikipediaの[こちらのページ](http://ja.wikipedia.org/wiki/%E5%8D%88%E5%89%8D%E3%81%A8%E5%8D%88%E5%BE%8C)で詳しく解説されています。 | ||
`date-and-time`では英米式の12時間制をデフォルト実装しているため、日本向けにロジックのカスタマイズが必要です。以下に例をご紹介します。 | ||
`date-and-time`では英米式の12時間制をデフォルト実装しているため、日本向けにロジックのカスタマイズが必要です。以下に例をご紹介します。 | ||
```JavaScript | ||
@@ -188,6 +189,7 @@ var date = require('date-and-time'); | ||
``` | ||
上記の例はWikipediaで説明されている「日本時計協会」方式です。「日本式」はロジックがより複雑になるため割愛させていただきます。 | ||
# Browser Support | ||
## Browser Support | ||
Chrome, Android, Firefox, Safari, Mobile Safari, Opera, and Internet Explorer 6+. | ||
# License | ||
## 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
154541
180