- java.lang.Object
-
- java.util.Date
-
- java.sql.Time
-
- All Implemented Interfaces:
- Serializable, Cloneable, Comparable<Date>
public class Time extends Date
A thin wrapper around the
java.util.Date
class that allows the JDBC API to identify this as an SQLTIME
value. TheTime
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.
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description Time(int hour, int minute, int second)
Deprecated.Use the constructor that takes a milliseconds value in place of this constructorTime(long time)
Constructs aTime
object using a milliseconds time value.
-
Method Summary
Methods Modifier and Type Method and Description int
getDate()
Deprecated.int
getDay()
Deprecated.int
getMonth()
Deprecated.int
getYear()
Deprecated.void
setDate(int i)
Deprecated.void
setMonth(int i)
Deprecated.void
setTime(long time)
Sets aTime
object using a milliseconds time value.void
setYear(int i)
Deprecated.String
toString()
Formats a time in JDBC time escape format.static Time
valueOf(String s)
Converts a string in JDBC time escape format to aTime
value.-
Methods inherited from class java.util.Date
after, before, clone, compareTo, equals, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC
-
-
-
-
Constructor Detail
-
Time
@Deprecated public Time(int hour, int minute, int second)
Deprecated. Use the constructor that takes a milliseconds value in place of this constructorConstructs aTime
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 aTime
object will throw ajava.lang.IllegalArgumentException
.The result is undefined if a given argument is out of bounds.
- Parameters:
hour
- 0 to 23minute
- 0 to 59second
- 0 to 59
-
Time
public Time(long time)
Constructs aTime
object using a milliseconds time value.- Parameters:
time
- milliseconds since January 1, 1970, 00:00:00 GMT; a negative number is milliseconds before January 1, 1970, 00:00:00 GMT
-
-
Method Detail
-
setTime
public void setTime(long time)
Sets aTime
object using a milliseconds time value.
-
valueOf
public static Time valueOf(String s)
Converts a string in JDBC time escape format to aTime
value.- Parameters:
s
- time in format "hh:mm:ss"- Returns:
- a corresponding
Time
object
-
toString
public String toString()
Formats a time in JDBC time escape format.- Overrides:
toString
in classDate
- Returns:
- a
String
in hh:mm:ss format - See Also:
Date.toLocaleString()
,Date.toGMTString()
-
getYear
@Deprecated public int getYear()
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a year component.- Overrides:
getYear
in classDate
- Returns:
- the year represented by this date, minus 1900.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
setYear(int)
-
getMonth
@Deprecated public int getMonth()
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a month component.- Overrides:
getMonth
in classDate
- Returns:
- the month represented by this date.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
setMonth(int)
-
getDay
@Deprecated public int getDay()
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a day component.- Overrides:
getDay
in classDate
- Returns:
- the day of the week represented by this date.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
Calendar
-
getDate
@Deprecated public int getDate()
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a date component.- Overrides:
getDate
in classDate
- Returns:
- the day of the month represented by this date.
- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
setDate(int)
-
setYear
@Deprecated public void setYear(int i)
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a year component.- Overrides:
setYear
in classDate
- Parameters:
i
- the year value.- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
getYear()
-
setMonth
@Deprecated public void setMonth(int i)
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a month component.- Overrides:
setMonth
in classDate
- Parameters:
i
- the month value between 0-11.- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
getMonth()
-
setDate
@Deprecated public void setDate(int i)
Deprecated.This method is deprecated and should not be used because SQLTIME
values do not have a date component.- Overrides:
setDate
in classDate
- Parameters:
i
- the day of the month value between 1-31.- Throws:
IllegalArgumentException
- if this method is invoked- See Also:
getDate()
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/sql/Time.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.