Skip to content

Commit ea29a30

Browse files
committed
Editorial: Clarify definition of "time zone transition"
Closes: #3105
1 parent dc923b5 commit ea29a30

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

spec/timezone.html

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -88,12 +88,13 @@ <h1>
8888
<dl class="header">
8989
</dl>
9090
<p>
91-
The returned value _t_ represents the number of nanoseconds since the epoch that corresponds to the first time zone transition strictly after _epochNanoseconds_ in the IANA time zone identified by _timeZoneIdentifier_.
91+
The returned value _t_ represents the number of nanoseconds since the epoch that corresponds to the first time zone UTC offset transition strictly after _epochNanoseconds_ in the IANA time zone identified by _timeZoneIdentifier_.
9292
The operation returns *null* if no such transition exists for which _t_ ≤ ℤ(nsMaxInstant).
9393
</p>
9494
<p>
9595
A transition is a point in time where the UTC offset of a time zone changes, for example when Daylight Saving Time starts or stops.
9696
The returned value _t_ represents the first nanosecond where the new UTC offset is used in this time zone, not the last nanosecond where the previous UTC offset is used.
97+
In other words, GetOffsetNanosecondsFor(_timeZone_, _t_) ≠ GetOffsetNanosecondsFor(_timeZone_, _t_ - 1).
9798
</p>
9899
<p>Given the same values of _timeZoneIdentifier_ and _epochNanoseconds_, the result must be the same for the lifetime of the surrounding agent.</p>
99100
<p>The minimum implementation of GetNamedTimeZoneNextTransition for ECMAScript implementations that do not include local political rules for any time zones performs the following steps when called:</p>
@@ -113,12 +114,13 @@ <h1>
113114
<dl class="header">
114115
</dl>
115116
<p>
116-
The returned value _t_ represents the number of nanoseconds since the epoch that corresponds to the last time zone transition strictly before _epochNanoseconds_ in the IANA time zone identified by _timeZoneIdentifier_.
117+
The returned value _t_ represents the number of nanoseconds since the epoch that corresponds to the last time zone UTC offset transition strictly before _epochNanoseconds_ in the IANA time zone identified by _timeZoneIdentifier_.
117118
The operation returns *null* if no such transition exists for which _t_ ≥ ℤ(nsMinInstant).
118119
</p>
119120
<p>
120121
A transition is a point in time where the UTC offset of a time zone changes, for example when Daylight Saving Time starts or stops.
121122
The returned value _t_ represents the first nanosecond where the new UTC offset is used in this time zone, not the last nanosecond where the previous UTC offset is used.
123+
In other words, GetOffsetNanosecondsFor(_timeZone_, _t_) ≠ GetOffsetNanosecondsFor(_timeZone_, _t_ - 1).
122124
</p>
123125
<p>Given the same values of _timeZoneIdentifier_ and _epochNanoseconds_, the result must be the same for the lifetime of the surrounding agent.</p>
124126
<p>The minimum implementation of GetNamedTimeZonePreviousTransition for ECMAScript implementations that do not include local political rules for any time zones performs the following steps when called:</p>

0 commit comments

Comments
 (0)