Date 對(duì)象

Date 對(duì)象的概述和抽象操作的定義

 下面的抽象操作函數(shù)用來操作時(shí)間值（15.9.1.1 定義）。注：任何情況下，如果這些函數(shù)之一的任意參數(shù)是 NaN，則結(jié)果將是 NaN。

時(shí)間值和時(shí)間范圍

 一個(gè) Date 對(duì)象包含一個(gè)表示特定時(shí)間瞬間的毫秒的數(shù)字值。這樣的數(shù)字值叫做 時(shí)間值 。一個(gè)時(shí)間值也可以是 NaN，說明這個(gè) Date 對(duì)象不表示特定時(shí)間瞬間。

 ECMAScript 中測(cè)量的時(shí)間是從協(xié)調(diào)世界時(shí) 1970 年 1 月 1 日開始的毫秒數(shù)。在時(shí)間值中閏秒是被忽略的，假設(shè)每天正好有 86,400,000 毫秒。ECMAScript 數(shù)字值可表示的所有從–9,007,199,254,740,991 到 9,007,199,254,740,991 的整數(shù)；這個(gè)范圍足以衡量協(xié)調(diào)世界時(shí) 1970 年 1 月 1 日前后約 285,616 年內(nèi)任何時(shí)間瞬間的精確毫秒。

 ECMAScript Date 對(duì)象支持的實(shí)際時(shí)間范圍是略小一些的：相對(duì)協(xié)調(diào)世界時(shí) 1970 年 1 月 1 日午夜 0 點(diǎn)的精確的–100,000,000 天到 100,000,000 天。這給出了協(xié)調(diào)世界時(shí) 1970 年 1 月 1 日前后 8,640,000,000,000,000 毫秒的范圍。

 精確的協(xié)調(diào)世界時(shí) 1970 年 1 月 1 日午夜 0 點(diǎn)用 +0 表示。

天數(shù)和天內(nèi)時(shí)間

 一個(gè)給定時(shí)間值 t 所屬的天數(shù)是

 其中每天的毫秒數(shù)是

 余數(shù)叫做天內(nèi)時(shí)間

年數(shù)

 ECMAScript 使用一個(gè)推算公歷系統(tǒng)，來將一個(gè)天數(shù)映射到一個(gè)年數(shù)，并確定在那年的月份的日期。在這個(gè)系統(tǒng)中，閏年是且僅是（可被 4 整除）且（（不可被 100 整除）或（可被 400 整除））的年份。因此，y 年的天的數(shù)目定義為

 所有非閏年有 365 天，其中每月的天的數(shù)目是常規(guī)的。閏年的二月里有個(gè)多出來的一天。 y 年第一天的天數(shù)是 :

 y 年的起始時(shí)間值是：

 一個(gè)時(shí)間值決定的年數(shù)是：

 若時(shí)間值在閏年內(nèi)，閏年函數(shù)返回 1，否則返回 0：

月數(shù)

 月份是由閉區(qū)間 0 到 11 內(nèi)的一個(gè)整數(shù)確定。一個(gè)時(shí)間值 t 到一個(gè)月數(shù)的映射 MonthFromTime(t) 的定義為：

 其中

 月數(shù)值 0 指一月；1 指二月；2 指三月；3 指四月；4 指五月；5 指六月；6 指七月；7 指八月；8 指九月；9 指十月；10 指十一月；11 指十二月。注：MonthFromTime(0) = 0，對(duì)應(yīng) 1970 年 1 月 1 日，星期四。

日期數(shù)

 一個(gè)日期數(shù)用閉區(qū)間 1 到 31 內(nèi)的一個(gè)整數(shù)標(biāo)識(shí)。從一個(gè)時(shí)間值 t 到一個(gè)日期數(shù)的映射 DateFromTime(t) 的定義為：

星期數(shù)

 特定時(shí)間值 t 對(duì)應(yīng)的星期數(shù)的定義為：

 星期數(shù)的值 0 指星期日；1 指星期一；2 指星期二；3 指星期三；4 指星期四；5 指星期五；6 指星期六。注：WeekDay(0) = 4, 對(duì)應(yīng) 1970 年 1 月 01 日 星期四。

本地時(shí)區(qū)校準(zhǔn)

 期望一個(gè) ECMAScript 的實(shí)現(xiàn)確定本地時(shí)區(qū)校準(zhǔn)。本地時(shí)區(qū)校準(zhǔn)是一個(gè)毫秒為單位的值 LocalTZA，它加上 UTC 代表本地標(biāo)準(zhǔn)時(shí)間。LocalTZA 不體現(xiàn)夏令時(shí)。LocalTZA 值不隨時(shí)間改變，但只取決于地理位置。

夏令時(shí)校準(zhǔn)

 期望一個(gè) ECMAScript 的實(shí)現(xiàn)確定夏令時(shí)算法。確定夏令時(shí)校準(zhǔn)的算法 DaylightSavingTA(t)，以毫秒為單位，必須只依賴下面四個(gè)項(xiàng)目：

 (1) 自本年開始以來的時(shí)間

 (2) t 是否在閏年內(nèi)

 (3) 本年第一天的星期數(shù)

 (4) 地理位置。

 The implementation of ECMAScript should not try to determine whether the exact time was subject to daylight saving time, but just whether daylight saving time would have been in effect if the current daylight saving time algorithm had been used at the time. This avoids complications such as taking into account the years that the locale observed daylight saving time year round.

 If the host environment provides functionality for determining daylight saving time, the implementation of ECMAScript is free to map the year in question to an equivalent year (same leap-year-ness and same starting week day for the year) for which the host environment provides daylight saving time information. The only restriction is that all equivalent years should produce the same result.

本地時(shí)間

 從協(xié)調(diào)世界時(shí)到本地時(shí)間的轉(zhuǎn)換，定義為

 從本地時(shí)間到協(xié)調(diào)世界時(shí)的轉(zhuǎn)換，定義為

 UTC(LocalTime(t)) 不一定總是等于 t。

小時(shí) , 分鐘 , 秒 , 毫秒

 以下函數(shù)用于分解時(shí)間值：

 其中

MakeTime (hour, min, sec, ms)

 MakeTime 抽象操作用它的四個(gè)參數(shù)算出一個(gè)毫秒數(shù)，參數(shù)必須是 ECMAScript 數(shù)字值。此抽象操作運(yùn)行如下：

1. 如果 hour 不是有限的或 min 不是有限的或 sec 不是有限的或 ms 不是有限的 , 返回 NaN。
2. 令 h 為 ToInteger(hour).
3. 令 m 為 ToInteger(min).
4. 令 s 為 ToInteger(sec).
5. 令 milli 為 ToInteger(ms).
6. 令 t 為 h * msPerHour + m * msPerMinute + s * msPerSecond + milli, 執(zhí)行的四則運(yùn)算根據(jù) IEEE 754 規(guī)則（這就像使用 ECMAScript 運(yùn)算符 * 和 + 一樣）。
7. 返回 t。

MakeDay (year, month, date)

 MakeDay 抽象操作用它的三個(gè)參數(shù)算出一個(gè)天數(shù)，參數(shù)必須是 ECMAScript 數(shù)字值。此抽象操作運(yùn)行如下：

1. 如果 year 不是有限的或 month 不是有限的或 date 不是有限的 , 返回 NaN.
2. 令 y 為 ToInteger(year).
3. 令 m 為 ToInteger(month).
4. 令 dt 為 ToInteger(date).
5. 令 ym 為 y + floor(m /12).
6. 令 mn 為 m modulo 12.
7. 找一個(gè)滿足 YearFromTime(t) == ym 且 MonthFromTime(t) == mn 且 DateFromTime(t) == 1 的 t 值 ; 但如果這些條件是不可能的（因?yàn)橛行﹨?shù)超出了范圍）, 返回 NaN.
8. 返回 Day(t) + dt ? 1.

MakeDate (day, time)

 MakeDate 抽象操作用它的兩個(gè)參數(shù)算出一個(gè)毫秒數(shù)，參數(shù)必須是 ECMAScript 數(shù)字值。此抽象操作運(yùn)行如下：

1. 如果 day 不是有限的或 time 不是有限的 , 返回 NaN.
2. 返回 day × msPerDay + time.

TimeClip (time)

 TimeClip 抽象操作用它的參數(shù)算出一個(gè)毫秒數(shù)，參數(shù)必須是 ECMAScript 數(shù)字值。此抽象操作運(yùn)行如下：

1. 如果 time 不是有限的 , 返回 NaN.
2. 如果 abs(time) > 8.64 x 1015, 返回 NaN.
3. 返回 ToInteger(time) 和 ToInteger(time) + (+0) 之一，這依賴于實(shí)現(xiàn) ( 加正一是為了將 ?0 轉(zhuǎn)換成 +0)。

 第 3 步的重點(diǎn)是說允許實(shí)現(xiàn)自行選擇時(shí)間值的內(nèi)部表示形式，如 64 位有符號(hào)整數(shù)或 64 位浮點(diǎn)數(shù)。根據(jù)不同的實(shí)現(xiàn)，這個(gè)內(nèi)部表示可能區(qū)分也可能無法區(qū)分 ?0 和 +0。

日期時(shí)間字符串格式

 ECMAScript 定義了一個(gè)基于簡(jiǎn)化的 ISO 8601 擴(kuò)展格式的日期時(shí)間的字符串互換格式，格式為：YYYY-MM-DDTHH:mm:ss.sssZ

 其中個(gè)字段為：

 YYYY 是公歷中年的十進(jìn)制數(shù)字。

 - 在字符串中直接以“-” ( 破折號(hào) ) 出現(xiàn)兩次。

 MM 是一年中的月份，從 01 ( 一月 ) 到 12 ( 十二月 )。

 DD 是月份中的日期，從 01 到 30。

 T 在字符串中直接以“T”出現(xiàn)，用來表明時(shí)間元素的開始。

 HH 是用兩個(gè)十進(jìn)制數(shù)字表示的，自午夜 0 點(diǎn)以來的小時(shí)數(shù)。

 : 在字符串中直接以“:” ( 冒號(hào) ) 出現(xiàn)兩次。

 mm 是用兩個(gè)十進(jìn)制數(shù)字表示的，自小時(shí)開始以來的分鐘數(shù)。

 ss 是用兩個(gè)十進(jìn)制數(shù)字表示的，自分開始以來的秒數(shù)。

 . 在字符串中直接以“.” ( 點(diǎn) ) 出現(xiàn)。

 sss 是用三個(gè)十進(jìn)制數(shù)字表示的，自秒開始以來的毫秒數(shù)。

 Z 是時(shí)區(qū)偏移量，由（“Z” ( 指 UTC) 或“+” 或 “-”）和后面跟著的時(shí)間表達(dá)式 hh:mm 組成。

 這個(gè)格式包括只表示日期的形式：

 這個(gè)格式還包括“日期時(shí)間”形式，它由上面的只表示日期的形式之一和緊跟在后面的“T”和以下時(shí)間形式之一和可選的時(shí)區(qū)偏移量組成：

 所有數(shù)字必須是 10 進(jìn)制的。如果缺少 MM 或 DD 字段，用“01”作為它們的值。如果缺少 mm 或 ss 字段，用“00”作為它們的值，對(duì)于缺少的 sss 用“000”作為它的值。對(duì)于缺少的時(shí)區(qū)偏移量用“Z”。

 一個(gè)格式字符串里有非法值（越界以及語(yǔ)法錯(cuò)誤），意味著這個(gè)格式字符串不是有效的本節(jié)描述格式的實(shí)例。

 由于每天的開始和結(jié)束都在午夜，倆符號(hào) 00:00 和 24:00 可區(qū)分這樣的可以是同一時(shí)間的兩個(gè)午夜。這意味著兩個(gè)符號(hào) 1995-02-04T24:00 和 1995-02-05T00:00 精準(zhǔn)的指向同一時(shí)刻。

 不存在用來規(guī)范像 CET, EST 這樣的民間時(shí)區(qū)縮寫的國(guó)際標(biāo)準(zhǔn)。有時(shí)相同的縮寫甚至使用不同的時(shí)區(qū)。出于這個(gè)原因，ISO 8601 和這里的格式指定數(shù)字來表示時(shí)區(qū)。

擴(kuò)展的年

 ECMAScript 需要能表示 6 位數(shù)年份（擴(kuò)展的年份）的能力；協(xié)調(diào)世界時(shí) 1970 年 1 月 1 日前后分別約 285,616 年。對(duì)于表示 0 年之前或 9999 年之后的年份，ISO 8601 允許對(duì)年的表示法進(jìn)行擴(kuò)展，但只能在發(fā)送和接受信息的雙方有事先共同約定的情況下才能擴(kuò)展。在已經(jīng)簡(jiǎn)化的 ECMAScript 的格式中這樣擴(kuò)展的年份表示法有 2 個(gè)額外的數(shù)字和始終存在的前綴符號(hào) + 或 - 。0 年被認(rèn)為是正的，因此用 + 符號(hào)作為前綴。

 擴(kuò)展年的示例

作為函數(shù)調(diào)用 Date 構(gòu)造器

 當(dāng)把 Date 作為函數(shù)來調(diào)用，而不作為構(gòu)造器，它返回一個(gè)表示當(dāng)前時(shí)間（協(xié)調(diào)世界時(shí)）的字符串。

 函數(shù)調(diào)用 Date(…) 的結(jié)果和用相同參數(shù)調(diào)用表達(dá)式 new Date(…) 創(chuàng)建的對(duì)象是不同的。

Date ( [ year [, month [, date [, hours [, minutes [, seconds [, ms ] ] ] ] ] ] ] )

 所有參數(shù)都是可選的；接受提供的任何參數(shù)，但被完全忽略。返回一個(gè)仿佛是用表達(dá)式 (new Date()).toString() 創(chuàng)建的字符串，這里的 Date 是標(biāo)準(zhǔn)內(nèi)置構(gòu)造器，toString 是標(biāo)準(zhǔn)內(nèi)置方法 Date.prototype.toString。

Date 構(gòu)造器

 當(dāng)把 Date 作為 new 表達(dá)式的一部分來調(diào)用，它是個(gè)構(gòu)造器：它初始化新創(chuàng)建的對(duì)象。

new Date (year, month [, date [, hours [, minutes [, seconds [, ms ] ] ] ] ] )

 當(dāng)用二到七個(gè)參數(shù)調(diào)用 Date 構(gòu)造器，它用 year, month, 還有 ( 可選的 ) date, hours, minutes, seconds, ms 來計(jì)算時(shí)間。

 新構(gòu)造對(duì)象的 [[Prototype]] 內(nèi)部屬性設(shè)定為原始的時(shí)間原型對(duì)象，它是 Date.prototype(15.9.4.1) 的初始值。

 新構(gòu)造對(duì)象的 [[Class]] 內(nèi)部屬性設(shè)定為 "Date"。

 新構(gòu)造對(duì)象的 [[Extensible]] 內(nèi)部屬性設(shè)定為 ture。

 新構(gòu)造對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性按照以下步驟設(shè)定：

1. 令 y 為 ToNumber(year).
2. 令 m 為 ToNumber(month).
3. 如果提供了 date ，則令 dt 為 ToNumber(date); 否則令 dt 為 1.
4. 如果提供了 hours ，則令 h 為 ToNumber(hours); 否則令 h 為 0.
5. 如果提供了 minutes ，則令 min 為 ToNumber(minutes); 否則令 min 為 0.
6. 如果提供了 seconds ，則令 s 為 ToNumber(seconds); 否則令 s 為 0.
7. 如果提供了 ms ，則令 milli 為 ToNumber(ms); 否則令 milli 為 0.
8. 如果 y 不是 NaN 且 0 ≤ ToInteger(y) ≤ 99, 則令 yr 為 1900+ToInteger(y); 否則令 yr 為 y.
9. 令 finalDate 為 MakeDate(MakeDay(yr, m, dt), MakeTime(h, min, s, milli)).
10. 設(shè)定新構(gòu)造對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 TimeClip(UTC(finalDate)).

new Date (value)

 新構(gòu)造對(duì)象的 [[Prototype]] 內(nèi)部屬性設(shè)定為原始的時(shí)間原型對(duì)象，它是 Date.prototype(15.9.4.1) 的初始值。

 新構(gòu)造對(duì)象的 [[Class]] 內(nèi)部屬性設(shè)定為 "Date"。

 新構(gòu)造對(duì)象的 [[Extensible]] 內(nèi)部屬性設(shè)定為 ture。

 新構(gòu)造對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性按照以下步驟設(shè)定：

1. 令 v 為 ToPrimitive(value).
2. 如果 Type(v) 是 String, 則用與 parse 方法 (15.9.4.2) 完全相同的方式將 v 解析為一個(gè)日期時(shí)間；令 V 為這個(gè)日期時(shí)間的時(shí)間值。
3. 否則 , 令 V 為 ToNumber(v).
4. 設(shè)定新構(gòu)造對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 TimeClip(V)，并返回這個(gè)值。

new Date ( )

 新構(gòu)造對(duì)象的 [[Prototype]] 內(nèi)部屬性設(shè)定為原始的時(shí)間原型對(duì)象，它是 Date.prototype(15.9.4.1) 的初始值。

 新構(gòu)造對(duì)象的 [[Class]] 內(nèi)部屬性設(shè)定為 "Date"。

 新構(gòu)造對(duì)象的 [[Extensible]] 內(nèi)部屬性設(shè)定為 ture。

 新構(gòu)造對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性設(shè)定為表示當(dāng)前時(shí)間的時(shí)間值（協(xié)調(diào)世界時(shí)）。

Date 構(gòu)造器的屬性

 Date 構(gòu)造器的 [[Prototype]] 內(nèi)部屬性的值是函數(shù)原型對(duì)象 (15.3.4)。

 除了內(nèi)部屬性和 length 屬性 ( 值為 7) 之外，Date 構(gòu)造器還有以下屬性：

Date.prototype

 Date.prototype 的初始值是內(nèi)置的 Date 原型對(duì)象 (15.9.5)。

 此屬性有特性 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }。

Date.parse (string)

 parse 函數(shù)對(duì)它的參數(shù)應(yīng)用 ToString 操作并將結(jié)果字符串解釋為一個(gè)日期和時(shí)間；返回一個(gè)數(shù)字值，是對(duì)應(yīng)這個(gè)日期時(shí)間的 UTC 時(shí)間值。字符串可解釋為本地時(shí)間，UTC 時(shí)間，或某個(gè)其他時(shí)區(qū)的時(shí)間，這取決于字符串里的內(nèi)容。此函數(shù)首先嘗試根據(jù)日期時(shí)間字符串格式（15.9.1.15）里的規(guī)則來解析字符串的格式。如果字符串不符合這個(gè)格式此函數(shù)可回退，用任意實(shí)現(xiàn)定義的試探方式或日期格式。無法識(shí)別的字符串或日期時(shí)間包含非法元素值，將導(dǎo)致 Date.parse 返回 NaN。

 在所有屬性都指向它們的初始值的情況下，如果 x 是一個(gè)在特定 ECMAScript 的實(shí)現(xiàn)里的毫秒數(shù)為零的任意 Date 對(duì)象，則在這個(gè)實(shí)現(xiàn)中以下所有表達(dá)式應(yīng)產(chǎn)生相同數(shù)字值：

 然而，表達(dá)式

Date.parse( x.toLocaleString())

 是不需要產(chǎn)生與前面三個(gè)表達(dá)參數(shù)相同的數(shù)字值。通常，在給定的字符串不符合日期時(shí)間字符串格式（15.9.1.15）時(shí)，Date.parse 的產(chǎn)生值是依賴于實(shí)現(xiàn)，并且在同一實(shí)現(xiàn)中 toString 或 toUTCString 方法不能產(chǎn)生不符合日期時(shí)間字符串格式的字符串。

Date.UTC (year, month [, date [, hours [, minutes [, seconds [, ms ] ] ] ] ])

 當(dāng)用少于兩個(gè)的參數(shù)調(diào)用 UTC 函數(shù)時(shí)，它的行為是依賴于實(shí)現(xiàn)的。當(dāng)用二到七個(gè)參數(shù)調(diào)用 UTC 函數(shù)，它從 year, month 和 ( 可選的 ) date, hours, minutes, seconds, ms 計(jì)算出日期時(shí)間。采用以下步驟：

1. 令 y 為 ToNumber(year).
2. 令 m 為 ToNumber(month).
3. 如果提供了 date ，則令 dt 為 ToNumber(date); 否則令 dt 為 1.
4. 如果提供了 hours ，則令 h 為 ToNumber(hours); 否則令 h 為 0.
5. 如果提供了 minutes ，則令 min 為 ToNumber(minutes); 否則令 min 為 0.
6. 如果提供了 seconds ，則令 s 為 ToNumber(seconds); 否則令 s 為 0.
7. 如果提供了 ms ，則令 milli 為 ToNumber(ms); 否則令 milli 為 0.
8. 如果 y 不是 NaN 且 0 ≤ ToInteger(y) ≤ 99, 則令 yr 為 1900+ToInteger(y); 否則令 yr 為 y.
9. 返回 TimeClip(MakeDate(MakeDay(yr, m, dt), MakeTime(h, min, s, milli))).

 UTC 函數(shù)的 length 屬性是 7。

 UTC 函數(shù)與 Date 構(gòu)造器的不同點(diǎn)有：它返回一個(gè)時(shí)間值，而不是創(chuàng)建 Date 對(duì)象，還有它將參數(shù)解釋為 UTC，而不是本地時(shí)間。

Date.now ( )

 now 函數(shù)返回一個(gè)數(shù)字值，它表示調(diào)用 now 時(shí)的 UTC 日期時(shí)間的時(shí)間值。

Date 原型對(duì)象的屬性

 Date 原型對(duì)象自身是一個(gè) Date 對(duì)象（其 [[Class]] 是 "Date"），其 [[PrimitiveValue]] 是 NaN。

 Date 原型對(duì)象的 [[Prototype]] 內(nèi)部屬性的值是標(biāo)準(zhǔn)內(nèi)置 Object 原型對(duì)象 (15.2.4)。

 在以下對(duì) Date 原型對(duì)象的函數(shù)屬性的描述中，短語(yǔ)“this Date 對(duì)象”指調(diào)用函數(shù)時(shí)的 this 值對(duì)象。除非另外說明，這些函數(shù)不是通用的；如果 this 值不是 [[Class]] 內(nèi)部屬性為 "Date" 的對(duì)象，則拋出一個(gè) TypeError 異常。短語(yǔ)“this 時(shí)間值”指代表 this Date 對(duì)象的時(shí)間值的數(shù)字值，它是 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性的值。

Date.prototype.constructor

 Date.prototype.constructor 的初始值是內(nèi)置 Date 構(gòu)造器。

Date.prototype.toString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種方便，人類可讀的形式表示當(dāng)前時(shí)區(qū)的時(shí)間。

 對(duì)毫秒數(shù)為零的任意 Date 值 d，Date.parse(d.toString()) 和 d.valueOf() 的結(jié)果相同。見 15.9.4.2

Date.prototype.toDateString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種方便，人類可讀的形式表示當(dāng)前時(shí)區(qū)時(shí)間的“日期”部分。

Date.prototype.toTimeString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種方便，人類可讀的形式表示當(dāng)前時(shí)區(qū)時(shí)間的“時(shí)間”部分。

Date.prototype.toLocaleString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種 -- 對(duì)應(yīng)宿主環(huán)境的當(dāng)前語(yǔ)言環(huán)境設(shè)定的 -- 方便，人類可讀的形式表示當(dāng)前時(shí)區(qū)的時(shí)間。

 這個(gè)函數(shù)的第一個(gè)參數(shù)可能會(huì)在此標(biāo)準(zhǔn)的未來版本中使用到；因此建議實(shí)現(xiàn)不要以任何目的使用這個(gè)位置參數(shù)。

Date.prototype.toLocaleDateString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種 -- 對(duì)應(yīng)宿主環(huán)境的當(dāng)前語(yǔ)言環(huán)境設(shè)定的 -- 方便，人類可讀的形式表示當(dāng)前時(shí)區(qū)時(shí)間的“日期”部分。

 這個(gè)函數(shù)的第一個(gè)參數(shù)可能會(huì)在此標(biāo)準(zhǔn)的未來版本中使用到；因此建議實(shí)現(xiàn)不要以任何目的使用這個(gè)位置參數(shù)。

Date.prototype.toLocaleTimeString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種 -- 對(duì)應(yīng)宿主環(huán)境的當(dāng)前語(yǔ)言環(huán)境設(shè)定的 -- 方便，人類可讀的形式表示當(dāng)前時(shí)區(qū)時(shí)間的“時(shí)間”部分。

 這個(gè)函數(shù)的第一個(gè)參數(shù)可能會(huì)在此標(biāo)準(zhǔn)的未來版本中使用到；因此建議實(shí)現(xiàn)不要以任何目的使用這個(gè)位置參數(shù)。

Date.prototype.valueOf ( )

 valueOf 函數(shù)返回一個(gè)數(shù)字值，它是 this 時(shí)間值。

Date.prototype.getTime ( )

1. 返回 this 時(shí)間值。

Date.prototype.getFullYear ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 YearFromTime(LocalTime(t)).

Date.prototype.getUTCFullYear ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 YearFromTime(t).

Date.prototype.getMonth ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 MonthFromTime(LocalTime(t)).

Date.prototype.getUTCMonth ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 MonthFromTime(t).

Date.prototype.getDate ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 DateFromTime(LocalTime(t)).

Date.prototype.getUTCDate ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 DateFromTime(t).

Date.prototype.getDay ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 WeekDay(LocalTime(t)).

Date.prototype.getUTCDay ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 WeekDay(t).

Date.prototype.getHours ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 HourFromTime(LocalTime(t)).

Date.prototype.getUTCHours ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 HourFromTime(t).

Date.prototype.getMinutes ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 MinFromTime(LocalTime(t)).

Date.prototype.getUTCMinutes ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 MinFromTime(t).

Date.prototype.getSeconds ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 SecFromTime(LocalTime(t)).

Date.prototype.getUTCSeconds ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 SecFromTime(t).

Date.prototype.getMilliseconds ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 msFromTime(LocalTime(t)).

Date.prototype.getUTCMilliseconds ( )

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 msFromTime(t).

Date.prototype.getTimezoneOffset ( )

 返回本地時(shí)間和 UTC 時(shí)間之間相差的分鐘數(shù)。

1. 令 t 為 this 時(shí)間值 .
2. 如果 t 是 NaN, 返回 NaN.
3. 返回 (t ? LocalTime(t)) / msPerMinute.

Date.prototype.setTime (time)

1. 令 v 為 TimeClip(ToNumber(time)).
2. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
3. 返回 v.

Date.prototype.setMilliseconds (ms)

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 .
2. 令 time 為 MakeTime(HourFromTime(t), MinFromTime(t), SecFromTime(t), ToNumber(ms)).
3. 令 u 為 TimeClip(UTC(MakeDate(Day(t), time))).
4. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
5. 返回 u.

Date.prototype.setUTCMilliseconds (ms)

1. 令 t 為 this 時(shí)間值 .
2. 令 time 為 MakeTime(HourFromTime(t), MinFromTime(t), SecFromTime(t), ToNumber(ms)).
3. 令 v 為 TimeClip(MakeDate(Day(t), time)).
4. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
5. 返回 v.

Date.prototype.setSeconds (sec [, ms ] )

 沒指定 ms 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getMilliseconds() 的結(jié)果一樣。

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 .
2. 令 s 為 ToNumber(sec).
3. 如果沒指定 ms , 則令 milli 為 msFromTime(t); 否則，令 milli 為 ToNumber(ms).
4. 令 date 為 MakeDate(Day(t), MakeTime(HourFromTime(t), MinFromTime(t), s, milli)).
5. 令 u 為 TimeClip(UTC(date)).
6. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
7. 返回 u.

 setSeconds 方法的 length 屬性是 2。

Date.prototype.setUTCSeconds (sec [, ms ] )

 沒指定 ms 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCMilliseconds() 的結(jié)果一樣。

1. 令 t 為 this 時(shí)間值 .
2. 令 s 為 ToNumber(sec).
3. 如果沒指定 ms , 則令 milli 為 msFromTime(t); 否則，令 milli 為 ToNumber(ms).
4. 令 date 為 MakeDate(Day(t), MakeTime(HourFromTime(t), MinFromTime(t), s, milli)).
5. 令 v 為 TimeClip(date).
6. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
7. 返回 v.

 setUTCSeconds 方法的 length 屬性是 2。

Date.prototype.setMinutes (min [, sec [, ms ] ] )

 沒指定 sec 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getSeconds() 的結(jié)果一樣。

 沒指定 ms 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getMilliseconds() 的結(jié)果一樣。

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 .
2. 令 m 為 ToNumber(min).
3. 如果沒指定 sec , 則令 s 為 SecFromTime(t); 否則 , 令 s 為 ToNumber(sec).
4. 如果沒指定 ms , 則令 milli 為 msFromTime(t); 否則 , 令 milli 為 ToNumber(ms).
5. 令 date 為 MakeDate(Day(t), MakeTime(HourFromTime(t), m, s, milli)).
6. 令 u 為 TimeClip(UTC(date)).
7. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
8. 返回 u.

 setMinutes 方法的 length 屬性是 3。

Date.prototype.setUTCMinutes (min [, sec [, ms ] ] )

 沒指定 sec 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCSeconds() 的結(jié)果一樣。

 沒指定 ms 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCMilliseconds() 的結(jié)果一樣。

1. 令 t 為 this 時(shí)間值 .
2. 令 m 為 ToNumber(min).
3. 如果沒指定 sec , 則令 s 為 SecFromTime(t); 否則 , 令 s 為 ToNumber(sec).
4. 如果沒指定 ms , 則令 milli 為 msFromTime(t); 否則 , 令 milli 為 ToNumber(ms).
5. 令 date 為 MakeDate(Day(t), MakeTime(HourFromTime(t), m, s, milli)).
6. 令 v 為 TimeClip(date).
7. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
8. 返回 v.

 setUTCMinutes 方法的 length 屬性是 3。

Date.prototype.setHours (hour [, min [, sec [, ms ] ] ] )

 沒指定 min 參數(shù)時(shí)的行為是，仿佛 min 被指定為調(diào)用 getMinutes() 的結(jié)果一樣。

 沒指定 sec 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getSeconds() 的結(jié)果一樣。

 沒指定 ms 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getMilliseconds() 的結(jié)果一樣。

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 .
2. 令 h 為 ToNumber(hour).
3. 如果沒指定 min , 則令 m 為 MinFromTime(t); 否則 , 令 m 為 ToNumber(min).
4. 如果沒指定 sec , 則令 s 為 SecFromTime(t); 否則 , 令 s 為 ToNumber(sec).
5. 如果沒指定 ms , 則令 milli 為 msFromTime(t); 否則 , 令 milli 為 ToNumber(ms).
6. 令 date 為 MakeDate(Day(t), MakeTime(h, m, s, milli)).
7. 令 u 為 TimeClip(UTC(date)).
8. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
9. 返回 u.

 setHours 方法的 length 屬性是 4。

Date.prototype.setUTCHours (hour [, min [, sec [, ms ] ] ] )

 沒指定 min 參數(shù)時(shí)的行為是，仿佛 min 被指定為調(diào)用 getUTCMinutes() 的結(jié)果一樣。

 沒指定 sec 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCSeconds() 的結(jié)果一樣。

 沒指定 ms 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCMilliseconds() 的結(jié)果一樣。

1. 令 t 為 this 時(shí)間值 .
2. 令 h 為 ToNumber(hour).
3. 如果沒指定 min , 則令 m 為 MinFromTime(t); 否則 , 令 m 為 ToNumber(min).
4. 如果沒指定 sec , 則令 s 為 SecFromTime(t); 否則 , 令 s 為 ToNumber(sec).
5. 如果沒指定 ms , 則令 milli 為 msFromTime(t); 否則 , 令 milli 為 ToNumber(ms).
6. 令 date 為 MakeDate(Day(t), MakeTime(h, m, s, milli)).
7. 令 v 為 TimeClip(date).
8. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
9. 返回 v.

 setUTCHours 方法的 length 屬性是 4。

Date.prototype.setDate (date)

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 .
2. 令 dt 為 ToNumber(date).
3. 令 newDate 為 MakeDate(MakeDay(YearFromTime(t), MonthFromTime(t), dt), TimeWithinDay(t)).
4. 令 u 為 TimeClip(UTC(newDate)).
5. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
6. 返回 u.

Date.prototype.setUTCDate (date)

1. 令 t 為 this 時(shí)間值 .
2. 令 dt 為 ToNumber(date).
3. 令 newDate 為 MakeDate(MakeDay(YearFromTime(t), MonthFromTime(t), dt), TimeWithinDay(t)).
4. 令 v 為 TimeClip(newDate).
5. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
6. 返回 v.

Date.prototype.setMonth (month [, date ] )

 沒指定 date 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getDate() 的結(jié)果一樣。

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 .
2. 令 m 為 ToNumber(month).
3. 如果沒指定 date , 則令 dt 為 DateFromTime(t); 否則 , 令 dt 為 ToNumber(date).
4. 令 newDate 為 MakeDate(MakeDay(YearFromTime(t), m, dt), TimeWithinDay(t)).
5. 令 u 為 TimeClip(UTC(newDate)).
6. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
7. 返回 u.

 setMonth 方法的 length 屬性是 2。

Date.prototype.setUTCMonth (month [, date ] )

 沒指定 date 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCDate() 的結(jié)果一樣。

1. 令 t 為 this 時(shí)間值 .
2. 令 m 為 ToNumber(month).
3. 如果沒指定 date , 則令 dt 為 DateFromTime(t); 否則 , 令 dt 為 ToNumber(date).
4. 令 newDate 為 MakeDate(MakeDay(YearFromTime(t), m, dt), TimeWithinDay(t)).
5. 令 v 為 TimeClip(newDate).
6. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
7. 返回 v.

 setUTCMonth 方法的 length 屬性是 2。

Date.prototype.setFullYear (year [, month [, date ] ] )

 沒指定 month 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getMonth() 的結(jié)果一樣。

 沒指定 date 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getDate() 的結(jié)果一樣。

1. 令 t 為 LocalTime(this 時(shí)間值 ) 的結(jié)果 ; 但如果 this 時(shí)間值是 NaN, 則令 t 為 +0.
2. 令 y 為 ToNumber(year).
3. 如果沒指定 month , 則令 m 為 MonthFromTime(t); 否則 , 令 m 為 ToNumber(month).
4. 如果沒指定 date , 則令 dt 為 DateFromTime(t); 否則 , 令 dt 為 ToNumber(date).
5. 令 newDate 為 MakeDate(MakeDay(y, m, dt), TimeWithinDay(t)).
6. 令 u 為 TimeClip(UTC(newDate)).
7. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 u.
8. 返回 u.

 setFullYear 方法的 length 屬性是 3。

Date.prototype.setUTCFullYear (year [, month [, date ] ] )

 沒指定 month 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCMonth() 的結(jié)果一樣。

 沒指定 date 參數(shù)時(shí)的行為是，仿佛 ms 被指定為調(diào)用 getUTCDate() 的結(jié)果一樣。

1. 令 t 為 this 時(shí)間值 ; 但如果 this 時(shí)間值是 NaN, 則令 t 為 +0.
2. 令 y 為 ToNumber(year).
3. 如果沒指定 month , 則令 m 為 MonthFromTime(t); 否則 , 令 m 為 ToNumber(month).
4. 如果沒指定 date , 則令 dt 為 DateFromTime(t); 否則 , 令 dt 為 ToNumber(date).
5. 令 newDate 為 MakeDate(MakeDay(y, m, dt), TimeWithinDay(t)).
6. 令 v 為 TimeClip(newDate).
7. 設(shè)定 this Date 對(duì)象的 [[PrimitiveValue]] 內(nèi)部屬性為 v.
8. 返回 v.

 setUTCFullYear 方法的 length 屬性是 3。

Date.prototype.toUTCString ( )

 此函數(shù)返回一個(gè)字符串值。字符串中內(nèi)容是依賴于實(shí)現(xiàn)的，但目的是用一種方便，人類可讀的形式表示 UTC 時(shí)間。

 此函數(shù)的目的是為日期時(shí)間產(chǎn)生一個(gè)比 15.9.1.15 指定的格式更易讀的字符串表示。沒必要選擇明確的或易于機(jī)器解析的格式。如果一個(gè)實(shí)現(xiàn)沒有一個(gè)首選的人類可讀格式，建議使用 15.9.1.15 定義的格式，但用空格而不是“T”分割日期和時(shí)間元素。

Date.prototype.toISOString ( )

 此函數(shù)返回一個(gè)代表 --this Date 對(duì)象表示的時(shí)間的實(shí)例 -- 的字符串。字符串的格式是 15.9.1.15 定義的日期時(shí)間字符串格式。字符串中包含所有的字段。字符串表示的時(shí)區(qū)總是 UTC，用后綴 Z 標(biāo)記。如果 this 對(duì)象的時(shí)間值不是有限的數(shù)字值，拋出一個(gè) RangeError 異常。

Date.prototype.toJSON ( key )

 此函數(shù)為 JSON.stringify (15.12.3) 提供 Date 對(duì)象的一個(gè)字符串表示。

 當(dāng)用參數(shù) key 調(diào)用 toJSON 方法，采用以下步驟：

1. 令 O 為 以 this 值為參數(shù)調(diào)用 toObject 的結(jié)果。
2. 令 tv 為 ToPrimitive(O, hint Number).
3. 如果 tv 是一個(gè)數(shù)字值且不是有限的 , 返回 null.
4. 令 toISO 為以 "toISOString" 為參數(shù)調(diào)用 O 的 [[Get]] 內(nèi)部方法的結(jié)果。
5. 如果 IsCallable(toISO) 是 false, 拋出一個(gè) TypeError 異常 .
6. O 作為以 this 值并用空參數(shù)列表調(diào)用 toISO 的 [[Call]] 內(nèi)部方法，返回結(jié)果。

 參數(shù)是被忽略的。

 toJSON 函數(shù)是故意設(shè)計(jì)成通用的；它不需要其 this 值必須是一個(gè) Date 對(duì)象。因此，它可以作為方法轉(zhuǎn)移到其他類型的對(duì)象上。但轉(zhuǎn)移到的對(duì)象必須有 toISOString 方法。對(duì)象可自由使用參數(shù) key 來過濾字符串化的方式。

Date 實(shí)例的屬性

 Date 實(shí)例從 Date 原型對(duì)象繼承屬性，Date 實(shí)例的 [[Class]] 內(nèi)部屬性值是 "Date"。Date 實(shí)例還有一個(gè) [[PrimitiveValue]] 內(nèi)部屬性。

 [[PrimitiveValue]] 內(nèi)部屬性是代表 this Date 對(duì)象的時(shí)間值。