Interface TimeProvider
-
- All Known Subinterfaces:
DateTimeProvider
- All Known Implementing Classes:
LocalDateTime,LocalTime,OffsetDateTime,OffsetTime,ZonedDateTime
public interface TimeProviderProvides access to a time in the ISO-8601 calendar system.TimeProvider is a simple interface that provides uniform access to any object that can provide access to a time in the ISO-8601 calendar system.
The implementation of
TimeProvidermay be mutable. For example,GregorianCalendaris a mutable implementation of this interface. The result oftoLocalTime(), however, is immutable.When implementing an API that accepts a TimeProvider as a parameter, it is important to convert the input to a
LocalTimeonce and once only. It is recommended that this is done at the top of the method before other processing. This is necessary to handle the case where the implementation of the provider is mutable and changes in value between two calls totoLocalTime().The recommended way to convert a TimeProvider to a LocalTime is using
LocalTime.of(TimeProvider)as this method provides additional null checking.It is recommended that this interface should only be implemented by classes that provide time information to at least minute precision.
The implementation of
TimeProvidermay provide more information than just a time. For example,OffsetTime, implements this interface and also provides a zone offset.TimeProvider makes no guarantees about the thread-safety or immutability of implementations.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description LocalTimetoLocalTime()Returns an instance ofLocalTimeinitialized from the state of this object.
-
-
-
Method Detail
-
toLocalTime
LocalTime toLocalTime()
Returns an instance ofLocalTimeinitialized from the state of this object.This method will take the time represented by this object and return a
LocalTimeconstructed using the hour, minute, second and nanosecond. If this object is already aLocalTimethen it is simply returned.If this object does not support nanosecond precision, then all fields below the precision it does support must be set to zero. For example, if this instance only stores hours, minutes and seconds, then the nanoseconds part will be set to zero.
The result of this method is a
LocalTimewhich represents a time in the ISO calendar system. Implementors may perform conversion when implementing this method to convert from alternate calendar systems.- Returns:
- the
LocalTimeequivalent to this object, never null - Throws:
CalendricalException- if the time cannot be converted
-
-