Temporal.PlainMonthDay.prototype.toString()

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

Синтаксис

toString()
toString(options)

Параметры

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

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

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

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

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

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

"always"

Всегда включает аннотацию календаря. Референтный год также всегда включается.

"never"

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

"critical"

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

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

Строка в формате RFC 9557, представляющая этот месяц-день. Аннотация календаря включена, как указано. Референтный год включается, если включена аннотация календаря или если календарь не является "iso8601".

Исключения

RangeError

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

TypeError

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

Примеры

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

const md = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
console.log(md.toString()); // '08-01'

const md2 = Temporal.PlainMonthDay.from({
  monthCode: "M08",
  day: 1,
  calendar: "chinese",
});
console.log(md2.toString()); // '1972-09-08[u-ca=chinese]'

Использование options

const isoMD = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
const md = Temporal.PlainMonthDay.from({
  monthCode: "M08",
  day: 1,
  calendar: "chinese",
});
console.log(isoMD.toString({ calendarName: "auto" })); // '08-01'
console.log(md.toString({ calendarName: "auto" })); // '1972-09-08[u-ca=chinese]'
console.log(isoMD.toString({ calendarName: "always" })); // '1972-08-01[u-ca=iso8601]'
console.log(md.toString({ calendarName: "always" })); // '1972-09-08[u-ca=chinese]'
console.log(isoMD.toString({ calendarName: "never" })); // '08-01'
console.log(md.toString({ calendarName: "never" })); // '1972-09-08'
console.log(isoMD.toString({ calendarName: "critical" })); // '1972-08-01[!u-ca=iso8601]'
console.log(md.toString({ calendarName: "critical" })); // '1972-09-08[!u-ca=chinese]'

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

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

См. также

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