Temporal.Instant.from()

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

Синтаксис

Temporal.Instant.from(info)

Параметры

info

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

• Экземпляр Temporal.Instant, который создает копию экземпляра.
• Строка RFC 9557, содержащая дату, время и смещение часового пояса. Имя часового пояса игнорируется; используется только смещение.

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

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

Исключения

TypeError

Выбрасывается, если info не является экземпляром Temporal.Instant или строкой.

RangeError

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

• Строка не является действительной строкой RFC 9557.
• Информация не находится в представимом диапазоне, который составляет ±10⁸ дней, или около ±273 972,6 лет, от эпохи Unix.

Примеры

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

const instant = Temporal.Instant.from("1970-01-01T00Z");
console.log(instant.toString()); // 1970-01-01T00:00:00Z

const instant2 = Temporal.Instant.from("1970-01-01T00+08:00");
console.log(instant2.toString()); // 1969-12-31T16:00:00Z

// America/New_York is UTC-5 in January 1970, not UTC+8
const instant3 = Temporal.Instant.from("1970-01-01T00+08:00[America/New_York]");
console.log(instant3.toString()); // 1969-12-31T16:00:00Z; the time zone name is ignored

Создание момента времени из другого момента времени

const instant = Temporal.Instant.from("1970-01-01T00Z");
const instant2 = Temporal.Instant.from(instant);
console.log(instant2.toString()); // 1970-01-01T00:00:00Z

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

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

См. также

• Temporal.Instant
• Temporal.Instant.fromEpochMilliseconds()
• Temporal.Instant.fromEpochNanoseconds()