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

    • Форматирует часть с датой как текст, без времени, в местном часовом поясе.

      Пример: 15 января 2024 в 14:30 -> 'Mon Jan 15 2024'

      Parameters

      Returns string

      Дата как текст вида 'Mon Jan 15 2024'

    • Форматирует дату и время в форме ISO 8601, используемой для обмена данными, всегда в UTC.

      Пример: 15 января 2024 в 14:30 -> '2024-01-15T14:30:45.000Z'

      Parameters

      Returns string

      Дата как текст вида '2024-01-15T14:30:45.000Z'

    • Форматирует дату так, как она выглядит внутри JSON, то есть в форме ISO 8601 в UTC.

      Пример: 15 января 2024 в 14:30 -> '2024-01-15T14:30:00.000Z'

      Parameters

      Returns string

      Дата как текст вида '2024-01-15T14:30:00.000Z'

    • Форматирует полные дату и время как текст в местном часовом поясе, со смещением пояса.

      Пример: 15 января 2024 в 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'

      Parameters

      Returns string

      Дата и время как текст

    • Форматирует часть со временем как текст, без даты, в местном часовом поясе со смещением пояса.

      Пример: 15 января 2024 в 14:30 -> '14:30:45 GMT+0000'

      Parameters

      Returns string

      Время как текст вида '14:30:45 GMT+0000'

    • Форматирует дату и время как текст в UTC.

      Пример: 15 января 2024 в 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'

      Parameters

      Returns string

      Дата и время как текст в UTC

    create

    • Дает текущие дату и время в момент вызова.

      Returns Date

      Текущие дата и время

    • Строит дату из ее частей, читаемых в местном часовом поясе.

      Месяц считается с 0: 0 - январь, 11 - декабрь. Часть вне своего диапазона переносится дальше, так что 32-й день января становится первым февраля. Пример: год 2024, месяц 0, день 15, часы 14, минуты 30 -> 15 января 2024 в 14:30 по местному времени

      Parameters

      • inputs: CreateDateDto

        Год, месяц, день, часы, минуты, секунды и миллисекунды

      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 - декабрь. Часть вне своего диапазона переносится дальше. Пример: год 2024, месяц 0, день 15 -> 15 января 2024 в 00:00 UTC

      Parameters

      • inputs: CreateDateDto

        Год, месяц, день, часы, минуты, секунды и миллисекунды

      Returns Date

      Дата

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

    • Строит дату из метки времени Unix: числа миллисекунд с 1 января 1970 года 00:00 UTC.

      Пример: 1705329000000 -> 15 января 2024 в 14:30 UTC

      Parameters

      Returns Date

      Дата

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

    get

    • Читает день месяца, от 1 до 31, в местном часовом поясе.

      Пример: 15 января 2024 -> 15

      Parameters

      Returns number

      День месяца

    • Читает день недели в местном часовом поясе: 0 - воскресенье, 6 - суббота.

      Пример: 15 января 2024 -> 1, понедельник

      Parameters

      Returns number

      День недели от 0 до 6

    • Читает полный год в местном часовом поясе.

      Пример: 15 января 2024 -> 2024

      Parameters

      Returns number

      Год

    • Читает месяц в местном часовом поясе, считая с 0: 0 - январь, 11 - декабрь.

      Пример: 15 января 2024 -> 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: миллисекунды с 1 января 1970 года 00:00 UTC.

      Пример: 15 января 2024 в 14:30 UTC -> 1705329000000

      Parameters

      Returns number

      Метка времени в миллисекундах

    • Читает полный год в UTC.

      Пример: 15 января 2024 -> 2024

      Parameters

      Returns number

      Год

    • Читает месяц в UTC, считая с 0: 0 - январь, 11 - декабрь.

      Пример: 15 января 2024 -> 0

      Parameters

      Returns number

      Месяц от 0 до 11

    • Читает день месяца, от 1 до 31, в UTC.

      Пример: 15 января 2024 -> 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, миллисекунды с 1 января 1970 года 00:00 UTC.

      Текст ISO 8601, такой как '2024-01-15' или '2024-01-15T14:30:00Z', читается надежно; текст, который нельзя прочитать, дает NaN. Пример: '2024-01-15' -> 1705276800000

      Parameters

      Returns number

      Метка времени в миллисекундах или NaN, если текст не является датой

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

    set

    • Делает копию даты с другим годом, в местном часовом поясе. Заданная дата не изменяется.

      Пример: 15 января 2024 с годом 2025 -> 15 января 2025

      Parameters

      Returns Date

      Новая дата с измененным годом

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

    • Делает копию даты с другим месяцем, в местном часовом поясе; месяцы считаются с 0. Заданная дата не изменяется.

      Пример: 15 января 2024 с месяцем 5 -> 15 июня 2024

      Parameters

      Returns Date

      Новая дата с измененным месяцем

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

    • Делает копию даты с другим днем месяца, в местном часовом поясе. Заданная дата не изменяется.

      Пример: 15 января 2024 с днем 20 -> 20 января 2024

      Parameters

      • inputs: DateDayDto

        Дата и день от 1 до 31

      Returns Date

      Новая дата с измененным днем

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

    • Делает копию даты с другим часом, в местном часовом поясе. Заданная дата не изменяется.

      Пример: 14:30 с часами 9 -> 09:30

      Parameters

      Returns Date

      Новая дата с измененным часом

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

    • Делает копию даты с другими минутами, в местном часовом поясе. Заданная дата не изменяется.

      Пример: 14:30 с минутами 45 -> 14:45

      Parameters

      Returns Date

      Новая дата с измененными минутами

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

    • Делает копию даты с другими секундами, в местном часовом поясе. Заданная дата не изменяется.

      Пример: 14:30:00 с секундами 30 -> 14:30:30

      Parameters

      Returns Date

      Новая дата с измененными секундами

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

    • Делает копию даты с другими миллисекундами, в местном часовом поясе. Заданная дата не изменяется.

      Пример: 14:30:00.000 с миллисекундами 500 -> 14:30:00.500

      Parameters

      Returns Date

      Новая дата с измененными миллисекундами

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

    • Делает копию даты, перемещенную на метку времени Unix, миллисекунды с 1 января 1970 года 00:00 UTC. Заданная дата не изменяется.

      Пример: любая дата с временем 0 -> 1 января 1970 в 00:00 UTC

      Parameters

      • inputs: DateTimeDto

        Дата и метка времени в миллисекундах

      Returns Date

      Новая дата с измененной меткой времени

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

    • Делает копию даты с другим годом, в UTC. Заданная дата не изменяется.

      Пример: 15 января 2024 с годом 2025 -> 15 января 2025

      Parameters

      Returns Date

      Новая дата с измененным годом

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

    • Делает копию даты с другим месяцем, в UTC; месяцы считаются с 0. Заданная дата не изменяется.

      Пример: 15 января 2024 с месяцем 5 -> 15 июня 2024

      Parameters

      Returns Date

      Новая дата с измененным месяцем

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

    • Делает копию даты с другим днем месяца, в UTC. Заданная дата не изменяется.

      Пример: 15 января 2024 с днем 20 -> 20 января 2024

      Parameters

      • inputs: DateDayDto

        Дата и день от 1 до 31

      Returns Date

      Новая дата с измененным днем

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

    • Делает копию даты с другим часом, в UTC. Заданная дата не изменяется.

      Пример: 14:30 UTC с часами 9 -> 09:30 UTC

      Parameters

      Returns Date

      Новая дата с измененным часом

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

    • Делает копию даты с другими минутами, в UTC. Заданная дата не изменяется.

      Пример: 14:30 UTC с минутами 45 -> 14:45 UTC

      Parameters

      Returns Date

      Новая дата с измененными минутами

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

    • Делает копию даты с другими секундами, в UTC. Заданная дата не изменяется.

      Пример: 14:30:00 UTC с секундами 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 с миллисекундами 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