Skip to content

Fix: time offsets vs time zones uses better wording #768

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.

Sign up for GitHub

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

Open
trwnh wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Fix: time offsets vs time zones uses better wording #768

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 20 additions & 7 deletions core/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -425,18 +425,19 @@ <h3>Date and Times</h3>
"time-offset" and "full-date" constructs are as defined in
[[RFC3339]].
</p>
<pre>
<pre class="abnf">
as2-partial-time = time-hour ":" time-minute [":" time-second [time-secfrac]]
as2-full-time = as2-partial-time time-offset
as2-date-time = full-date "T" as2-full-time
</pre>

<p>
It is important to note that the `time-offset` component does not
correlate to time-zones, and while times that include the
`time-offset` component work well for timestamps, they cannot be
reliably converted to and from local "wall times" without additional
information and processing.
<p class="note" title="Avoiding common confusion between time offsets and time zones">
The `time-offset` component correlates to a time offset from UTC, which is
not the same as a "time zone". Applications cannot reliably convert
time offsets to time zones without additional information and processing,
such as knowing when daylight saving rules are in effect for certain localities,
as well as the history of legislation which affects historical start and end times
for daylight saving rules.
</p>

</section>
Expand Down Expand Up @@ -2523,6 +2524,18 @@ <h2>Example using Multiple Vocabularies</h2>

<h2>Changelog</h2>

<section>
<h3>Changes since 2017-05-23 Recommendation</h3>
<p>The following changes have been made to this document since the
previous recommendation of <a href="https://www.w3.org/TR/2017/REC-activitystreams-core-20170523/">2017-05-23</a>:</p>
<ul>
<li>Cleaned up language around datetime serialization.</li>
</ul>
</section>

<section>
<h3>Changes since 2016-12-15 Candidate Recommendation</h3>
</section>
<p>
The following notable changes have been made to this document since the
previous candidate recommendation of <a href="https://www.w3.org/TR/2016/CR-activitystreams-core-20161215/#changelog">2016-12-15</a>.
Expand Down