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.
| Constructor and Description |
|---|
Time(int hour,
int minute,
int second)
Deprecated.
Use the constructor that takes a milliseconds value
in place of this constructor
|
Time(long time)
Constructs a
Time object using a milliseconds time value. |
| 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 a
Time object using a milliseconds time value. |
void |
setYear(int i)
Deprecated.
|
Instant |
toInstant()
This method always throws an UnsupportedOperationException and should
not be used because SQL
Time values do not have a date
component. |
LocalTime |
toLocalTime()
Converts this
Time object to a LocalTime. |
String |
toString()
Formats a time in JDBC time escape format.
|
static Time |
valueOf(LocalTime time)
Obtains an instance of
Time from a LocalTime object
with the same hour, minute and second time value as the given
LocalTime. |
static Time |
valueOf(String s)
Converts a string in JDBC time escape format to a
Time value. |
after, before, clone, compareTo, equals, from, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC@Deprecated public Time(int hour, int minute, int second)
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.
hour - 0 to 23minute - 0 to 59second - 0 to 59public Time(long time)
Time object using a milliseconds time value.time - milliseconds since January 1, 1970, 00:00:00 GMT;
a negative number is milliseconds before
January 1, 1970, 00:00:00 GMTpublic void setTime(long time)
Time object using a milliseconds time value.public static Time valueOf(String s)
Time value.s - time in format "hh:mm:ss"Time objectpublic String toString()
toString in class DateString in hh:mm:ss formatDate.toLocaleString(),
Date.toGMTString()@Deprecated public int getYear()
TIME
values do not have a year component.getYear in class DateIllegalArgumentException - if this
method is invokedsetYear(int)@Deprecated public int getMonth()
TIME
values do not have a month component.getMonth in class DateIllegalArgumentException - if this
method is invokedsetMonth(int)@Deprecated public int getDay()
TIME
values do not have a day component.getDay in class DateIllegalArgumentException - if this
method is invokedCalendar@Deprecated public int getDate()
TIME
values do not have a date component.getDate in class DateIllegalArgumentException - if this
method is invokedsetDate(int)@Deprecated public void setYear(int i)
TIME
values do not have a year component.setYear in class Datei - the year value.IllegalArgumentException - if this
method is invokedgetYear()@Deprecated public void setMonth(int i)
TIME
values do not have a month component.setMonth in class Datei - the month value between 0-11.IllegalArgumentException - if this
method is invokedgetMonth()@Deprecated public void setDate(int i)
TIME
values do not have a date component.setDate in class Datei - the day of the month value between 1-31.IllegalArgumentException - if this
method is invokedgetDate()public static Time valueOf(LocalTime time)
Time from a LocalTime object
with the same hour, minute and second time value as the given
LocalTime.time - a LocalTime to convertTime objectNullPointerException - if time is nullpublic LocalTime toLocalTime()
Time object to a LocalTime.
The conversion creates a LocalTime that represents the same
hour, minute, and second time value as this Time.
LocalTime object representing the same time valuepublic Instant toInstant()
Time values do not have a date
component.toInstant in class DateDate objectUnsupportedOperationException - if this method is invoked Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.