Package java.sql

Class Date

java.lang.Object
java.util.Date
java.sql.Date
All Implemented Interfaces:
Serializable, Cloneable, Comparable<Date>
public class Date
extends Date
A class which can consume and produce dates in SQL Date format.

Dates are represented in SQL as yyyy-MM-dd. Note that this date format only deals with year, month and day values. There are no values for hours, minutes, seconds.

This is unlike the familiar java.util.Date object, which also includes values for hours, minutes, seconds, and milliseconds.

Time points are handled as millisecond values - milliseconds since the Epoch, January 1st 1970, 00:00:00.000 GMT. Time values passed to the java.sql.Date class are "normalized" to the time 00:00:00.000 GMT on the date implied by the time value.

See Also:
Serialized Form

  • Constructor Details

    • Date

      @Deprecated public Date​(int theYear, int theMonth, int theDay)
      Deprecated.
      Use the constructor Date(long) instead.
      Constructs a Date object corresponding to the supplied year, month and day.
      Parameters:
      theYear - the year, specified as the year minus 1900. Must be in the range [0,8099].
      theMonth - the month, specified as a number with 0 = January. Must be in the range [0,11].
      theDay - the day in the month. Must be in the range [1,31].

    • Date

      public Date​(long theDate)
      Creates a date which corresponds to the day determined by the supplied milliseconds time value theDate.
      Parameters:
      theDate - a time value in milliseconds since the epoch - January 1 1970 00:00:00 GMT. The time value (hours, minutes, seconds, milliseconds) stored in the Date object is adjusted to correspond to 00:00:00 GMT on the day determined by the supplied time value.

  • Method Details

    • getHours

      @Deprecated public int getHours()
      Deprecated.
      This method is deprecated and must not be used. SQL Date values do not have an hours component.
      Description copied from class: Date
      Returns the gregorian calendar hour of the day for this Date object.
      Overrides:
      getHours in class Date
      Returns:
      does not return anything.
      Throws:
      IllegalArgumentException - if this method is called.

    • getMinutes

      @Deprecated public int getMinutes()
      Deprecated.
      This method is deprecated and must not be used. SQL Date values do not have a minutes component.
      Description copied from class: Date
      Returns the gregorian calendar minute of the hour for this Date object.
      Overrides:
      getMinutes in class Date
      Returns:
      does not return anything.
      Throws:
      IllegalArgumentException - if this method is called.

    • getSeconds

      @Deprecated public int getSeconds()
      Deprecated.
      This method is deprecated and must not be used. SQL Date values do not have a seconds component.
      Description copied from class: Date
      Returns the gregorian calendar second of the minute for this Date object.
      Overrides:
      getSeconds in class Date
      Returns:
      does not return anything.
      Throws:
      IllegalArgumentException - if this method is called.

    • setHours

      @Deprecated public void setHours​(int theHours)
      Deprecated.
      This method is deprecated and must not be used. SQL Date values do not have an hours component.
      Description copied from class: Date
      Sets the gregorian calendar hour of the day for this Date object.
      Overrides:
      setHours in class Date
      Parameters:
      theHours - the number of hours to set.
      Throws:
      IllegalArgumentException - if this method is called.

    • setMinutes

      @Deprecated public void setMinutes​(int theMinutes)
      Deprecated.
      This method is deprecated and must not be used. SQL Date values do not have a minutes component.
      Description copied from class: Date
      Sets the gregorian calendar minute of the hour for this Date object.
      Overrides:
      setMinutes in class Date
      Parameters:
      theMinutes - the number of minutes to set.
      Throws:
      IllegalArgumentException - if this method is called.

    • setSeconds

      @Deprecated public void setSeconds​(int theSeconds)
      Deprecated.
      This method is deprecated and must not be used. SQL Date values do not have a seconds component.
      Description copied from class: Date
      Sets the gregorian calendar second of the minute for this Date object.
      Overrides:
      setSeconds in class Date
      Parameters:
      theSeconds - the number of seconds to set.
      Throws:
      IllegalArgumentException - if this method is called.

    • setTime

      public void setTime​(long theTime)
      Sets this date to a date supplied as a milliseconds value. The date is set based on the supplied time value and rounded to zero GMT for that day.
      Overrides:
      setTime in class Date
      Parameters:
      theTime - the time in milliseconds since the Epoch.

    • toString

      public String toString()
      Produces a string representation of the date in SQL format
      Overrides:
      toString in class Date
      Returns:
      a string representation of the date in SQL format - "yyyy-MM-dd".

    • valueOf

      public static Date valueOf​(String dateString)
      Creates a Date from a string representation of a date in SQL format.
      Parameters:
      dateString - the string representation of a date in SQL format - " yyyy-MM-dd".
      Returns:
      the Date object.
      Throws:
      IllegalArgumentException - if the format of the supplied string does not match the SQL format.