常用API - 时间日期类
Posted 小橘子ღ
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了常用API - 时间日期类相关的知识,希望对你有一定的参考价值。
Date类
概述
java.util.Date
类 表示特定的瞬间,精确到毫秒。
继续查阅Date类的描述,发现Date拥有多个构造函数,只是部分已经过时,但是其中有未过时的构造函数可以把毫秒值转成日期对象。
public Date()
:分配Date对象并初始化此对象,以表示分配它的时间(精确到毫秒)。public Date(long date)
:分配Date对象并初始化此对象,以表示自从标准基准时间(称为“历元(epoch)”,即1970年1月1日00:00:00 GMT)以来的指定毫秒数。
tips: 由于我们处于东八区,所以我们的基准时间为1970年1月1日8时0分0秒。
简单来说:使用无参构造,可以自动设置当前系统时间的毫秒时刻;指定long类型的构造参数,可以自定义毫秒时刻。例如:
package com;
import java.util.Date;
/**
* 日期时间类
*/
public class DateTest {
public static void main(String[] args) {
// 空参构造函数
Date date = new Date();
System.out.println(date);
// 带毫秒的long参数 毫秒转日期
Date date1 = new Date(999999999999L);
System.out.println(date1);
// 日期转毫秒
long millisecond = date.getTime();
System.out.println(millisecond);
}
}
tips:在使用println方法时,会自动调用Date类中的toString方法。
Date类对Object类中的toString方法进行了覆盖重写,所以结果为指定格式的字符串。
常用方法
Date类中的多数方法已经过时,常用的方法有:
方法摘要 | 描述+ |
---|---|
public long getTime() | 把日期对象转换成对应的时间毫秒值。 |
boolean after(Date when) | 测试此日期是否在指定日期之后。 |
boolean before(Date when) | 测试此日期是否在指定日期之前。 |
int compareTo(Date anotherDate) | 比较两个日期的顺序。等于返回 0;之前返回小于 0 的值;之后返回大于 0 的值。 |
boolean equals(Object obj) | 比较两个日期的相等性。 |
Object clone() | 返回此对象的副本。 |
int hashCode() | 返回此对象的哈希码值。 |
String toString() | 把此 Date 对象转换为以下形式的 String: dow mon dd hh:mm:ss zzz yyyy 其中: dow 是一周中的某一天 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)。 |
?
DateFormat类
java.text.DateFormat
是日期/时间格式化子类的抽象类,
我们通过这个类可以帮我们完成日期和文本之间的转换,也就是可以在Date对象与String对象之间进行来回转换。
-
格式化:按照指定的格式,从Date对象转换为String对象。
-
解析:按照指定的格式,从String对象转换为Date对象。
构造方法
由于DateFormat为抽象类,不能直接使用,所以需要常用的子类java.text.SimpleDateFormat
。
这个类需要一个模式(格式)来指定格式化或解析的标准。构造方法为:
public SimpleDateFormat(String pattern)
:用给定的模式和默认语言环境的日期格式符号构造SimpleDateFormat。
参数pattern是一个字符串,代表日期时间的自定义格式。
构造方法摘要 | 描述 |
---|---|
SimpleDateFormat() | 用默认的模式和默认语言环境的日期格式符号构造 SimpleDateFormat。 |
SimpleDateFormat(String pattern) * | 用给定的模式和默认语言环境的日期格式符号构造 SimpleDateFormat。 |
SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols) | 用给定的模式和日期符号构造 SimpleDateFormat。 |
SimpleDateFormat(String pattern, Locale locale) | 用给定的模式和给定语言环境的默认日期格式符号构造 SimpleDateFormat。 |
格式规则
常用的格式规则为:
标识字母(区分大小写) | 含义 |
---|---|
y | 年 |
M | 月 |
d | 日 |
H | 时 |
m | 分 |
s | 秒 |
常用方法
DateFormat类的常用方法有:
public String format(Date date)
:将Date对象格式化为字符串。public Date parse(String source)
:将字符串解析为Date对象。
方法摘要 | 描述 |
---|---|
Date parse(String text, ParsePosition pos) | 解析字符串的文本,生成 Date。 |
String toPattern() | 返回描述此日期格式的模式字符串。 |
void applyPattern(String pattern) | 将给定模式字符串应用于此日期格式。 |
void applyLocalizedPattern(String pattern) | 将给定的本地化模式字符串应用于此日期格式。 |
Object clone() | 创建此 SimpleDateFormat 的一个副本。 |
boolean equals(Object obj) | 比较给定对象与此 SimpleDateFormat 的相等性。 |
int hashCode() | 返回此 SimpleDateFormat 对象的哈希码值。 |
StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition pos) | 将给定的 Date 格式化为日期/时间字符串,并将结果添加到给定的 StringBuffer。 |
AttributedCharacterIterator formatToCharacterIterator(Object obj) | 格式化生成 AttributedCharacterIterator 的对象。 |
Date get2DigitYearStart() | 返回在 100 年周期内被解释的两位数字年份的开始日期。 |
DateFormatSymbols getDateFormatSymbols() | 获取此日期格式的日期和时间格式符号的一个副本。 |
void set2DigitYearStart(Date startDate) | 设置 100 年周期的两位数年份,该年份将被解释为从用户指定的日期开始。 |
void setDateFormatSymbols(DateFormatSymbols newFormatSymbols) | 设置此日期格式的日期和时间格式符号。 |
String toLocalizedPattern() | 返回描述此日期格式的本地化模式字符串。 |
简单使用
package com;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class SimpleDateFormatTest {
public static void main(String[] args) {
// **格式化** 日期转换为文本
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String str = dateFormat.format(new Date());
System.out.println(str);
//**解析** 将文本转为日期
try {
Date date = dateFormat.parse(str);
System.out.println(date);
} catch (ParseException e) {
System.out.println("解析异常");
}
}
}
练习
请使用日期时间相关的API,计算出一个人已经出生了多少天。
思路:
1.获取当前时间对应的毫秒值
2.获取自己出生日期对应的毫秒值
3.两个时间相减(当前时间– 出生日期)
代码实现:
public static void function() throws Exception {
System.out.println("请输入出生日期 格式 YYYY-MM-dd");
// 获取出生日期,键盘输入
String birthdayString = new Scanner(System.in).next();
// 将字符串日期,转成Date对象
// 创建SimpleDateFormat对象,写日期模式
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
// 调用方法parse,字符串转成日期对象
Date birthdayDate = sdf.parse(birthdayString);
// 获取今天的日期对象
Date todayDate = new Date();
// 将两个日期转成毫秒值,Date类的方法getTime
long birthdaySecond = birthdayDate.getTime();
long todaySecond = todayDate.getTime();
long secone = todaySecond-birthdaySecond;
if (secone < 0){
System.out.println("还没出生呢");
} else {
System.out.println(secone/1000/60/60/24);
}
}
Calendar类
概念
java.util.Calendar
是日历类,在Date后出现,替换掉了许多Date的方法。
该类将所有可能用到的时间信息封装为静态成员变量,方便获取。日历类就是方便获取各个时间属性的。
获取方式
Calendar为抽象类,由于语言敏感性,Calendar类在创建对象时并非直接创建,而是通过静态方法创建,返回子类对象。
Calendar静态方法
public static Calendar getInstance()
:使用默认时区和语言环境获得一个日历
例如:
package com;
import java.util.Calendar;
public class CalendarTest {
public static void main(String[] args) {
Calendar c = Calendar.getInstance();
System.out.println(c);
}
}
静态字段
Calendar类中提供很多成员常量,代表给定的日历字段:
字段值 | 含义 |
---|---|
YEAR | 年 |
MONTH | 月(从0开始,可以+1使用) |
DAY_OF_MONTH | 月中的天(几号) |
DATE | get 和 set 的字段数字,指示一个月中的某天。 |
HOUR | 时(12小时制) |
HOUR_OF_DAY | 时(24小时制) |
MINUTE | 分 |
SECOND | 秒 |
DAY_OF_WEEK | 周中的天(周几,周日为1,可以-1使用) |
DAY_OF_MONTH | get 和 set 的字段数字,指示一个月中的某天。 |
DAY_OF_YEAR | get 和 set 的字段数字,指示当前年中的天数。 |
DAY_OF_WEEK_IN_MONTH | get 和 set 的字段数字,指示当前月中的第几个星期。 |
AUGUST | 指示在格里高利历和罗马儒略历中一年中第八个月的 MONTH 字段值。 |
areFieldsSet | 如果 fields[] 与当前的设置时间同步,则返回 true。 |
APRIL | 指示在格里高利历和罗马儒略历中一年中第四个月的 MONTH 字段值。 |
AM_PM | get 和 set 的字段数字,指示 HOUR 是在中午之前还是在中午之后。 |
AM | 指示从午夜到中午之前这段时间的 AM_PM 字段值。 |
ALL_STYLES | 指示所有风格名称的 getDisplayNames 的风格说明符,比如 "January" 和 "Jan"。 |
常用方法
根据Calendar类的API文档,常用方法有:
public int get(int field)
:返回给定日历字段的值。public void set(int field, int value)
:将给定的日历字段设置为给定值。public abstract void add(int field, int amount)
:根据日历的规则,为给定的日历字段添加或减去指定的时间量。public Date getTime()
:返回一个表示此Calendar时间值(从历元到现在的毫秒偏移量)的Date对象。
方法 | 描述 |
---|---|
int get(int field) | 返回给定日历字段的值。 字段可以用上面的静态字段,如:Calendar.YEAR |
void set(int field, int value) | 将给定的日历字段设置为给定值。 |
abstract void add(int field, int amount) | 根据日历的规则,为给定的日历字段添加或减去指定的时间量。 |
Date getTime() | 返回一个表示此 Calendar 时间值(从历元至现在的毫秒偏移量)的 Date 对象。 |
boolean after(Object when) | 判断此 Calendar 表示的时间是否在指定 Object 表示的时间之后,返回判断结果。 |
boolean before(Object when) | 判断此 Calendar 表示的时间是否在指定 Object 表示的时间之前,返回判断结果。 |
void clear() | 将此 Calendar 的所日历字段值和时间值(从历元至现在的毫秒偏移量)设置成未定义。 |
void clear(int field) | 将此 Calendar 的给定日历字段值和时间值(从历元至现在的毫秒偏移量)设置成未定义。 |
Object clone() | 创建并返回此对象的一个副本。 |
int compareTo(Calendar anotherCalendar) | 比较两个 Calendar 对象表示的时间值(从历元至现在的毫秒偏移量)。 |
protected void complete() | 填充日历字段中所有未设置的字段。 |
protected abstract void computeFields() | 将当前毫秒时间值 time 转换为 fields[] 中的日历字段值。 |
protected abstract void computeTime() | 将 fields[] 中的当前日历字段值转换为毫秒时间值 time。 |
boolean equals(Object obj) | 将此 Calendar 与指定 Object 比较。 |
int getActualMaximum(int field) | 给定此 Calendar 的时间值,返回指定日历字段可能拥有的最大值。 |
int getActualMinimum(int field) | 给定此 Calendar 的时间值,返回指定日历字段可能拥有的最小值。 |
static Locale[] getAvailableLocales() | 返回所有语言环境的数组,此类的 getInstance 方法可以为其返回本地化的实例。 |
String getDisplayName(int field, int style, Locale locale) | 返回给定 style 和 locale 下的日历 field 值的字符串表示形式。 |
Map<String,Integer> getDisplayNames(int field, int style, Locale locale) | 返回给定 style 和 locale 下包含日历 field 所有名称的 Map 及其相应字段值。 |
int getFirstDayOfWeek() | 获取一星期的第一天;例如,在美国,这一天是 SUNDAY,而在法国,这一天是 MONDAY。 |
abstract int getGreatestMinimum(int field) | 返回此 Calendar 实例给定日历字段的最高的最小值。 |
static Calendar getInstance() | 使用默认时区和语言环境获得一个日历。 |
static Calendar getInstance(Locale aLocale) | 使用默认时区和指定语言环境获得一个日历。 |
static Calendar getInstance(TimeZone zone) | 使用指定时区和默认语言环境获得一个日历。 |
static Calendar getInstance(TimeZone zone, Locale aLocale) | 使用指定时区和语言环境获得一个日历。 |
abstract int getLeastMaximum(int field) | 返回此 Calendar 实例给定日历字段的最低的最大值。 |
abstract int getMaximum(int field) | 返回此 Calendar 实例给定日历字段的最大值。 |
int getMinimalDaysInFirstWeek() | 获取一年中第一个星期所需的最少天数,例如,如果定义第一个星期包含一年第一个月的第一天,则此方法将返回 1。 |
abstract int getMinimum(int field) | 返回此 Calendar 实例给定日历字段的最小值。 |
long getTimeInMillis() | 返回此 Calendar 的时间值,以毫秒为单位。 |
TimeZone getTimeZone() | 获得时区。 |
int hashCode() | 返回该此日历的哈希码。 |
protected int internalGet(int field) | 返回给定日历字段的值。 |
boolean isLenient() | 判断日期/时间的解释是否为宽松的。 |
boolean isSet(int field) | 确定给定日历字段是否已经设置了一个值,其中包括因为调用 get 方法触发内部字段计算而导致已经设置该值的情况。 |
abstract void roll(int field, boolean up) | 在给定的时间字段上添加或减去(上/下)单个时间单元,不更改更大的字段。 |
void roll(int field, int amount) | 向指定日历字段添加指定(有符号的)时间量,不更改更大的字段。 |
void set(int year, int month, int date) | 设置日历字段 YEAR、MONTH 和 DAY_OF_MONTH 的值。 |
void set(int year, int month, int date, int hourOfDay, int minute) | 设置日历字段 YEAR、MONTH、DAY_OF_MONTH、HOUR_OF_DAY 和 MINUTE 的值。 |
void set(int year, int month, int date, int hourOfDay, int minute, int second) | 设置字段 YEAR、MONTH、DAY_OF_MONTH、HOUR、MINUTE 和 SECOND 的值。 |
void setFirstDayOfWeek(int value) | 设置一星期的第一天是哪一天;例如,在美国,这一天是 SUNDAY,而在法国,这一天是 MONDAY。 |
void setLenient(boolean lenient) | 指定日期/时间解释是否是宽松的。 |
void setMinimalDaysInFirstWeek(int value) | 设置一年中第一个星期所需的最少天数,例如,如果定义第一个星期包含一年第一个月的第一天,则使用值 1 调用此方法。 |
void setTime(Date date) | 使用给定的 Date 设置此 Calendar 的时间。 |
void setTimeInMillis(long millis) | 用给定的 long 值设置此 Calendar 的当前时间值。 |
void setTimeZone(TimeZone value) | 使用给定的时区值来设置时区。 |
String toString() | 返回此日历的字符串表示形式。 |
简单使用
package com;
import java.util.Calendar;
/**
* Calendar类的常用方法
* 根据Calendar类的API文档,常用方法有:
* public int get(int field):返回给定日历字段的值。
* public void set(int field, int value):将给定的日历字段设置为给定值。
* public abstract void add(int field, int amount):根据日历的规则,为给定的日历字段添加或减去指定的时间量。
* public Date getTime():返回一个表示此Calendar时间值(从历元到现在的毫秒偏移量)的Date对象。
*/
public class CalendarTest {
public static void main(String[] args) {
Calendar c = Calendar.getInstance();
// get 获取日历的某个字段
System.out.println(c.get(Calendar.YEAR));
// 月份从0开始
System.out.println(c.get(Calendar.MONTH));
System.out.println(c.get(Calendar.DAY_OF_YEAR));
// set 设置日历的某个字段
c.set(Calendar.YEAR,1995);
System.out.println(c.getTime());
c.set(1999, Calendar.DECEMBER, 1);
System.out.println(c.getTime());
// add 修改指定的字段,可以是整数也可以是负数
System.out.println("======add 加减=====");
c.add(Calendar.YEAR,10);
System.out.println(c.getTime());
// getTime 将日历转为日期Date
}
}
小贴士:
? 西方星期的开始为周日,中国为周一。
? 在Calendar类中,月份的表示是以0-11代表1-12月。
? 日期是有大小关系的,时间靠后,时间越大。
以上是关于常用API - 时间日期类的主要内容,如果未能解决你的问题,请参考以下文章
JAVA-基础-常用API(时间日期类,Date,Dateformat,Calendar)
java常用类详细介绍及总结:字符串相关类日期时间API比较器接口SystemMathBigInteger与BigDecimal
Java日期时间API系列20-----Jdk8中java.time包中的新的日期时间API类,ZoneId时区ID大全等。