java中Date

Posted 2020-09-11 茅坤宝骏氹

在类 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	getYear()           已过时。 从 JDK 1.1 开始，由 Calendar.get(Calendar.YEAR) - 1900 取代。
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 开始，由 Calendar.get(Calendar.MONTH) 取代。
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 位十进制数。

覆盖：

类 Object 中的 toString

返回：

此日期的字符串表示形式。