File	Doc	Category	Size	Date	Package
Date.java	API Doc	Android 1.5 API	8876	Wed May 06 22:41:06 BST 2009	java.sql

Date

• java.lang.Object
  • java.util.Date

Fields Summary
private static final long	serialVersionUID

Constructors Summary
public Date(int theYear, int theMonth, int theDay) Constructs a {@code Date} object corresponding to the supplied year, month and day. deprecated Please use the constructor {@link #Date(long)}. param theYear the year, specified as the year minus 1900. Must be in the range {@code [0,8099]}. param theMonth the month, specified as a number with 0 = January. Must be in the range {@code [0,11]}. param theDay the day in the month. Must be in the range {@code [1,31]}. since Android 1.0 super(theYear, theMonth, theDay);
public Date(long theDate) Creates a date which corresponds to the day determined by the supplied milliseconds time value {@code theDate}. param 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 {@code Date} object is adjusted to correspond to 00:00:00 GMT on the day determined by the supplied time value. since Android 1.0 super(normalizeTime(theDate));

Methods Summary
public int	getHours() deprecated This method is deprecated and must not be used. SQL {@code Date} values do not have an hours component. return does not return anything. throws IllegalArgumentException if this method is called. since Android 1.0 throw new IllegalArgumentException();
public int	getMinutes() deprecated This method is deprecated and must not be used. SQL {@code Date} values do not have a minutes component. return does not return anything. throws IllegalArgumentException if this method is called. since Android 1.0 throw new IllegalArgumentException();
public int	getSeconds() deprecated This method is deprecated and must not be used. SQL {@code Date} values do not have a seconds component. return does not return anything. throws IllegalArgumentException if this method is called. since Android 1.0 throw new IllegalArgumentException();
private static long	normalizeTime(long theTime) return theTime;
public void	setHours(int theHours) deprecated This method is deprecated and must not be used. SQL {@code Date} values do not have an hours component. param theHours the number of hours to set. throws IllegalArgumentException if this method is called. since Android 1.0 throw new IllegalArgumentException();
public void	setMinutes(int theMinutes) deprecated This method is deprecated and must not be used. SQL {@code Date} values do not have a minutes component. param theMinutes the number of minutes to set. throws IllegalArgumentException if this method is called. since Android 1.0 throw new IllegalArgumentException();
public void	setSeconds(int theSeconds) deprecated This method is deprecated and must not be used. SQL {@code Date} values do not have a seconds component. param theSeconds the number of seconds to set. throws IllegalArgumentException if this method is called. since Android 1.0 throw new IllegalArgumentException();
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. param theTime the time in milliseconds since the Epoch. since Android 1.0 /* * Store the Date based on the supplied time after removing any time * elements finer than the day based on zero GMT */ super.setTime(normalizeTime(theTime));
public java.lang.String	toString() Produces a string representation of the date in SQL format return a string representation of the date in SQL format - {@code "yyyy-mm-dd"}. since Android 1.0 SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd"); //$NON-NLS-1$ return dateFormat.format(this);
public static java.sql.Date	valueOf(java.lang.String dateString) Creates a {@code Date} from a string representation of a date in SQL format. param dateString the string representation of a date in SQL format - " {@code yyyy-mm-dd}". return the {@code Date} object. throws IllegalArgumentException if the format of the supplied string does not match the SQL format. since Android 1.0 if (dateString == null) { throw new IllegalArgumentException(); } int firstIndex = dateString.indexOf('-"); int secondIndex = dateString.indexOf('-", firstIndex + 1); // secondIndex == -1 means none or only one separator '-' has been // found. // The string is separated into three parts by two separator characters, // if the first or the third part is null string, we should throw // IllegalArgumentException to follow RI if (secondIndex == -1 || firstIndex == 0 || secondIndex + 1 == dateString.length()) { throw new IllegalArgumentException(); } // parse each part of the string int year = Integer.parseInt(dateString.substring(0, firstIndex)); int month = Integer.parseInt(dateString.substring(firstIndex + 1, secondIndex)); int day = Integer.parseInt(dateString.substring(secondIndex + 1, dateString.length())); return new Date(year - 1900, month - 1, day);