![uni-app](https://web-assets.dcloud.net.cn/unidoc/zh/logo-en-D.png)
![uni-app](https://web-assets.dcloud.net.cn/unidoc/zh/logo-en.png)
English
创建一个 Date 实例,该实例呈现时间中的某个时刻。Date 对象则基于 Unix Time Stamp,即自 1970 年 1 月 1 日(UTC)起经过的毫秒数。
new Date();
new Date(value);
new Date(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]]);
返回自 1970 年 1 月 1 日 00:00:00 (UTC) 到当前时间的毫秒数。
Return value
Type |
---|
number |
// this example takes 2 seconds to run
const start = Date.now()
console.log('starting timer...')
// expected output: starting timer...
setTimeout(() => {
const millis = Date.now() - start
console.log(`seconds elapsed = ${Math.floor(millis / 1000)}`)
// expected output: seconds elapsed = 2
}, 2000)
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | √ | 3.9.0 | 9.0 | √ | x |
返回一个字符串,以本地的时区表示该 Date 对象。
Return value
Type |
---|
string |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
以美式英语和人类易读的形式返回一个日期对象日期部分的字符串。
Return value
Type |
---|
string |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
返回从UTC时间1970年1月1日午夜开始以毫秒为单位存储的时间值。
Return value
Type |
---|
number |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间返回指定日期的年份。此方法替代 getYear() 。
Return value
Type | description |
---|---|
number | 根据当地时间,返回一个对应于给定日期的年份数字。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | √ | 3.9.0 | 9.0 | √ | x |
根据本地时间,返回一个指定的日期对象的月份,为基于 0 的值(0 表示一年中的第一月)。
Return value
Type | description |
---|---|
number | 一个 0 到 11 的整数值:0 代表一月份,1 代表二月份,2 代表三月份,依次类推。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | √ | 3.9.0 | 9.0 | √ | x |
根据本地时间,返回一个指定的日期对象为一个月中的哪一日(从 1--31)。
Return value
Type | description |
---|---|
number | 返回一个 1 到 31 的整数值。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | √ | 3.9.0 | 9.0 | √ | x |
根据本地时间,返回一个具体日期中一周的第几天,0 表示星期天。
Return value
Type | description |
---|---|
number | 根据本地时间,返回一个 0 到 6 之间的整数值,代表星期几:0 代表星期日,1 代表星期一,2 代表星期二,依次类推。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | √ | 3.9.0 | 9.0 | √ | x |
根据本地时间,返回一个指定的日期对象的小时。
Return value
Type | description |
---|---|
number | 返回一个 0 到 23 之间的整数值。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间,返回一个指定的日期对象的分钟数。
Return value
Type | description |
---|---|
number | 返回一个 0 到 59 的整数值。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间,返回一个指定的日期对象的秒数。
Return value
Type | description |
---|---|
number | 返回一个 0 到 59 的整数值。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
以一个表示从 1970-1-1 00:00:00 UTC 计时的毫秒数为来为 Date 对象设置时间。
Parameters
name | type | required | description |
---|---|---|---|
time | number | YES | 一个整数,表示从 1970-1-1 00:00:00 UTC 开始计时的毫秒数。 |
Return value
Type | description |
---|---|
number | UTC 1970 年 1 月 1 日 00:00:00 与更新日期之间的毫秒数(实际上是自变量的值)。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间设置一个日期对象的豪秒数。如果指定的数字超出了合理范围,则日期对象的时间信息会被相应地更新。例如,如果指定了 1005,则秒数加 1,豪秒数为 5。
Parameters
name | type | required | description |
---|---|---|---|
ms | number | YES | 一个 0 到 999 的数字,表示豪秒数。 |
Return value
Type | description |
---|---|
number | 返回更新后的时间距 1970 年 1 月 1 日 00:00:00 的毫秒数。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间设置一个日期对象的秒数。
Parameters
name | type | required | description |
---|---|---|---|
sec | number | YES | 一个 0 到 59 的整数。 |
ms | number | NO | 一个 0 到 999 的数字,表示微秒数。 |
Return value
Type |
---|
number |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间为一个日期对象设置分钟数。
Parameters
name | type | required | description |
---|---|---|---|
min | number | YES | 一个 0 到 59 的整数,表示分钟数。 |
sec | number | NO | 一个 0 到 59 的整数,表示秒数。如果指定了 sec 参数,则必须同时指定 min 参数。 |
ms | number | NO | 一个 0 到 999 的数字,表示微秒数,如果指定了 ms 参数,则必须同时指定 min 和 sec 参数。 |
Return value
Type |
---|
number |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间为一个日期对象设置小时数,返回从 1970-01-01 00:00:00 UTC 到更新后的 日期 对象实例所表示时间的毫秒数。
Parameters
name | type | required | description |
---|---|---|---|
hours | number | YES | 必填,一个 0 到 23 的整数,表示小时。 |
min | number | NO | 可选,一个 0 到 59 的整数,表示分钟。 |
sec | number | NO | 可选,一个 0 到 59 的整数,表示秒数。如果指定了 sec 参数,则必须同时指定 min 参数。 |
ms | number | NO | 可选,一个 0 到 999 的数字,表示微秒数,如果指定了 ms 参数,则必须同时指定 min 和 sec 参数。 |
Return value
Type |
---|
number |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间来指定一个日期对象的天数。如果 dayValue 超出了月份的合理范围,setDate 将会相应地更新 Date 对象。例如,如果为 dayValue 指定 0,那么日期就会被设置为上个月的最后一天。如果 dayValue 被设置为负数,日期会设置为上个月最后一天往前数这个负数绝对值天数后的日期。-1 会设置为上月最后一天的前一天(译者注:例如当前为 4 月,如果 setDate(-2),则为 3 月 29 日)
Parameters
name | type | required | description |
---|---|---|---|
date | number | YES | 一个整数,表示该月的第几天。 |
Return value
Type |
---|
number |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
根据本地时间为一个日期对象设置月份。
Parameters
name | type | required | description |
---|---|---|---|
month | number | YES | 必填参数,介于 0 到 11 之间的整数(表示一月到十二月)。 |
date | number | NO | 可选参数,从 1 到 31 之间的整数,表示月份中的第几天。0 为上个月最后一天。 |
Return value
Type | description |
---|---|
number | 基于 1 January 1970 00:00:00 UTC 开始计算的毫秒数。 |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |
各个平台在处理时间戳为负数时会有细节差异,尽量避免 参数小于1970的情况
根据本地时间为一个日期对象设置年份。
Parameters
name | type | required | description |
---|---|---|---|
year | number | YES | 指定年份的整数值,例如 1995。 |
month | number | NO | 可选参数:一个 0 到 11 之间的整数值,表示从一月到十二月。 |
date | number | NO | 可选参数:一个 1 到 31 之间的整数值,表示月份中的第几天。如果你指定了 date 参数,就必须同时指定 month。 |
Return value
Type |
---|
number |
Compatibility
Android version | Android uni-app | Android uni-app-x | iOS version | iOS uni-app | iOS uni-app-x |
---|---|---|---|---|---|
4.4 | 3.9.0 | 3.9.0 | 9.0 | √ | x |