|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.joda.time.base.AbstractInstant
org.joda.time.base.AbstractDateTime
org.joda.time.base.BaseDateTime
org.joda.time.DateTime
DateTime is the standard implementation of an unmodifiable datetime class. It holds the datetime as milliseconds from the Java epoch of 1970-01-01T00:00:00Z.
This class uses a Chronology internally. The Chronology determines how the
millisecond instant value is converted into the date time fields.
The default Chronology is ISOChronology
which is the agreed
international standard and compatable with the modern Gregorian calendar.
Each individual field can be queried in two ways:
getHourOfDay()
hourOfDay().get()
DateTime is thread-safe and immutable, provided that the Chronology is as well. All standard Chronology classes supplied are thread-safe and immutable.
MutableDateTime
,
Serialized FormNested Class Summary | |
static class |
DateTime.Property
DateTime.Property binds a DateTime to a DateTimeField allowing powerful datetime functionality to be easily accessed. |
Constructor Summary | |
DateTime()
Constructs an instance set to the current system millisecond time using ISOChronology in the default time zone. |
|
DateTime(Chronology chronology)
Constructs an instance set to the current system millisecond time using the specified chronology. |
|
DateTime(DateTimeZone zone)
Constructs an instance set to the current system millisecond time using ISOChronology in the specified time zone. |
|
DateTime(int year,
int monthOfYear,
int dayOfMonth,
int hourOfDay,
int minuteOfHour,
int secondOfMinute,
int millisOfSecond)
Constructs an instance from datetime field values using ISOChronology in the default time zone. |
|
DateTime(int year,
int monthOfYear,
int dayOfMonth,
int hourOfDay,
int minuteOfHour,
int secondOfMinute,
int millisOfSecond,
Chronology chronology)
Constructs an instance from datetime field values using the specified chronology. |
|
DateTime(int year,
int monthOfYear,
int dayOfMonth,
int hourOfDay,
int minuteOfHour,
int secondOfMinute,
int millisOfSecond,
DateTimeZone zone)
Constructs an instance from datetime field values using ISOChronology in the specified time zone. |
|
DateTime(long instant)
Constructs an instance set to the milliseconds from 1970-01-01T00:00:00Z using ISOChronology in the default time zone. |
|
DateTime(long instant,
Chronology chronology)
Constructs an instance set to the milliseconds from 1970-01-01T00:00:00Z using the specified chronology. |
|
DateTime(long instant,
DateTimeZone zone)
Constructs an instance set to the milliseconds from 1970-01-01T00:00:00Z using ISOChronology in the specified time zone. |
|
DateTime(Object instant)
Constructs an instance from an Object that represents a datetime. |
|
DateTime(Object instant,
Chronology chronology)
Constructs an instance from an Object that represents a datetime, using the specified chronology. |
|
DateTime(Object instant,
DateTimeZone zone)
Constructs an instance from an Object that represents a datetime, forcing the time zone to that specified. |
Method Summary | |
DateTime.Property |
centuryOfEra()
Get the century of era property. |
DateTime.Property |
dayOfMonth()
Get the day of month property. |
DateTime.Property |
dayOfWeek()
Get the day of week property. |
DateTime.Property |
dayOfYear()
Get the day of year property. |
DateTime.Property |
era()
Get the era property. |
DateTime.Property |
hourOfDay()
Get the hour of day field property |
DateTime.Property |
millisOfDay()
Get the millis of day property |
DateTime.Property |
millisOfSecond()
Get the millis of second property |
DateTime |
minus(long duration)
Gets a copy of this datetime with the specified duration take away. |
DateTime |
minus(ReadableDuration duration)
Gets a copy of this datetime with the specified duration take away. |
DateTime |
minus(ReadablePeriod period)
Gets a copy of this datetime with the specified period take away. |
DateTime |
minusDays(int days)
Returns a new datetime minus the specified number of days. |
DateTime |
minusHours(int hours)
Returns a new datetime minus the specified number of hours. |
DateTime |
minusMillis(int millis)
Returns a new datetime minus the specified number of millis. |
DateTime |
minusMinutes(int minutes)
Returns a new datetime minus the specified number of minutes. |
DateTime |
minusMonths(int months)
Returns a new datetime minus the specified number of months. |
DateTime |
minusSeconds(int seconds)
Returns a new datetime minus the specified number of seconds. |
DateTime |
minusWeeks(int weeks)
Returns a new datetime minus the specified number of weeks. |
DateTime |
minusYears(int years)
Returns a new datetime minus the specified number of years. |
DateTime.Property |
minuteOfDay()
Get the minute of day property |
DateTime.Property |
minuteOfHour()
Get the minute of hour field property |
DateTime.Property |
monthOfYear()
Get the month of year property. |
DateTime |
plus(long duration)
Gets a copy of this datetime with the specified duration added. |
DateTime |
plus(ReadableDuration duration)
Gets a copy of this datetime with the specified duration added. |
DateTime |
plus(ReadablePeriod period)
Gets a copy of this datetime with the specified period added. |
DateTime |
plusDays(int days)
Returns a new datetime plus the specified number of days. |
DateTime |
plusHours(int hours)
Returns a new datetime plus the specified number of hours. |
DateTime |
plusMillis(int millis)
Returns a new datetime plus the specified number of millis. |
DateTime |
plusMinutes(int minutes)
Returns a new datetime plus the specified number of minutes. |
DateTime |
plusMonths(int months)
Returns a new datetime plus the specified number of months. |
DateTime |
plusSeconds(int seconds)
Returns a new datetime plus the specified number of seconds. |
DateTime |
plusWeeks(int weeks)
Returns a new datetime plus the specified number of weeks. |
DateTime |
plusYears(int years)
Returns a new datetime plus the specified number of years. |
DateTime.Property |
property(DateTimeFieldType type)
Gets the property object for the specified type, which contains many useful methods. |
DateTime.Property |
secondOfDay()
Get the second of day property |
DateTime.Property |
secondOfMinute()
Get the second of minute field property |
DateMidnight |
toDateMidnight()
Converts this object to a DateMidnight using the same millis and chronology. |
DateTime |
toDateTime()
Get this object as a DateTime by returning this . |
DateTime |
toDateTime(Chronology chronology)
Get this object as a DateTime, returning this if possible. |
DateTime |
toDateTime(DateTimeZone zone)
Get this object as a DateTime, returning this if possible. |
DateTime |
toDateTimeISO()
Get this object as a DateTime using ISOChronology in the default zone, returning this if possible. |
TimeOfDay |
toTimeOfDay()
Converts this object to a TimeOfDay using the same millis and chronology. |
YearMonthDay |
toYearMonthDay()
Converts this object to a YearMonthDay using the same millis and chronology. |
DateTime.Property |
weekOfWeekyear()
Get the week of a week based year property. |
DateTime.Property |
weekyear()
Get the year of a week based year property. |
DateTime |
withChronology(Chronology newChronology)
Gets a copy of this datetime with a different chronology. |
DateTime |
withDate(int year,
int monthOfYear,
int dayOfMonth)
Gets a copy of this datetime with the specified date, retaining the time fields. |
DateTime |
withDurationAdded(long durationToAdd,
int scalar)
Gets a copy of this datetime with the specified duration added. |
DateTime |
withDurationAdded(ReadableDuration durationToAdd,
int scalar)
Gets a copy of this datetime with the specified duration added. |
DateTime |
withField(DateTimeFieldType fieldType,
int value)
Gets a copy of this datetime with the specified field set to a new value. |
DateTime |
withFieldAdded(DurationFieldType fieldType,
int amount)
Gets a copy of this datetime with the value of the specified field increased. |
DateTime |
withFields(ReadablePartial partial)
Gets a copy of this datetime with the partial set of fields replacing those from this instance. |
DateTime |
withMillis(long newMillis)
Gets a copy of this datetime with different millis. |
DateTime |
withPeriodAdded(ReadablePeriod period,
int scalar)
Gets a copy of this datetime with the specified period added. |
DateTime |
withTime(int hourOfDay,
int minuteOfHour,
int secondOfMinute,
int millisOfSecond)
Gets a copy of this datetime with the specified time, retaining the date fields. |
DateTime |
withZone(DateTimeZone newZone)
Gets a copy of this datetime with a different time zone, preserving the millisecond instant. |
DateTime |
withZoneRetainFields(DateTimeZone newZone)
Gets a copy of this datetime with a different time zone, preserving the field values. |
DateTime.Property |
year()
Get the year property. |
DateTime.Property |
yearOfCentury()
Get the year of century property. |
DateTime.Property |
yearOfEra()
Get the year of era property. |
Methods inherited from class org.joda.time.base.BaseDateTime |
getChronology, getMillis |
Methods inherited from class org.joda.time.base.AbstractDateTime |
get, getCenturyOfEra, getDayOfMonth, getDayOfWeek, getDayOfYear, getEra, getHourOfDay, getMillisOfDay, getMillisOfSecond, getMinuteOfDay, getMinuteOfHour, getMonthOfYear, getSecondOfDay, getSecondOfMinute, getWeekOfWeekyear, getWeekyear, getYear, getYearOfCentury, getYearOfEra, toCalendar, toGregorianCalendar, toString, toString |
Methods inherited from class org.joda.time.base.AbstractInstant |
compareTo, equals, get, getZone, hashCode, isAfter, isAfter, isAfterNow, isBefore, isBefore, isBeforeNow, isEqual, isEqual, isEqualNow, isSupported, toDate, toInstant, toMutableDateTime, toMutableDateTime, toMutableDateTime, toMutableDateTimeISO, toString, toString |
Methods inherited from class java.lang.Object |
getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.joda.time.ReadableDateTime |
getCenturyOfEra, getDayOfMonth, getDayOfWeek, getDayOfYear, getEra, getHourOfDay, getMillisOfDay, getMillisOfSecond, getMinuteOfDay, getMinuteOfHour, getMonthOfYear, getSecondOfDay, getSecondOfMinute, getWeekOfWeekyear, getWeekyear, getYear, getYearOfCentury, getYearOfEra, toMutableDateTime, toString, toString |
Methods inherited from interface org.joda.time.ReadableInstant |
compareTo, equals, get, getChronology, getMillis, getZone, hashCode, isAfter, isBefore, isEqual, isSupported, toInstant, toString |
Constructor Detail |
public DateTime()
ISOChronology
in the default time zone.
public DateTime(DateTimeZone zone)
ISOChronology
in the specified time zone.
If the specified time zone is null, the default zone is used.
zone
- the time zone, null means default zonepublic DateTime(Chronology chronology)
If the chronology is null, ISOChronology
in the default time zone is used.
chronology
- the chronology, null means ISOChronology in default zonepublic DateTime(long instant)
ISOChronology
in the default time zone.
instant
- the milliseconds from 1970-01-01T00:00:00Zpublic DateTime(long instant, DateTimeZone zone)
ISOChronology
in the specified time zone.
If the specified time zone is null, the default zone is used.
instant
- the milliseconds from 1970-01-01T00:00:00Zzone
- the time zone, null means default zonepublic DateTime(long instant, Chronology chronology)
If the chronology is null, ISOChronology
in the default time zone is used.
instant
- the milliseconds from 1970-01-01T00:00:00Zchronology
- the chronology, null means ISOChronology in default zonepublic DateTime(Object instant)
If the object implies a chronology (such as GregorianCalendar does), then that chronology will be used. Otherwise, ISO default is used. Thus if a GregorianCalendar is passed in, the chronology used will be GJ, but if a Date is passed in the chronology will be ISO.
The recognised object types are defined in
ConverterManager
and
include ReadableInstant, String, Calendar and Date.
instant
- the datetime object, null means now
IllegalArgumentException
- if the instant is invalidpublic DateTime(Object instant, DateTimeZone zone)
If the object implies a chronology (such as GregorianCalendar does), then that chronology will be used, but with the time zone adjusted. Otherwise, ISO is used in the specified time zone. If the specified time zone is null, the default zone is used. Thus if a GregorianCalendar is passed in, the chronology used will be GJ, but if a Date is passed in the chronology will be ISO.
The recognised object types are defined in
ConverterManager
and
include ReadableInstant, String, Calendar and Date.
instant
- the datetime object, null means nowzone
- the time zone, null means default time zone
IllegalArgumentException
- if the instant is invalidpublic DateTime(Object instant, Chronology chronology)
If the chronology is null, ISO in the default time zone is used. Any chronology implied by the object (such as GregorianCalendar does) is ignored.
The recognised object types are defined in
ConverterManager
and
include ReadableInstant, String, Calendar and Date.
instant
- the datetime object, null means nowchronology
- the chronology, null means ISO in default zone
IllegalArgumentException
- if the instant is invalidpublic DateTime(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute, int millisOfSecond)
ISOChronology
in the default time zone.
year
- the yearmonthOfYear
- the month of the yeardayOfMonth
- the day of the monthhourOfDay
- the hour of the dayminuteOfHour
- the minute of the hoursecondOfMinute
- the second of the minutemillisOfSecond
- the millisecond of the secondpublic DateTime(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute, int millisOfSecond, DateTimeZone zone)
ISOChronology
in the specified time zone.
If the specified time zone is null, the default zone is used.
year
- the yearmonthOfYear
- the month of the yeardayOfMonth
- the day of the monthhourOfDay
- the hour of the dayminuteOfHour
- the minute of the hoursecondOfMinute
- the second of the minutemillisOfSecond
- the millisecond of the secondzone
- the time zone, null means default time zonepublic DateTime(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute, int millisOfSecond, Chronology chronology)
If the chronology is null, ISOChronology
in the default time zone is used.
year
- the yearmonthOfYear
- the month of the yeardayOfMonth
- the day of the monthhourOfDay
- the hour of the dayminuteOfHour
- the minute of the hoursecondOfMinute
- the second of the minutemillisOfSecond
- the millisecond of the secondchronology
- the chronology, null means ISOChronology in default zoneMethod Detail |
public DateTime toDateTime()
this
.
toDateTime
in interface ReadableDateTime
toDateTime
in class AbstractInstant
this
public DateTime toDateTimeISO()
this
if possible.
toDateTimeISO
in class AbstractInstant
public DateTime toDateTime(DateTimeZone zone)
this
if possible.
toDateTime
in class AbstractInstant
zone
- time zone to apply, or default if null
public DateTime toDateTime(Chronology chronology)
this
if possible.
toDateTime
in class AbstractInstant
chronology
- chronology to apply, or ISOChronology if null
public DateTime withMillis(long newMillis)
The returned object will be either be a new instance or this
.
Only the millis will change, the chronology and time zone are kept.
newMillis
- the new millis, from 1970-01-01T00:00:00Z
public DateTime withChronology(Chronology newChronology)
The returned object will be either be a new instance or this
.
Only the chronology will change, the millis are kept.
newChronology
- the new chronology, null means ISO default
public DateTime withZone(DateTimeZone newZone)
This method is useful for finding the local time in another timezone. For example, if this instant holds 12:30 in Europe/London, the result from this method with Europe/Paris would be 13:30.
The returned object will be a new instance of the same implementation type.
This method changes the time zone, and does not change the
millisecond instant, with the effect that the field values usually change.
The returned object will be either be a new instance or this
.
newZone
- the new time zone
withZoneRetainFields(org.joda.time.DateTimeZone)
public DateTime withZoneRetainFields(DateTimeZone newZone)
This method is useful for finding the millisecond time in another timezone. For example, if this instant holds 12:30 in Europe/London (ie. 12:30Z), the result from this method with Europe/Paris would be 12:30 (ie. 11:30Z).
The returned object will be a new instance of the same implementation type.
This method changes the time zone and the millisecond instant to keep
the field values the same.
The returned object will be either be a new instance or this
.
newZone
- the new time zone, null means default
withZone(org.joda.time.DateTimeZone)
public DateTime withDate(int year, int monthOfYear, int dayOfMonth)
If the date is already the date passed in, then this
is returned.
To set a single field use the properties, for example:
DateTime set = monthOfYear().setCopy(6);
year
- the new year valuemonthOfYear
- the new monthOfYear valuedayOfMonth
- the new dayOfMonth value
IllegalArgumentException
- if any value if invalidpublic DateTime withTime(int hourOfDay, int minuteOfHour, int secondOfMinute, int millisOfSecond)
If the time is already the time passed in, then this
is returned.
To set a single field use the properties, for example:
DateTime set = dt.hourOfDay().setCopy(6);
hourOfDay
- the hour of the dayminuteOfHour
- the minute of the hoursecondOfMinute
- the second of the minutemillisOfSecond
- the millisecond of the second
IllegalArgumentException
- if any value if invalidpublic DateTime withFields(ReadablePartial partial)
For example, if the partial is a TimeOfDay
then the time fields
would be changed in the returned instance.
If the partial is null, then this
is returned.
partial
- the partial set of fields to apply to this datetime, null ignored
IllegalArgumentException
- if any value is invalidpublic DateTime withField(DateTimeFieldType fieldType, int value)
For example, if the field type is hourOfDay
then the hour of day
field would be changed in the returned instance.
If the field type is null, then this
is returned.
These three lines are equivalent:
DateTime updated = dt.withField(DateTimeFieldType.dayOfMonth(), 6); DateTime updated = dt.dayOfMonth().setCopy(6); DateTime updated = dt.property(DateTimeFieldType.dayOfMonth()).setCopy(6);
fieldType
- the field type to set, not nullvalue
- the value to set
IllegalArgumentException
- if the value is null or invalidpublic DateTime withFieldAdded(DurationFieldType fieldType, int amount)
If the addition is zero or the field is null, then this
is returned.
These three lines are equivalent:
DateTime added = dt.withFieldAdded(DurationFieldType.years(), 6); DateTime added = dt.plusYears(6); DateTime added = dt.plus(Period.years(6));
fieldType
- the field type to add to, not nullamount
- the amount to add
IllegalArgumentException
- if the value is null or invalid
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime withDurationAdded(long durationToAdd, int scalar)
If the addition is zero, then this
is returned.
durationToAdd
- the duration to add to this onescalar
- the amount of times to add, such as -1 to subtract once
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime withDurationAdded(ReadableDuration durationToAdd, int scalar)
If the addition is zero, then this
is returned.
durationToAdd
- the duration to add to this one, null means zeroscalar
- the amount of times to add, such as -1 to subtract once
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime withPeriodAdded(ReadablePeriod period, int scalar)
If the addition is zero, then this
is returned.
This method is typically used to add multiple copies of complex
period instances. Adding one field is best achieved using methods
like withFieldAdded(DurationFieldType, int)
or plusYears(int)
.
period
- the period to add to this one, null means zeroscalar
- the amount of times to add, such as -1 to subtract once
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime plus(long duration)
If the amount is zero or null, then this
is returned.
duration
- the duration, in millis, to add to this one
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime plus(ReadableDuration duration)
If the amount is zero or null, then this
is returned.
duration
- the duration to add to this one, null means zero
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime plus(ReadablePeriod period)
If the amount is zero or null, then this
is returned.
This method is typically used to add complex period instances.
Adding one field is best achieved using methods
like plusYears(int)
.
period
- the duration to add to this one, null means zero
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime plusYears(int years)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusYears(6); DateTime added = dt.plus(Period.years(6)); DateTime added = dt.withFieldAdded(DurationFieldType.years(), 6);
years
- the amount of years to add, may be negative
public DateTime plusMonths(int months)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusMonths(6); DateTime added = dt.plus(Period.months(6)); DateTime added = dt.withFieldAdded(DurationFieldType.months(), 6);
months
- the amount of months to add, may be negative
public DateTime plusWeeks(int weeks)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusWeeks(6); DateTime added = dt.plus(Period.weeks(6)); DateTime added = dt.withFieldAdded(DurationFieldType.weeks(), 6);
weeks
- the amount of weeks to add, may be negative
public DateTime plusDays(int days)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusDays(6); DateTime added = dt.plus(Period.days(6)); DateTime added = dt.withFieldAdded(DurationFieldType.days(), 6);
days
- the amount of days to add, may be negative
public DateTime plusHours(int hours)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusHours(6); DateTime added = dt.plus(Period.hours(6)); DateTime added = dt.withFieldAdded(DurationFieldType.hours(), 6);
hours
- the amount of hours to add, may be negative
public DateTime plusMinutes(int minutes)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusMinutes(6); DateTime added = dt.plus(Period.minutes(6)); DateTime added = dt.withFieldAdded(DurationFieldType.minutes(), 6);
minutes
- the amount of minutes to add, may be negative
public DateTime plusSeconds(int seconds)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusSeconds(6); DateTime added = dt.plus(Period.seconds(6)); DateTime added = dt.withFieldAdded(DurationFieldType.seconds(), 6);
seconds
- the amount of seconds to add, may be negative
public DateTime plusMillis(int millis)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime added = dt.plusMillis(6); DateTime added = dt.plus(Period.millis(6)); DateTime added = dt.withFieldAdded(DurationFieldType.millis(), 6);
millis
- the amount of millis to add, may be negative
public DateTime minus(long duration)
If the amount is zero or null, then this
is returned.
duration
- the duration, in millis, to reduce this instant by
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime minus(ReadableDuration duration)
If the amount is zero or null, then this
is returned.
duration
- the duration to reduce this instant by
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime minus(ReadablePeriod period)
If the amount is zero or null, then this
is returned.
This method is typically used to subtract complex period instances.
Subtracting one field is best achieved using methods
like minusYears(int)
.
period
- the period to reduce this instant by
ArithmeticException
- if the new datetime exceeds the capacity of a longpublic DateTime minusYears(int years)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusYears(6); DateTime subtracted = dt.minus(Period.years(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.years(), -6);
years
- the amount of years to subtract, may be negative
public DateTime minusMonths(int months)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusMonths(6); DateTime subtracted = dt.minus(Period.months(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.months(), -6);
months
- the amount of months to subtract, may be negative
public DateTime minusWeeks(int weeks)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusWeeks(6); DateTime subtracted = dt.minus(Period.weeks(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.weeks(), -6);
weeks
- the amount of weeks to subtract, may be negative
public DateTime minusDays(int days)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusDays(6); DateTime subtracted = dt.minus(Period.days(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.days(), -6);
days
- the amount of days to subtract, may be negative
public DateTime minusHours(int hours)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusHours(6); DateTime subtracted = dt.minus(Period.hours(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.hours(), -6);
hours
- the amount of hours to subtract, may be negative
public DateTime minusMinutes(int minutes)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusMinutes(6); DateTime subtracted = dt.minus(Period.minutes(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.minutes(), -6);
minutes
- the amount of minutes to subtract, may be negative
public DateTime minusSeconds(int seconds)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusSeconds(6); DateTime subtracted = dt.minus(Period.seconds(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.seconds(), -6);
seconds
- the amount of seconds to subtract, may be negative
public DateTime minusMillis(int millis)
This datetime instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
DateTime subtracted = dt.minusMillis(6); DateTime subtracted = dt.minus(Period.millis(6)); DateTime subtracted = dt.withFieldAdded(DurationFieldType.millis(), -6);
millis
- the amount of millis to subtract, may be negative
public DateTime.Property property(DateTimeFieldType type)
type
- the field type to get the chronology for
IllegalArgumentException
- if the field is null or unsupportedpublic DateMidnight toDateMidnight()
public YearMonthDay toYearMonthDay()
public TimeOfDay toTimeOfDay()
public DateTime.Property era()
public DateTime.Property centuryOfEra()
public DateTime.Property yearOfCentury()
public DateTime.Property yearOfEra()
public DateTime.Property year()
public DateTime.Property weekyear()
public DateTime.Property monthOfYear()
public DateTime.Property weekOfWeekyear()
public DateTime.Property dayOfYear()
public DateTime.Property dayOfMonth()
public DateTime.Property dayOfWeek()
public DateTime.Property hourOfDay()
public DateTime.Property minuteOfDay()
public DateTime.Property minuteOfHour()
public DateTime.Property secondOfDay()
public DateTime.Property secondOfMinute()
public DateTime.Property millisOfDay()
public DateTime.Property millisOfSecond()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |