Date

发布时间 2023-09-03 18:49:34作者: linux星

Date

创建一个 Date 实例,该实例呈现时间中的某个时刻。Date 对象则基于 Unix Time Stamp,即自 1970 年 1 月 1 日(UTC)起经过的毫秒数。

#语法

new Date();
new Date(value);
new Date(year, monthIndex [, day [, hours [, minutes [, seconds [, milliseconds]]]]]);
复制代码
  • 如果没有输入任何参数,则 Date 的构造器会依据系统设置的当前时间来创建一个 Date 对象。
  • 如果提供了至少两个参数,其余的参数均会默认设置为 1(如果没有指定 day 参数)或者 0(如果没有指定 day 以外的参数)。
  • uts 的时间由世界标准时间(UTC)1970 年 1 月 1 日开始,用毫秒计时,一天由 86,400,000 毫秒组成。Date 对象的范围是 -100,000,000 天至 100,000,000 天(等效的毫秒值)。

#静态方法

#now

表示自 UNIX 纪元开始(1970 年 1 月 1 日 00:00:00 (UTC))到当前时间的毫秒数。

平台差异说明

JavaScript Kotlin Swift
√ (3.6.11+)
// 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)
复制代码

#实例方法

#toString()

返回一个字符串,以本地的时区表示该 Date 对象。

返回值

类型
string

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#toDateString()

以美式英语和人类易读的形式返回一个日期对象日期部分的字符串。

返回值

类型
string

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#getTime()

返回从UTC时间1970年1月1日午夜开始以毫秒为单位存储的时间值。

返回值

类型
number

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#getFullYear()

根据本地时间返回指定日期的年份。此方法替代 getYear() 。

返回值

类型 描述
number 根据当地时间,返回一个对应于给定日期的年份数字。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 9.0 x

#getMonth()

根据本地时间,返回一个指定的日期对象的月份,为基于 0 的值(0 表示一年中的第一月)。

返回值

类型 描述
number 一个 0 到 11 的整数值:0 代表一月份,1 代表二月份,2 代表三月份,依次类推。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 9.0 x

#getDate()

根据本地时间,返回一个指定的日期对象为一个月中的哪一日(从 1--31)。

返回值

类型 描述
number 返回一个 1 到 31 的整数值。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 9.0 x

#getDay()

根据本地时间,返回一个具体日期中一周的第几天,0 表示星期天。

返回值

类型 描述
number 根据本地时间,返回一个 0 到 6 之间的整数值,代表星期几:0 代表星期日,1 代表星期一,2 代表星期二,依次类推。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 9.0 x

#getHours()

根据本地时间,返回一个指定的日期对象的小时。

返回值

类型 描述
number 返回一个 0 到 23 之间的整数值。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#getMinutes()

根据本地时间,返回一个指定的日期对象的分钟数。

返回值

类型 描述
number 返回一个 0 到 59 的整数值。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#getSeconds()

根据本地时间,返回一个指定的日期对象的秒数。

返回值

类型 描述
number 返回一个 0 到 59 的整数值。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setTime(time)

以一个表示从 1970-1-1 00:00:00 UTC 计时的毫秒数为来为 Date 对象设置时间。

参数

参数名 参数类型 是否必填 描述
time number 一个整数,表示从 1970-1-1 00:00:00 UTC 开始计时的毫秒数。

返回值

类型 描述
number UTC 1970 年 1 月 1 日 00:00:00 与更新日期之间的毫秒数(实际上是自变量的值)。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setMilliseconds(ms)

根据本地时间设置一个日期对象的豪秒数。如果指定的数字超出了合理范围,则日期对象的时间信息会被相应地更新。例如,如果指定了 1005,则秒数加 1,豪秒数为 5。

参数

参数名 参数类型 是否必填 描述
ms number 一个 0 到 999 的数字,表示豪秒数。

返回值

类型 描述
number 返回更新后的时间距 1970 年 1 月 1 日 00:00:00 的毫秒数。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setSeconds(sec, ms?)

根据本地时间设置一个日期对象的秒数。

参数

参数名 参数类型 是否必填 描述
sec number 一个 0 到 59 的整数。
ms number 一个 0 到 999 的数字,表示微秒数。

返回值

类型
number

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setMinutes(min, sec?, ms?)

根据本地时间为一个日期对象设置分钟数。

参数

参数名 参数类型 是否必填 描述
min number 一个 0 到 59 的整数,表示分钟数。
sec number 一个 0 到 59 的整数,表示秒数。如果指定了 sec 参数,则必须同时指定 min 参数。
ms number 一个 0 到 999 的数字,表示微秒数,如果指定了 ms 参数,则必须同时指定 min 和 sec 参数。

返回值

类型
number

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setHours(hours, min?, sec?, ms?)

根据本地时间为一个日期对象设置小时数,返回从 1970-01-01 00:00:00 UTC 到更新后的 日期 对象实例所表示时间的毫秒数。

参数

参数名 参数类型 是否必填 描述
hours number 必填,一个 0 到 23 的整数,表示小时。
min number 可选,一个 0 到 59 的整数,表示分钟。
sec number 可选,一个 0 到 59 的整数,表示秒数。如果指定了 sec 参数,则必须同时指定 min 参数。
ms number 可选,一个 0 到 999 的数字,表示微秒数,如果指定了 ms 参数,则必须同时指定 min 和 sec 参数。

返回值

类型
number

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setDate(date)

根据本地时间来指定一个日期对象的天数。如果 dayValue 超出了月份的合理范围,setDate 将会相应地更新 Date 对象。例如,如果为 dayValue 指定 0,那么日期就会被设置为上个月的最后一天。如果 dayValue 被设置为负数,日期会设置为上个月最后一天往前数这个负数绝对值天数后的日期。-1 会设置为上月最后一天的前一天(译者注:例如当前为 4 月,如果 setDate(-2),则为 3 月 29 日)

参数

参数名 参数类型 是否必填 描述
date number 一个整数,表示该月的第几天。

返回值

类型
number

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setMonth(month, date?)

根据本地时间为一个日期对象设置月份。

参数

参数名 参数类型 是否必填 描述
month number 必填参数,介于 0 到 11 之间的整数(表示一月到十二月)。
date number 可选参数,从 1 到 31 之间的整数,表示月份中的第几天。0 为上个月最后一天。

返回值

类型 描述
number 基于 1 January 1970 00:00:00 UTC 开始计算的毫秒数。

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x

#setFullYear(year, month?, date?)

根据本地时间为一个日期对象设置年份。

参数

参数名 参数类型 是否必填 描述
year number 指定年份的整数值,例如 1995。
month number 可选参数:一个 0 到 11 之间的整数值,表示从一月到十二月。
date number 可选参数:一个 1 到 31 之间的整数值,表示月份中的第几天。如果你指定了 date 参数,就必须同时指定 month。

返回值

类型
number

兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
4.4 3.9.0 3.9.0 9.0 x