Module com.aoapps.lang
Package com.aoapps.lang.time

Class Instant

java.lang.Object
com.aoapps.lang.time.Instant
All Implemented Interfaces:
Serializable, Comparable<Instant>
@Deprecated public class Instant extends Object implements Comparable<Instant>, Serializable
Deprecated.
Please use standard Java 8 classes.
Wraps the number of seconds from the Epoch as well as positive nanoseconds into an immutable value type.

This will be deprecated once Java 8 is ubiquitous and only serves as an extremely simplified stop-gap.

Author:
AO Industries, Inc.
See Also:

  • Field Details

    • EPOCH

      public static final Instant EPOCH
      Deprecated.

  • Constructor Details

    • Instant

      public Instant(long epochSecond, int nano)
      Deprecated.

  • Method Details

    • valueOf

      public static Instant valueOf(String s)
      Deprecated.
      Parses an Instant's string representation.
      Returns:
      Instant the instant or null when toString is null
      Throws:
      IllegalArgumentException - when unable to parse

    • readResolve

      protected Object readResolve()
      Deprecated.

    • toString

      public String toString()
      Deprecated.
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object obj)
      Deprecated.
      Overrides:
      equals in class Object

    • equals

      public boolean equals(Instant other)
      Deprecated.

    • hashCode

      public int hashCode()
      Deprecated.
      Overrides:
      hashCode in class Object

    • compareTo

      public int compareTo(Instant other)
      Deprecated.
      Specified by:
      compareTo in interface Comparable<Instant>

    • getEpochSecond

      public long getEpochSecond()
      Deprecated.

    • getNano

      public int getNano()
      Deprecated.

      The nanoseconds, to simplify this is always in the positive direction. For negative instants, this means the nanos goes up from zero to 1 billion, then the seconds go up one (toward zero). This may be counterintuitive if one things of nanoseconds as a fractional part of seconds, but this definition leads to a very clean implementation.

      Counting up by nanoseconds:

      1. -1.999999998
      2. -1.999999999
      3. 0.000000000
      4. 0.000000001
      5. 0.000000002

    • plusNanos

      public Instant plusNanos(long nanosToAdd)
      Deprecated.