org.modeshape.jcr.value

Interface DateTimeFactory

All Superinterfaces:

ValueFactory<DateTime>

All Known Implementing Classes:

ModeShapeDateTimeValueFactory

public interface DateTimeFactory
extends ValueFactory<DateTime>

A factory for creating date-time instants. This interface extends the ValueFactory generic interface and adds specific methods for creating instants for the current time (and time zone) as well as various combinations of individual field values.

ISO-8601

The factory creates date-time instants from strings that are in the standard ISO-8601 format. The format this factory supports is month-based. The month-based representation is the most common format of ISO8601, and is the format used in the XML standards for passing dates and times:

 yyyy-mm-ddTHH:MM:SS.SSSZ
 

The fields are separated by dashes and consist of:

• four digit year;
• two digit month, where 01 is Janurary and 12 is December;
• two digit day of month, from 01 to 31;
• two digit hour, from 00 to 23;
• two digit minute, from 00 to 59;
• two digit second, from 00 to 59;
• three decimal places for milliseconds, if required;
• time zone offset of the form HH:mm (or '0' if UTC)

Field Summary

Fields inherited from interface org.modeshape.jcr.value.ValueFactory

DEFAULT_DECODER, DEFAULT_ENCODER

Method Summary

Modifier and Type	Method and Description
DateTime	create() Create a date-time instance for the current time in the local time zone.
DateTime	create(DateTime original, long offsetInMillis) Create a date-time instance that is offset from the original by the specified amount.
DateTime	create(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute, int millisecondsOfSecond) Create a date-time instance given the individual values for the fields
DateTime	createUtc() Create a date-time instance for the current time in UTC.
DateTimeFactory	with(ValueFactories valueFactories) Return a potentially new copy of this factory that uses the supplied ValueFactories object.

Methods inherited from interface org.modeshape.jcr.value.ValueFactory

create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, createEmptyArray, getPropertyType

Method Detail

with

DateTimeFactory with(ValueFactories valueFactories)

Description copied from interface: ValueFactory

Return a potentially new copy of this factory that uses the supplied ValueFactories object.

Specified by:

with in interface ValueFactory<DateTime>

Parameters:

valueFactories - the value factories object; may not be null

Returns:

the factory, which may be a new instance or may be this object if the supplied value factories is the same as used by this factory; never null

create

DateTime create()

Create a date-time instance for the current time in the local time zone.

Returns:

the current date-time instance

See Also:

createUtc()

createUtc

DateTime createUtc()

Create a date-time instance for the current time in UTC.

Returns:

the current date-time instance (in UTC)

See Also:

create()

create

DateTime create(DateTime original,
                long offsetInMillis)

Create a date-time instance that is offset from the original by the specified amount.

Parameters:

original - the original DateTime

offsetInMillis - the offset in milliseconds (positive or negative)

Returns:

the offset date-time instance

create

DateTime create(int year,
                int monthOfYear,
                int dayOfMonth,
                int hourOfDay,
                int minuteOfHour,
                int secondOfMinute,
                int millisecondsOfSecond)

Create a date-time instance given the individual values for the fields

Parameters:

year - the year of the era

monthOfYear - the month of the year

dayOfMonth - the day of the month

hourOfDay - the hour of the day

minuteOfHour - the minute of the hour

secondOfMinute - the second of the minute

millisecondsOfSecond - the milliseconds of the second

Returns:

the date-time instance