Temporal.PlainDateTime.from()

Статический метод Temporal.PlainDateTime.from() создает новый объект Temporal.PlainDateTime из другого объекта Temporal.PlainDateTime, объекта со свойствами даты и времени или строки RFC 9557.

Синтаксис

Temporal.PlainDateTime.from(info)
Temporal.PlainDateTime.from(info, options)

Параметры

info

Одно из следующего:

• Экземпляр Temporal.PlainDateTime, который создает копию экземпляра.
• Строка RFC 9557, содержащая дату, необязательно время и необязательный календарь.
• Объект, содержащий свойства, распознаваемые либо Temporal.PlainDate.from() (calendar, era, eraYear, year, month, monthCode, day), либо Temporal.PlainTime.from() (hour, minute, second, millisecond, microsecond, nanosecond). Объект info должен явно указывать год (в виде year или era и eraYear), месяц (в виде month или monthCode) и день; остальные являются необязательными и будут установлены в свои значения по умолчанию.

options Необязательный

Объект, содержащий следующее свойство:

overflow Необязательный

Строка, определяющая поведение, когда компонент даты выходит за пределы допустимого диапазона (при использовании объекта info). Возможные значения:

"constrain" (по умолчанию)

Компонент даты ограничивается допустимым диапазоном.

"reject"

Будет выброшено исключение RangeError, если компонент даты выходит за пределы допустимого диапазона.

Возвращаемое значение

Новый объект Temporal.PlainDateTime, представляющий дату и время, указанные info в указанном calendar.

Исключения

TypeError

Выбрасывается в одном из следующих случаев:

• info не является объектом или строкой.
• options не является объектом или undefined.
• Предоставленные свойства недостаточны для однозначного определения даты. Обычно вам необходимо предоставить year (или era и eraYear), month (или monthCode) и day.

RangeError

Выбрасывается в одном из следующих случаев:

• Предоставленные свойства, указывающие на один и тот же компонент, противоречивы.
• Предоставленные нечисловые свойства недопустимы; например, если monthCode никогда не является допустимым кодом месяца в этом календаре.
• Предоставленные числовые свойства выходят за пределы допустимого диапазона, и options.overflow установлено в "reject".
• Данные info находятся вне представимого диапазона, который составляет ±(10⁸ + 1) дней, или примерно ±273 972,6 лет, от эпохи Unix.

Примеры

Создание PlainDateTime из объекта

// Year + month + day + hour + minute + second
const dt = Temporal.PlainDateTime.from({
  year: 2021,
  month: 7,
  day: 1,
  hour: 12,
  minute: 34,
  second: 56,
});
console.log(dt.toString()); // "2021-07-01T12:34:56"

Создание PlainDateTime из строки

const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
console.log(dt.toLocaleString()); // "7/1/2021, 12:34:56 PM" (assuming en-US locale)

Для получения дополнительных примеров, особенно касающихся различных календарей и настроек переполнения, см. Temporal.PlainDate.from() и Temporal.PlainTime.from().

Спецификации

Совместимость с браузерами

См. также

• Temporal.PlainDateTime
• Temporal.PlainDateTime()
• Temporal.PlainDateTime.prototype.with()