[html5] r2444 - [e] (0) clarify use cases for <time>

whatwg at whatwg.org whatwg at whatwg.org
Tue Nov 25 13:39:28 PST 2008


Author: ianh
Date: 2008-11-25 13:39:27 -0800 (Tue, 25 Nov 2008)
New Revision: 2444

Modified:
   index
   source
Log:
[e] (0) clarify use cases for <time>

Modified: index
===================================================================
--- index	2008-11-25 20:48:21 UTC (rev 2443)
+++ index	2008-11-25 21:39:27 UTC (rev 2444)
@@ -12298,7 +12298,8 @@
   readonly attribute <a href=#domtimestamp>DOMTimeStamp</a> <a href=#dom-time-timezone title=dom-time-timezone>timezone</a>;
 };</pre>
    </dd>
-  </dl><p>The <code><a href=#the-time-element>time</a></code> element represents a date and/or a time.</p>
+  </dl><p>The <code><a href=#the-time-element>time</a></code> element represents a precise date and/or a
+  time in the proleptic Gregorian calendar. <a href=#refsGREGORIAN>[GREGORIAN]</a></p>
 
   <p>The <dfn id=attr-time-datetime title=attr-time-datetime><code>datetime</code></dfn>
   attribute, if present, must contain a <a href=#valid-date-or-time-string>valid date or time
@@ -12390,8 +12391,14 @@
 
   </div>
 
+  <p class=note>The <code><a href=#the-time-element>time</a></code> element is not intended for
+  encoding times for which a precise date or time cannot be
+  established. For example, it would be inappropriate for encoding
+  times like "one millisecond after the big bang", "the early part of
+  the Jurassic period", or "a winter around 250 BCE".</p>
 
 
+
   <h4 id=the-progress-element><span class=secno>4.6.11 </span>The <dfn><code>progress</code></dfn> element</h4>
 
   <dl class=element><dt>Categories</dt>

Modified: source
===================================================================
--- source	2008-11-25 20:48:21 UTC (rev 2443)
+++ source	2008-11-25 21:39:27 UTC (rev 2444)
@@ -13090,7 +13090,9 @@
    </dd>
   </dl>
 
-  <p>The <code>time</code> element represents a date and/or a time.</p>
+  <p>The <code>time</code> element represents a precise date and/or a
+  time in the proleptic Gregorian calendar. <a
+  href="#refsGREGORIAN">[GREGORIAN]</a></p>
 
   <p>The <dfn title="attr-time-datetime"><code>datetime</code></dfn>
   attribute, if present, must contain a <span>valid date or time
@@ -13203,8 +13205,14 @@
 
   </div>
 
+  <p class="note">The <code>time</code> element is not intended for
+  encoding times for which a precise date or time cannot be
+  established. For example, it would be inappropriate for encoding
+  times like "one millisecond after the big bang", "the early part of
+  the Jurassic period", or "a winter around 250 BCE".</p>
 
 
+
   <h4>The <dfn><code>progress</code></dfn> element</h4>
 
   <dl class="element">




More information about the Commit-Watchers mailing list