Temporal.PlainDateTime.from()
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
The **Temporal.PlainDateTime.from()** static method creates a new Temporal.PlainDateTime object from another Temporal.PlainDateTime object, an object with date and time properties, or an RFC 9557 string.
Syntax
js-nolint
Temporal.PlainDateTime.from(info)
Temporal.PlainDateTime.from(info, options)Parameters
info- : One of the following:
- A {{jsxref("Temporal.PlainDateTime")}} instance, which creates a copy of the instance.
- An RFC 9557 string containing a date, optionally a time, and optionally a calendar.
- An object containing properties that are recognized by either {{jsxref("Temporal/PlainDate/from", "Temporal.PlainDate.from()")}} (
calendar,era,eraYear,year,month,monthCode,day) or {{jsxref("Temporal/PlainTime/from", "Temporal.PlainTime.from()")}} (hour,minute,second,millisecond,microsecond,nanosecond). The info should explicitly specify a year (asyearoreraanderaYear), a month (asmonthormonthCode), and a day; others are optional and will be set to their default values. options{{optional_inline}}- : An object containing the following property:
overflow{{optional_inline}}- : A string specifying the behavior when a date component is out of range (when using the object
info). Possible values are: "constrain"(default)- : The date component is clamped to the valid range.
"reject"- : A {{jsxref("RangeError")}} is thrown if the date component is out of range.
Return value
A new Temporal.PlainDateTime object, representing the date and time specified by info in the specified calendar.
Exceptions
- {{jsxref("TypeError")}}
- : Thrown in one of the following cases:
infois not an object or a string.optionsis not an object orundefined.- The provided properties are insufficient to unambiguously determine a date. You usually need to provide a
year(oreraanderaYear), amonth(ormonthCode), and aday. - {{jsxref("RangeError")}}
- : Thrown in one of the following cases:
- The provided properties that specify the same component are inconsistent.
- The provided non-numerical properties are not valid; for example, if
monthCodeis never a valid month code in this calendar. - The provided numerical properties are out of range, and
options.overflowis set to"reject". - The info is not in the representable range, which is ±(10<sup>8</sup> + 1) days, or about ±273,972.6 years, from the Unix epoch.
Examples
Creating a PlainDateTime from an object
js
// 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"Creating a PlainDateTime from a string
js
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)For more examples, especially regarding different calendars and overflow settings, see {{jsxref("Temporal/PlainDate/from", "Temporal.PlainDate.from()")}} and {{jsxref("Temporal/PlainTime/from", "Temporal.PlainTime.from()")}}.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{jsxref("Temporal.PlainDateTime")}}
- {{jsxref("Temporal/PlainDateTime/PlainDateTime", "Temporal.PlainDateTime()")}}
- {{jsxref("Temporal/PlainDateTime/with", "Temporal.PlainDateTime.prototype.with()")}}