1. /*

  2.  * @(#)Date.java	1.31 03/01/23

  3.  *

  4.  * Copyright 2003 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package java.sql;

  9. 

  10. /**

  11.  * <P>A thin wrapper around a millisecond value that allows

  12.  * JDBC to identify this as an SQL <code>DATE</code> value.  A 

  13.  * milliseconds value represents the number of milliseconds that 

  14.  * have passed since January 1, 1970 00:00:00.000 GMT.

  15.  * <p>

  16.  * To conform with the definition of SQL <code>DATE</code>, the 

  17.  * millisecond values wrapped by a <code>java.sql.Date</code> instance 

  18.  * must be 'normalized' by setting the 

  19.  * hours, minutes, seconds, and milliseconds to zero in the particular

  20.  * time zone with which the instance is associated.

  21.  */

  22. public class Date extends java.util.Date {

  23. 

  24.     /**

  25.      * Constructs a <code>Date</code> object initialized with the given

  26.      * year, month, and day.

  27.      * <P>

  28.      * The result is undefined if a given argument is out of bounds.

  29.      *

  30.      * @param year the year minus 1900; must be 0 to 8099. (Note that

  31.      *        8099 is 9999 minus 1900.)

  32.      * @param month 0 to 11

  33.      * @param day 1 to 31

  34.      * @deprecated instead use the constructor <code>Date(long date)</code>

  35.      */

  36.     public Date(int year, int month, int day) {

  37. 	super(year, month, day);

  38.     }

  39. 

  40.     /**

  41.      * Constructs a <code>Date</code> object using the given milliseconds 

  42.      * time value.  If the given milliseconds value contains time 

  43.      * information, the driver will set the time components to the

  44.      * time in the default time zone (the time zone of the Java virtual

  45.      * machine running the application) that corresponds to zero GMT.

  46.      *

  47.      * @param date milliseconds since January 1, 1970, 00:00:00 GMT not

  48.      *        to exceed the milliseconds representation for the year 8099.

  49.      *        A negative number indicates the number of milliseconds

  50.      *        before January 1, 1970, 00:00:00 GMT.

  51.      */

  52.     public Date(long date) {

  53. 	// If the millisecond date value contains time info, mask it out.

  54. 	super(date);

  55. 	

  56.     }

  57. 

  58.     /**

  59.      * Sets an existing <code>Date</code> object 

  60.      * using the given milliseconds time value. 

  61.      * If the given milliseconds value contains time information, 

  62.      * the driver will set the time components to the

  63.      * time in the default time zone (the time zone of the Java virtual

  64.      * machine running the application) that corresponds to zero GMT.

  65.      *

  66.      * @param date milliseconds since January 1, 1970, 00:00:00 GMT not

  67.      *        to exceed the milliseconds representation for the year 8099.

  68.      *        A negative number indicates the number of milliseconds

  69.      *        before January 1, 1970, 00:00:00 GMT.

  70.      */

  71.     public void setTime(long date) {

  72. 	// If the millisecond date value contains time info, mask it out.

  73. 	super.setTime(date);	 

  74.     }

  75. 

  76.     /**

  77.      * Converts a string in JDBC date escape format to

  78.      * a <code>Date</code> value.

  79.      *

  80.      * @param s a <code>String</code> object representing a date in 

  81.      *        in the format "yyyy-mm-dd"

  82.      * @return a <code>java.sql.Date</code> object representing the

  83.      *         given date

  84.      * @throws IllegalArgumentException if the date given is not in the

  85.      *         JDBC date escape format (yyyy-mm-dd)

  86.      */

  87.     public static Date valueOf(String s) {

  88. 	int year;

  89. 	int month;

  90. 	int day;

  91. 	int firstDash;

  92. 	int secondDash;

  93. 

  94. 	if (s == null) throw new java.lang.IllegalArgumentException();

  95. 

  96. 	firstDash = s.indexOf('-');

  97. 	secondDash = s.indexOf('-', firstDash+1);

  98. 	if ((firstDash > 0) & (secondDash > 0) & (secondDash < s.length()-1)) {

  99. 	    year = Integer.parseInt(s.substring(0, firstDash)) - 1900;

  100. 	    month = Integer.parseInt(s.substring(firstDash+1, secondDash)) - 1;

  101. 	    day = Integer.parseInt(s.substring(secondDash+1));	 

  102. 	} else {

  103. 	    throw new java.lang.IllegalArgumentException();

  104. 	}

  105. 			

  106. 	return new Date(year, month, day);

  107.     }

  108. 

  109.     /**

  110.      * Formats a date in the date escape format yyyy-mm-dd.  

  111.      * <P>

  112.      * NOTE:  To specify a date format for the class

  113.      * <code>SimpleDateFormat</code>, use "yyyy.MM.dd" rather than

  114.      * "yyyy-mm-dd".  In the context of <code>SimpleDateFormat</code>,

  115.      * "mm" indicates minutes rather than the month.  

  116.      * For example:

  117.      * <PRE>

  118.      *

  119.      *  Format Pattern                         Result

  120.      *  --------------                         -------

  121.      *	"yyyy.MM.dd G 'at' hh:mm:ss z"    ->>  1996.07.10 AD at 15:08:56 PDT

  122.      * </PRE>

  123.      * @return a String in yyyy-mm-dd format

  124.      */

  125.     public String toString () {

  126. 	int year = super.getYear() + 1900;

  127. 	int month = super.getMonth() + 1;

  128. 	int day = super.getDate();

  129. 

  130.         char buf[] = "2000-00-00".toCharArray();

  131.         buf[0] = Character.forDigit(year1000,10);

  132.         buf[1] = Character.forDigit((year100)%10,10);

  133.         buf[2] = Character.forDigit((year10)%10,10);

  134.         buf[3] = Character.forDigit(year%10,10);

  135.         buf[5] = Character.forDigit(month10,10);

  136.         buf[6] = Character.forDigit(month%10,10);

  137.         buf[8] = Character.forDigit(day10,10);

  138.         buf[9] = Character.forDigit(day%10,10);

  139. 		

  140. 	return new String(buf);

  141.     }

  142. 

  143.     // Override all the time operations inherited from java.util.Date;

  144. 

  145.    /**

  146.     * This method is deprecated and should not be used because SQL Date 

  147.     * values do not have a time component.

  148.     *

  149.     * @deprecated

  150.     * @exception java.lang.IllegalArgumentException if this method is invoked

  151.     * @see #setHours

  152.     */

  153.     public int getHours() {

  154. 	throw new java.lang.IllegalArgumentException();

  155.     }

  156. 

  157.    /**

  158.     * This method is deprecated and should not be used because SQL Date 

  159.     * values do not have a time component.

  160.     *

  161.     * @deprecated

  162.     * @exception java.lang.IllegalArgumentException if this method is invoked

  163.     * @see #setMinutes

  164.     */

  165.     public int getMinutes() {

  166. 	throw new java.lang.IllegalArgumentException();

  167.     }

  168.     

  169.    /**

  170.     * This method is deprecated and should not be used because SQL Date 

  171.     * values do not have a time component.

  172.     *

  173.     * @deprecated

  174.     * @exception java.lang.IllegalArgumentException if this method is invoked

  175.     * @see #setSeconds

  176.     */

  177.     public int getSeconds() {

  178. 	throw new java.lang.IllegalArgumentException();

  179.     }

  180. 

  181.    /**

  182.     * This method is deprecated and should not be used because SQL Date 

  183.     * values do not have a time component.

  184.     *

  185.     * @deprecated

  186.     * @exception java.lang.IllegalArgumentException if this method is invoked

  187.     * @see #getHours

  188.     */

  189.     public void setHours(int i) {

  190. 	throw new java.lang.IllegalArgumentException();

  191.     }

  192. 

  193.    /**

  194.     * This method is deprecated and should not be used because SQL Date 

  195.     * values do not have a time component.

  196.     *

  197.     * @deprecated

  198.     * @exception java.lang.IllegalArgumentException if this method is invoked

  199.     * @see #getMinutes

  200.     */

  201.     public void setMinutes(int i) {

  202. 	throw new java.lang.IllegalArgumentException();

  203.     }

  204. 

  205.    /**

  206.     * This method is deprecated and should not be used because SQL Date 

  207.     * values do not have a time component.

  208.     *

  209.     * @deprecated

  210.     * @exception java.lang.IllegalArgumentException if this method is invoked

  211.     * @see #getSeconds

  212.     */

  213.     public void setSeconds(int i) {

  214. 	throw new java.lang.IllegalArgumentException();

  215.     }

  216. 

  217.    /**

  218.     * Private serial version unique ID to ensure serialization

  219.     * compatibility.

  220.     */ 

  221.     static final long serialVersionUID = 1511598038487230103L;

  222. }

  223.