Add "named" to available time zone text

This commit adds "named" to text and AOs dealing with available time
identifiers. The purpose of this change is to clarify that offset time
zones are not included in available time zone IDs.

Author: justingrant

spec/intl.html

@@ -55,8 +55,8 @@ <h1>Time Zone Identifiers</h1>
         <p>
           The ECMAScript Internationalization API Specification identifies time zones using the Zone and Link names of the IANA Time Zone Database <a href="https://www.iana.org/time-zones/">https://www.iana.org/time-zones/</a>.
           Time zone identifiers are case-insensitive and so are compared using ASCII case-insensitive comparisons, but time zone identifiers returned by ECMAScript built-in objects always use the casing found in the IANA Time Zone Database.
-          A primary time zone identifier is a Zone name, and a non-primary time zone identifier is a Link name, respectively, in the IANA Time Zone Database except as specifically overridden by AvailableTimeZoneIdentifiers.
-          In an implementation that implements the ECMAScript Internationalization API Specification, available time zone identifiers are the set of Zone and Link identifiers that are supported by an ECMAScript implementation.
+          A primary time zone identifier is a Zone name, and a non-primary time zone identifier is a Link name, respectively, in the IANA Time Zone Database except as specifically overridden by AvailableNamedTimeZoneIdentifiers.
+          In an implementation that implements the ECMAScript Internationalization API Specification, available named time zone identifiers are the set of Zone and Link identifiers that are supported by an ECMAScript implementation.
         </p>
 
         <p>
@@ -78,7 +78,7 @@ <h1>Time Zone Identifiers</h1>
 
         <p>
           New Zone identifiers can be added to the IANA Time Zone Database, for example when one part of a country starts observing Daylight Saving Time differently from other parts, or when a new country declares independence.
-          ECMAScript implementations are recommended to include newly-added identifiers as soon as possible into the results of AvailableTimeZoneIdentifiers.
+          ECMAScript implementations are recommended to include newly-added identifiers as soon as possible into the results of AvailableNamedTimeZoneIdentifiers.
           Such prompt action ensures that ECMAScript programs receiving those identifiers from an external source (including the host's operating system) will be able to recognize and calculate using the new time zone.
         </p>
 
@@ -151,12 +151,12 @@ <h1>
     </del>
 
     <ins class="block">
-      <emu-clause id="sup-availabletimezoneidentifiers" oldids="sec-availabletimezones" type="implementation-defined abstract operation">
-        <h1>AvailableTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records</h1>
+      <emu-clause id="sup-availablenamedtimezoneidentifiers" oldids="sec-availabletimezones" type="implementation-defined abstract operation">
+        <h1>AvailableNamedTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records</h1>
         <dl class="header">
           <dt>description</dt>
           <dd>
-            Its result describes all available time zone identifiers in this implementation, as well as the primary time zone identifier corresponding to each available identifier.
+            Its result describes all available named time zone identifiers in this implementation, as well as the primary time zone identifier corresponding to each available named time zone identifier.
             The List is sorted by [[Identifier]] of each Time Zone Identifier Record.
           </dd>
           <dt>redefinition</dt>
@@ -182,11 +182,11 @@ <h1>AvailableTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records</h1
 
         <emu-note>
           Time zone identifiers in the IANA Time Zone Database can change over time.
-          At a minimum, it is recommended that implementations limit changes to the result of AvailableTimeZoneIdentifiers to the changes allowed by GetAvailableTimeZoneIdentifier, for the lifetime of the surrounding agent.
-          Due to the complexity of supporting these recommendations, it is recommended that the result of AvailableTimeZoneIdentifiers remains the same for the lifetime of the surrounding agent.
+          At a minimum, it is recommended that implementations limit changes to the result of AvailableNamedTimeZoneIdentifiers to the changes allowed by GetAvailableNamedTimeZoneIdentifier, for the lifetime of the surrounding agent.
+          Due to the complexity of supporting these recommendations, it is recommended that the result of AvailableNamedTimeZoneIdentifiers remains the same for the lifetime of the surrounding agent.
         </emu-note>
 
-        <p>This definition supersedes the definition provided in <emu-xref href="#sec-availabletimezoneidentifiers"></emu-xref>.</p>
+        <p>This definition supersedes the definition provided in <emu-xref href="#sec-availablenamedtimezoneidentifiers"></emu-xref>.</p>
       </emu-clause>
     </ins>
   </emu-clause>
@@ -316,7 +316,7 @@ <h1>InitializeDateTimeFormat ( _dateTimeFormat_, _locales_, _options_ [ , <ins>_
         1. Else,
           1. <ins>If _toLocaleStringTimeZone_ is present, throw a *TypeError* exception.</ins>
           1. Set _timeZone_ to ? ToString(_timeZone_).
-          1. <ins>Let _timeZoneIdentifierRecord_ be GetAvailableTimeZoneIdentifier(_timeZone_).</ins>
+          1. <ins>Let _timeZoneIdentifierRecord_ be GetAvailableNamedTimeZoneIdentifier(_timeZone_).</ins>
           1. If <del>the result of IsValidTimeZoneName(_timeZone_) is *false*</del><ins>_timeZoneIdentifierRecord_ is ~empty~</ins>, then
             1. Throw a *RangeError* exception.
           1. Set _timeZone_ to <del>CanonicalizeTimeZoneName(_timeZone_)</del><ins>_timeZoneIdentifierRecord_.[[PrimaryIdentifier]]</ins>.
@@ -2538,7 +2538,7 @@ <h1>Temporal.ZonedDateTime.prototype.toLocaleString ( [ _locales_ [ , _options_
             1. Let _dateTimeFormat_ be ! OrdinaryCreateFromConstructor(%DateTimeFormat%, %DateTimeFormat.protoytpe%, « [[InitializedDateTimeFormat]], [[Locale]], [[Calendar]], [[NumberingSystem]], [[TimeZone]], [[Weekday]], [[Era]], [[Year]], [[Month]], [[Day]], [[DayPeriod]], [[Hour]], [[Minute]], [[Second]], [[FractionalSecondDigits]], [[TimeZoneName]], [[HourCycle]], [[Pattern]], [[BoundFormat]] »).
             1. Let _timeZone_ be ? ToTemporalTimeZoneIdentifier(_zonedDateTime_.[[TimeZone]]).
             1. If IsTimeZoneOffsetString(_timeZone_) is *true*, throw a *RangeError* exception.
-            1. Let _timeZoneIdentifierRecord_ be GetAvailableTimeZoneIdentifier(_timeZone_).
+            1. Let _timeZoneIdentifierRecord_ be GetAvailableNamedTimeZoneIdentifier(_timeZone_).
             1. If _timeZoneIdentifierRecord_ is ~empty~, throw a RangeError exception.
             1. Set _timeZone_ to _timeZoneIdentifierRecord_.[[PrimaryIdentifier]].
             1. Perform ? InitializeDateTimeFormat(_dateTimeFormat_, _locales_, _options_, _timeZone_).

spec/timezone.html

@@ -14,20 +14,20 @@ <h1>Time Zone Identifiers</h1>
       <p>
         Time zones in ECMAScript are described using <dfn variants="time zone identifier">time zone identifiers</dfn>, which must be Strings composed entirely of characters from the Unicode Basic Latin block.
         Time zone identifiers are case-insensitive and so are compared using ASCII case-insensitive comparisons.
-        Built-in time zones may be <dfn variants="named time zone">named time zones</dfn>, represented by Strings for which GetAvailableTimeZoneIdentifier does not return ~empty~.
-        They may also be <dfn variants="offset time zone">offset time zones</dfn>, represented by Strings for which IsTimeZoneOffsetString returns *true*.
+        Built-in time zones may be <dfn variants="named time zone">named time zones</dfn>, identified by Strings for which GetAvailableNamedTimeZoneIdentifier does not return ~empty~.
+        They may also be <dfn variants="offset time zone">offset time zones</dfn>, identified by Strings for which IsTimeZoneOffsetString returns *true*.
       </p>
       <p>
-        <emu-xref href="#sec-temporal-timezone-constructor">The `Temporal.TimeZone` constructor</emu-xref>, when called with the name of a built-in time zone as the argument, will return a valid `Temporal.TimeZone` object.
+        <emu-xref href="#sec-temporal-timezone-constructor">The `Temporal.TimeZone` constructor</emu-xref>, when called with the identifier of a built-in time zone as the argument, will return a valid `Temporal.TimeZone` object.
         When called with any other string, it will throw a *RangeError* exception.
       </p>
       <p>
         A <dfn variants="primary time zone identifiers">primary time zone identifier</dfn> represents the preferred identifier of a named time zone, while a <dfn variants="non-primary time zone identifiers">non-primary time zone identifier</dfn> is an alternate identifier for the same named time zone.
-        The set of built-in, named time zone identifiers (both primary and non-primary) that are supported by an ECMAScript implementation are called available time zone identifiers.
+        The set of built-in, named time zone identifiers (both primary and non-primary) that are supported by an ECMAScript implementation are called <dfn variants="available named time zone identifier">available named time zone identifiers</dfn>.
       </p>
       <p>
         At a minimum, ECMAScript implementations must support a built-in time zone with the identifier *"UTC"*, which must be primary.
-        If the return value _tz_ of SystemTimeZoneIdentifier is different from *"UTC"*, and IsTimeZoneOffsetString(_tz_) is *false*, then implementations must also support _tz_ as a built-in time zone identifier, and it must be primary as well.
+        If the return value _tz_ of SystemTimeZoneIdentifier is different from *"UTC"*, and IsTimeZoneOffsetString(_tz_) is *false*, then implementations must also support _tz_ as an available named time zone identifier, and it must be primary as well.
         In addition, implementations may support any number of other built-in time zones.
       </p>
       <p>
@@ -41,7 +41,7 @@ <h1>Time Zone Identifiers</h1>
 
     <emu-clause id="sec-time-zone-identifier-record">
       <h1>Time Zone Identifier Record</h1>
-      <p>A <dfn variants="Time Zone Identifier Records">Time Zone Identifier Record</dfn> is a Record used to describe an available time zone identifier, as well as the primary time zone identifier corresponding to it.</p>
+      <p>A <dfn variants="Time Zone Identifier Records">Time Zone Identifier Record</dfn> is a Record used to describe an available named time zone identifier, as well as the primary time zone identifier corresponding to it.</p>
       <p>Time Zone Identifier Records have the fields listed in <emu-xref href="#table-time-zone-identifier-record-fields"></emu-xref>.</p>
       <emu-table id="table-time-zone-identifier-record-fields" caption="Time Zone Identifier Record Fields">
         <table>
@@ -53,7 +53,7 @@ <h1>Time Zone Identifier Record</h1>
           <tr>
             <td>[[Identifier]]</td>
             <td>a String</td>
-            <td>An available time zone identifier that is supported by the implementation.</td>
+            <td>An available named time zone identifier that is supported by the implementation.</td>
           </tr>
           <tr>
             <td>[[PrimaryIdentifier]]</td>
@@ -70,17 +70,17 @@ <h1>Time Zone Identifier Record</h1>
       </emu-note>
     </emu-clause>
 
-    <emu-clause id="sec-availabletimezoneidentifiers" type="implementation-defined abstract operation">
-      <h1>AvailableTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records</h1>
+    <emu-clause id="sec-availablenamedtimezoneidentifiers" type="implementation-defined abstract operation">
+      <h1>AvailableNamedTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records</h1>
       <dl class="header">
         <dt>description</dt>
         <dd>
-          Its result describes all available time zone identifiers in this implementation, as well as the primary time zone identifier corresponding to each available identifier.
+          Its result describes all available named time zone identifiers in this implementation, as well as the primary time zone identifier corresponding to each available named time zone identifier.
           The List is sorted by [[Identifier]] of each Time Zone Identifier Record.
         </dd>
       </dl>
       <p>
-        Time zone aware implementations, including all implementations that implement the ECMA-402 Internationalization API, must implement the AvailableTimeZoneIdentifiers abstract operation as specified in the ECMA-402 specification.
+        Time zone aware implementations, including all implementations that implement the ECMA-402 Internationalization API, must implement the AvailableNamedTimeZoneIdentifiers abstract operation as specified in the ECMA-402 specification.
         For implementations that are not time zone aware, the following specification is used.
       </p>
       <emu-alg>
@@ -104,27 +104,27 @@ <h1>AvailableTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records</h1
 
     <emu-clause id="sec-getavailabletimezoneidentifier" type="abstract operation">
       <h1>
-        GetAvailableTimeZoneIdentifier (
+        GetAvailableNamedTimeZoneIdentifier (
           _timeZoneIdentifier_: a String,
         ): either a Time Zone Identifier Record or ~empty~
       </h1>
 
       <dl class="header">
         <dt>description</dt>
         <dd>
-          If _timeZoneIdentifier_ is a time zone identifier that is supported by the implementation, then it returns one of the records in the List returned by AvailableTimeZoneIdentifiers.
+          If _timeZoneIdentifier_ is a named time zone identifier that is supported by the implementation, then it returns one of the records in the List returned by AvailableNamedTimeZoneIdentifiers.
           Otherwise, ~empty~ will be returned.
         </dd>
       </dl>
       <emu-alg>
-        1. For each element _record_ of AvailableTimeZoneIdentifiers(), do
+        1. For each element _record_ of AvailableNamedTimeZoneIdentifiers(), do
           1. If _record_.[[Identifier]] is an ASCII-case-insensitive match for _timeZoneIdentifier_, return _record_.
         1. Return ~empty~.
       </emu-alg>
       <emu-note>
         Given the same value of _timeZoneIdentifier_ or any value that is an ASCII-case-insensitive match for it, it is recommended that the resulting Time Zone Identifier Record contain the same property values for the lifetime of the surrounding agent.
-        Furthermore, it is recommended that time zone identifiers do not dynamically change from primary to non-primary, meaning that if _timeZoneIdentifier_ is a case-insensitive match for the [[PrimaryIdentifier]] property of the result of a previous call to GetAvailableTimeZoneIdentifier, then GetAvailableTimeZoneIdentifier(_timeZoneIdentifier_) will return a record where [[Identifier]] is [[PrimaryIdentifier]].
-        Due to the complexity of supporting these recommendations, it is recommended that the result of AvailableTimeZoneIdentifiers (and therefore GetAvailableTimeZoneIdentifier) remains the same for the lifetime of the surrounding agent.
+        Furthermore, it is recommended that time zone identifiers do not dynamically change from primary to non-primary, meaning that if _timeZoneIdentifier_ is a case-insensitive match for the [[PrimaryIdentifier]] property of the result of a previous call to GetAvailableNamedTimeZoneIdentifier, then GetAvailableNamedTimeZoneIdentifier(_timeZoneIdentifier_) will return a record where [[Identifier]] is [[PrimaryIdentifier]].
+        Due to the complexity of supporting these recommendations, it is recommended that the result of AvailableNamedTimeZoneIdentifiers (and therefore GetAvailableNamedTimeZoneIdentifier) remains the same for the lifetime of the surrounding agent.
       </emu-note>
     </emu-clause>
 
@@ -139,9 +139,9 @@ <h1>SystemTimeZoneIdentifier ( ): a String</h1>
 
       <emu-alg>
         1. If the implementation only supports the UTC time zone, return *"UTC"*.
-        1. Let _systemTimeZoneString_ be the String representing the environment's current time zone, either a time zone identifier or a UTC offset string.
+        1. Let _systemTimeZoneString_ be the String representing the environment's current time zone, either a named time zone identifier or a UTC offset string.
         1. If IsTimeZoneOffsetString(_systemTimeZoneString_) is *true*, return _systemTimeZoneString_.
-        1. Assert: _systemTimeZoneString_ is equal to the [[PrimaryIdentifier]] property of at least one Time Zone Identifier Record returned by AvailableTimeZoneIdentifiers().
+        1. Assert: _systemTimeZoneString_ is equal to the [[PrimaryIdentifier]] property of at least one Time Zone Identifier Record returned by AvailableNamedTimeZoneIdentifiers().
         1. Return _systemTimeZoneString_.
       </emu-alg>
 
@@ -183,7 +183,7 @@ <h1>Temporal.TimeZone ( _identifier_ )</h1>
           1. Throw a *TypeError* exception.
         1. Set _identifier_ to ? ToString(_identifier_).
         1. If IsTimeZoneOffsetString(_identifier_) is *false*, then
-          1. Let _timeZoneIdentifierRecord_ be GetAvailableTimeZoneIdentifier(_identifier_).
+          1. Let _timeZoneIdentifierRecord_ be GetAvailableNamedTimeZoneIdentifier(_identifier_).
           1. If _timeZoneIdentifierRecord_ is ~empty~, throw a *RangeError* exception.
           1. Set _identifier_ to _timeZoneIdentifierRecord_.[[PrimaryIdentifier]].
         1. Return ? CreateTemporalTimeZone(_identifier_, NewTarget).
@@ -457,7 +457,7 @@ <h1>
           1. Set _object_.[[Identifier]] to ! FormatTimeZoneOffsetString(_offsetNanosecondsResult_).
           1. Set _object_.[[OffsetNanoseconds]] to _offsetNanosecondsResult_.
         1. Else,
-          1. Assert: GetAvailableTimeZoneIdentifier(_identifier_).[[PrimaryIdentifier]] is _identifier_.
+          1. Assert: GetAvailableNamedTimeZoneIdentifier(_identifier_).[[PrimaryIdentifier]] is _identifier_.
           1. Set _object_.[[Identifier]] to _identifier_.
           1. Set _object_.[[OffsetNanoseconds]] to *undefined*.
         1. Return _object_.
@@ -648,7 +648,7 @@ <h1>
           1. If IsTimeZoneOffsetString(_name_) is *true*, then
             1. Let _offsetNanoseconds_ be ParseTimeZoneOffsetString(_name_).
             1. Return ! FormatTimeZoneOffsetString(_offsetNanoseconds_).
-          1. Let _timeZoneIdentifierRecord_ be GetAvailableTimeZoneIdentifier(_name_).
+          1. Let _timeZoneIdentifierRecord_ be GetAvailableNamedTimeZoneIdentifier(_name_).
           1. If _timeZoneIdentifierRecord_ is ~empty~, throw a *RangeError* exception.
           1. Return _timeZoneIdentifierRecord_.[[PrimaryIdentifier]].
         1. If _parseResult_.[[Z]] is *true*, return *"UTC"*.
@@ -669,7 +669,7 @@ <h1>
       </dl>
       <emu-alg>
         1. If _timeZoneSlotValue_ is a String, then
-          1. Assert: Either IsTimeZoneOffsetString(_timeZoneSlotValue_) is *true*, or GetAvailableTimeZoneIdentifier(_timeZoneSlotValue_) is not ~empty~.
+          1. Assert: Either IsTimeZoneOffsetString(_timeZoneSlotValue_) is *true*, or GetAvailableNamedTimeZoneIdentifier(_timeZoneSlotValue_) is not ~empty~.
           1. Return _timeZoneSlotValue_.
         1. Let _identifier_ be ? Get(_timeZoneSlotValue_, *"id"*).
         1. If _identifier_ is not a String, throw a *TypeError* exception.