Module  java.sql
软件包  java.sql

Class Time

  • All Implemented Interfaces:
    Serializable ， Cloneable ， Comparable<Date> 

    public class Time
extends Date

    围绕java.util.Date类的薄包装，允许JDBC API将其标识为SQL TIME值。 Time类添加了格式化和解析操作，以支持时间值的JDBC转义语法。

    日期组件应设置为1970年1月1日的“零纪元”值，不应被访问。

    从以下版本开始：
    1.1
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • Time

        @Deprecated(since="1.2")
public Time​(int hour,
            int minute,
            int second)
        已过时。 使用构造函数，该构造函数需要一个毫秒值来代替此构造函数
        构造一个Time对象，该对象使用给定的小时，分钟和秒值进行初始化。 驱动程序将日期组件设置为1970年1月1日。尝试访问Time对象的日期组件的任何方法将抛出一个java.lang.IllegalArgumentException 。

        如果给定的参数超出界限，结果是未定义的。

        参数
        hour - 0至23
        minute - 0至59
        second - 0至59

      • Time

        public Time​(long time)
        使用毫秒时间值构造一个 Time对象。
        参数
        time - 1970年1月1日00:00:00 GMT以来的毫秒数 负数是1970年1月1日00:00:00 GMT之前的毫秒

    • 方法详细信息

      • setTime

        public void setTime​(long time)
        使用毫秒时间值设置 Time对象。
        重写：
        setTime在 Date
        参数
        time - 1970年1月1日00:00:00 GMT以来的毫秒 负数是1970年1月1日00:00:00 GMT之前的毫秒

      • valueOf

        public static Time valueOf​(String s)
        将JDBC时间转义格式的字符串转换为 Time值。
        参数
        s - 时间格式“hh：mm：ss”
        结果
        一个对应的 Time对象

      • getYear

        @Deprecated(since="1.2")
public int getYear​()
        已过时。
        此方法已被弃用，不应使用，因为SQL TIME值不具有年份组件。
        重写：
        getYear在 Date
        结果
        这个日期代表的年份，减去1900年。
        异常
        IllegalArgumentException - 如果调用此方法
        另请参见：
        setYear(int)

      • getDay

        @Deprecated(since="1.2")
public int getDay​()
        已过时。
        此方法已被弃用，不应使用，因为SQL TIME值不包含日组件。
        重写：
        getDay在 Date
        结果
        这个日期的星期几。
        异常
        IllegalArgumentException - 如果这个方法被调用
        另请参见：
        Calendar

      • setMonth

        @Deprecated(since="1.2")
public void setMonth​(int i)
        已过时。
        此方法已被弃用，不应使用，因为SQL TIME值不具有月份组件。
        重写：
        setMonth中的 Date
        参数
        i - 0-11之间的月份值。
        异常
        IllegalArgumentException - 如果这个方法被调用
        另请参见：
        getMonth()

      • setDate

        @Deprecated(since="1.2")
public void setDate​(int i)
        已过时。
        此方法已被弃用，不应使用，因为SQL TIME值没有日期组件。
        重写：
        setDate在 Date
        参数
        i - 月中的日期值在1-31之间。
        异常
        IllegalArgumentException - 如果调用此方法
        另请参见：
        getDate()

      • valueOf

        public static Time valueOf​(LocalTime time)
        从LocalTime对象获取Time的实例，具有与给定的LocalTime相同的小时，分钟和秒值。 来自LocalTime字段不是新创建的Time对象的一部分。
        参数
        time - a转换 LocalTime
        结果
        一个 Time对象
        异常
        NullPointerException - 如果 time为空
        从以下版本开始：
        1.8

      • toLocalTime

        public LocalTime toLocalTime​()
        将此Time对象转换为LocalTime 。

        该转换创建一个LocalTime ，表示与此Time相同的小时，分钟和秒值。 纳秒LocalTime字段将被设置为零。

        结果
        一个表示相同时间值的 LocalTime对象
        从以下版本开始：
        1.8

      • toInstant

        public Instant toInstant​()
        此方法总是引发UnsupportedOperationException，因为SQL Time值不具有日期组件，因此不应该使用它。
        重写：
        toInstant在 Date
        结果
        即时表示在这个 Date对象的时间线上的相同点
        异常
        UnsupportedOperationException - if this method is invoked