- From: Richard Tibbett via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 25 Jan 2010 11:58:27 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/calendar
In directory hutz:/tmp/cvs-serv4077
Modified Files:
Overview.html
Log Message:
Replaced ambiguous date and time formatting with DOM Level 3 Core DOMTimeStamp object formatting.
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/calendar/Overview.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- Overview.html 22 Jan 2010 14:07:38 -0000 1.6
+++ Overview.html 25 Jan 2010 11:58:25 -0000 1.7
@@ -79,7 +79,7 @@
}
// Perform a calendar search
-navigator.service.calendar.findEvents( {startBefore: 1270832400}, // find all calendar events that start
+navigator.service.calendar.findEvents( {startBefore: 1270832400000}, // find all calendar events that start
// before April 9, 2010 @ 5pm
successCalendarFindEventsCallback,
generalErrorCB );</pre>
@@ -95,15 +95,15 @@
description: 'W3C weekly meeting',
summary: 'Agenda to be distributed weekly',
location: 'IRC and Conf. call #XXX',
- start: 1264604400, // January 27, 2010 @ 3pm
- end: 1264609800, // January 27, 2010 @ 4:30pm
+ start: 1264604400000, // January 27, 2010 @ 3pm
+ end: 1264609800000, // January 27, 2010 @ 4:30pm
recurrence: {
frequency: 'weekly',
- expires: 1312156800, // August 1, 2011 @ 12am
- daysInWeek: [3] // Every Wednesday
+ expires: 1312156800000, // August 1, 2011 @ 12am
+ daysInWeek: [3] // Every Wednesday
},
freebusy: 'busy',
- reminder: -3600, // Remind 1 hour before each occurance of this event
+ reminder: -3600000, // Remind 1 hour before each occurance of this event
serviceId: 'http://localhost/calendar'
});</pre>
</div>
@@ -165,9 +165,10 @@
<p>
This specification requires that UTC timestamp formatting for
- all dates and times is provided as the number of seconds since the UNIX epoch (Jan 1, 1970). All UTC timestamps must be normalized to standard GMT +0 times. This specification is not
- prescriptive on the way that date and time information should be rendered according to any specific time zone, only that the any dates and times provided have been
- normalized to a standard time zone by the API for the purposes of distribution across heterogeneous clients.
+ all dates and times be applied according to the defintion of DOMTimeStamp in [[!DOM-LEVEL-3-CORE]]. This is defined as the date and time, in
+ milliseconds since the UNIX epoch (Jan 1, 1970). All UTC timestamps must be normalized to standard GMT +0 times. This specification is not
+ prescriptive on the way that date and time information should be rendered according to any specific time zone, only that the any dates and times
+ provided have been normalized to a standard time zone by the API for the purposes of distribution across heterogeneous clients.
</p>
</section
@@ -521,20 +522,20 @@
<pre class="example sh_javascript_dom">{summary: 'Agenda:\n\n\t* Introductions\n\t* AoB'}</pre>
</dd>
<dt>
- attribute unsigned long start
+ attribute DOMTimeStamp start
</dt>
<dd>
- <p>The start date and time of the event in UTC timestamp format.</p>
+ <p>The start date and time of the event in UTC timestamp format as defined in [[!DOM-LEVEL-3-CORE]].</p>
- <pre class="example sh_javascript_dom">{start: 1269439200} // Event starts on March 24, 2010 @ 2pm</pre>
+ <pre class="example sh_javascript_dom">{start: 1269439200000} // Event starts on March 24, 2010 @ 2pm</pre>
</dd>
<dt>
- attribute unsigned long? end
+ attribute DOMTimeStamp? end
</dt>
<dd>
- <p>The end date and time of the event in UTC timestamp format.</p>
+ <p>The end date and time of the event in UTC timestamp format as defined in [[!DOM-LEVEL-3-CORE]].</p>
- <pre class="example sh_javascript_dom">{end: 1269442800} // Event ends on March 24, 2010 @ 3pm</pre>
+ <pre class="example sh_javascript_dom">{end: 1269442800000} // Event ends on March 24, 2010 @ 3pm</pre>
</dd>
<dt>
attribute DOMString? freebusy
@@ -589,18 +590,18 @@
</dd>
<dt>
- attribute long? reminder
+ attribute long long? reminder
</dt>
<dd>
<p>A reminder for the event.</p>
- <p>This attribute can be specified as a positive value in standard UTC timestamp format denoting a one-time reminder or as a negative value in seconds denoting a relative relationship
+ <p>This attribute can be specified as a positive value in standard UTC timestamp format, as defined in [[!DOM-LEVEL-3-CORE]], denoting a one-time reminder or as a negative value in milliseconds denoting a relative relationship
to the start time of the calendar event.</p>
<p>A relative reminder is paticularly useful for setting a reminder for recurring events.</p>
- <pre class="example sh_javascript_dom">{reminder: 1269435600} // Remind ONCE on March 24, 2010 @ 1pm</pre>
- <pre class="example sh_javascript_dom">{reminder: -3600} // Remind 1 hour before every occurance of this event</pre>
+ <pre class="example sh_javascript_dom">{reminder: 1269435600000} // Remind ONCE on March 24, 2010 @ 1pm</pre>
+ <pre class="example sh_javascript_dom">{reminder: -3600000} // Remind 1 hour before every occurance of this event</pre>
</dd>
<dt>
@@ -625,28 +626,28 @@
<dl title='[NoInterfaceObject] interface CalendarFindEventProperties : CalendarEventProperties' class='idl'>
<dt>
- attribute unsigned long startBefore
+ attribute DOMTimeStamp startBefore
</dt>
<dd>
- Search for Calendar Events that start before the UTC time provided.
+ Search for Calendar Events that start before the UTC time provided as defined in [[!DOM-LEVEL-3-CORE]].
</dd>
<dt>
- attribute unsigned long startAfter
+ attribute DOMTimeStamp startAfter
</dt>
<dd>
- Search for Calendar Events that start after the UTC time provided.
+ Search for Calendar Events that start after the UTC time provided as defined in [[!DOM-LEVEL-3-CORE]].
</dd>
<dt>
- attribute unsigned long endBefore
+ attribute DOMTimeStamp endBefore
</dt>
<dd>
- Search for Calendar Events that end before the UTC time provided.
+ Search for Calendar Events that end before the UTC time provided as defined in [[!DOM-LEVEL-3-CORE]].
</dd>
<dt>
- attribute unsigned long endAfter
+ attribute DOMTimeStamp endAfter
</dt>
<dd>
- Search for Calendar Events that end after the UTC time provided.
+ Search for Calendar Events that end after the UTC time provided as defined in [[!DOM-LEVEL-3-CORE]].
</dd>
</dl>
</section>
@@ -672,14 +673,14 @@
<pre class="example sh_javascript_dom">{frequency: 'monthly'} // Event repeats on a monthly basis</pre>
</dd>
<dt>
- attribute unsigned long? expires
+ attribute DOMTimeStamp? expires
</dt>
<dd>
- <p>The date and time to which the CalendarRepeatRule applies in UTC timestamp format.</p>
+ <p>The date and time to which the CalendarRepeatRule applies in DOMTimeStamp format as defined in [[!DOM-LEVEL-3-CORE]].</p>
<p>If this parameter is set to <code>null</code> the event item does not have any fixed expiry date and the event is scheduled to continue indefintely.</p>
- <pre class="example sh_javascript_dom">{expires: 1312156800} // Event repeats until August 1, 2011 @ 12am</pre>
+ <pre class="example sh_javascript_dom">{expires: 1312156800000} // Event repeats until August 1, 2011 @ 12am</pre>
</dd>
<dt>
attribute short[] daysInWeek
@@ -1030,8 +1031,8 @@
<p>
For example, the following <a href="#calendarfindeventproperties-interface"><code>CalendarFindEventProperties</code></a> object is supplied for Calendar Event searching:
<pre class="example sh_javascript">navigator.service.calendar.findEvents({
- startBefore:1282780800, // All events before August 26, 2010
- freebusy:'busy'
+ startBefore: 1282780800000, // All events before August 26, 2010
+ freebusy: 'busy'
},
/*...*/);</pre>
Received on Monday, 25 January 2010 11:58:29 UTC