Temporal.PlainDate.prototype.toString()

Метод toString() экземпляров Temporal.PlainDate возвращает строку, представляющую эту дату в формате RFC 9557.

Синтаксис

toString()
toString(options)

Параметры

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

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

calendarName Необязательно

Следует ли показывать аннотацию календаря ([u-ca=calendar_id]) в возвращаемом значении. Возможные значения:

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

Включить аннотацию календаря, если календарь не является "iso8601".

"always"

Всегда включать аннотацию календаря.

"never"

Никогда не включать аннотацию календаря. Это делает возвращаемую строку невосстановимой до того же экземпляра Temporal.PlainDate, хотя значение даты остается прежним.

"critical"

Всегда включать аннотацию календаря и добавлять критический флаг: [!u-ca=calendar_id]. Полезно при отправке строки в определенные системы, но бесполезно для самого Temporal.

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

Строка в формате RFC 9557, представляющая эту дату. Аннотация календаря включается в соответствии с указанием.

Исключения

RangeError

Выбрасывается, если один из параметров недопустим.

TypeError

Выбрасывается, если options не является объектом или undefined.

Примеры

Использование toString()

const date = Temporal.PlainDate.from("2021-08-01");
console.log(date.toString()); // '2021-08-01'

Использование параметров

const isoDate = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const date = Temporal.PlainDate.from({
  year: 2021,
  month: 8,
  day: 1,
  calendar: "islamic-umalqura",
});
console.log(isoDate.toString({ calendarName: "auto" })); // '2021-08-01'
console.log(date.toString({ calendarName: "auto" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(isoDate.toString({ calendarName: "always" })); // '2021-08-01[u-ca=iso8601]'
console.log(date.toString({ calendarName: "always" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(date.toString({ calendarName: "never" })); // '2582-12-17'
console.log(isoDate.toString({ calendarName: "critical" })); // '2021-08-01[!u-ca=iso8601]'
console.log(date.toString({ calendarName: "critical" })); // '2582-12-17[!u-ca=islamic-umalqura]'

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

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

См. также

• Temporal.PlainDate
• Temporal.PlainDate.from()
• Temporal.PlainDate.prototype.toJSON()
• Temporal.PlainDate.prototype.toLocaleString()