In this article, we will discuss what are all the Temporal Fields supported by LocalTime using isSupported() method provided in Java 1.8 version
1. LocalTime & TemporalField :
- A field of date-time, such as month-of-year or hour-of-minute
- Date and time is expressed using fields which partition the time-line into something meaningful for humans
- Implementations of this interface represent those fields
- isSupported(TemporalField) – checks if the specified field is supported by invoking LocalTime
- Return true, if supported
- Returns false, if not supported
- There are various methods available in LocalTime which can be used after checking if they are supported by LocalTime
- get(TemporalField) – gets the value of the specified field from invoking LocalTime as an int
- getLong(TemporalField) – gets the value of the specified field from invoking LocalTime as a long
- range(TemporalField) – gets the range of valid values for the specified field
- with(TemporalField, long) – returns a copy of invoking LocalTime with the specified field set to a new value
- Below are the list of Temporal Fields (ChronoField) supported by invoking LocalTime
- NANO_OF_SECOND
- NANO_OF_DAY
- MICRO_OF_SECOND
- MICRO_OF_DAY
- MILLI_OF_SECOND
- MILLI_OF_DAY
- SECOND_OF_MINUTE
- SECOND_OF_DAY
- MINUTE_OF_HOUR
- MINUTE_OF_DAY
- HOUR_OF_AMPM
- CLOCK_HOUR_OF_AMPM
- HOUR_OF_DAY
- CLOCK_HOUR_OF_DAY
- AMPM_OF_DAY
- Below are the list of Temporal Fields (ChronoField) NOT supported by invoking LocalTime
- DAY_OF_WEEK
- ALIGNED_DAY_OF_WEEK_IN_MONTH
- ALIGNED_DAY_OF_WEEK_IN_YEAR
- DAY_OF_MONTH
- DAY_OF_YEAR
- EPOCH_DAY
- ALIGNED_WEEK_OF_MONTH
- ALIGNED_WEEK_OF_YEAR
- MONTH_OF_YEAR
- PROLEPTIC_MONTH
- YEAR_OF_ERA
- YEAR
- ERA
- INSTANT_SECONDS
- OFFSET_SECONDS
- There are 30 enum constants in ChronoField out of which 15 are supported by LocalTime
- Lets see 2 examples covering each of the above ChronoField ENUM constants
2. Examples on LocalTime & TemporalField :
- Temporal Fields supported by LocalTime
- Temporal Fields not supported by LocalTime
2.1 Temporal Fields supported by LocalTime :
- This example covers all the Temporal Fields supported by LocalTime
CheckLocalTimeIsSupportedUsingTemporalField.java
package in.bench.resources.java8.localtime.examples;
import java.time.LocalTime;
import java.time.temporal.ChronoField;
public class CheckLocalTimeIsSupportedUsingTemporalField {
public static void main(String[] args) {
// get current system time
LocalTime localTime = LocalTime.now();
System.out.println("Current system time is = \n" + localTime);
// •NANO_OF_SECOND
// •NANO_OF_DAY
// •MICRO_OF_SECOND
// •MICRO_OF_DAY
// •MILLI_OF_SECOND
// •MILLI_OF_DAY
// •SECOND_OF_MINUTE
// •SECOND_OF_DAY
// •MINUTE_OF_HOUR
// •MINUTE_OF_DAY
// •HOUR_OF_AMPM
// •CLOCK_HOUR_OF_AMPM
// •HOUR_OF_DAY
// •CLOCK_HOUR_OF_DAY
// •AMPM_OF_DAY
// Except above, all other ChronoField instances will return false
// 1. check ChronoField.NANO_OF_SECOND field supported ?
System.out.println("\n1. LocalTime.isSupported(ChronoField.NANO_OF_SECOND) ? " +
localTime.isSupported(ChronoField.NANO_OF_SECOND));
// 2. check ChronoField.NANO_OF_DAY field supported ?
System.out.println("\n2. LocalTime.isSupported(ChronoField.NANO_OF_DAY) ? " +
localTime.isSupported(ChronoField.NANO_OF_DAY));
// 3. check ChronoField.MICRO_OF_SECOND field supported ?
System.out.println("\n3. LocalTime.isSupported(ChronoField.MICRO_OF_SECOND) ? " +
localTime.isSupported(ChronoField.MICRO_OF_SECOND));
// 4. check ChronoField.MICRO_OF_DAY field supported ?
System.out.println("\n4. LocalTime.isSupported(ChronoField.MICRO_OF_DAY) ? " +
localTime.isSupported(ChronoField.MICRO_OF_DAY));
// 5. check ChronoField.MILLI_OF_SECOND field supported ?
System.out.println("\n5. LocalTime.isSupported(ChronoField.MILLI_OF_SECOND) ? " +
localTime.isSupported(ChronoField.MILLI_OF_SECOND));
// 6. check ChronoField.MILLI_OF_DAY field supported ?
System.out.println("\n6. LocalTime.isSupported(ChronoField.MILLI_OF_DAY) ? " +
localTime.isSupported(ChronoField.MILLI_OF_DAY));
// 7. check ChronoField.SECOND_OF_MINUTE field supported ?
System.out.println("\n7. LocalTime.isSupported(ChronoField.SECOND_OF_MINUTE) ? " +
localTime.isSupported(ChronoField.SECOND_OF_MINUTE));
// 8. check ChronoField.SECOND_OF_DAY field supported ?
System.out.println("\n8. LocalTime.isSupported(ChronoField.SECOND_OF_DAY) ? " +
localTime.isSupported(ChronoField.SECOND_OF_DAY));
// 9. check ChronoField.MINUTE_OF_HOUR field supported ?
System.out.println("\n9. LocalTime.isSupported(ChronoField.MINUTE_OF_HOUR) ? " +
localTime.isSupported(ChronoField.MINUTE_OF_HOUR));
// 10. check ChronoField.MINUTE_OF_DAY field supported ?
System.out.println("\n10. LocalTime.isSupported(ChronoField.MINUTE_OF_DAY) ? " +
localTime.isSupported(ChronoField.MINUTE_OF_DAY));
// 11. check ChronoField.HOUR_OF_AMPM field supported ?
System.out.println("\n11. LocalTime.isSupported(ChronoField.HOUR_OF_AMPM) ? " +
localTime.isSupported(ChronoField.HOUR_OF_AMPM));
// 12. check ChronoField.CLOCK_HOUR_OF_AMPM field supported ?
System.out.println("\n12. LocalTime.isSupported(ChronoField.CLOCK_HOUR_OF_AMPM) ? " +
localTime.isSupported(ChronoField.CLOCK_HOUR_OF_AMPM));
// 13. check ChronoField.HOUR_OF_DAY field supported ?
System.out.println("\n13. LocalTime.isSupported(ChronoField.HOUR_OF_DAY) ? " +
localTime.isSupported(ChronoField.HOUR_OF_DAY));
// 14. check ChronoField.CLOCK_HOUR_OF_DAY field supported ?
System.out.println("\n14. LocalTime.isSupported(ChronoField.CLOCK_HOUR_OF_DAY) ? " +
localTime.isSupported(ChronoField.CLOCK_HOUR_OF_DAY));
// 15. check ChronoField.AMPM_OF_DAY field supported ?
System.out.print("\n15. LocalTime.isSupported(ChronoField.AMPM_OF_DAY) ? " +
localTime.isSupported(ChronoField.AMPM_OF_DAY));
}
}
Output:
Current system time is =
18:10:09.709831400
1. LocalTime.isSupported(ChronoField.NANO_OF_SECOND) ? true
2. LocalTime.isSupported(ChronoField.NANO_OF_DAY) ? true
3. LocalTime.isSupported(ChronoField.MICRO_OF_SECOND) ? true
4. LocalTime.isSupported(ChronoField.MICRO_OF_DAY) ? true
5. LocalTime.isSupported(ChronoField.MILLI_OF_SECOND) ? true
6. LocalTime.isSupported(ChronoField.MILLI_OF_DAY) ? true
7. LocalTime.isSupported(ChronoField.SECOND_OF_MINUTE) ? true
8. LocalTime.isSupported(ChronoField.SECOND_OF_DAY) ? true
9. LocalTime.isSupported(ChronoField.MINUTE_OF_HOUR) ? true
10. LocalTime.isSupported(ChronoField.MINUTE_OF_DAY) ? true
11. LocalTime.isSupported(ChronoField.HOUR_OF_AMPM) ? true
12. LocalTime.isSupported(ChronoField.CLOCK_HOUR_OF_AMPM) ? true
13. LocalTime.isSupported(ChronoField.HOUR_OF_DAY) ? true
14. LocalTime.isSupported(ChronoField.CLOCK_HOUR_OF_DAY) ? true
15. LocalTime.isSupported(ChronoField.AMPM_OF_DAY) ? true
2.2 Temporal Fields not supported by LocalTime :
- This example covers Temporal Fields not supported by LocalTime
CheckLocalTimeIsSupportedUsingTemporalField2.java
package in.bench.resources.java8.localtime.examples;
import java.time.LocalTime;
import java.time.temporal.ChronoField;
public class CheckLocalTimeIsSupportedUsingTemporalField2 {
public static void main(String[] args) {
// get current system time
LocalTime localTime = LocalTime.now();
System.out.println("Current system time is = \n" + localTime);
// •DAY_OF_WEEK
// •ALIGNED_DAY_OF_WEEK_IN_MONTH
// •ALIGNED_DAY_OF_WEEK_IN_YEAR
// •DAY_OF_MONTH
// •DAY_OF_YEAR
// •EPOCH_DAY
// •ALIGNED_WEEK_OF_MONTH
// •ALIGNED_WEEK_OF_YEAR
// •MONTH_OF_YEAR
// •PROLEPTIC_MONTH
// •YEAR_OF_ERA
// •YEAR
// •ERA
// •INSTANT_SECONDS
// •OFFSET_SECONDS
// 1. check ChronoField.DAY_OF_WEEK field supported ?
System.out.println("\n1. LocalTime.isSupported(ChronoField.DAY_OF_WEEK) ? " +
localTime.isSupported(ChronoField.DAY_OF_WEEK));
// 2. check ChronoField.ALIGNED_DAY_OF_WEEK_IN_MONTH field supported ?
System.out.println("\n2. LocalTime.isSupported(ChronoField.ALIGNED_DAY_OF_WEEK_IN_MONTH) ? " +
localTime.isSupported(ChronoField.ALIGNED_DAY_OF_WEEK_IN_MONTH));
// 3. check ChronoField.ALIGNED_DAY_OF_WEEK_IN_YEAR field supported ?
System.out.println("\n3. LocalTime.isSupported(ChronoField.ALIGNED_DAY_OF_WEEK_IN_YEAR) ? " +
localTime.isSupported(ChronoField.ALIGNED_DAY_OF_WEEK_IN_YEAR));
// 4. check ChronoField.DAY_OF_MONTH field supported ?
System.out.println("\n4. LocalTime.isSupported(ChronoField.DAY_OF_MONTH) ? " +
localTime.isSupported(ChronoField.DAY_OF_MONTH));
// 5. check ChronoField.DAY_OF_YEAR field supported ?
System.out.println("\n5. LocalTime.isSupported(ChronoField.DAY_OF_YEAR) ? " +
localTime.isSupported(ChronoField.DAY_OF_YEAR));
// 6. check ChronoField.EPOCH_DAY field supported ?
System.out.println("\n6. LocalTime.isSupported(ChronoField.EPOCH_DAY) ? " +
localTime.isSupported(ChronoField.EPOCH_DAY));
// 7. check ChronoField.ALIGNED_WEEK_OF_MONTH field supported ?
System.out.println("\n7. LocalTime.isSupported(ChronoField.ALIGNED_WEEK_OF_MONTH) ? " +
localTime.isSupported(ChronoField.ALIGNED_WEEK_OF_MONTH));
// 8. check ChronoField.ALIGNED_WEEK_OF_YEAR field supported ?
System.out.println("\n8. LocalTime.isSupported(ChronoField.ALIGNED_WEEK_OF_YEAR) ? " +
localTime.isSupported(ChronoField.ALIGNED_WEEK_OF_YEAR));
// 9. check ChronoField.MONTH_OF_YEAR field supported ?
System.out.println("\n9. LocalTime.isSupported(ChronoField.MONTH_OF_YEAR) ? " +
localTime.isSupported(ChronoField.MONTH_OF_YEAR));
// 10. check ChronoField.PROLEPTIC_MONTH field supported ?
System.out.println("\n10. LocalTime.isSupported(ChronoField.PROLEPTIC_MONTH) ? " +
localTime.isSupported(ChronoField.PROLEPTIC_MONTH));
// 11. check ChronoField.YEAR_OF_ERA field supported ?
System.out.println("\n11. LocalTime.isSupported(ChronoField.YEAR_OF_ERA) ? " +
localTime.isSupported(ChronoField.YEAR_OF_ERA));
// 12. check ChronoField.YEAR field supported ?
System.out.println("\n12. LocalTime.isSupported(ChronoField.YEAR) ? " +
localTime.isSupported(ChronoField.YEAR));
// 13. check ChronoField.ERA field supported ?
System.out.println("\n13. LocalTime.isSupported(ChronoField.ERA) ? " +
localTime.isSupported(ChronoField.ERA));
// 14. check ChronoField.INSTANT_SECONDS field supported ?
System.out.println("\n14. LocalTime.isSupported(ChronoField.INSTANT_SECONDS) ? " +
localTime.isSupported(ChronoField.INSTANT_SECONDS));
// 15. check ChronoField.OFFSET_SECONDS field supported ?
System.out.print("\n15. LocalTime.isSupported(ChronoField.OFFSET_SECONDS) ? " +
localTime.isSupported(ChronoField.OFFSET_SECONDS));
}
}
Output:
Current system time is =
09:21:43.524673900
1. LocalTime.isSupported(ChronoField.DAY_OF_WEEK) ? false
2. LocalTime.isSupported(ChronoField.ALIGNED_DAY_OF_WEEK_IN_MONTH) ? false
3. LocalTime.isSupported(ChronoField.ALIGNED_DAY_OF_WEEK_IN_YEAR) ? false
4. LocalTime.isSupported(ChronoField.DAY_OF_MONTH) ? false
5. LocalTime.isSupported(ChronoField.DAY_OF_YEAR) ? false
6. LocalTime.isSupported(ChronoField.EPOCH_DAY) ? false
7. LocalTime.isSupported(ChronoField.ALIGNED_WEEK_OF_MONTH) ? false
8. LocalTime.isSupported(ChronoField.ALIGNED_WEEK_OF_YEAR) ? false
9. LocalTime.isSupported(ChronoField.MONTH_OF_YEAR) ? false
10. LocalTime.isSupported(ChronoField.PROLEPTIC_MONTH) ? false
11. LocalTime.isSupported(ChronoField.YEAR_OF_ERA) ? false
12. LocalTime.isSupported(ChronoField.YEAR) ? false
13. LocalTime.isSupported(ChronoField.ERA) ? false
14. LocalTime.isSupported(ChronoField.INSTANT_SECONDS) ? false
15. LocalTime.isSupported(ChronoField.OFFSET_SECONDS) ? false
Related Articles:
- Java 8 – LocalTime with method details and examples
- Java 8 – How to get Hour, Minute and Second fields from LocalTime ?
- Java 8 – How to form LocalTime passing Hour, Minute and Second fields ?
- Java 8 – How to parse LocalTime in String form ?
- Java 8 – How to convert String to LocalTime ?
- Java 8 – How to convert LocalTime to String ?
- Java 8 – How to convert LocalTime in different formats ?
- Java 8 – How to convert LocalTime in different Format Style ?
- Java 8 – How to convert LocalTime to LocalDateTime ?
- Java 8 – How to convert LocalTime to ZonedDateTime ?
- Java 8 – How to convert LocalTime to an OffsetDateTime ?
- Java 8 – How to convert LocalTime to an Instant ?
- Java 8 – How to convert LocalTime to an OffsetTime ?
- Java 8 – How to convert LocalTime to Seconds and vice-versa ?
- Java 8 – How to convert LocalTime to Nanoseconds and vice-versa ?
- Java 8 – How to convert LocalTime to java.util.Date and vice-versa ?
- Java 8 – How to convert LocalTime to java.sql.Timestamp and vice-versa ?
- Java 8 – How to convert LocalTime to Calendar and vice-versa ?
- Java 8 – How to convert LocalTime to GregorianCalendar and vice-versa ?
- Java 8 – How to convert LocalTime to XMLGregorianCalendar and vice-versa ?
- Java 8 – How to convert java.util.Date to LocalTime in different ways ?
- Java 8 – How to add Hour, Minute and Second fields to LocalTime ?
- Java 8 – How to subtract Hour, Minute and Second fields from LocalTime ?
- Java 8 – How to alter Hour, Minute and Second fields of LocalTime ?
- Java 8 – How to check whether a LocalTime is Before another LocalTime ?
- Java 8 – How to check whether a LocalTime is After another LocalTime ?
- Java 8 – How to compare two LocalTime instances ?
- Java 8 – How to find time duration between two LocalTime instances ?
- Java 8 – What are all the Temporal Fields supported by LocalTime ?
- Java 8 – What are all the Temporal Units supported by LocalTime ?
- Java 9 – Find difference between two LocalTime instances upto nanosecond precision ?
- More Java 8 Date/Time API examples
References:
- https://docs.oracle.com/javase/8/docs/api/java/time/LocalTime.html
- https://docs.oracle.com/javase/8/docs/api/java/time/temporal/ChronoField.html
- https://docs.oracle.com/javase/8/docs/api/java/time/temporal/TemporalField.html
- https://docs.oracle.com/javase/8/docs/api/java/time/temporal/ChronoUnit.html
- https://docs.oracle.com/javase/8/docs/api/java/time/temporal/TemporalUnit.html
Happy Coding !!
Happy Learning !!