Bitbybit Docs
    Preparing search index...

    Class Dates

    以 JavaScript Date 值表示的日期和时间：创建它们，读取和设置其各部分，以及将其格式化为文本。月份从 0 开始计数（一月为 0，十二月为 11），星期从 0 开始（星期日）；月中的日从 1 开始计数。每个设置器都返回新日期，并保持给定的日期不变。大多数操作都有本地时间和 UTC 两种变体。

    Index

    Constructors

    constructor

    convert

    toDateString toISOString toJSON toString toTimeString toUTCString

    create

    now createDate createDateUTC createFromUnixTimeStamp

    get

    getDayOfMonth getWeekday getYear getMonth getHours getMinutes getSeconds getMilliseconds getTime getUTCYear getUTCMonth getUTCDay getUTCHours getUTCMinutes getUTCSeconds getUTCMilliseconds

    parse

    parseDate

    set

    setYear setMonth setDayOfMonth setHours setMinutes setSeconds setMilliseconds setTime setUTCYear setUTCMonth setUTCDay setUTCHours setUTCMinutes setUTCSeconds setUTCMilliseconds

    Constructors

    convert

    • 将日期部分格式化为文本，不含时间，采用本地时区。

      示例：2024 年 1 月 15 日 14:30 -> 'Mon Jan 15 2024'

      Parameters

      Returns string

      以文本表示的日期，例如 'Mon Jan 15 2024'

    • 以用于数据交换的 ISO 8601 形式格式化日期和时间，始终采用 UTC。

      示例：2024 年 1 月 15 日 14:30 -> '2024-01-15T14:30:45.000Z'

      Parameters

      Returns string

      以文本表示的日期，例如 '2024-01-15T14:30:45.000Z'

    • 按日期在 JSON 中出现的方式格式化它，即 UTC 的 ISO 8601 形式。

      示例：2024 年 1 月 15 日 14:30 -> '2024-01-15T14:30:00.000Z'

      Parameters

      Returns string

      以文本表示的日期，例如 '2024-01-15T14:30:00.000Z'

    • 将完整的日期和时间格式化为本地时区的文本，带时区偏移。

      示例：2024 年 1 月 15 日 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'

      Parameters

      Returns string

      以文本表示的日期和时间

    • 将时间部分格式化为文本，不含日期，采用本地时区并带时区偏移。

      示例：2024 年 1 月 15 日 14:30 -> '14:30:45 GMT+0000'

      Parameters

      Returns string

      以文本表示的时间，例如 '14:30:45 GMT+0000'

    • 将日期和时间格式化为 UTC 的文本。

      示例：2024 年 1 月 15 日 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'

      Parameters

      Returns string

      以 UTC 文本表示的日期和时间

    create

    • 给出调用时刻的当前日期和时间。

      Returns Date

      当前日期和时间

    • 由各部分构建日期，按本地时区读取。

      月份从 0 开始计数：0 是一月，11 是十二月。超出范围的部分会进位，因此一月的第 32 天变成二月一日。 示例：year 2024，month 0，day 15，hours 14，minutes 30 -> 本地时间 2024 年 1 月 15 日 14:30

      Parameters

      Returns Date

      日期

      const date = bitbybit.dates.createDate({ year: 2024, month: 0, day: 15, hours: 14, minutes: 30, seconds: 0, milliseconds: 0 });

    • 由各部分构建日期，按 UTC 读取，因此本地时区不起作用。

      月份从 0 开始计数：0 是一月，11 是十二月。超出范围的部分会进位。 示例：year 2024，month 0，day 15 -> 2024 年 1 月 15 日 00:00 UTC

      Parameters

      Returns Date

      日期

      const date = bitbybit.dates.createDateUTC({ year: 2024, month: 0, day: 15, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 });

    • 由 Unix 时间戳构建日期：自 1970 年 1 月 1 日 00:00 UTC 起的毫秒数。

      示例：1705329000000 -> 2024 年 1 月 15 日 14:30 UTC

      Parameters

      Returns Date

      日期

      const date = bitbybit.dates.createFromUnixTimeStamp({ unixTimeStamp: 1705329000000 });

    get

    • 读取月中的日，从 1 到 31，采用本地时区。

      示例：2024 年 1 月 15 日 -> 15

      Parameters

      Returns number

      月中的日

    • 读取本地时区的星期几：0 是星期日，6 是星期六。

      示例：2024 年 1 月 15 日 -> 1，星期一

      Parameters

      Returns number

      星期几，从 0 到 6

    • 读取本地时区的完整年份。

      示例：2024 年 1 月 15 日 -> 2024

      Parameters

      Returns number

      年

    • 读取本地时区的月份，从 0 开始计数：0 是一月，11 是十二月。

      示例：2024 年 1 月 15 日 -> 0

      Parameters

      Returns number

      月，从 0 到 11

    • 读取小时，从 0 到 23，采用本地时区。

      示例：14:30 -> 14

      Parameters

      Returns number

      小时

    • 读取分钟，从 0 到 59，采用本地时区。

      示例：14:30 -> 30

      Parameters

      Returns number

      分钟

    • 读取秒，从 0 到 59，采用本地时区。

      示例：14:30:45 -> 45

      Parameters

      Returns number

      秒

    • 读取毫秒，从 0 到 999，采用本地时区。

      示例：14:30:45.123 -> 123

      Parameters

      Returns number

      毫秒

    • 以 Unix 时间戳给出日期：自 1970 年 1 月 1 日 00:00 UTC 起的毫秒数。

      示例：2024 年 1 月 15 日 14:30 UTC -> 1705329000000

      Parameters

      Returns number

      以毫秒为单位的时间戳

    • 读取 UTC 的完整年份。

      示例：2024 年 1 月 15 日 -> 2024

      Parameters

      Returns number

      年

    • 读取 UTC 的月份，从 0 开始计数：0 是一月，11 是十二月。

      示例：2024 年 1 月 15 日 -> 0

      Parameters

      Returns number

      月，从 0 到 11

    • 读取月中的日，从 1 到 31，采用 UTC。

      示例：2024 年 1 月 15 日 -> 15

      Parameters

      Returns number

      月中的日

    • 读取小时，从 0 到 23，采用 UTC。

      示例：14:00 UTC -> 14

      Parameters

      Returns number

      小时

    • 读取分钟，从 0 到 59，采用 UTC。

      示例：14:30 UTC -> 30

      Parameters

      Returns number

      分钟

    • 读取秒，从 0 到 59，采用 UTC。

      示例：14:30:45 UTC -> 45

      Parameters

      Returns number

      秒

    • 读取毫秒，从 0 到 999，采用 UTC。

      示例：14:30:45.123 UTC -> 123

      Parameters

      Returns number

      毫秒

    parse

    • 读取以文本书写的日期并给出其 Unix 时间戳，即自 1970 年 1 月 1 日 00:00 UTC 起的毫秒数。

      '2024-01-15' 或 '2024-01-15T14:30:00Z' 之类的 ISO 8601 文本可以可靠地读取；无法读取的文本给出 NaN。 示例：'2024-01-15' -> 1705276800000

      Parameters

      Returns number

      以毫秒为单位的时间戳，文本不是日期时为 NaN

      const stamp = bitbybit.dates.parseDate({ dateString: "2024-01-15T14:30:00Z" });

    set

    • 创建日期的副本并换成另一个年份，采用本地时区。给定的日期不会被更改。

      示例：2024 年 1 月 15 日，year 2025 -> 2025 年 1 月 15 日

      Parameters

      Returns Date

      更改年份后的新日期

      const changed = bitbybit.dates.setYear({ date: bitbybit.dates.now(), year: 2025 });

    • 创建日期的副本并换成另一个月份，采用本地时区；月份从 0 开始计数。给定的日期不会被更改。

      示例：2024 年 1 月 15 日，month 5 -> 2024 年 6 月 15 日

      Parameters

      Returns Date

      更改月份后的新日期

      const changed = bitbybit.dates.setMonth({ date: bitbybit.dates.now(), month: 5 });

    • 创建日期的副本并换成月中的另一天，采用本地时区。给定的日期不会被更改。

      示例：2024 年 1 月 15 日，day 20 -> 2024 年 1 月 20 日

      Parameters

      Returns Date

      更改日后的新日期

      const changed = bitbybit.dates.setDayOfMonth({ date: bitbybit.dates.now(), day: 20 });

    • 创建日期的副本并换成另一个小时，采用本地时区。给定的日期不会被更改。

      示例：14:30，hours 9 -> 09:30

      Parameters

      Returns Date

      更改小时后的新日期

      const changed = bitbybit.dates.setHours({ date: bitbybit.dates.now(), hours: 9 });

    • 创建日期的副本并换成另一个分钟值，采用本地时区。给定的日期不会被更改。

      示例：14:30，minutes 45 -> 14:45

      Parameters

      Returns Date

      更改分钟后的新日期

      const changed = bitbybit.dates.setMinutes({ date: bitbybit.dates.now(), minutes: 45 });

    • 创建日期的副本并换成另一个秒值，采用本地时区。给定的日期不会被更改。

      示例：14:30:00，seconds 30 -> 14:30:30

      Parameters

      Returns Date

      更改秒后的新日期

      const changed = bitbybit.dates.setSeconds({ date: bitbybit.dates.now(), seconds: 30 });

    • 创建日期的副本并换成另一个毫秒值，采用本地时区。给定的日期不会被更改。

      示例：14:30:00.000，milliseconds 500 -> 14:30:00.500

      Parameters

      Returns Date

      更改毫秒后的新日期

      const changed = bitbybit.dates.setMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });

    • 创建日期的副本并将其移到某个 Unix 时间戳，即自 1970 年 1 月 1 日 00:00 UTC 起的毫秒数。给定的日期不会被更改。

      示例：任何日期，time 0 -> 1970 年 1 月 1 日 00:00 UTC

      Parameters

      • inputs: DateTimeDto

        日期和以毫秒为单位的时间戳

      Returns Date

      更改时间戳后的新日期

      const changed = bitbybit.dates.setTime({ date: bitbybit.dates.now(), time: 1705329000000 });

    • 创建日期的副本并换成另一个年份，采用 UTC。给定的日期不会被更改。

      示例：2024 年 1 月 15 日，year 2025 -> 2025 年 1 月 15 日

      Parameters

      Returns Date

      更改年份后的新日期

      const changed = bitbybit.dates.setUTCYear({ date: bitbybit.dates.now(), year: 2025 });

    • 创建日期的副本并换成另一个月份，采用 UTC；月份从 0 开始计数。给定的日期不会被更改。

      示例：2024 年 1 月 15 日，month 5 -> 2024 年 6 月 15 日

      Parameters

      Returns Date

      更改月份后的新日期

      const changed = bitbybit.dates.setUTCMonth({ date: bitbybit.dates.now(), month: 5 });

    • 创建日期的副本并换成月中的另一天，采用 UTC。给定的日期不会被更改。

      示例：2024 年 1 月 15 日，day 20 -> 2024 年 1 月 20 日

      Parameters

      Returns Date

      更改日后的新日期

      const changed = bitbybit.dates.setUTCDay({ date: bitbybit.dates.now(), day: 20 });

    • 创建日期的副本并换成另一个小时，采用 UTC。给定的日期不会被更改。

      示例：14:30 UTC，hours 9 -> 09:30 UTC

      Parameters

      Returns Date

      更改小时后的新日期

      const changed = bitbybit.dates.setUTCHours({ date: bitbybit.dates.now(), hours: 9 });

    • 创建日期的副本并换成另一个分钟值，采用 UTC。给定的日期不会被更改。

      示例：14:30 UTC，minutes 45 -> 14:45 UTC

      Parameters

      Returns Date

      更改分钟后的新日期

      const changed = bitbybit.dates.setUTCMinutes({ date: bitbybit.dates.now(), minutes: 45 });

    • 创建日期的副本并换成另一个秒值，采用 UTC。给定的日期不会被更改。

      示例：14:30:00 UTC，seconds 30 -> 14:30:30 UTC

      Parameters

      Returns Date

      更改秒后的新日期

      const changed = bitbybit.dates.setUTCSeconds({ date: bitbybit.dates.now(), seconds: 30 });

    • 创建日期的副本并换成另一个毫秒值，采用 UTC。给定的日期不会被更改。

      示例：14:30:00.000 UTC，milliseconds 500 -> 14:30:00.500 UTC

      Parameters

      Returns Date

      更改毫秒后的新日期

      const changed = bitbybit.dates.setUTCMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });

    Settings

    Member Visibility

    On This Page

    Constructors
    convert
    create
    get
    parse
    set