在类 Date
所有可以接受或返回年、月、日期、小时、分钟和秒值的方法中,将使用下面的表示形式:
- 年份 y 由整数 y
- 1900
表示。 - 月份由从 0 至 11 的整数表示;0 是一月、1 是二月等等;因此 11 是十二月。
- 日期(一月中的某天)按通常方式由整数 1 至 31 表示。
- 小时由从 0 至 23 的整数表示。因此,从午夜到 1 a.m. 的时间是 0 点,从中午到 1 p.m. 的时间是 12 点。
- 分钟按通常方式由 0 至 59 的整数表示。
- 秒由 0 至 61 的整数表示;值 60 和 61 只对闰秒发生,尽管那样,也只用在实际正确跟踪闰秒的 Java 实现中。于按当前引入闰秒的方式,两个闰秒在同一分钟内发生是极不可能的,但此规范遵循 ISO C 的日期和时间约定。
在所有情形中,针对这些目的赋予方法的参数不需要在指定的范围内;例如,可以把日期指定为 1 月 32 日,并把它解释为 2 月 1 日的相同含义。
过时方法摘要 |
---|
int |
|
int |
getDate() 已过时。 从 JDK 1.1 开始,由 Calendar.get(Calendar.DAY_OF_MONTH) 取代。 |
int |
getDay() 已过时。 从 JDK 1.1 开始,由 Calendar.get(Calendar.DAY_OF_WEEK) 取代。 |
int |
getHours() 已过时。 从 JDK 1.1 开始,由 Calendar.get(Calendar.HOUR_OF_DAY) 取代。 |
int |
getMinutes() 已过时。 从 JDK 1.1 开始,由 Calendar.get(Calendar.MINUTE) 取代。 |
int |
getMonth()
已过时。 从 JDK 1.1 开始,由 |
int |
getSeconds() 已过时。 从 JDK 1.1 开始,由 Calendar.get(Calendar.SECOND) 取代。 |
常用方法
getTime
public long getTime()
- 返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此 Date 对象表示的毫秒数。
-
-
- 返回:
- 自 1970 年 1 月 1 日 00:00:00 GMT 以来此日期表示的毫秒数。
setTime
public void setTime(long time)
- 设置此
Date
对象,以表示 1970 年 1 月 1 日 00:00:00 GMT 以后time
毫秒的时间点。 -
-
- 参数:
time
- 毫秒数。
before
public boolean before(Date when)
- 测试此日期是否在指定日期之前。
-
-
- 参数:
when
- 日期。- 返回:
- 当且仅当此 Date 对象表示的瞬间比 when 表示的瞬间早,才返回
true
;否则返回false
。 - 抛出:
NullPointerException
- 如果when
为 null。
after
public boolean after(Date when)
- 测试此日期是否在指定日期之后。
-
-
- 参数:
when
- 日期。- 返回:
- 当且仅当此 Date 对象表示的瞬间比 when 表示的瞬间晚,才返回
true
;否则返回false
。 - 抛出:
NullPointerException
- 如果when
为 null。
toString
public String toString()
- 把此
Date
对象转换为以下形式的String
:dow mon dd hh:mm:ss zzz yyyy
其中:
- dow 是一周中的某一天 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)。
- mon 是月份 (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)。
- dd 是一月中的某一天(01 至 31),显示为两位十进制数。
- hh 是一天中的小时(00 至 23),显示为两位十进制数。
- mm 是小时中的分钟(00 至 59),显示为两位十进制数。
- ss 是分钟中的秒数(00 至 61),显示为两位十进制数。
- zzz 是时区(并可以反映夏令时)。标准时区缩写包括方法 parse 识别的时区缩写。如果不提供时区信息,则 zzz 为空,即根本不包括任何字符。
- yyyy 是年份,显示为 4 位十进制数。
-
- 返回:
- 此日期的字符串表示形式。
时间: 2024-10-12 05:36:02