Rename Temporal.now => Temporal.Now

Author: justingrant

docs/README.md

@@ -33,25 +33,25 @@ Converting between such types and exact time types (`Temporal.Instant` and `Temp
 
 Several important concepts are explained elsewhere: [exact time, wall-clock time, time zones, DST, handling ambiguity, and more](./ambiguity.md).
 
-### **Temporal.now**
-
-- `Temporal.now.instant()` - get the exact time since [Unix epoch](https://en.wikipedia.org/wiki/Unix_time)
-- `Temporal.now.timeZone()` - get the current system time zone
-- `Temporal.now.zonedDateTime(calendar)` - get the current date and wall-clock time in the system time zone and specified calendar
-- `Temporal.now.zonedDateTimeISO()` - get the current date and wall-clock time in the system time zone and ISO-8601 calendar
-- `Temporal.now.plainDate(calendar)` - get the current date in the system time zone and specified calendar
-- `Temporal.now.plainDateISO()` - get the current date in the system time zone and ISO-8601 calendar
-- `Temporal.now.plainTimeISO()` - get the current wall-clock time in the system time zone and ISO-8601 calendar
-- `Temporal.now.plainDateTime(calendar)` - get the current system date/time in the system time zone, but return an object that doesn't remember its time zone so should NOT be used to derive other values (e.g. 12 hours later) in time zones that use Daylight Saving Time (DST).
-- `Temporal.now.plainDateTimeISO()` - same as above, but return the DateTime in the ISO-8601 calendar
+### **Temporal.Now**
+
+- `Temporal.Now.instant()` - get the exact time since [Unix epoch](https://en.wikipedia.org/wiki/Unix_time)
+- `Temporal.Now.timeZone()` - get the current system time zone
+- `Temporal.Now.zonedDateTime(calendar)` - get the current date and wall-clock time in the system time zone and specified calendar
+- `Temporal.Now.zonedDateTimeISO()` - get the current date and wall-clock time in the system time zone and ISO-8601 calendar
+- `Temporal.Now.plainDate(calendar)` - get the current date in the system time zone and specified calendar
+- `Temporal.Now.plainDateISO()` - get the current date in the system time zone and ISO-8601 calendar
+- `Temporal.Now.plainTimeISO()` - get the current wall-clock time in the system time zone and ISO-8601 calendar
+- `Temporal.Now.plainDateTime(calendar)` - get the current system date/time in the system time zone, but return an object that doesn't remember its time zone so should NOT be used to derive other values (e.g. 12 hours later) in time zones that use Daylight Saving Time (DST).
+- `Temporal.Now.plainDateTimeISO()` - same as above, but return the DateTime in the ISO-8601 calendar
 
 ```js
-console.log('Initialization complete', Temporal.now.instant());
+console.log('Initialization complete', Temporal.Now.instant());
 // example output:
 // Initialization complete 2021-01-13T20:57:01.500944804Z
 ```
 
-See [Temporal.now Documentation](./now.md) for detailed documentation.
+See [Temporal.Now Documentation](./now.md) for detailed documentation.
 
 ### **Temporal.Instant**
 
@@ -207,8 +207,8 @@ It is also possible to implement your own time zones.
 const timeZone = Temporal.TimeZone.from('Africa/Cairo');
 timeZone.getInstantFor('2000-01-01T00:00'); // => 1999-12-31T22:00:00Z
 timeZone.getPlainDateTimeFor('2000-01-01T00:00Z'); // => 2000-01-01T02:00:00
-timeZone.getPreviousTransition(Temporal.now.instant()); // => 2014-09-25T21:00:00Z
-timeZone.getNextTransition(Temporal.now.instant()); // => null
+timeZone.getPreviousTransition(Temporal.Now.instant()); // => 2014-09-25T21:00:00Z
+timeZone.getNextTransition(Temporal.Now.instant()); // => null
 ```
 
 See [Temporal.TimeZone Documentation](./timezone.md) for detailed documentation.

docs/calendar-draft.md

@@ -299,7 +299,7 @@ Here is an illustrated version of this option:
 
 ### New Factory Methods (Option 6)
 
-With this option, separate methods would indicate whether the Full ISO calendar should be used versus a potentially non-ISO calendar. For example, `Temporal.now.plainDateISO` would be added to supplement `Temporal.now.plainDate`. See the full table below.
+With this option, separate methods would indicate whether the Full ISO calendar should be used versus a potentially non-ISO calendar. For example, `Temporal.Now.plainDateISO` would be added to supplement `Temporal.Now.plainDate`. See the full table below.
 
 ### Methods of Construction
 
@@ -312,8 +312,8 @@ The following table describes these semantics. Option 5 is not shown because the
 | T.Date.from(string)\*      | _From String_ | Explicit | Partial ISO | Environ. | _From String_ |
 | T.Date.from(fields)\*\*    | _From Object_ | Explicit | Partial ISO | Environ. | _From Object_ |
 | new T.Date()               | Full ISO      | Full ISO | Full ISO    | Full ISO | Full ISO      |
-| T.now.plainDate()          | Full ISO      | Explicit | Partial ISO | Environ. | Explicit      |
-| T.now.plainDateISO()       | N/A           | N/A      | N/A         | N/A      | Full ISO      |
+| T.Now.plainDate()          | Full ISO      | Explicit | Partial ISO | Environ. | Explicit      |
+| T.Now.plainDateISO()       | N/A           | N/A      | N/A         | N/A      | Full ISO      |
 | instant.inTimeZone()       | Full ISO      | Explicit | Partial ISO | Environ. | Explicit      |
 | instant.inZoneISO()        | N/A           | N/A      | N/A         | N/A      | Full ISO      |
 | date.getMonthDay()\*\*\*\* | Inherit       | Inherit  | Explicit    | Inherit  | Inherit       |
@@ -351,31 +351,31 @@ Code:
 
 ```javascript
 /// Options 1 and 4: calendar implicit
-const today = Temporal.now.plainDate();
+const today = Temporal.Now.plainDate();
 // OPTION 1 BUG: the ISO calendar is implicit when creating the MonthDay
 const monthDay = today.getMonthDay();
 console.log('Today is:', monthDay.toLocaleString());
 
 /// Options 2 and 6: calendar in factory method
 const calendar = navigator.locales[0].getLikelyCalendar();
-const today = Temporal.now.plainDate(calendar);
+const today = Temporal.Now.plainDate(calendar);
 const monthDay = today.getMonthDay();
 console.log('Today is:', monthDay.toLocaleString());
 
 /// Option 3 and 5: getMonthDay() requires a calendar to be given
-const today = Temporal.now.plainDate();
+const today = Temporal.Now.plainDate();
 const calendar = navigator.locales[0].getLikelyCalendar();
 const monthDay = today.withCalendar(calendar).getMonthDay();
 console.log('Today is:', monthDay.toLocaleString());
 
 /// Option 3 and 5 alternative: add argument to getMonthDay()
-const today = Temporal.now.plainDate();
+const today = Temporal.Now.plainDate();
 const calendar = navigator.locales[0].getLikelyCalendar();
 const monthDay = today.getMonthDay(calendar);
 console.log('Today is:', monthDay.toLocaleString());
 
 /// Alternative using Intl settings
-const today = Temporal.now.plainDate();
+const today = Temporal.Now.plainDate();
 console.log(
   'Today is:',
   today.toLocaleString(undefined, {
@@ -401,7 +401,7 @@ Code:
 
 ```javascript
 /// Options 1 and 4: calendar implicit
-const today = Temporal.now.plainDate();
+const today = Temporal.Now.plainDate();
 console.log('Today is:', today.toLocaleString());
 // OPTION 1 BUG:
 // Arithmetic in months must take place in the user calendar
@@ -410,13 +410,13 @@ console.log('Next month is: ', nextMonth.toLocaleString());
 
 /// Options 2 and 6: calendar in factory method
 const calendar = navigator.locales[0].getLikelyCalendar();
-const today = Temporal.now.plainDate(calendar);
+const today = Temporal.Now.plainDate(calendar);
 console.log('Today is:', today.toLocaleString());
 const nextMonth = today.add({ months: 1 });
 console.log('Next month is: ', nextMonth.toLocaleString());
 
 /// Options 3 and 5: calendar only when needed
-const today = Temporal.now.plainDate();
+const today = Temporal.Now.plainDate();
 console.log('Today is:', today.toLocaleString());
 const calendar = navigator.locales[0].getLikelyCalendar();
 const nextMonth = today.withCalendar(calendar).add({ months: 1 });
@@ -439,7 +439,7 @@ Code:
 
 ```javascript
 /// Options 1 and 4: calendar implicit
-const date = Temporal.now.plainDate();
+const date = Temporal.Now.plainDate();
 console.log('Today is:', date.toLocaleString());
 // OPTION 1 BUG:
 // The MonthDay needs to be represented in the user calendar; otherwise,
@@ -449,13 +449,13 @@ console.log(`Is ${monthDay.toLocaleString()} your birthday?`);
 
 /// Options 2 and 6: calendar in factory method
 const calendar = navigator.locales[0].getLikelyCalendar();
-const date = Temporal.now.plainDate(calendar);
+const date = Temporal.Now.plainDate(calendar);
 console.log('Today is:', date.toLocaleString());
 const monthDay = date.getMonthDay();
 console.log(`Is ${monthDay.toLocaleString()} your birthday?`);
 
 /// Options 3 and 5: calendar only when needed
-const date = Temporal.now.plainDate();
+const date = Temporal.Now.plainDate();
 console.log('Today is:', date.toLocaleString());
 const calendar = navigator.locales[0].getLikelyCalendar();
 const monthDay = date.withCalendar(calendar).getMonthDay();
@@ -478,7 +478,7 @@ Code:
 
 ```javascript
 /// Options 1 and 4: calendar implicit
-const date = Temporal.now.plainDate();
+const date = Temporal.Now.plainDate();
 // OPTION 1 BUG:
 // The YearMonth needs to be represented in the user calendar
 const yearMonth = date.getYearMonth();
@@ -487,13 +487,13 @@ console.log('Number of days this month:', yearMonth.daysInMonth);
 
 /// Options 2 and 6: calendar in factory method
 const calendar = navigator.locales[0].getLikelyCalendar();
-const date = Temporal.now.plainDate(calendar);
+const date = Temporal.Now.plainDate(calendar);
 const yearMonth = date.getYearMonth();
 console.log('Today is:', date.toLocaleString());
 console.log('Number of days this month:', yearMonth.daysInMonth);
 
 /// Options 3 and 5: calendar only when needed
-const date = Temporal.now.plainDate();
+const date = Temporal.Now.plainDate();
 const calendar = navigator.locales[0].getLikelyCalendar();
 const yearMonth = date.withCalendar(calendar).getYearMonth();
 console.log('Today is:', date.toLocaleString());
@@ -650,16 +650,16 @@ Temporal.Instant.prototype.inTimeZone = function(timeZone, calendar) {
 }
 ```
 
-### Temporal.now
+### Temporal.Now
 
 The fourth way to get a Temporal.PlainDate is to get the current time according to the environment (or mocked for SES).
 
 As above, this API depends on whether we decide to use a default calendar. If we require an explicit calendar, it would be similar to above:
 
 ```javascript
-Temporal.now.plainDate = function (calendar) {
-  const instant = Temporal.now.instant(); // use intrinsic
-  const timeZone = Temporal.now.timeZone(); // use intrinsic
+Temporal.Now.plainDate = function (calendar) {
+  const instant = Temporal.Now.instant(); // use intrinsic
+  const timeZone = Temporal.Now.timeZone(); // use intrinsic
   return instant.inTimeZone(timeZone, calendar); // use intrinsic
 };
 ```

docs/calendar-review.md

@@ -192,7 +192,7 @@ For example:
   Userland code can completely avoid the use of calendar-specific constants (e.g. 12 months per year) by using these properties.
 - There is never an implicit default calendar system.
   Developers must explicitly decide whether they're using the ISO calendar or another calendar.
-  For example, shortcut methods on the `Temporal.now` object are named with an ISO prefix to avoid ambiguity, such as `Temporal.now.zonedDateTimeISO()`.
+  For example, shortcut methods on the `Temporal.Now` object are named with an ISO prefix to avoid ambiguity, such as `Temporal.Now.zonedDateTimeISO()`.
 - Temporal never infers a calendar from the user's environment.
   Introducing a calendar system into a program requires a conscious, opt-in decision on the part of the developer of the app, library, or input source.
 
@@ -305,11 +305,11 @@ In the end, the champions decided that the subclassing approach brought a high c
 
 ### Alternative 4: Separate Types for Calendared Dates
 
-This approach would mean introducing a new type that carries a date without a calendar system, to supplement the type with the calendar system.  Most documentation would recommend the calendar-agnostic type except when calendar-aware logic is necessary.  We discuss this approach in more detail as [Option 5 in calendar-draft.md](https://github.com/tc39/proposal-temporal/blob/main/docs/calendar-draft.md#new-non-calendar-types-option-5).
+This approach would mean introducing a new type that carries a date without a calendar system, to supplement the type with the calendar system. Most documentation would recommend the calendar-agnostic type except when calendar-aware logic is necessary. We discuss this approach in more detail as [Option 5 in calendar-draft.md](https://github.com/tc39/proposal-temporal/blob/main/docs/calendar-draft.md#new-non-calendar-types-option-5).
 
 We decided against the dual classes approach because:
 
 1. If the new type were truly calendar-agnostic, it could not support month and year arithmetic, because doing so would introduce an ISO bias.
 2. If the new type had ISO-like behavior for months and years, then it is no different from PlainDate with an ISO calendar.
 
-Note that (2) is true for ECMAScript because it is dynamically typed.  Statically typed languages could enforce compile-time type checking for (2) that is not possible in ECMAScript.  Note also that clients such as TypeScript can treat PlainDate as having a type parameter corresponding to the calendar system in order to enforce more compile-time type checking of calendar systems.  Separate data types are not necessary for that validation.
+Note that (2) is true for ECMAScript because it is dynamically typed. Statically typed languages could enforce compile-time type checking for (2) that is not possible in ECMAScript. Note also that clients such as TypeScript can treat PlainDate as having a type parameter corresponding to the calendar system in order to enforce more compile-time type checking of calendar systems. Separate data types are not necessary for that validation.

docs/cookbook.md

@@ -224,7 +224,7 @@ The graph always starts at midnight in the tank's location, but the graph labels
 <script type="text/javascript">
 {
 // Generate fictitious "data"
-const start = Temporal.now.instant().subtract({ hours: 24 });
+const start = Temporal.Now.instant().subtract({ hours: 24 });
 const blank = Array(24 * 12);
 const tankDataX = Array.from(blank, (_, ix) => start.add({ minutes: ix * 5 }));
 const tankDataY = Array.from(blank);
@@ -329,7 +329,7 @@ An example HTML form inspired by [Days Calculator](https://www.timeanddate.com/d
   // the example; see 'Calendar input element'
   const futureDatePicker = document.querySelector('input[name="futuredate"]');
   const browserCalendar = new Intl.DateTimeFormat().resolvedOptions().calendar;
-  const today = Temporal.now.plainDate(browserCalendar);
+  const today = Temporal.Now.plainDate(browserCalendar);
   futureDatePicker.min = today;
   futureDatePicker.value = today.add({ months: 1 });
 

docs/cookbook/calendarInput.js

@@ -1,4 +1,4 @@
 const datePicker = document.getElementById('calendar-input');
-const today = Temporal.now.plainDateISO();
+const today = Temporal.Now.plainDateISO();
 datePicker.max = today;
 datePicker.value = today;

docs/cookbook/futureDateForm.js

@@ -14,7 +14,7 @@ function englishPlural(n, singular, plural) {
 if (futuredateParam !== null) {
   const browserCalendar = new Intl.DateTimeFormat().resolvedOptions().calendar;
   const futureDate = Temporal.PlainDate.from(futuredateParam).withCalendar(browserCalendar);
-  const today = Temporal.now.plainDate(browserCalendar);
+  const today = Temporal.Now.plainDate(browserCalendar);
   const until = today.until(futureDate, { largestUnit: 'day' });
   const untilMonths = until.round({ largestUnit: 'month', relativeTo: today });
 

docs/cookbook/getCurrentDate.mjs

@@ -5,8 +5,8 @@
  *
  */
 
-const date = Temporal.now.plainDateISO(); // Gets the current date
+const date = Temporal.Now.plainDateISO(); // Gets the current date
 date.toString(); // returns the date in ISO 8601 date format
 
 // If you additionally want the time:
-Temporal.now.plainDateTimeISO().toString(); // date and time in ISO 8601 format
+Temporal.Now.plainDateTimeISO().toString(); // date and time in ISO 8601 format

docs/cookbook/getElapsedDurationSinceInstant.mjs

@@ -10,7 +10,7 @@ assert.equal(`${result2}`, 'PT240M');
 
 // Example of using it in a countdown:
 
-const duration = Temporal.now.instant().until(Temporal.Instant.from('2020-04-01T13:00-07:00[America/Los_Angeles]'));
+const duration = Temporal.Now.instant().until(Temporal.Instant.from('2020-04-01T13:00-07:00[America/Los_Angeles]'));
 // Note that this does not work unless you have Intl.DurationFormat, which is
 // still an early-stage proposal.
 `It's ${duration.toLocaleString()} ${duration.sign < 0 ? 'until' : 'since'} the TC39 Temporal presentation`;

docs/cookbook/getTimeStamp.mjs

@@ -5,7 +5,7 @@
  *
  */
 
-const timeStamp = Temporal.now.instant();
+const timeStamp = Temporal.Now.instant();
 
 // Timestamp in Milliseconds
 timeStamp.epochMilliseconds;

docs/cookbook/meetingPlanner.js

@@ -1,6 +1,6 @@
 // Display local time zone and three others
 const browserCalendar = new Intl.DateTimeFormat().resolvedOptions().calendar;
-const now = Temporal.now.zonedDateTime(browserCalendar);
+const now = Temporal.Now.zonedDateTime(browserCalendar);
 const timeZones = [
   { name: 'Here', tz: now.timeZone },
   { name: 'New York', tz: Temporal.TimeZone.from('America/New_York') },