Home » Specifications » OpenSearch » Extensions » Time » 1.0 » Draft 1


[edit] Notice

This is a draft document for public review.

[edit] Introduction

As the amount of historic data builds on the web, it is valuable to provide a way for users and tools to easily query based on time and timespans. The purpose of the OpenSearch-Time extensions is to provide a standard mechanism to query a resource based on temporal extents.

The Temporal parameters are based on the iCalendar and Microformat standards.

[edit] Namespace

Updated July 27, 2007: the OpenSearch Time extension namespace was shortened to just "time" instead of "opensearchtime". This was to make the namespace more succint.

[edit] Example

Example of a detailed OpenSearch description document that describes a search engine that accept temporal search parameters.

 <?xml version="1.0" encoding="UTF-8"?>
 <OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/"
   <ShortName>Web Search</ShortName>
   <Description>Use Example.com to search the Web.</Description>
   <Tags>example web</Tags>
   <Url type="application/atom+xml"
   <Url type="text/html"
   <LongName>Example.com Web Search</LongName>
   <Image height="64" width="64" type="image/png">http://example.com/websearch.png</Image>
   <Query role="example" searchTerms="cat" />
   <Developer>Example.com Development Team</Developer>
       Search data Copyright 2005, Example.com, Inc., All Rights Reserved

[edit] Namespace

The XML namespace of the OpenSearch Time Extension is:


This namespace and a corresponding namespace prefix must be included when the extension is used in an OpenSearch Description document.

[edit] Parameters

[edit] The "start" and "end" parameters


Replaced with a string of the beginning of the time slice of the search query. This string should match the RFC-3339 - Date and Time on the Internet: Timestamps, which is also used by the Atom syndication format.

It is of the format


'Z' is the time-offset, where 'Z' signifies UTC or an actual offset can be used.



[edit] Author

Andrew Turner <ajturner@highearthorbit.com>

[edit] Contributors

DeWitt Clinton <dewitt@opensearch.org>

[edit] License

This document is made available subject to the terms of the Creative Commons Attribution-ShareAlike 2.5 License.