uk.ac.ed.epcc.safe.accounting.parsers.value

Class DateParser

java.lang.Object

uk.ac.ed.epcc.safe.accounting.parsers.value.DateParser

All Implemented Interfaces:

ValueFormatter<java.util.Date>, ValueParser<java.util.Date>

Direct Known Subclasses:

DateTimeParser, PbsDateParser

public class DateParser
extends java.lang.Object
implements ValueParser<java.util.Date>

Parses a string into a Date. There are many formats of a date can be represented in. As a result, this parser must be given an appropriate date DateFormat object to know how to parse a string into a date. In particular situations where the same format is being used for a larger more complicated parser, it may be more appropriate to subclass this object and hard code the format into the class.

Author:

jgreen4

Field Summary

Fields

Modifier and Type	Field and Description
static DateParser	PARSER Simple date format that accepts dates in the default ISO 8601 format yyyy-MM-dd

Constructor Summary

Constructors

Constructor and Description
DateParser()
DateParser(java.text.DateFormat format)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	format(java.util.Date date) Takes a date and returns a string representation of it using the format this parser uses to convert strings into dates.
java.lang.Class<java.util.Date>	getType() Returns the Class of object this ValueParser can handle.
java.util.Date	parse(java.lang.String valueString) Parses the specified string and constructs the appropriate object out of it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PARSER

public static final DateParser PARSER

Simple date format that accepts dates in the default ISO 8601 format yyyy-MM-dd

Constructor Detail

DateParser

public DateParser(java.text.DateFormat format)

DateParser

public DateParser()

Method Detail

getType

public java.lang.Class<java.util.Date> getType()

Description copied from interface: ValueParser

Returns the Class of object this ValueParser can handle. The ValueParser.parse(String) method must return objects that are assignable to this type. The #format(T) method can format any object assignable to this type. The returned class will be the exact Class (i.e. not a subclass) of this ValueParser's type

Specified by:

getType in interface ValueFormatter<java.util.Date>

Specified by:

getType in interface ValueParser<java.util.Date>

Returns:

The Type of this ValueParser

parse

public java.util.Date parse(java.lang.String valueString)
                     throws ValueParseException

Description copied from interface: ValueParser

Parses the specified string and constructs the appropriate object out of it.

Specified by:

parse in interface ValueParser<java.util.Date>

Throws:

ValueParseException - If valueString is not of a format that allows this parser to convert it into an object of type T

Parameters:

valueString - The string to parse

Returns:

The object representation of valueString

format

public java.lang.String format(java.util.Date date)

Takes a date and returns a string representation of it using the format this parser uses to convert strings into dates.

Specified by:

format in interface ValueFormatter<java.util.Date>

Specified by:

format in interface ValueParser<java.util.Date>

Parameters:

date - The date to be converted into a string

Returns:

date in string format