FileDocCategorySizeDatePackage
Time.javaAPI DocJava SE 5 API6580Fri Aug 26 14:57:20 BST 2005java.sql

Time

public class Time extends Date

A thin wrapper around the java.util.Date class that allows the JDBC API to identify this as an SQL TIME value. The Time class adds formatting and parsing operations to support the JDBC escape syntax for time values.

The date components should be set to the "zero epoch" value of January 1, 1970 and should not be accessed.

Fields Summary
static final long
serialVersionUID
Private serial version unique ID to ensure serialization compatibility.
Constructors Summary
public Time(int hour, int minute, int second)
Constructs a Time object initialized with the given values for the hour, minute, and second. The driver sets the date components to January 1, 1970. Any method that attempts to access the date components of a Time object will throw a java.lang.IllegalArgumentException.

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

param
hour 0 to 23
param
minute 0 to 59
param
second 0 to 59
deprecated
Use the constructor that takes a milliseconds value in place of this constructor

	super(70, 0, 1, hour, minute, second);
    
public Time(long time)
Constructs a Time object using a milliseconds time value.

param
time milliseconds since January 1, 1970, 00:00:00 GMT; a negative number is milliseconds before January 1, 1970, 00:00:00 GMT

	super(time);
    
Methods Summary
public intgetDate()
This method is deprecated and should not be used because SQL TIME values do not have a date component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked
see
#setDate

	throw new java.lang.IllegalArgumentException();
    
public intgetDay()
This method is deprecated and should not be used because SQL TIME values do not have a day component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked

	throw new java.lang.IllegalArgumentException();
    
public intgetMonth()
This method is deprecated and should not be used because SQL TIME values do not have a month component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked
see
#setMonth

	throw new java.lang.IllegalArgumentException();
    
public intgetYear()
This method is deprecated and should not be used because SQL TIME values do not have a year component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked
see
#setYear

	throw new java.lang.IllegalArgumentException();
    
public voidsetDate(int i)
This method is deprecated and should not be used because SQL TIME values do not have a date component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked
see
#getDate

	throw new java.lang.IllegalArgumentException();
    
public voidsetMonth(int i)
This method is deprecated and should not be used because SQL TIME values do not have a month component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked
see
#getMonth

	throw new java.lang.IllegalArgumentException();
    
public voidsetTime(long time)
Sets a Time object using a milliseconds time value.

param
time milliseconds since January 1, 1970, 00:00:00 GMT; a negative number is milliseconds before January 1, 1970, 00:00:00 GMT

	super.setTime(time);
    
public voidsetYear(int i)
This method is deprecated and should not be used because SQL TIME values do not have a year component.

deprecated
exception
java.lang.IllegalArgumentException if this method is invoked
see
#getYear

	throw new java.lang.IllegalArgumentException();
    
public java.lang.StringtoString()
Formats a time in JDBC time escape format.

return
a String in hh:mm:ss format

	int hour = super.getHours();
	int minute = super.getMinutes();
	int second = super.getSeconds();
	String hourString;
	String minuteString;
	String secondString;

	if (hour < 10) {
	    hourString = "0" + hour;
	} else {		
	    hourString = Integer.toString(hour);
	}
	if (minute < 10) {
	    minuteString = "0" + minute;
	} else {		
	    minuteString = Integer.toString(minute);
	}
	if (second < 10) {
	    secondString = "0" + second;
	} else {		
	    secondString = Integer.toString(second);
	}
	return (hourString + ":" + minuteString + ":" + secondString);
    
public static java.sql.TimevalueOf(java.lang.String s)
Converts a string in JDBC time escape format to a Time value.

param
s time in format "hh:mm:ss"
return
a corresponding Time object

	int hour;
	int minute;
	int second;
	int firstColon;
	int secondColon;

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

	firstColon = s.indexOf(':");
	secondColon = s.indexOf(':", firstColon+1);
	if ((firstColon > 0) & (secondColon > 0) & 
	    (secondColon < s.length()-1)) {
	    hour = Integer.parseInt(s.substring(0, firstColon));
	    minute = 
		Integer.parseInt(s.substring(firstColon+1, secondColon));
	    second = Integer.parseInt(s.substring(secondColon+1));	    
	} else {
	    throw new java.lang.IllegalArgumentException();
	}

	return new Time(hour, minute, second);