OSDN Git Service

Regular updates
[twpd/master.git] / js-date.md
1 ---
2 title: JavaScript Date
3 category: JavaScript
4 layout: 2017/sheet
5 weight: -3
6 ---
7
8 ## Date
9 {: .-left-reference}
10
11 ### Constructor
12
13 ```js
14 // Now
15 new Date()
16 ```
17
18 ```js
19 // ms since epoch
20 new Date(1419785527580)
21 ```
22
23 ```js
24 // Date format
25 new Date("May 17, 1995 03:24:00")
26 ```
27
28 ```js
29 // ISO date format
30 new Date("2013-03-01T01:10:00")
31 ```
32
33 ```js
34 new Date(2014, 2, 1, 13, 0, 59, 0)
35 ```
36
37 ### Constructor
38
39 | `new Date(` | `2014,` | `2,`  | `1,` | `13,` | `0,` | `59,` | `0)`  |
40 | Date        | Year    | Month | Day  | Hour  | Min  | Sec   | Milli |
41 {: .-css-breakdown}
42
43 Months are zero-indexed (eg, January is `0`).
44
45 ### Conversion
46
47 | Method                   | Result                                      |
48 | ---                      | ---                                         |
49 | `d.toString()`           | `"Mon Dec 29 2014 00:58:28 GMT+0800 (PHT)"` |
50 | `d.toTimeString()`       | `"00:58:46 GMT+0800 (PHT)"`                 |
51 | `d.toUTCString()`        | `"Sun, 28 Dec 2014 16:58:59 GMT"`           |
52 | ---                      | ---                                         |
53 | `d.toDateString()`       | `"Thu Jan 10 2013"`                         |
54 | `d.toISOString()`        | `"2013-01-09T16:00:00.000Z"`                |
55 | `d.toLocaleString()`     | `"12/29/2014, 12:57:31 AM"`                 |
56 | `d.toLocaleTimeString()` | `"12:57:31 AM"`                             |
57 | ---                      | ---                                         |
58 | `d.getTime()`            | `1419785527580`                             |
59
60 Accessing
61 ---------
62
63 ### Getters
64
65 | Method                 | Result            |
66 | ---                    | ---               |
67 | `.getDate()`           | `1..31`           |
68 | `.getDay()`            | `0..6` (sun..sat) |
69 | `.getFullYear()`       | `2014`            |
70 | `.getMonth()`          | `0..11`           |
71 | ---                    | ---               |
72 | `.getHours()`          |                   |
73 | `.getMinutes()`        |                   |
74 | `.getSeconds()`        |                   |
75 | `.getMilliseconds()`   |                   |
76 | ---                    | ---               |
77 | `.getTime()`           | ms since epoch    |
78 | `.getTimezoneOffset()` |                   |
79
80 UTC versions are also available (eg, `.getUTCDate()`, `.getUTCDay()`, etc).
81
82 ### Setters
83
84 | Method                       | Result |
85 | ---                          | ---    |
86 | `.setDate` _(val)_           |        |
87 | `.setDay` _(val)_            |        |
88 | `.setFullYear` _(val)_       |        |
89 | `.setMonth` _(val)_          |        |
90 | ---                          | ---    |
91 | `.setHours` _(val)_          |        |
92 | `.setMinutes` _(val)_        |        |
93 | `.setSeconds` _(val)_        |        |
94 | `.setMilliseconds` _(val)_   |        |
95 | ---                          | ---    |
96 | `.setTime` _(val)_           |        |
97 | `.setTimezoneOffset` _(val)_ |        |
98
99 See the getters list.