Package com.itextpdf.kernel.xmp.impl

Class XMPDateTimeImpl

java.lang.Object

com.itextpdf.kernel.xmp.impl.XMPDateTimeImpl

All Implemented Interfaces:

XMPDateTime, Comparable

       public class XMPDateTimeImpl extends Object implements XMPDateTime
      

The implementation of XMPDateTime. Internally a calendar is used plus an additional nano seconds field, because Calendar supports only milli seconds. The nanoSeconds convers only the resolution beyond a milli second.

Since:

16.02.2006

Constructor Summary

Constructors

Constructor	Description
XMPDateTimeImpl()	Creates an XMPDateTime-instance with the current time in the default time zone.
XMPDateTimeImpl(String strValue)	Creates an XMPDateTime-instance from an ISO 8601 string.
XMPDateTimeImpl(Calendar calendar)	Creates an XMPDateTime-instance from a calendar.
XMPDateTimeImpl(Date date, TimeZone timeZone)	Creates an XMPDateTime-instance from a Date and a TimeZone.

Method Summary

Modifier and Type	Method	Description
int	compareTo(Object dt)
Calendar	getCalendar()
int	getDay()
int	getHour()
String	getISO8601String()
int	getMinute()
int	getMonth()
int	getNanoSecond()
int	getSecond()
TimeZone	getTimeZone()
int	getYear()
boolean	hasDate()	This flag is set either by parsing or by setting year, month or day.
boolean	hasTime()	This flag is set either by parsing or by setting hours, minutes, seconds or milliseconds.
boolean	hasTimeZone()	This flag is set either by parsing or by setting hours, minutes, seconds or milliseconds.
void	setDay(int day)
void	setHour(int hour)
void	setMinute(int minute)
void	setMonth(int month)
void	setNanoSecond(int nanoSecond)
void	setSecond(int second)
void	setTimeZone(TimeZone timeZone)
void	setYear(int year)
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

XMPDateTimeImpl

             public XMPDateTimeImpl()
            

Creates an XMPDateTime-instance with the current time in the default time zone.

XMPDateTimeImpl

             public XMPDateTimeImpl
             (Calendar calendar)
            

Creates an XMPDateTime-instance from a calendar.

Parameters:

calendar - a Calendar

XMPDateTimeImpl

             public XMPDateTimeImpl
             (Date date, TimeZone timeZone)
            

Creates an XMPDateTime-instance from a Date and a TimeZone.

Parameters:

date - a date describing an absolute point in time

timeZone - a TimeZone how to interpret the date

XMPDateTimeImpl

             public XMPDateTimeImpl
             (String strValue) throws XMPException
            

Creates an XMPDateTime-instance from an ISO 8601 string.

Parameters:

strValue - an ISO 8601 string

Throws:

XMPException - If the string is a non-conform ISO 8601 string, an exception is thrown

Method Details

getYear

             public int getYear()
            

Specified by:

getYear in interface XMPDateTime

Returns:

Returns the year, can be negative.

See Also:

• XMPDateTime.getYear()

setYear

             public void setYear
             (int year)
            

Specified by:

setYear in interface XMPDateTime

Parameters:

year - Sets the year

See Also:

• XMPDateTime.setYear(int)

getMonth

             public int getMonth()
            

Specified by:

getMonth in interface XMPDateTime

Returns:

Returns The month in the range 1..12.

See Also:

• XMPDateTime.getMonth()

setMonth

             public void setMonth
             (int month)
            

Specified by:

setMonth in interface XMPDateTime

Parameters:

month - Sets the month 1..12

See Also:

• XMPDateTime.setMonth(int)

getDay

             public int getDay()
            

Specified by:

getDay in interface XMPDateTime

Returns:

Returns the day of the month in the range 1..31.

See Also:

• XMPDateTime.getDay()

setDay

             public void setDay
             (int day)
            

Specified by:

setDay in interface XMPDateTime

Parameters:

day - Sets the day 1..31

See Also:

• XMPDateTime.setDay(int)

getHour

             public int getHour()
            

Specified by:

getHour in interface XMPDateTime

Returns:

Returns hour - The hour in the range 0..23.

See Also:

• XMPDateTime.getHour()

setHour

             public void setHour
             (int hour)
            

Specified by:

setHour in interface XMPDateTime

Parameters:

hour - Sets the hour in the range 0..23.

See Also:

• XMPDateTime.setHour(int)

getMinute

             public int getMinute()
            

Specified by:

getMinute in interface XMPDateTime

Returns:

Returns the minute in the range 0..59.

See Also:

• XMPDateTime.getMinute()

setMinute

             public void setMinute
             (int minute)
            

Specified by:

setMinute in interface XMPDateTime

Parameters:

minute - Sets the minute in the range 0..59.

See Also:

• XMPDateTime.setMinute(int)

getSecond

             public int getSecond()
            

Specified by:

getSecond in interface XMPDateTime

Returns:

Returns the second in the range 0..59.

See Also:

• XMPDateTime.getSecond()

setSecond

             public void setSecond
             (int second)
            

Specified by:

setSecond in interface XMPDateTime

Parameters:

second - Sets the second in the range 0..59.

See Also:

• XMPDateTime.setSecond(int)

getNanoSecond

             public int getNanoSecond()
            

Specified by:

getNanoSecond in interface XMPDateTime

Returns:

Returns milli-, micro- and nano seconds. Nanoseconds within a second, often left as zero?

See Also:

• XMPDateTime.getNanoSecond()

setNanoSecond

             public void setNanoSecond
             (int nanoSecond)
            

Specified by:

setNanoSecond in interface XMPDateTime

Parameters:

nanoSecond - Sets the milli-, micro- and nano seconds. Granularity goes down to milli seconds.

See Also:

• XMPDateTime.setNanoSecond(int)

compareTo

             public int compareTo
             (Object dt)
            

Specified by:

compareTo in interface Comparable

See Also:

• Comparable.compareTo(Object)

getTimeZone

             public TimeZone getTimeZone()
            

Specified by:

getTimeZone in interface XMPDateTime

Returns:

Returns the time zone.

See Also:

• XMPDateTime.getTimeZone()

setTimeZone

             public void setTimeZone
             (TimeZone timeZone)
            

Specified by:

setTimeZone in interface XMPDateTime

Parameters:

timeZone - a time zone to set

See Also:

• XMPDateTime.setTimeZone(java.util.TimeZone)

hasDate

             public boolean hasDate()
            

Description copied from interface: XMPDateTime

This flag is set either by parsing or by setting year, month or day.

Specified by:

hasDate in interface XMPDateTime

Returns:

Returns true if the XMPDateTime object has a date portion.

See Also:

• XMPDateTime.hasDate()

hasTime

             public boolean hasTime()
            

Description copied from interface: XMPDateTime

This flag is set either by parsing or by setting hours, minutes, seconds or milliseconds.

Specified by:

hasTime in interface XMPDateTime

Returns:

Returns true if the XMPDateTime object has a time portion.

See Also:

• XMPDateTime.hasTime()

hasTimeZone

             public boolean hasTimeZone()
            

Description copied from interface: XMPDateTime

This flag is set either by parsing or by setting hours, minutes, seconds or milliseconds.

Specified by:

hasTimeZone in interface XMPDateTime

Returns:

Returns true if the XMPDateTime object has a defined timezone.

See Also:

• XMPDateTime.hasTimeZone()

getCalendar

             public Calendar getCalendar()
            

Specified by:

getCalendar in interface XMPDateTime

Returns:

Returns a Calendar (only with milli second precision).
Note: the dates before Oct 15th 1585 (which normally fall into validity of the Julian calendar) are also rendered internally as Gregorian dates.

See Also:

• XMPDateTime.getCalendar()

getISO8601String

             public String getISO8601String()
            

Specified by:

getISO8601String in interface XMPDateTime

Returns:

Returns the ISO 8601 string representation of the date and time.

See Also:

• XMPDateTime.getISO8601String()

toString

             public String toString()
            

Overrides:

toString in class Object

Returns:

Returns the ISO string representation.