java.lang.Object | |||
↳ | org.joda.time.base.AbstractPartial | ||
↳ | org.joda.time.base.BasePartial | ||
↳ | org.joda.time.TimeOfDay |
This class is deprecated.
Use LocalTime which has a much better internal implementation and
has been available since 1.3
TimeOfDay is an immutable partial supporting the hour, minute, second and millisecond fields.
NOTE: This class only supports the four fields listed above. Thus, you
cannot query the millisOfDay or secondOfDay fields for example.
The new LocalTime
class removes this restriction.
Calculations on TimeOfDay are performed using a Chronology
.
This chronology is set to be in the UTC time zone for all calculations.
Each individual field can be queried in two ways:
getHourOfDay()
hourOfDay().get()
hourOfDay().get()
hourOfDay().getAsText()
hourOfDay().getAsShortText()
hourOfDay().getMaximumValue()
hourOfDay().addToCopy()
hourOfDay().setCopy()
TimeOfDay is thread-safe and immutable, provided that the Chronology is as well. All standard Chronology classes supplied are thread-safe and immutable.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
TimeOfDay.Property | This class is deprecated. Use LocalTime which has a much better internal implementation |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | HOUR_OF_DAY | The index of the hourOfDay field in the field array | |||||||||
int | MILLIS_OF_SECOND | The index of the millisOfSecond field in the field array | |||||||||
int | MINUTE_OF_HOUR | The index of the minuteOfHour field in the field array | |||||||||
int | SECOND_OF_MINUTE | The index of the secondOfMinute field in the field array |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
MIDNIGHT | Constant for midnight. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a TimeOfDay with the current time, using ISOChronology in
the default zone to extract the fields.
| |||||||||||
Constructs a TimeOfDay with the current time, using ISOChronology in
the specified zone to extract the fields.
| |||||||||||
Constructs a TimeOfDay with the current time, using the specified chronology
and zone to extract the fields.
| |||||||||||
Constructs a TimeOfDay extracting the partial fields from the specified
milliseconds using the ISOChronology in the default zone.
| |||||||||||
Constructs a TimeOfDay extracting the partial fields from the specified
milliseconds using the chronology provided.
| |||||||||||
Constructs a TimeOfDay from an Object that represents a time.
| |||||||||||
Constructs a TimeOfDay from an Object that represents a time, using the
specified chronology.
| |||||||||||
Constructs a TimeOfDay with specified hour and minute and zero seconds and milliseconds
using
ISOChronology in the default zone. | |||||||||||
Constructs a TimeOfDay with specified hour and minute and zero seconds and milliseconds.
| |||||||||||
Constructs a TimeOfDay with specified time field values and zero milliseconds
using
ISOChronology in the default zone. | |||||||||||
Constructs a TimeOfDay with specified time field values and zero milliseconds.
| |||||||||||
Constructs a TimeOfDay with specified time field values using
ISOChronology in the default zone. | |||||||||||
Constructs a TimeOfDay with specified time field values and chronology.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a TimeOfDay from a
java.util.Calendar
using exactly the same field values avoiding any time zone effects. | |||||||||||
Constructs a TimeOfDay from a
java.util.Date
using exactly the same field values avoiding any time zone effects. | |||||||||||
Constructs a TimeOfDay from the specified millis of day using the
specified chronology.
| |||||||||||
Constructs a TimeOfDay from the specified millis of day using the
ISO chronology.
| |||||||||||
Gets the field type at the specified index.
| |||||||||||
Gets an array of the field type of each of the fields that this partial supports.
| |||||||||||
Get the hour of day (0-23) field value.
| |||||||||||
Get the millis of second field value.
| |||||||||||
Get the minute of hour field value.
| |||||||||||
Get the second of minute field value.
| |||||||||||
Get the hour of day field property which provides access to advanced functionality.
| |||||||||||
Get the millis of second property which provides access to advanced functionality.
| |||||||||||
Returns a copy of this time with the specified period taken away,
wrapping to what would be a new day if required.
| |||||||||||
Returns a copy of this time minus the specified number of hours.
| |||||||||||
Returns a copy of this time minus the specified number of millis.
| |||||||||||
Returns a copy of this time minus the specified number of minutes.
| |||||||||||
Returns a copy of this time minus the specified number of seconds.
| |||||||||||
Get the minute of hour field property which provides access to advanced functionality.
| |||||||||||
Returns a copy of this time with the specified period added,
wrapping to what would be a new day if required.
| |||||||||||
Returns a copy of this time plus the specified number of hours.
| |||||||||||
Returns a copy of this time plus the specified number of millis.
| |||||||||||
Returns a copy of this time plus the specified number of minutes.
| |||||||||||
Returns a copy of this time plus the specified number of seconds.
| |||||||||||
Gets the property object for the specified type, which contains
many useful methods.
| |||||||||||
Get the second of minute field property which provides access to advanced functionality.
| |||||||||||
Gets the number of fields in this partial.
| |||||||||||
Converts this partial to a full datetime using the specified time zone
setting the time fields from this instance and the date fields from
the current time.
| |||||||||||
Converts this partial to a full datetime using the default time zone
setting the time fields from this instance and the date fields from
the current time.
| |||||||||||
Converts this object to a LocalTime with the same time and chronology.
| |||||||||||
Output the time in the ISO8601 format THH:mm:ss.SSS.
| |||||||||||
Returns a copy of this time with the specified chronology.
| |||||||||||
Returns a copy of this time with the specified field set to a new value.
| |||||||||||
Returns a copy of this time with the value of the specified field increased,
wrapping to what would be a new day if required.
| |||||||||||
Returns a copy of this time with the hour of day field updated.
| |||||||||||
Returns a copy of this time with the millis of second field updated.
| |||||||||||
Returns a copy of this time with the minute of hour field updated.
| |||||||||||
Returns a copy of this time with the specified period added,
wrapping to what would be a new day if required.
| |||||||||||
Returns a copy of this time with the second of minute field updated.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Gets the field for a specific index in the chronology specified.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.joda.time.base.BasePartial
| |||||||||||
From class
org.joda.time.base.AbstractPartial
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.lang.Comparable
| |||||||||||
From interface
org.joda.time.ReadablePartial
|
The index of the hourOfDay field in the field array
The index of the millisOfSecond field in the field array
The index of the minuteOfHour field in the field array
The index of the secondOfMinute field in the field array
Constructs a TimeOfDay with the current time, using ISOChronology in the default zone to extract the fields.
The constructor uses the default time zone, resulting in the local time being initialised. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
Constructs a TimeOfDay with the current time, using ISOChronology in the specified zone to extract the fields.
The constructor uses the specified time zone to obtain the current time. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
zone | the zone to use, null means default zone |
---|
Constructs a TimeOfDay with the current time, using the specified chronology and zone to extract the fields.
The constructor uses the time zone of the chronology specified. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
chronology | the chronology, null means ISOChronology in the default zone |
---|
Constructs a TimeOfDay extracting the partial fields from the specified milliseconds using the ISOChronology in the default zone.
The constructor uses the default time zone, resulting in the local time being initialised. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
instant | the milliseconds from 1970-01-01T00:00:00Z |
---|
Constructs a TimeOfDay extracting the partial fields from the specified milliseconds using the chronology provided.
The constructor uses the time zone of the chronology specified. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
instant | the milliseconds from 1970-01-01T00:00:00Z |
---|---|
chronology | the chronology, null means ISOChronology in the default zone |
Constructs a TimeOfDay from an Object that represents a time.
The recognised object types are defined in
ConverterManager
and
include ReadableInstant, String, Calendar and Date.
The String formats are described by timeParser()
.
The chronology used will be derived from the object, defaulting to ISO.
NOTE: Prior to v1.3 the string format was described by
dateTimeParser()
. Dates are now rejected.
instant | the datetime object, null means now |
---|
IllegalArgumentException | if the instant is invalid |
---|
Constructs a TimeOfDay from an Object that represents a time, using the specified chronology.
The recognised object types are defined in
ConverterManager
and
include ReadableInstant, String, Calendar and Date.
The String formats are described by timeParser()
.
The constructor uses the time zone of the chronology specified. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC). The specified chronology overrides that of the object.
NOTE: Prior to v1.3 the string format was described by
dateTimeParser()
. Dates are now rejected.
instant | the datetime object, null means now |
---|---|
chronology | the chronology, null means ISO default |
IllegalArgumentException | if the instant is invalid |
---|
Constructs a TimeOfDay with specified hour and minute and zero seconds and milliseconds
using ISOChronology
in the default zone.
The constructor uses the no time zone initialising the fields as provided. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
hourOfDay | the hour of the day |
---|---|
minuteOfHour | the minute of the hour |
Constructs a TimeOfDay with specified hour and minute and zero seconds and milliseconds.
The constructor uses the time zone of the chronology specified. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
hourOfDay | the hour of the day |
---|---|
minuteOfHour | the minute of the hour |
chronology | the chronology, null means ISOChronology in the default zone |
Constructs a TimeOfDay with specified time field values and zero milliseconds
using ISOChronology
in the default zone.
The constructor uses the no time zone initialising the fields as provided. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
hourOfDay | the hour of the day |
---|---|
minuteOfHour | the minute of the hour |
secondOfMinute | the second of the minute |
Constructs a TimeOfDay with specified time field values and zero milliseconds.
The constructor uses the time zone of the chronology specified. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
hourOfDay | the hour of the day |
---|---|
minuteOfHour | the minute of the hour |
secondOfMinute | the second of the minute |
chronology | the chronology, null means ISOChronology in the default zone |
Constructs a TimeOfDay with specified time field values using
ISOChronology
in the default zone.
The constructor uses the no time zone initialising the fields as provided. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
hourOfDay | the hour of the day |
---|---|
minuteOfHour | the minute of the hour |
secondOfMinute | the second of the minute |
millisOfSecond | the millisecond of the second |
Constructs a TimeOfDay with specified time field values and chronology.
The constructor uses the time zone of the chronology specified. Once the constructor is complete, all further calculations are performed without reference to a timezone (by switching to UTC).
hourOfDay | the hour of the day |
---|---|
minuteOfHour | the minute of the hour |
secondOfMinute | the second of the minute |
millisOfSecond | the millisecond of the second |
chronology | the chronology, null means ISOChronology in the default zone |
Constructs a TimeOfDay from a java.util.Calendar
using exactly the same field values avoiding any time zone effects.
Each field is queried from the Calendar and assigned to the TimeOfDay. This is useful to ensure that the field values are the same in the created TimeOfDay no matter what the time zone is. For example, if the Calendar states that the time is 04:29, then the created TimeOfDay will always have the time 04:29 irrespective of time zone issues.
This factory method ignores the type of the calendar and always creates a TimeOfDay with ISO chronology.
calendar | the Calendar to extract fields from |
---|
IllegalArgumentException | if the calendar is null |
---|---|
IllegalArgumentException | if the time is invalid for the ISO chronology |
Constructs a TimeOfDay from a java.util.Date
using exactly the same field values avoiding any time zone effects.
Each field is queried from the Date and assigned to the TimeOfDay. This is useful to ensure that the field values are the same in the created TimeOfDay no matter what the time zone is. For example, if the Calendar states that the time is 04:29, then the created TimeOfDay will always have the time 04:29 irrespective of time zone issues.
This factory method always creates a TimeOfDay with ISO chronology.
date | the Date to extract fields from |
---|
IllegalArgumentException | if the calendar is null |
---|---|
IllegalArgumentException | if the date is invalid for the ISO chronology |
Constructs a TimeOfDay from the specified millis of day using the specified chronology.
The millisOfDay value may exceed the number of millis in one day, but additional days will be ignored. This method uses the UTC time zone internally.
millisOfDay | the number of milliseconds into a day to convert |
---|---|
chrono | the chronology, null means ISO chronology |
Constructs a TimeOfDay from the specified millis of day using the ISO chronology.
The millisOfDay value may exceed the number of millis in one day, but additional days will be ignored. This method uses the UTC time zone internally.
millisOfDay | the number of milliseconds into a day to convert |
---|
Gets the field type at the specified index.
index | the index to retrieve |
---|
IndexOutOfBoundsException | if the index is invalid |
---|
Gets an array of the field type of each of the fields that this partial supports.
The fields are returned largest to smallest, Hour, Minute, Second, Millis.
Get the hour of day (0-23) field value.
Get the millis of second field value.
Get the minute of hour field value.
Get the second of minute field value.
Get the hour of day field property which provides access to advanced functionality.
Get the millis of second property which provides access to advanced functionality.
Returns a copy of this time with the specified period taken away, wrapping to what would be a new day if required.
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 minusHours(int)
.
period | the period to reduce this instant by |
---|
ArithmeticException | if the new time exceeds capacity |
---|
Returns a copy of this time minus the specified number of hours.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay subtracted = dt.minusHours(6); TimeOfDay subtracted = dt.minus(Period.hours(6)); TimeOfDay subtracted = dt.withFieldAdded(DurationFieldType.hours(), -6);
hours | the amount of hours to subtract, may be negative |
---|
Returns a copy of this time minus the specified number of millis.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay subtracted = dt.minusMillis(6); TimeOfDay subtracted = dt.minus(Period.millis(6)); TimeOfDay subtracted = dt.withFieldAdded(DurationFieldType.millis(), -6);
millis | the amount of millis to subtract, may be negative |
---|
Returns a copy of this time minus the specified number of minutes.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay subtracted = dt.minusMinutes(6); TimeOfDay subtracted = dt.minus(Period.minutes(6)); TimeOfDay subtracted = dt.withFieldAdded(DurationFieldType.minutes(), -6);
minutes | the amount of minutes to subtract, may be negative |
---|
Returns a copy of this time minus the specified number of seconds.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay subtracted = dt.minusSeconds(6); TimeOfDay subtracted = dt.minus(Period.seconds(6)); TimeOfDay subtracted = dt.withFieldAdded(DurationFieldType.seconds(), -6);
seconds | the amount of seconds to subtract, may be negative |
---|
Get the minute of hour field property which provides access to advanced functionality.
Returns a copy of this time with the specified period added, wrapping to what would be a new day if required.
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 plusHours(int)
.
period | the duration to add to this one, null means zero |
---|
ArithmeticException | if the new datetime exceeds the capacity of a long |
---|
Returns a copy of this time plus the specified number of hours.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay added = dt.plusHours(6); TimeOfDay added = dt.plus(Period.hours(6)); TimeOfDay added = dt.withFieldAdded(DurationFieldType.hours(), 6);
hours | the amount of hours to add, may be negative |
---|
Returns a copy of this time plus the specified number of millis.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay added = dt.plusMillis(6); TimeOfDay added = dt.plus(Period.millis(6)); TimeOfDay added = dt.withFieldAdded(DurationFieldType.millis(), 6);
millis | the amount of millis to add, may be negative |
---|
Returns a copy of this time plus the specified number of minutes.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay added = dt.plusMinutes(6); TimeOfDay added = dt.plus(Period.minutes(6)); TimeOfDay added = dt.withFieldAdded(DurationFieldType.minutes(), 6);
minutes | the amount of minutes to add, may be negative |
---|
Returns a copy of this time plus the specified number of seconds.
This time instance is immutable and unaffected by this method call.
The following three lines are identical in effect:
TimeOfDay added = dt.plusSeconds(6); TimeOfDay added = dt.plus(Period.seconds(6)); TimeOfDay added = dt.withFieldAdded(DurationFieldType.seconds(), 6);
seconds | the amount of seconds to add, may be negative |
---|
Gets the property object for the specified type, which contains many useful methods.
type | the field type to get the property for |
---|
IllegalArgumentException | if the field is null or unsupported |
---|
Get the second of minute field property which provides access to advanced functionality.
Gets the number of fields in this partial.
Converts this partial to a full datetime using the specified time zone setting the time fields from this instance and the date fields from the current time.
This method uses the chronology from this instance plus the time zone specified.
zone | the zone to use, null means default |
---|
Converts this partial to a full datetime using the default time zone setting the time fields from this instance and the date fields from the current time.
Converts this object to a LocalTime with the same time and chronology.
Output the time in the ISO8601 format THH:mm:ss.SSS.
Returns a copy of this time with the specified chronology. This instance is immutable and unaffected by this method call.
This method retains the values of the fields, thus the result will typically refer to a different instant.
The time zone of the specified chronology is ignored, as TimeOfDay operates without a time zone.
newChronology | the new chronology, null means ISO |
---|
IllegalArgumentException | if the values are invalid for the new chronology |
---|
Returns a copy of this time with the specified field set to a new value.
For example, if the field type is minuteOfHour
then the day
would be changed in the returned instance.
These three lines are equivalent:
TimeOfDay updated = tod.withField(DateTimeFieldType.minuteOfHour(), 6); TimeOfDay updated = tod.minuteOfHour().setCopy(6); TimeOfDay updated = tod.property(DateTimeFieldType.minuteOfHour()).setCopy(6);
fieldType | the field type to set, not null |
---|---|
value | the value to set |
IllegalArgumentException | if the value is null or invalid |
---|
Returns a copy of this time with the value of the specified field increased, wrapping to what would be a new day if required.
If the addition is zero, then this
is returned.
These three lines are equivalent:
TimeOfDay added = tod.withFieldAdded(DurationFieldType.minutes(), 6); TimeOfDay added = tod.plusMinutes(6); TimeOfDay added = tod.minuteOfHour().addToCopy(6);
fieldType | the field type to add to, not null |
---|---|
amount | the amount to add |
IllegalArgumentException | if the value is null or invalid |
---|---|
ArithmeticException | if the new datetime exceeds the capacity |
Returns a copy of this time with the hour of day field updated.
TimeOfDay is immutable, so there are no set methods. Instead, this method returns a new instance with the value of hour of day changed.
hour | the hour of day to set |
---|
IllegalArgumentException | if the value is invalid |
---|
Returns a copy of this time with the millis of second field updated.
TimeOfDay is immutable, so there are no set methods. Instead, this method returns a new instance with the value of millis of second changed.
millis | the millis of second to set |
---|
IllegalArgumentException | if the value is invalid |
---|
Returns a copy of this time with the minute of hour field updated.
TimeOfDay is immutable, so there are no set methods. Instead, this method returns a new instance with the value of minute of hour changed.
minute | the minute of hour to set |
---|
IllegalArgumentException | if the value is invalid |
---|
Returns a copy of this time with the specified period added, wrapping to what would be a new day if required.
If the addition is zero, then this
is returned.
Fields in the period that aren't present in the partial are ignored.
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 plusHours(int)
.
period | the period to add to this one, null means zero |
---|---|
scalar | the amount of times to add, such as -1 to subtract once |
ArithmeticException | if the new datetime exceeds the capacity |
---|
Returns a copy of this time with the second of minute field updated.
TimeOfDay is immutable, so there are no set methods. Instead, this method returns a new instance with the value of second of minute changed.
second | the second of minute to set |
---|
IllegalArgumentException | if the value is invalid |
---|
Gets the field for a specific index in the chronology specified.
This method must not use any instance variables.
index | the index to retrieve |
---|---|
chrono | the chronology to use |