Update docs for zero-padded monthCode format (#1364)

Author: cjtenny

docs/calendar.md

@@ -234,7 +234,7 @@ For example:
 const date = Temporal.PlainDate.from('2019-02-06').withCalendar('hebrew');
 date.year; // => 5779
 date.calendar.year(date); // same result, but calling the method directly
-date.monthCode; // => "M5L"
+date.monthCode; // => "M05L"
 date.calendar.monthCode(date); // same result, but calling the method directly
 date.daysInYear; // => 385
 date.calendar.daysInYear(date); // same result, but calling the method directly
@@ -271,10 +271,10 @@ A custom implementation of these methods would convert the calendar-space argume
 For example:
 
 ```javascript
-date = Temporal.PlainDate.from({ year: 5779, monthCode: 'M5L', day: 18, calendar: 'hebrew' });
+date = Temporal.PlainDate.from({ year: 5779, monthCode: 'M05L', day: 18, calendar: 'hebrew' });
 date.year; // => 5779
 date.month; // => 6
-date.monthCode; // => "M5L"
+date.monthCode; // => "M05L"
 date.day; // => 18
 date.toString(); // => 2019-02-23[u-ca-hebrew]
 date.toLocaleString('en-US', { calendar: 'hebrew' }); // => "18 Adar I 5779"
@@ -433,9 +433,9 @@ Usage example:
 // and `monthCode` into account
 Temporal.Calendar.from('iso8601').mergeFields(
   { year: 2006, month: 7, day: 31 },
-  { monthCode: 'M8' }
+  { monthCode: 'M08' }
 );
-// => { year: 2006, monthCode: 'M8', day: 31 }
+// => { year: 2006, monthCode: 'M08', day: 31 }
 ```
 <!-- prettier-ignore-end -->
 

docs/plaindate.md

@@ -165,9 +165,9 @@ The above read-only properties allow accessing each component of a date individu
   The last month of every year has `month` equal to the `monthsInYear` property.
   `month` values start at 1, which is different from legacy `Date` where months are represented by zero-based indices (0 to 11).
 - `monthCode` is a calendar-specific string that identifies the month in a year-independent way.
-  For common (non-leap) months, `monthCode` should be `` `M${month}` ``.
+  For common (non-leap) months, `monthCode` should be `` `M${month}` ``, where `month` is zero padded up to two digits.
   For uncommon (leap) months in lunisolar calendars like Hebrew or Chinese, the month code is the previous month's code with with an "L" suffix appended.
-  Examples: `'M2'` => February; `'M8L'` => repeated 8th month in the Chinese calendar; `'M5L'` => Adar I in the Hebrew calendar.
+  Examples: `'M02'` => February; `'M08L'` => repeated 8th month in the Chinese calendar; `'M05L'` => Adar I in the Hebrew calendar.
   - `day` is a positive integer representing the day of the month.
 
 Either `month` or `monthCode` can be used in `from` or `with` to refer to the month.
@@ -180,13 +180,13 @@ Usage examples:
 date = Temporal.PlainDate.from('2006-08-24');
 date.year;      // => 2006
 date.month;     // => 8
-date.monthCode; // => "M8"
+date.monthCode; // => "M08"
 date.day;       // => 24
 
 date = Temporal.PlainDate.from('2019-02-23[u-ca-hebrew]');
 date.year;      // => 5779
 date.month;     // => 6
-date.monthCode; // => "M5L"
+date.monthCode; // => "M05L"
 date.day;       // => 18
 ```
 <!-- prettier-ignore-end -->

docs/plaindatetime.md

@@ -241,9 +241,9 @@ Date unit details:
   The last month of every year has `month` equal to the `monthsInYear` property.
   `month` values start at 1, which is different from legacy `Date` where months are represented by zero-based indices (0 to 11).
 - `monthCode` is a calendar-specific string that identifies the month in a year-independent way.
-  For common (non-leap) months, `monthCode` should be `` `M${month}` ``.
+  For common (non-leap) months, `monthCode` should be `` `M${month}` ``, where `month` is zero padded up to two digits.
   For uncommon (leap) months in lunisolar calendars like Hebrew or Chinese, the month code is the previous month's code with with an "L" suffix appended.
-  Examples: `'M2'` => February; `'M8L'` => repeated 8th month in the Chinese calendar; `'M5L'` => Adar I in the Hebrew calendar.
+  Examples: `'M02'` => February; `'M08L'` => repeated 8th month in the Chinese calendar; `'M05L'` => Adar I in the Hebrew calendar.
 - `day` is a positive integer representing the day of the month.
 
 Either `month` or `monthCode` can be used in `from` or `with` to refer to the month.
@@ -278,7 +278,7 @@ dt.nanosecond;  // => 500
 dt = Temporal.PlainDate.from('2019-02-23T03:24:30.000003500[u-ca-hebrew]');
 dt.year;        // => 5779
 dt.month;       // => 6
-dt.monthCode;   // => "M5L"
+dt.monthCode;   // => "M05L"
 dt.day;         // => 18
 dt.hour;        // => 3
 dt.minute;      // => 24

docs/plainmonthday.md

@@ -95,7 +95,7 @@ md = Temporal.PlainMonthDay.from('2006-08-24T15:43:27+01:00[Europe/Brussels]');
 // => 08-24
 md === Temporal.PlainMonthDay.from(md); // => true
 
-md = Temporal.PlainMonthDay.from({ monthCode: 'M8', day: 24 }); // => 08-24
+md = Temporal.PlainMonthDay.from({ monthCode: 'M08', day: 24 }); // => 08-24
 md = Temporal.PlainMonthDay.from(Temporal.PlainDate.from('2006-08-24'));
 // => same as above; Temporal.PlainDate has month and day properties
 
@@ -112,14 +112,14 @@ md = Temporal.PlainMonthDay.from({ month: 2, day: 29, year: 2001 }, { overflow:
 // throws (this year is not a leap year in the ISO calendar)
 
 // non-ISO calendars
-md = Temporal.PlainMonthDay.from({ monthCode: 'M5L', day: 15, calendar: 'hebrew' });
+md = Temporal.PlainMonthDay.from({ monthCode: 'M05L', day: 15, calendar: 'hebrew' });
 // => 2019-02-20[u-ca-hebrew]
 md = Temporal.PlainMonthDay.from({ month: 6, day: 15, year: 5779, calendar: 'hebrew' });
 // => 2019-02-20[u-ca-hebrew]
 md = Temporal.PlainMonthDay.from({ month: 6, day: 15, calendar: 'hebrew' });
 // => throws (either year or monthCode is required)
 md = Temporal.PlainMonthDay.from('2019-02-20[u-ca-hebrew]');
-md.monthCode; // => "M5L"
+md.monthCode; // => "M05L"
 md.day; // => 15
 md.month; // undefined (month property is not present in this type; use monthCode instead)
 ```
@@ -133,9 +133,9 @@ md.month; // undefined (month property is not present in this type; use monthCod
 The above read-only properties allow accessing each component of the date individually.
 
 - `monthCode` is a calendar-specific string that identifies the month in a year-independent way.
-  For common (non-leap) months, `monthCode` should be ` ` `M${month}` ` `.
+  For common (non-leap) months, `monthCode` should be ` ` `M${month}` ` `, where `month` is zero padded up to two digits.
   For uncommon (leap) months in lunisolar calendars like Hebrew or Chinese, the month code is the previous month's code with with an "L" suffix appended.
-  Examples: `'M2'` => February; `'M8L'` => repeated 8th month in the Chinese calendar; `'M5L'` => Adar I in the Hebrew calendar.
+  Examples: `'M02'` => February; `'M08L'` => repeated 8th month in the Chinese calendar; `'M05L'` => Adar I in the Hebrew calendar.
 - `day` is a positive integer representing the day of the month.
 
 Note that this type has no `month` property, because `month` is ambiguous for some calendars without knowing the year.
@@ -145,12 +145,12 @@ Usage examples:
 
 ```javascript
 md = Temporal.PlainMonthDay.from('08-24');
-md.monthCode; // => "M8"
+md.monthCode; // => "M08"
 md.day; // => 24
 md.month; // undefined (no `month` property; use `monthCode` instead)
 
 md = Temporal.PlainMonthDay.from('2019-02-20[u-ca-hebrew]');
-md.monthCode; // => "M5L"
+md.monthCode; // => "M05L"
 md.day; // => 15
 md.month; // undefined (no `month` property; use `monthCode` instead)
 ```
@@ -285,7 +285,7 @@ Example usage:
 
 ```js
 ({ calendar } = new Intl.DateTimeFormat().resolvedOptions());
-md = Temporal.PlainMonthDay.from({ monthCode: 'M8', day: 24, calendar });
+md = Temporal.PlainMonthDay.from({ monthCode: 'M08', day: 24, calendar });
 md.toLocaleString(); // => example output: 08-24
 // Same as above, but explicitly specifying the calendar:
 md.toLocaleString(undefined, { calendar });
@@ -311,7 +311,7 @@ Example usage:
 ```js
 const holiday = {
   name: 'Canada Day',
-  holidayMonthDay: Temporal.PlainMonthDay.from({ monthCode: 'M7', day: 1 })
+  holidayMonthDay: Temporal.PlainMonthDay.from({ monthCode: 'M07', day: 1 })
 };
 const str = JSON.stringify(holiday, null, 2);
 console.log(str);
@@ -364,7 +364,7 @@ Example:
 ```javascript
 md = Temporal.PlainMonthDay.from({
   calendar: 'japanese',
-  monthCode: 'M1',
+  monthCode: 'M01',
   day: 1
 });
 

docs/plainyearmonth.md

@@ -164,9 +164,9 @@ The above read-only properties allow accessing the year or month individually.
   The last month of every year has `month` equal to the `monthsInYear` property.
   `month` values start at 1, which is different from legacy `Date` where months are represented by zero-based indices (0 to 11).
 - `monthCode` is a calendar-specific string that identifies the month in a year-independent way.
-  For common (non-leap) months, `monthCode` should be `` `M${month}` ``.
+  For common (non-leap) months, `monthCode` should be `` `M${month}` ``, where `month` is zero padded up to two digits.
   For uncommon (leap) months in lunisolar calendars like Hebrew or Chinese, the month code is the previous month's code with with an "L" suffix appended.
-  Examples: `'M2'` => February; `'M8L'` => repeated 8th month in the Chinese calendar; `'M5L'` => Adar I in the Hebrew calendar.
+  Examples: `'M02'` => February; `'M08L'` => repeated 8th month in the Chinese calendar; `'M05L'` => Adar I in the Hebrew calendar.
 
 Either `month` or `monthCode` can be used in `from` or `with` to refer to the month.
 Similarly, in calendars that user eras an `era`/`eraYear` pair can be used in place of `year` when calling `from` or `with`.
@@ -177,12 +177,12 @@ Usage examples:
 ym = Temporal.PlainYearMonth.from('2019-06');
 ym.year; // => 2019
 ym.month; // => 6
-ym.monthCode; // => "M6"
+ym.monthCode; // => "M06"
 
 ym = Temporal.PlainYearMonth.from('2019-02-23[u-ca-hebrew]');
 ym.year; // => 5779
 ym.month; // => 6
-ym.monthCode; // => "M5L"
+ym.monthCode; // => "M05L"
 ym.day; // => 18
 ```
 

docs/zoneddatetime.md

@@ -301,9 +301,9 @@ Date unit details:
   The last month of every year has `month` equal to the `monthsInYear` property.
   `month` values start at 1, which is different from legacy `Date` where months are represented by zero-based indices (0 to 11).
 - `monthCode` is a calendar-specific string that identifies the month in a year-independent way.
-  For common (non-leap) months, `monthCode` should be `` `M${month}` ``.
+  For common (non-leap) months, `monthCode` should be `` `M${month}` ``, where `month` is zero padded up to two digits.
   For uncommon (leap) months in lunisolar calendars like Hebrew or Chinese, the month code is the previous month's code with with an "L" suffix appended.
-  Examples: `'M2'` => February; `'M8L'` => repeated 8th month in the Chinese calendar; `'M5L'` => Adar I in the Hebrew calendar.
+  Examples: `'M02'` => February; `'M08L'` => repeated 8th month in the Chinese calendar; `'M05L'` => Adar I in the Hebrew calendar.
 - `day` is a positive integer representing the day of the month.
 
 Either `month` or `monthCode` can be used in `from` or `with` to refer to the month.
@@ -338,7 +338,7 @@ dt.nanosecond;  // => 500
 dt = Temporal.ZonedDateTime.from('2019-02-23T03:24:30.000003500[Europe/Rome][u-ca-hebrew]');
 dt.year;        // => 5779
 dt.month;       // => 6
-dt.monthCode;   // => "M5L"
+dt.monthCode;   // => "M05L"
 dt.day;         // => 18
 dt.hour;        // => 3
 dt.minute;      // => 24