diff options
Diffstat (limited to 'files/zh-cn/conflicting/web/javascript/reference/global_objects/date/index.html')
| -rw-r--r-- | files/zh-cn/conflicting/web/javascript/reference/global_objects/date/index.html | 181 |
1 files changed, 181 insertions, 0 deletions
diff --git a/files/zh-cn/conflicting/web/javascript/reference/global_objects/date/index.html b/files/zh-cn/conflicting/web/javascript/reference/global_objects/date/index.html new file mode 100644 index 0000000000..da3d715018 --- /dev/null +++ b/files/zh-cn/conflicting/web/javascript/reference/global_objects/date/index.html @@ -0,0 +1,181 @@ +--- +title: Date.prototype +slug: Web/JavaScript/Reference/Global_Objects/Date/prototype +tags: + - Date + - JavaScript + - Property +translation_of: Web/JavaScript/Reference/Global_Objects/Date +translation_of_original: Web/JavaScript/Reference/Global_Objects/Date/prototype +--- +<div>{{JSRef}}</div> + +<p><strong><code>Date.prototype</code></strong> 属性表示{{jsxref("Date")}}构造函数的原型。</p> + +<div>{{js_property_attributes(0,0,1)}}</div> + +<h2 id="Description" name="Description">描述</h2> + +<p>{{jsxref("Date")}}实例继承自<code>Date.prototype</code>。可以通过修改构造函数的原型对象来影响 {{jsxref("Date")}}实例继承的属性和方法。</p> + +<p>为了兼容千禧年计算（也即考虑到 2000 年），应该总是指定完整的年份，例如，使用 1998，而不是 98。为了方便以完整的格式指定年份， JavaScript 包含了相应的方法{{jsxref("Global_Objects/Date/getFullYear", "getFullYear()")}}，{{jsxref("Global_Objects/Date/setFullYear", "setFullYear()")}}， {{jsxref("Global_Objects/Date/getUTCFullYear", "getUTCFullYear()")}} 和{{jsxref("Global_Objects/Date/setUTCFullYear", "setUTCFullYear()")}}。</p> + +<p>从 ECMAScript 6 开始，<code>Date.prototype</code>本身就是一个普通的对象。不是{{jsxref("Date")}}的实例。</p> + +<h2 id="Properties" name="Properties">属性</h2> + +<dl> + <dt><code>Date.prototype.constructor</code></dt> + <dd>返回创建该实例的函数。默认是<code>Date</code>构造函数。</dd> +</dl> + +<h2 id="Methods" name="Methods">方法</h2> + +<h3 id="Getter">Getter</h3> + +<dl> + <dt>{{jsxref("Date.prototype.getDate()")}}</dt> + <dd>根据本地时间返回指定日期对象的月份中的第几天（1-31）。</dd> + <dt>{{jsxref("Date.prototype.getDay()")}}</dt> + <dd>根据本地时间返回指定日期对象的星期中的第几天（0-6）。</dd> + <dt>{{jsxref("Date.prototype.getFullYear()")}}</dt> + <dd>根据本地时间返回指定日期对象的年份（四位数年份时返回四位数字）。</dd> + <dt>{{jsxref("Date.prototype.getHours()")}}</dt> + <dd>根据本地时间返回指定日期对象的小时（0-23）。</dd> + <dt>{{jsxref("Date.prototype.getMilliseconds()")}}</dt> + <dd>根据本地时间返回指定日期对象的毫秒（0-999）。</dd> + <dt>{{jsxref("Date.prototype.getMinutes()")}}</dt> + <dd>根据本地时间返回指定日期对象的分钟（0-59）。</dd> + <dt>{{jsxref("Date.prototype.getMonth()")}}</dt> + <dd>根据本地时间返回指定日期对象的月份（0-11）。</dd> + <dt>{{jsxref("Date.prototype.getSeconds()")}}</dt> + <dd>根据本地时间返回指定日期对象的秒数（0-59）。</dd> + <dt>{{jsxref("Date.prototype.getTime()")}}</dt> + <dd>返回从1970-1-1 00:00:00 UTC（协调世界时）到该日期经过的毫秒数，对于1970-1-1 00:00:00 UTC之前的时间返回负值。</dd> + <dt>{{jsxref("Date.prototype.getTimezoneOffset()")}}</dt> + <dd>返回当前时区的时区偏移。</dd> + <dt>{{jsxref("Date.prototype.getUTCDate()")}}</dt> + <dd>根据世界时返回特定日期对象一个月的第几天（1-31）.</dd> + <dt>{{jsxref("Date.prototype.getUTCDay()")}}</dt> + <dd>根据世界时返回特定日期对象一个星期的第几天（0-6）.</dd> + <dt>{{jsxref("Date.prototype.getUTCFullYear()")}}</dt> + <dd>根据世界时返回特定日期对象所在的年份（4位数）.</dd> + <dt>{{jsxref("Date.prototype.getUTCHours()")}}</dt> + <dd>根据世界时返回特定日期对象当前的小时（0-23）.</dd> + <dt>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</dt> + <dd>根据世界时返回特定日期对象的毫秒数（0-999）.</dd> + <dt>{{jsxref("Date.prototype.getUTCMinutes()")}}</dt> + <dd>根据世界时返回特定日期对象的分钟数（0-59）.</dd> + <dt>{{jsxref("Date.prototype.getUTCMonth()")}}</dt> + <dd>根据世界时返回特定日期对象的月份（0-11）.</dd> + <dt>{{jsxref("Date.prototype.getUTCSeconds()")}}</dt> + <dd>根据世界时返回特定日期对象的秒数（0-59）.</dd> + <dt>{{jsxref("Date.prototype.getYear()")}}{{deprecated_inline}}</dt> + <dd>根据特定日期返回年份 (通常 2-3 位数). 使用 {{jsxref("Global_Objects/Date/getFullYear", "getFullYear()")}} .</dd> +</dl> + +<h3 id="Setter">Setter</h3> + +<dl> + <dt>{{jsxref("Date.prototype.setDate()")}}</dt> + <dd>根据本地时间为指定的日期对象设置月份中的第几天。</dd> + <dt>{{jsxref("Date.prototype.setFullYear()")}}</dt> + <dd>根据本地时间为指定日期对象设置完整年份（四位数年份是四个数字）。</dd> + <dt>{{jsxref("Date.prototype.setHours()")}}</dt> + <dd>根据本地时间为指定日期对象设置小时数。</dd> + <dt>{{jsxref("Date.prototype.setMilliseconds()")}}</dt> + <dd>根据本地时间为指定日期对象设置毫秒数。</dd> + <dt>{{jsxref("Date.prototype.setMinutes()")}}</dt> + <dd>根据本地时间为指定日期对象设置分钟数。</dd> + <dt>{{jsxref("Date.prototype.setMonth()")}}</dt> + <dd>根据本地时间为指定日期对象设置月份。</dd> + <dt>{{jsxref("Date.prototype.setSeconds()")}}</dt> + <dd>根据本地时间为指定日期对象设置秒数。</dd> + <dt>{{jsxref("Date.prototype.setTime()")}}</dt> + <dd>通过指定从 1970-1-1 00:00:00 UTC 开始经过的毫秒数来设置日期对象的时间，对于早于 1970-1-1 00:00:00 UTC的时间可使用负值。</dd> + <dt>{{jsxref("Date.prototype.setUTCDate()")}}</dt> + <dd>根据世界时设置 Date 对象中月份的一天 (1 ~ 31)。</dd> + <dt>{{jsxref("Date.prototype.setUTCFullYear()")}}</dt> + <dd>根据世界时设置 Date 对象中的年份（四位数字）。</dd> + <dt>{{jsxref("Date.prototype.setUTCHours()")}}</dt> + <dd>根据世界时设置 Date 对象中的小时 (0 ~ 23)。</dd> + <dt>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</dt> + <dd>根据世界时设置 Date 对象中的毫秒 (0 ~ 999)。</dd> + <dt>{{jsxref("Date.prototype.setUTCMinutes()")}}</dt> + <dd>根据世界时设置 Date 对象中的分钟 (0 ~ 59)。</dd> + <dt>{{jsxref("Date.prototype.setUTCMonth()")}}</dt> + <dd>根据世界时设置 Date 对象中的月份 (0 ~ 11)。</dd> + <dt>{{jsxref("Date.prototype.setUTCSeconds()")}}</dt> + <dd>根据世界时设置 Date 对象中的秒钟 (0 ~ 59)。</dd> + <dt>{{jsxref("Date.prototype.setYear()")}} {{deprecated_inline}}</dt> + <dd>setYear() 方法用于设置年份。请使用 {{jsxref("Global_Objects/Date/setFullYear", "setFullYear()")}} 方法代替。</dd> +</dl> + +<h3 id="Conversion_getter">Conversion getter</h3> + +<dl> + <dt>{{jsxref("Date.prototype.toDateString()")}}</dt> + <dd>以人类易读（human-readable）的形式返回该日期对象日期部分的字符串。</dd> + <dt>{{jsxref("Date.prototype.toISOString()")}}</dt> + <dd>把一个日期转换为符合 ISO 8601 扩展格式的字符串。</dd> + <dt>{{jsxref("Date.prototype.toJSON()")}}</dt> + <dd>使用 {{jsxref("Global_Objects/Date/toISOString", "toISOString()")}} 返回一个表示该日期的字符串。为了在 {{jsxref("JSON.stringify()")}} 方法中使用。</dd> + <dt>{{jsxref("Date.prototype.toGMTString()")}} {{deprecated_inline}}</dt> + <dd>返回一个基于 GMT (UT) 时区的字符串来表示该日期。请使用 {{jsxref("Global_Objects/Date/toUTCString", "toUTCString()")}} 方法代替。</dd> + <dt>{{jsxref("Date.prototype.toLocaleDateString()")}}</dt> + <dd>返回一个表示该日期对象日期部分的字符串，该字符串格式与系统设置的地区关联（locality sensitive）。</dd> + <dt>{{jsxref("Date.prototype.toLocaleFormat()")}} {{non-standard_inline}}</dt> + <dd>使用格式字符串将日期转换为字符串。</dd> + <dt>{{jsxref("Date.prototype.toLocaleString()")}}</dt> + <dd>返回一个表示该日期对象的字符串，该字符串与系统设置的地区关联（locality sensitive）。覆盖了 {{jsxref("Global_Objects/Object/toLocaleString", "Object.prototype.toLocaleString()")}} 方法。</dd> + <dt>{{jsxref("Date.prototype.toLocaleTimeString()")}}</dt> + <dd>返回一个表示该日期对象时间部分的字符串，该字符串格式与系统设置的地区关联（locality sensitive）。</dd> + <dt>{{jsxref("Date.prototype.toSource()")}}{{non-standard_inline}}</dt> + <dd>返回一个与{{jsxref("Date")}}等价的原始字符串对象，你可以使用这个值去生成一个新的对象。重写了 {{jsxref("Object.prototype.toSource()")}} 这个方法。</dd> + <dt>{{jsxref("Date.prototype.toString()")}}</dt> + <dd>返回一个表示该日期对象的字符串。覆盖了{{jsxref("Object.prototype.toString()")}} 方法。</dd> + <dt>{{jsxref("Date.prototype.toTimeString()")}}</dt> + <dd>以人类易读格式返回日期对象时间部分的字符串。</dd> + <dt>{{jsxref("Date.prototype.toUTCString()")}}</dt> + <dd>把一个日期对象转换为一个以UTC时区计时的字符串。</dd> + <dt>{{jsxref("Date.prototype.valueOf()")}}</dt> + <dd>返回一个日期对象的原始值。覆盖了 {{jsxref("Object.prototype.valueOf()")}} 方法。</dd> +</dl> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('ES1')}}</td> + <td>{{Spec2('ES1')}}</td> + <td>Initial definition. Implemented in JavaScript 1.1.</td> + </tr> + <tr> + <td>{{SpecName('ES5.1', '#sec-15.9.5', 'Date.prototype')}}</td> + <td>{{Spec2('ES5.1')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('ES6', '#sec-properties-of-the-date-prototype-object', 'Date.prototype')}}</td> + <td>{{Spec2('ES6')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-properties-of-the-date-prototype-object', 'Date.prototype')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("javascript.builtins.Date.prototype")}}</p> |