W3C home > Mailing lists > Public > public-dap-commits@w3.org > January 2010

2009/dap/calendar Overview.html,1.6,1.7

From: Richard Tibbett via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 25 Jan 2010 11:58:27 +0000
To: public-dap-commits@w3.org
Message-Id: <E1NZNaN-000147-ON@lionel-hutz.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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 25 January 2010 11:58:29 GMT