Class Minute

All Implemented Interfaces:
Serializable, Comparable, TimePeriod, org.jfree.date.MonthConstants

public class Minute
extends RegularTimePeriod
implements Serializable
Represents a minute.

This class is immutable, which is a requirement for all RegularTimePeriod subclasses.

See Also:
Serialized Form
  • Field Details

    • FIRST_MINUTE_IN_HOUR

      public static final int FIRST_MINUTE_IN_HOUR
      Useful constant for the first minute in a day.
      See Also:
      Constant Field Values
    • LAST_MINUTE_IN_HOUR

      public static final int LAST_MINUTE_IN_HOUR
      Useful constant for the last minute in a day.
      See Also:
      Constant Field Values
  • Constructor Details

    • Minute

      public Minute()
      Constructs a new Minute, based on the system date/time.
    • Minute

      public Minute​(int minute, Hour hour)
      Constructs a new Minute.
      Parameters:
      minute - the minute (0 to 59).
      hour - the hour.
    • Minute

      public Minute​(Date time)
      Constructs a new Minute, based on the supplied date/time.
      Parameters:
      time - the time.
    • Minute

      public Minute​(Date time, TimeZone zone)
      Constructs a new Minute, based on the supplied date/time and timezone.
      Parameters:
      time - the time.
      zone - the time zone.
    • Minute

      public Minute​(int minute, int hour, int day, int month, int year)
      Creates a new minute.
      Parameters:
      minute - the minute (0-59).
      hour - the hour (0-23).
      day - the day (1-31).
      month - the month (1-12).
      year - the year (1900-9999).
  • Method Details

    • getHour

      public Hour getHour()
      Returns the hour.
      Returns:
      the hour.
    • getMinute

      public int getMinute()
      Returns the minute.
      Returns:
      the minute.
    • previous

      public RegularTimePeriod previous()
      Returns the minute preceding this one.
      Specified by:
      previous in class RegularTimePeriod
      Returns:
      the minute preceding this one.
    • next

      public RegularTimePeriod next()
      Returns the minute following this one.
      Specified by:
      next in class RegularTimePeriod
      Returns:
      the minute following this one.
    • getSerialIndex

      public long getSerialIndex()
      Returns a serial index number for the minute.
      Specified by:
      getSerialIndex in class RegularTimePeriod
      Returns:
      the serial index number.
    • getFirstMillisecond

      public long getFirstMillisecond​(Calendar calendar)
      Returns the first millisecond of the minute.
      Specified by:
      getFirstMillisecond in class RegularTimePeriod
      Parameters:
      calendar - the calendar and timezone.
      Returns:
      the first millisecond.
    • getLastMillisecond

      public long getLastMillisecond​(Calendar calendar)
      Returns the last millisecond of the minute.
      Specified by:
      getLastMillisecond in class RegularTimePeriod
      Parameters:
      calendar - the calendar and timezone.
      Returns:
      the last millisecond.
    • equals

      public boolean equals​(Object object)
      Tests the equality of this object against an arbitrary Object.

      This method will return true ONLY if the object is a Minute object representing the same minute as this instance.

      Overrides:
      equals in class Object
      Parameters:
      object - the object to compare.
      Returns:
      true if the minute and hour value of this and the object are the same.
    • hashCode

      public int hashCode()
      Returns a hash code for this object instance.

      The approach described by Joshua Bloch in "Effective Java" has been used here:

      http://developer.java.sun.com/developer/Books/effectivejava/Chapter3.pdf

      Overrides:
      hashCode in class Object
      Returns:
      A hash code.
    • compareTo

      public int compareTo​(Object o1)
      Returns an integer indicating the order of this Minute object relative to the specified object: negative == before, zero == same, positive == after.
      Specified by:
      compareTo in interface Comparable
      Parameters:
      o1 - object to compare.
      Returns:
      negative == before, zero == same, positive == after.
    • parseMinute

      public static Minute parseMinute​(String s)
      Creates a Minute instance by parsing a string. The string is assumed to be in the format "YYYY-MM-DD HH:MM", perhaps with leading or trailing whitespace.
      Parameters:
      s - the minute string to parse.
      Returns:
      null, if the string is not parseable, the minute otherwise.