diff --git a/js-date.md b/js-date.md index 494fc227d..5a3d111ea 100644 --- a/js-date.md +++ b/js-date.md @@ -1,63 +1,99 @@ --- title: JavaScript Date category: JavaScript +layout: 2017/sheet +weight: -3 --- +## Date +{: .-left-reference} + ### Constructor ```js +// Now new Date() -new Date(1419785527580) -new Date("December 17, 1995 03:24:00") -new Date("2013-03-01T01:10:00") -new Date(2014, 2, 1, 13, 0, 59, 0) - // year month* day hour minute sec milli - // * = zero-indexed ``` -### Getters - ```js -.getDate() //=> 1..31 -.getDay() //=> 0..6 (sun..sat) -.getFullYear() //=> 2014 -.getMonth() //=> 0..11 - -.getHours() -.getMinutes() -.getSeconds() -.getMilliseconds() - -.getTime() //=> ms since epoch -.getTimezoneOffset() +// ms since epoch +new Date(1419785527580) ``` +```js +// Date format +new Date("May 17, 1995 03:24:00") +``` + +```js +// ISO date format +new Date("2013-03-01T01:10:00") +``` + +```js +new Date(2014, 2, 1, 13, 0, 59, 0) +``` + +### Constructor + +| `new Date(` | `2014,` | `2,` | `1,` | `13,` | `0,` | `59,` | `0)` | +| Date | Year | Month | Day | Hour | Min | Sec | Milli | +{: .-css-breakdown} + +Months are zero-indexed (eg, January is `0`). + ### Conversion -```js -.toString() //=> "Mon Dec 29 2014 00:58:28 GMT+0800 (PHT)" -.toTimeString() //=> "00:58:46 GMT+0800 (PHT)" -.toUTCString() //=> ""Sun, 28 Dec 2014 16:58:59 GMT" +| Method | Result | +| --- | --- | +| `d.toString()` | `"Mon Dec 29 2014 00:58:28 GMT+0800 (PHT)"` | +| `d.toTimeString()` | `"00:58:46 GMT+0800 (PHT)"` | +| `d.toUTCString()` | `"Sun, 28 Dec 2014 16:58:59 GMT"` | +| --- | --- | +| `d.toDateString()` | `"Thu Jan 10 2013"` | +| `d.toISOString()` | `"2013-01-09T16:00:00.000Z"` | +| `d.toLocaleString()` | `"12/29/2014, 12:57:31 AM"` | +| `d.toLocaleTimeString()` | `"12:57:31 AM"` | +| --- | --- | +| `d.getTime()` | `1419785527580` | + +Accessing +--------- + +### Getters + +| Method | Result | +| --- | --- | +| `.getDate()` | `1..31` | +| `.getDay()` | `0..6` (sun..sat) | +| `.getFullYear()` | `2014` | +| `.getMonth()` | `0..11` | +| --- | --- | +| `.getHours()` | | +| `.getMinutes()` | | +| `.getSeconds()` | | +| `.getMilliseconds()` | | +| --- | --- | +| `.getTime()` | ms since epoch | +| `.getTimezoneOffset()` | | + +UTC versions are also available (eg, `.getUTCDate()`, `.getUTCDay()`, etc). -.toDateString() //=> "Thu Jan 10 2013" -.toISOString() //=> "2013-01-09T16:00:00.000Z" -.toLocaleString() //=> "12/29/2014, 12:57:31 AM" -.toLocaleTimeString() //=> "12:57:31 AM" -``` ### Setters -```js -.setDate() -.setFullYear() -.setHours() -// ...etc; see getters -``` +| Method | Result | +| --- | --- | +| `.setDate` _(val)_ | | +| `.setDay` _(val)_ | | +| `.setFullYear` _(val)_ | | +| `.setMonth` _(val)_ | | +| --- | --- | +| `.setHours` _(val)_ | | +| `.setMinutes` _(val)_ | | +| `.setSeconds` _(val)_ | | +| `.setMilliseconds` _(val)_ | | +| --- | --- | +| `.setTime` _(val)_ | | +| `.setTimezoneOffset` _(val)_ | | -### UTC getters - -```js -.getUTCDate() -.getUTCDay() -.getUTCMonth() -// ...etc; see getters -``` +See the getters list.