Source code
Revision control
Copy as Markdown
Other Tools
// |reftest| skip-if(!this.hasOwnProperty('Temporal')) -- Temporal is not enabled unconditionally
// Copyright (C) 2023 Igalia, S.L. All rights reserved.
// This code is governed by the BSD license found in the LICENSE file.
/*---
esid: sec-temporal.calendar.prototype.yearmonthfromfields
description: Reference ISO day is chosen to be the first of the calendar month
info: |
6.d. Perform ! CreateDataPropertyOrThrow(_fields_, *"day"*, *1*<sub>𝔽</sub>).
e. Let _result_ be ? CalendarDateToISO(_calendar_.[[Identifier]], _fields_, _options_).
includes: [temporalHelpers.js]
features: [Temporal]
---*/
// Month codes, month indices, and the ISO reference days of the months in 2022
const months2022TestData = [
// TODO: Sources conflict over whether M01L and M12L exist in _any_ year.
// Clarify this, and delete if appropriate. ICU has them, but may be wrong.
//
// - ICU4C and ICU4X both have M01L in Gregorian year 1651.
// - ICU4C has M12L in Gregorian year 1889, but ICU4X doesn't.
// - ICU4X has M12L in Gregorian year 1403, but ICU4C doesn't.
["M01", 1, 1],
["M02", 2, 3],
["M03", 3, 1],
["M04", 4, 1],
["M05", 5, 30],
["M06", 6, 29],
["M07", 7, 29],
["M08", 8, 27],
["M09", 9, 26],
["M10", 10, 25],
["M11", 11, 24],
["M12", 12, 23],
];
for (let [nonLeapMonthCode, month, referenceISODay] of months2022TestData) {
// Allow implementation-defined "epoch year" for the Chinese calendar.
const year = new Temporal.PlainDate(2022, 3, 1).withCalendar("chinese").year;
const leapMonthCode = nonLeapMonthCode + "L";
const fields = { year, monthCode: leapMonthCode, calendar: "chinese" };
const result = Temporal.PlainYearMonth.from(fields, { overflow: "constrain" });
// CalendarDateToISO ( calendar, fields, overflow )
//
// > If the month is a leap month that doesn't exist in the year, pick another
// > date according to the cultural conventions of that calendar's users.
// > Usually this will result in the same day in the month before or after
// > where that month would normally fall in a leap year.
//
// Without clear information in which direction the month has to be adjusted,
// we have to allow two possible implementations:
// 1. The previous month is used, i.e. "M01L" is constrained to "M01".
// 2. The next month is used, i.e. "M01L" is constrained to "M02".
if (result.month !== month) {
assert.sameValue(result.month, month + 1);
// Adjust nonLeapMonthCode, month, referenceISODay using the data from the
// next month.
const nextMonth = months2022TestData.find(e => e[1] === month + 1);
[nonLeapMonthCode, month, referenceISODay] = nextMonth;
}
TemporalHelpers.assertPlainYearMonth(
result,
year, month, nonLeapMonthCode,
`Chinese intercalary month ${leapMonthCode} does not exist in year 2022 (overflow constrain)`,
/* era = */ undefined, /* era year = */ undefined, referenceISODay
);
assert.throws(
RangeError,
() => Temporal.PlainYearMonth.from(fields, { overflow: "reject" }),
`Chinese intercalary month ${leapMonthCode} does not exist in year 2022 (overflow reject)`
);
}
// Years in which leap months exist according to ICU4C/ICU4X.
const leapMonthsTestData = [
["M01L", 1651, 2, 20],
["M02L", 2023, 3, 22],
["M03L", 1993, 4, 22],
["M04L", 2020, 5, 23],
["M05L", 2009, 6, 23],
["M06L", 2017, 7, 23],
["M07L", 2006, 8, 24],
["M08L", 1995, 9, 25],
["M09L", 2014, 10, 24],
["M10L", 1984, 11, 23],
["M11L", 1517, 12, 23],
];
for (const [monthCode, relatedYear, month, referenceISODay, isoYear = relatedYear, isoMonth = month] of leapMonthsTestData) {
// Allow implementation-defined "epoch year" for the Chinese calendar.
const year = new Temporal.PlainDate(relatedYear, 3, 1).withCalendar("chinese").year;
const result = Temporal.PlainYearMonth.from({ year, monthCode, calendar: "chinese" });
TemporalHelpers.assertPlainYearMonth(
result,
year, month, monthCode,
`Date of sample Chinese intercalary month ${monthCode}`,
/* era = */ undefined, /* era year = */ undefined, referenceISODay
);
const isoYearMonth = result.toString().slice(0, 7);
assert.sameValue(isoYearMonth, `${isoYear}-${String(isoMonth).padStart(2, '0')}`, `${year}-${monthCode} starts in ISO month ${isoYear}-${isoMonth}`);
}
reportCompare(0, 0);