com.google.ical.util

Class DTBuilder

java.lang.Object

com.google.ical.util.DTBuilder

public class DTBuilder
extends java.lang.Object

a mutable buffer that can be used to build DateValues and DateTimeValues.

Field Summary

Fields

Modifier and Type	Field and Description
int	day one indexed
int	hour zero indexed in 24 hour time.
int	minute zero indexed
int	month one indexed.
int	second zero indexed
int	year in AD.

Constructor Summary

Constructors

Constructor and Description
DTBuilder(DateValue dv)
DTBuilder(int year, int month, int day)
DTBuilder(int year, int month, int day, int hour, int minute, int second)

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(DateValue dv) behavior undefined unless normalized.
boolean	equals(java.lang.Object o)
int	hashCode()
void	normalize() makes sure that the fields are in the proper ranges, by e.g.
DateValue	toDate() produces a normalized date.
DateTimeValue	toDateTime() produces a normalized date time, using zero for the time fields if none were provided.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

year

public int year

in AD. 0 -> 1BC.

month

public int month

one indexed.

day

public int day

one indexed

hour

public int hour

zero indexed in 24 hour time.

minute

public int minute

zero indexed

second

public int second

zero indexed

Constructor Detail

DTBuilder

public DTBuilder(int year,
         int month,
         int day,
         int hour,
         int minute,
         int second)

DTBuilder

public DTBuilder(int year,
         int month,
         int day)

DTBuilder

public DTBuilder(DateValue dv)

Method Detail

toDateTime

public DateTimeValue toDateTime()

produces a normalized date time, using zero for the time fields if none were provided.

Returns:

not null

toDate

public DateValue toDate()

produces a normalized date.

Returns:

not null

compareTo

public int compareTo(DateValue dv)

behavior undefined unless normalized. If you're not sure whether it's appropriate to use this method, use toDateValue().compareTo(dv) instead.

normalize

public void normalize()

makes sure that the fields are in the proper ranges, by e.g. converting 32 January to 1 February, or month 0 to December of the year before.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object