Skip to content

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

Merged
merged 2 commits into from
Jul 26, 2025

Conversation

justingrant
Copy link
Contributor

@justingrant justingrant commented Jul 25, 2025

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:

  1. Ensures proper non-pluralization of Daylight Saving (no "s") Time https://en.wikipedia.org/wiki/Daylight_saving_time
  2. Updates usage of DST-like terms to instead use either "Daylight Saving TIme" or "DST" which are the terms in the definitions section.

Hopefully these suggestions aren't too pedantic!

Daylight Saving Time doesn't have an "s" at the end of Saving.

https://en.wikipedia.org/wiki/Daylight_saving_time
Copy link

netlify bot commented Jul 25, 2025

Deploy Preview for w3c-timezone ready!

Name Link
🔨 Latest commit f954305
🔍 Latest deploy log https://app.netlify.com/projects/w3c-timezone/deploys/68842a206f97e10008180d54
😎 Deploy Preview https://deploy-preview-30--w3c-timezone.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Collaborator

@aphillips aphillips left a 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>
Copy link
Collaborator

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=])

Copy link
Contributor Author

@justingrant justingrant Jul 26, 2025

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.
@aphillips
Copy link
Collaborator

Thank you!

@aphillips aphillips merged commit 5fe3f9d into w3c:gh-pages Jul 26, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants