-
Notifications
You must be signed in to change notification settings - Fork 3
Minor wording updates for DST terms #30
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
Daylight Saving Time doesn't have an "s" at the end of Saving. https://en.wikipedia.org/wiki/Daylight_saving_time
✅ Deploy Preview for w3c-timezone ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One small change request.
Thanks for this PR. I'm glad you found the document useful. I'm totally open to improvements and appreciate the effort.
index.html
Outdated
@@ -552,7 +552,7 @@ <h3>Working with mixed representations</h3> | |||
|
|||
<p>[=Incremental time=] and [=field-based time=] differ in the way certain operations work. For example, incremental times can often be directly compared: their integer values determine which is earlier or later. [=Field-based times=] have to be normalized and their individual fields compared.</p> | |||
|
|||
<p>[=Field-based times=] are often optimized to allow for various kinds of adjustments to be made to a value while minimizing the chances for error. For example, to set the date <code>2005-08-30</code> forward by one day, an implementation can add 'one unit' to the "day" field and adjust the day, month, and year fields as appropriate to the calendar system. In incremental time, a similar operation might be performed by incrementing the value by <code>24 hours * 60 minutes * 60 seconds * 1000 milliseconds</code>, which is one "logical day". However, there can be errors when a particular day has more or fewer seconds in it (such as occur during daylight saving transitions) or when the unit has a variable size, such as when adding a month or a year, since those fields have variable numbers of days in them.</p> | |||
<p>[=Field-based times=] are often optimized to allow for various kinds of adjustments to be made to a value while minimizing the chances for error. For example, to set the date <code>2005-08-30</code> forward by one day, an implementation can add 'one unit' to the "day" field and adjust the day, month, and year fields as appropriate to the calendar system. In incremental time, a similar operation might be performed by incrementing the value by <code>24 hours * 60 minutes * 60 seconds * 1000 milliseconds</code>, which is one "logical day". However, there can be errors when a particular day has more or fewer seconds in it (such as occur during DST transitions) or when the unit has a variable size, such as when adding a month or a year, since those fields have variable numbers of days in them.</p> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would keep "daylight saving time" here or at least termify DST (e.g. [=DST=]
)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oh! I naively assumed that it worked like ecmarkup where words are automatically termified if the text matches. I amended the commit to make this change.
Updates usage of DST-like terms to instead use either "Daylight Saving TIme" or "DST" which are the terms in the definitions section.
d65373c
to
f954305
Compare
Thank you! |
I just discovered this document, and I'm so happy it exists! I led the design of JS's new
Temporal.ZonedDateTime
and I'm pleased to see helpful timezone info popping up elsewhere in the web plaform. Thanks for writing it.This PR includes two commits with minor wording suggestions:
Hopefully these suggestions aren't too pedantic!