Class Timestamp

src/main/java/com/amazon/ion/Timestamp.java:75–2964

An immutable representation of a point in time. Ion defines a simple representation of time based on Coordinated Universal Time (UTC). In practice the use of time could be more accurately described as UTC-SLS (UTC Smoothed Leap Seconds) as there is no representation for the leap second discontinuiti

 * @see #compareTo(Timestamp)
 */
public final class Timestamp
    implements Comparable<Timestamp>, Cloneable
{
    private static final boolean APPLY_OFFSET_YES = true;
    private static final boolean APPLY_OFFSET_NO = false;
    private static final boolean CHECK_FRACTION_YES = true;
    private static final boolean CHECK_FRACTION_NO = false;

    private static final int NO_MONTH = 0;
    private static final int NO_DAY = 0;
    private static final int NO_HOURS = 0;
    private static final int NO_MINUTES = 0;
    private static final int NO_SECONDS = 0;
    private static final BigDecimal NO_FRACTIONAL_SECONDS = null;

    /**
     * 0001-01-01T00:00:00.0Z in millis.
     */
    static final long MINIMUM_TIMESTAMP_IN_MILLIS = -62135769600000L;

    /**
     * 0001-01-01T00:00:00.0Z in millis.
     */
    static final BigDecimal MINIMUM_TIMESTAMP_IN_MILLIS_DECIMAL = new BigDecimal(MINIMUM_TIMESTAMP_IN_MILLIS);

    /**
     * 10000T in millis, upper bound exclusive.
     */
    static final long MAXIMUM_TIMESTAMP_IN_MILLIS = 253402300800000L;

    /**
     * 10000T in millis, upper bound exclusive.
     */
    static final BigDecimal MAXIMUM_ALLOWED_TIMESTAMP_IN_MILLIS_DECIMAL = new BigDecimal(MAXIMUM_TIMESTAMP_IN_MILLIS);


    /**
     * 0001-01-01T00:00:00.0Z epoch seconds.
     */
    static final long MINIMUM_TIMESTAMP_IN_EPOCH_SECONDS = MINIMUM_TIMESTAMP_IN_MILLIS / 1000;

    /**
     * 10000T in epoch seconds, upper bound exclusive.
     */
    static final long MAXIMUM_TIMESTAMP_IN_EPOCH_SECONDS = MAXIMUM_TIMESTAMP_IN_MILLIS / 1000;

    /**
     * Unknown local offset from UTC.
     */
    public static final Integer UNKNOWN_OFFSET = null;

    /**
     * Local offset of zero hours from UTC.
     */
    public static final Integer UTC_OFFSET = Integer.valueOf(0);

    private static final int FLAG_YEAR      = 0x01;
    private static final int FLAG_MONTH     = 0x02;