HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/2384

File a bug

SVNBugCommentTime (UTC)
2384Define 'week' syntax. Details coming later.2008-10-30 01:56
Index: source
===================================================================
--- source	(revision 2383)
+++ source	(revision 2384)
@@ -2036,9 +2036,9 @@
    interpret the resulting sequence as a base-ten integer. Let that
    number be the <var title="">month</var>.</p></li>
 
-   <li>If <var title="">month</var> is not a number in the range
+   <li><p>If <var title="">month</var> is not a number in the range
    1&nbsp;&le;&nbsp;<var title="">month</var>&nbsp;&le;&nbsp;12, then
-   fail.</li>
+   fail.</p></li>
 
    <li><p>Return <var title="">year</var> and <var
    title="">month</var>.</p></li>
@@ -2301,9 +2301,9 @@
    (possibly with a fractional part). Let <var title="">second</var>
    be that number instead of the string version.</p></li>
 
-   <li>If <var title="">second</var> is not a number in the range
+   <li><p>If <var title="">second</var> is not a number in the range
    0&nbsp;&le;&nbsp;<var title="">second</var>&nbsp;&lt;&nbsp;60, then
-   fail.</li>
+   fail.</p></li>
 
    <li><p>Return <var title="">hour</var>, <var title="">minute</var>,
    and <var title="">second</var>.</p></li>
@@ -2640,12 +2640,87 @@
 
   <!-- XXX ISO week information -->
 
-  <p class="XXX">... <dfn>valid week string</dfn></p>
+  <p class="XXX">The <dfn>week number</dfn> of a day is ...</p>
 
-  <p class="XXX">... rules to <dfn>parse a week string</dfn></p>
+  <p class="XXX">The <dfn>week number of the last day</dfn> of a year ...</p>
 
+  <p>A string is a <dfn>valid week string</dfn> representing a year
+  <var title="">year</var> and week <var title="">week</var> if it
+  consists of the following components in the given order:</p>
 
+  <ol>
 
+   <li>Four or more <span
+   title="concept-datetime-digit">digits</span>, representing <var
+   title="">year</var></li>
+
+   <li>A U+002D HYPHEN-MINUS character (-)</li>
+
+   <li>A U+0057 LATIN CAPITAL LETTER W character</li>
+
+   <li>Two <span title="concept-datetime-digit">digits</span>,
+   representing the week <var title="">week</var>, in the range
+   1&nbsp;&le;&nbsp;<var title="">week</var>&nbsp;&le;&nbsp;<var
+   title="">maxweek</var>, where <var title="">maxweek</var> is the
+   <span>week number of the last day</span> of year <var
+   title="">year</var></li>
+
+  </ol>
+
+  <p>The rules to <dfn>parse a week string</dfn> are as follows. This
+  will either return a year and week, or nothing. If at any point the
+  algorithm says that it "fails", this means that it is aborted at
+  that point and returns nothing.</p>
+
+  <ol>
+
+   <li><p>Let <var title="">input</var> be the string being
+   parsed.</p></li>
+
+   <li><p>Let <var title="">position</var> be a pointer into <var
+   title="">input</var>, initially pointing at the start of the
+   string.</p></li>
+
+   <li><p><span>Collect a sequence of characters</span> in the range
+   U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9). If the collected
+   sequence is not at least four characters long, then
+   fail. Otherwise, interpret the resulting sequence as a base-ten
+   integer. Let that number be the <var title="">year</var>.</p></li>
+
+   <li><p>If <var title="">position</var> is beyond the end of <var
+   title="">input</var> or if the character at <var
+   title="">position</var> is not a U+002D HYPHEN-MINUS character,
+   then fail. Otherwise, move <var title="">position</var> forwards
+   one character.</p></li>
+
+   <li><p>If <var title="">position</var> is beyond the end of <var
+   title="">input</var> or if the character at <var
+   title="">position</var> is not a 0057 LATIN CAPITAL LETTER W
+   character, then fail. Otherwise, move <var title="">position</var>
+   forwards one character.</p></li>
+
+   <li><p><span>Collect a sequence of characters</span> in the range
+   U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9). If the collected
+   sequence is not exactly two characters long, then fail. Otherwise,
+   interpret the resulting sequence as a base-ten integer. Let that
+   number be the <var title="">week</var>.</p></li>
+
+   <li><p>Let <var title="">maxweek</var> be the <span>week number of
+   the last day</span> of year <var title="">year</var>.</p></li>
+
+   <li><p>If <var title="">week</var> is not a number in the range
+   1&nbsp;&le;&nbsp;<var title="">week</var>&nbsp;&le;&nbsp;<var
+   title="">maxweek</var>, then fail.</p></li>
+
+   <li><p>If <var title="">position</var> is <em>not</em> beyond the
+   end of <var title="">input</var>, then fail.</p></li>
+
+   <li><p>Return <var title="">year</var> and <var
+   title="">week</var>.</p></li>
+
+  </ol>
+
+
   <h5>Vaguer moments in time</h5>
 
   <p>This section defines <dfn title="date or time string">date or

|