ch.agent.t2.time

Interface TimeScanner

All Known Implementing Classes:

DefaultTimeScanner, TimeFactory

public interface TimeScanner

A time scanner extracts time parts from a string representation.

Author:

Jean-Paul Vetterli

Method Summary

Modifier and Type	Method and Description
TimeParts	scan(Resolution unit, String datetime) Scan the date string into a time parts object.

Method Detail

scan

TimeParts scan(Resolution unit,
               String datetime)
        throws T2Exception

Scan the date string into a time parts object. The scanner extracts fields from the input and assigns them to time parts without checking their validity. From the point of view of the scanner day 42 of month 99 is okay. The time resolution is used for interpreting fractional seconds if present, because in a decimal fraction, leading zeros are significant but trailing zeros can be omitted (for example 1 corresponds to 100 milliseconds but 100000 microseconds).

Parameters:

unit - the time resolution

datetime - a non-null string containing a date and time specification

Returns:

a TimeParts

Throws:

Exception

T2Exception