***************************************************************************
*
*  BBC Research and Development TV-Anytime Java API
*
*  Version 1.0
*  11 July 2003
*
***************************************************************************

*--------------------------------------------------------------------------
*  FAQ
*--------------------------------------------------------------------------


1. How do I use Locators and ProgramURLs
----------------------------------------
The bbc.rd.tvanytime.contentReferencing.Locator is a generic locator. This is 
obtained from a content referencing query and is bundled into a LocationsResult 
object. 

The bbc.rd.tvanytime.programLocation.ProgramURL represents a URL for a programme.
This is usually found in a ScheduleEvent object. 

When using the BBC TV-Anytime data both of these use a DVB URL format detailing 
channel, time/date and duration information in the form:

  [dvb://233a.1004.1084;6f2c@2001-12-08T02:50:00/PT00H10M45S]

The bbc.tvanytime.util.DVBLocatorToolbox contains methods that extract specific 
information given a DVB URL string, e.g. getDVBTriplet(), getDate()...

E.g. To get the date from a given ProgramURL object use:

  Date date = DVBLocatorToolbox.getDate(programURL.getProgramURL());