com.itextpdf.kernel.xmp

Class XMPDateTimeFactory

java.lang.Object

com.itextpdf.kernel.xmp.XMPDateTimeFactory

public final class XMPDateTimeFactory
extends Object

A factory to create XMPDateTime-instances from a Calendar or an ISO 8601 string or for the current time.

Since:

16.02.2006

Method Summary

Modifier and Type	Method and Description
static XMPDateTime	convertToLocalTime(XMPDateTime dateTime) Make sure a time is local.
static XMPDateTime	convertToUTCTime(XMPDateTime dateTime) Make sure a time is UTC.
static XMPDateTime	create() Creates an empty XMPDateTime-object.
static XMPDateTime	create(int year, int month, int day) Creates an XMPDateTime-object from initial values.
static XMPDateTime	create(int year, int month, int day, int hour, int minute, int second, int nanoSecond) Creates an XMPDateTime-object from initial values.
static XMPDateTime	createFromCalendar(Calendar calendar) Creates an XMPDateTime from a Calendar-object.
static XMPDateTime	createFromISO8601(String strValue) Creates an XMPDateTime from an ISO 8601 string.
static XMPDateTime	getCurrentDateTime() Obtain the current date and time.
static XMPDateTime	setLocalTimeZone(XMPDateTime dateTime) Sets the local time zone without touching any other Any existing time zone value is replaced, the other date/time fields are not adjusted in any way.

Methods inherited from class java.lang.Object

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

Method Detail

createFromCalendar

public static XMPDateTime createFromCalendar(Calendar calendar)

Creates an XMPDateTime from a Calendar-object.

Parameters:

calendar - a Calendar-object.

Returns:

An XMPDateTime-object.

create

public static XMPDateTime create()

Creates an empty XMPDateTime-object.

Returns:

Returns an XMPDateTime-object.

create

public static XMPDateTime create(int year,
                                 int month,
                                 int day)

Creates an XMPDateTime-object from initial values.

Parameters:

year - years

month - months from 1 to 12
Note: Remember that the month in Calendar is defined from 0 to 11.

day - days

Returns:

Returns an XMPDateTime-object.

create

public static XMPDateTime create(int year,
                                 int month,
                                 int day,
                                 int hour,
                                 int minute,
                                 int second,
                                 int nanoSecond)

Creates an XMPDateTime-object from initial values.

Parameters:

year - years

month - months from 1 to 12
Note: Remember that the month in Calendar is defined from 0 to 11.

day - days

hour - hours

minute - minutes

second - seconds

nanoSecond - nanoseconds

Returns:

Returns an XMPDateTime-object.

createFromISO8601

public static XMPDateTime createFromISO8601(String strValue)
                                     throws XMPException

Creates an XMPDateTime from an ISO 8601 string.

Parameters:

strValue - The ISO 8601 string representation of the date/time.

Returns:

An XMPDateTime-object.

Throws:

XMPException - When the ISO 8601 string is non-conform

getCurrentDateTime

public static XMPDateTime getCurrentDateTime()

Obtain the current date and time.

Returns:

Returns The returned time is UTC, properly adjusted for the local time zone. The resolution of the time is not guaranteed to be finer than seconds.

setLocalTimeZone

public static XMPDateTime setLocalTimeZone(XMPDateTime dateTime)

Sets the local time zone without touching any other Any existing time zone value is replaced, the other date/time fields are not adjusted in any way.

Parameters:

dateTime - the XMPDateTime variable containing the value to be modified.

Returns:

Returns an updated XMPDateTime-object.

convertToUTCTime

public static XMPDateTime convertToUTCTime(XMPDateTime dateTime)

Make sure a time is UTC. If the time zone is not UTC, the time is adjusted and the time zone set to be UTC.

Parameters:

dateTime - the XMPDateTime variable containing the time to be modified.

Returns:

Returns an updated XMPDateTime-object.

convertToLocalTime

public static XMPDateTime convertToLocalTime(XMPDateTime dateTime)

Make sure a time is local. If the time zone is not the local zone, the time is adjusted and the time zone set to be local.

Parameters:

dateTime - the XMPDateTime variable containing the time to be modified.

Returns:

Returns an updated XMPDateTime-object.