query() method of an Instant class used to query this instant using the specified query as parameter.The TemporalQuery object passed as parameter define the logic to be used to obtain the result from this instant.
Syntax:
public <R> R query(TemporalQuery<R> query)
Parameters: This method accepts only one parameter query which is the query to invoke.
Return value: This method returns the query result, null may be returned.
Exception: This method throws following Exceptions:
- DateTimeException – if unable to query .
- ArithmeticException – if numeric overflow occurs.
Below programs illustrate the query() method:
Program 1:
// Java program to demonstrate// Instant.query() method  import java.time.*;import java.time.temporal.*;  public class GFG {    public static void main(String[] args)    {          // create Instant object        Instant instant            = Instant.parse("2018-12-31T10:15:30.00Z");          // apply query method of Instant class        String value            = instant.query(TemporalQueries.precision())                  .toString();          // print the result        System.out.println("Precision value for Instant is "                           + value);    }} |
Output:
Precision value for Instant is Nanos
Program 2: Showing if query did not found the required object then it returns null.
// Java program to demonstrate// Instant.query() method  import java.time.*;import java.time.temporal.*;  public class GFG {    public static void main(String[] args)    {          // create Instant object        Instant instant            = Instant.parse("2018-12-31T10:15:30.00Z");          // apply query method of Instant class        // print the result        System.out.println("Zone value for Instant is "                           + instant.query(TemporalQueries.offset()));    }} |
Output:
Zone value for Instant is null
