js-date: update

This commit is contained in:
Rico Sta. Cruz 2017-08-30 14:36:43 +08:00
parent 5716955a9f
commit d397070836
No known key found for this signature in database
GPG Key ID: CAAD38AE2962619A
1 changed files with 79 additions and 43 deletions

View File

@ -1,63 +1,99 @@
--- ---
title: JavaScript Date title: JavaScript Date
category: JavaScript category: JavaScript
layout: 2017/sheet
weight: -3
--- ---
## Date
{: .-left-reference}
### Constructor ### Constructor
```js ```js
// Now
new Date() 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 ```js
.getDate() //=> 1..31 // ms since epoch
.getDay() //=> 0..6 (sun..sat) new Date(1419785527580)
.getFullYear() //=> 2014
.getMonth() //=> 0..11
.getHours()
.getMinutes()
.getSeconds()
.getMilliseconds()
.getTime() //=> ms since epoch
.getTimezoneOffset()
``` ```
```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 ### Conversion
```js | Method | Result |
.toString() //=> "Mon Dec 29 2014 00:58:28 GMT+0800 (PHT)" | --- | --- |
.toTimeString() //=> "00:58:46 GMT+0800 (PHT)" | `d.toString()` | `"Mon Dec 29 2014 00:58:28 GMT+0800 (PHT)"` |
.toUTCString() //=> ""Sun, 28 Dec 2014 16:58:59 GMT" | `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 ### Setters
```js | Method | Result |
.setDate() | --- | --- |
.setFullYear() | `.setDate` _(val)_ | |
.setHours() | `.setDay` _(val)_ | |
// ...etc; see getters | `.setFullYear` _(val)_ | |
``` | `.setMonth` _(val)_ | |
| --- | --- |
| `.setHours` _(val)_ | |
| `.setMinutes` _(val)_ | |
| `.setSeconds` _(val)_ | |
| `.setMilliseconds` _(val)_ | |
| --- | --- |
| `.setTime` _(val)_ | |
| `.setTimezoneOffset` _(val)_ | |
### UTC getters See the getters list.
```js
.getUTCDate()
.getUTCDay()
.getUTCMonth()
// ...etc; see getters
```