diff --git a/spec/annexes.html b/spec/annexes.html index 4e18e1eb..4aab6077 100644 --- a/spec/annexes.html +++ b/spec/annexes.html @@ -70,10 +70,10 @@

Implementation Dependent Behaviour

Localized weekday names, era names, month names, day period names, am/pm indicators, and time zone names ()
  • - The calendric calculations used for calendars other than *"gregory"*, and adjustments for local time zones and daylight saving time () + The calendric calculations used for calendars other than *"gregory"* ()
  • - The set of all known registered Zone and Link names of the IANA Time Zone Database and the information about their offsets from UTC and their daylight saving time rules () + The set of all known registered Zone and Link names of the IANA Time Zone Database and the information about their offsets from UTC and their daylight saving time rules ()
    • diff --git a/spec/datetimeformat.html b/spec/datetimeformat.html index 73e35b1a..b41a7588 100644 --- a/spec/datetimeformat.html +++ b/spec/datetimeformat.html @@ -107,10 +107,10 @@

    1. Let _offsetMinutes_ be _offsetNanoseconds_ / (6 × 1010). 1. Assert: _offsetMinutes_ is an integer. 1. Set _timeZone_ to FormatOffsetTimeZoneIdentifier(_offsetMinutes_). - 1. Else if IsValidTimeZoneName(_timeZone_) is *true*, then - 1. Set _timeZone_ to CanonicalizeTimeZoneName(_timeZone_). 1. Else, - 1. Throw a *RangeError* exception. + 1. Let _timeZoneIdentifierRecord_ be GetAvailableNamedTimeZoneIdentifier(_timeZone_). + 1. If _timeZoneIdentifierRecord_ is ~empty~, throw a *RangeError* exception. + 1. Set _timeZone_ to _timeZoneIdentifierRecord_.[[PrimaryIdentifier]]. 1. Set _dateTimeFormat_.[[TimeZone]] to _timeZone_. 1. Let _formatOptions_ be a new Record. 1. Set _formatOptions_.[[hourCycle]] to _hc_. @@ -1266,7 +1266,7 @@

    1. If IsTimeZoneOffsetString(_timeZoneIdentifier_) is *true*, then 1. Let _offsetNs_ be ParseTimeZoneOffsetString(_timeZoneIdentifier_). 1. Else, - 1. Assert: IsValidTimeZoneName(_timeZoneIdentifier_) is *true*. + 1. Assert: GetAvailableNamedTimeZoneIdentifier(_timeZoneIdentifier_) is not ~empty~. 1. Let _offsetNs_ be GetNamedTimeZoneOffsetNanoseconds(_timeZoneIdentifier_, _epochNs_). 1. Let _tz_ be ℝ(_epochNs_) + _offsetNs_. 1. If _calendar_ is *"gregory"*, then @@ -1274,10 +1274,6 @@

    1. Else, 1. Return a ToLocalTime Record with the fields calculated from _tz_ for the given _calendar_. The calculations should use best available information about the specified _calendar_. - - - A conforming implementation must recognize *"UTC"* and all Zone and Link names from the IANA Time Zone Database (and only such names), and use best available current and historical information about their offsets from UTC and their daylight saving time rules in calculations. - diff --git a/spec/intl.html b/spec/intl.html index 8a612be9..81405e6e 100644 --- a/spec/intl.html +++ b/spec/intl.html @@ -136,7 +136,7 @@

    Intl.supportedValuesOf ( _key_ )

    1. Else if _key_ is *"numberingSystem"*, then 1. Let _list_ be AvailableCanonicalNumberingSystems( ). 1. Else if _key_ is *"timeZone"*, then - 1. Let _list_ be AvailableCanonicalTimeZones( ). + 1. Let _list_ be AvailablePrimaryTimeZoneIdentifiers( ). 1. Else if _key_ is *"unit"*, then 1. Let _list_ be AvailableCanonicalUnits( ). 1. Else, diff --git a/spec/locales-currencies-tz.html b/spec/locales-currencies-tz.html index 03d30e16..e011077d 100644 --- a/spec/locales-currencies-tz.html +++ b/spec/locales-currencies-tz.html @@ -164,59 +164,111 @@

    - -

    Time Zone Names

    + +

    Use of the IANA Time Zone Database

    - This specification identifies time zones using the Zone and Link names of the IANA Time Zone Database. Their canonical form is the corresponding Zone name in the casing used in the IANA Time Zone Database except as specifically overridden by CanonicalizeTimeZoneName. + Implementations that adopt this specification must be time zone aware: they must use the IANA Time Zone Database https://www.iana.org/time-zones/ to supply time zone identifiers and data used in ECMAScript calculations and formatting. + This section defines how the IANA Time Zone Database should be used by time zone aware implementations. +

    +

    + Except as overridden by AvailableNamedTimeZoneIdentifiers, each Zone in the IANA Time Zone Database must be a primary time zone identifier and each Link name in the IANA Time Zone Database must be a non-primary time zone identifier. + No String may be an available named time zone identifier unless it is a Zone name or a Link name in the IANA Time Zone Database. + Available named time zone identifiers returned by ECMAScript built-in objects must use the casing found in the IANA Time Zone Database. +

    +

    + In the IANA Time Zone Database, the UTC time zone is represented by the Zone *"Etc/UTC"* which is distinct from the Zone *"Etc/GMT"*. + For historical reasons, ECMAScript uses *"UTC"* as the primary identifier for the former Zone and does not recognize the latter Zone as distinct, instead requiring *"Etc/UTC"*, *"Etc/GMT"*, and *"GMT"* (if available) to be non-primary identifiers that resolve to *"UTC"*. + This is the only deviation from the IANA Time Zone Database that is required of a time zone aware ECMAScript implementation. +

    +

    + The IANA Time Zone Database is typically updated between five and ten times per year. + These updates may add new Zone or Link names, may change Zones to Links, and may change the UTC offsets and transitions associated with any Zone. + ECMAScript implementations are recommended to include updates to the IANA Time Zone Database as soon as possible. + Such prompt action ensures that ECMAScript programs can accurately perform time-zone-sensitive calculations and can use newly-added available named time zone identifiers supplied by external input or the host environment.

    - A conforming implementation must recognize *"UTC"* and all other Zone and Link names (and only such names), and use best available current and historical information about their offsets from UTC and their daylight saving time rules in calculations. However, the set of combinations of time zone name and language tag for which localized time zone names are available is implementation dependent. + If implementations revise time zone information during the lifetime of an agent, then it is recommended that the list of available named time zone identifiers, the primary time zone identifier associated with any available named time zone identifier, and the UTC offsets and transitions associated with any available named time zone identifier, be consistent with results previously observed by that agent. + Due to the complexity of supporting this recommendation, it is recommended that implementations maintain a fully consistent copy of the IANA Time Zone Database for the lifetime of each agent.

    - -

    - IsValidTimeZoneName ( - _timeZone_: a String, - ): a Boolean -

    +

    This section complements but does not supersede .

    + + +

    + The IANA Time Zone Database offers build options that affect which time zone identifiers are primary. + The default build options merge different countries' time zones, for example *"Atlantic/Reykjavik"* being a Link to the Zone *"Africa/Abidjan"*. + Geographically and politically distinct locations are likely to introduce divergent time zone rules in a future version of the IANA Time Zone Database. + Therefore, it is recommended that ECMAScript implementations instead use build options such as PACKRATDATA=backzone PACKRATLIST=zone.tab or a similar alternative that ensures at least one primary identifier for each ISO 3166-1 Alpha-2 country code. +

    +     + + +

    AvailableNamedTimeZoneIdentifiers ( ): a List of Time Zone Identifier Records

    description
    -
    It verifies that the _timeZone_ argument represents a valid Zone or Link name of the IANA Time Zone Database.
    +
    + 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 ordered according to the [[Identifier]] field of each Time Zone Identifier Record. +
    +
    redefinition
    +
    true
    +

    This definition supersedes the definition provided in .

    - 1. If one of the Zone or Link names of the IANA Time Zone Database is an ASCII-case-insensitive match for _timeZone_, return *true*. - 1. If _timeZone_ is an ASCII-case-insensitive match for *"UTC"*, return *true*. - 1. Return *false*. + 1. Let _identifiers_ be a List containing the String value of each Zone or Link name in the IANA Time Zone Database. + 1. Assert: No element of _identifiers_ is an ASCII-case-insensitive match for any other element. + 1. Assert: Every element of _identifiers_ identifies a Zone or Link name in the IANA Time Zone Database. + 1. Sort _identifiers_ according to lexicographic code unit order. + 1. Let _result_ be a new empty List. + 1. For each element _identifier_ of _identifiers_, do + 1. Let _primary_ be _identifier_. + 1. If _identifier_ is a Link name and _identifier_ is not *"UTC"*, then + 1. Set _primary_ to the Zone name that _identifier_ resolves to, according to the rules for resolving Link names in the IANA Time Zone Database. + 1. NOTE: An implementation may need to resolve _identifier_ iteratively. + 1. If _primary_ is one of *"Etc/UTC"*, *"Etc/GMT"*, or *"GMT"*, set _primary_ to *"UTC"*. + 1. Let _record_ be the Time Zone Identifier Record { [[Identifier]]: _identifier_, [[PrimaryIdentifier]]: _primary_ }. + 1. Append _record_ to _result_. + 1. Assert: _result_ contains a Time Zone Identifier Record _r_ such that _r_.[[Identifier]] is *"UTC"* and _r_.[[PrimaryIdentifier]] is *"UTC"*. + 1. Return _result_. -     - - Any value returned from SystemTimeZoneIdentifier that is not recognized as valid by IsTimeZoneOffsetString must be recognized as valid by IsValidTimeZoneName. - + + 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 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. + +     - +

    - CanonicalizeTimeZoneName ( - _timeZone_: a String value that is a valid time zone name as verified by IsValidTimeZoneName, - ): a String + GetAvailableNamedTimeZoneIdentifier ( + _timeZoneIdentifier_: a String, + ): either a Time Zone Identifier Record or ~empty~

    description
    -
    It returns the canonical and case-regularized form of _timeZone_.
    +
    + If _timeZoneIdentifier_ is an available named time zone identifier, then it returns one of the records in the List returned by AvailableNamedTimeZoneIdentifiers. + Otherwise, ~empty~ will be returned. +
    - 1. Let _ianaTimeZone_ be the String value of the Zone or Link name of the IANA Time Zone Database that is an ASCII-case-insensitive match for _timeZone_. - 1. If _ianaTimeZone_ is a Link name, set _ianaTimeZone_ to the String value of the corresponding Zone name as specified in the file backward of the IANA Time Zone Database. - 1. If _ianaTimeZone_ is one of *"Etc/UTC"*, *"Etc/GMT"*, or *"GMT"*, return *"UTC"*. - 1. Return _ianaTimeZone_. + 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~. + + For any _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 field values for the lifetime of the surrounding agent. + Furthermore, it is recommended that time zone identifiers not dynamically change from primary to non-primary during the lifetime of the surrounding agent, meaning that if _timeZoneIdentifier_ is an ASCII-case-insensitive match for the [[PrimaryIdentifier]] field of the result of a previous call to GetAvailableNamedTimeZoneIdentifier, then GetAvailableNamedTimeZoneIdentifier(_timeZoneIdentifier_) must 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 too) remains the same for the lifetime of the surrounding agent. +     - +

    - AvailableCanonicalTimeZones ( + AvailablePrimaryTimeZoneIdentifiers ( ): a List of Strings

    @@ -225,14 +277,11 @@

    - 1. Let _names_ be a List of all Zone and Link names in the IANA Time Zone Database that are supported by the implementation. + 1. Let _records_ be AvailableNamedTimeZoneIdentifiers(). 1. Let _result_ be a new empty List. - 1. For each element _name_ of _names_, do - 1. Assert: IsValidTimeZoneName( _name_ ) is *true*. - 1. Let _canonical_ be CanonicalizeTimeZoneName( _name_ ). - 1. If _result_ does not contain _canonical_, then - 1. Append _canonical_ to _result_. - 1. [declared="comparefn"] Sort _result_ in order as if an Array of the same values had been sorted using %Array.prototype.sort% using *undefined* as _comparefn_. + 1. For each element _timeZoneIdentifierRecord_ of _records_, do + 1. If _timeZoneIdentifierRecord_.[[Identifier]] is _timeZoneIdentifierRecord_.[[PrimaryIdentifier]], then + 1. Append _timeZoneIdentifierRecord_.[[Identifier]] to _result_. 1. Return _result_.