Date类介绍及使用
关于SimpleDateFormat类
Calendar类介绍及使用
LocalDateTime类介绍及使用
关于DateTimeFormatter类
一、前言
本节内容是我们《API-常用类》专题的第五小节了。本节内容主要讲Date 类 和 Calendar 类, 内容包括但不限于 Date类简介, Date类使用, Calendar类的简介和使用, LocalDate、LocalTime、LocalDateTime类的介绍和演示。本节内容没什么难度,主要是介绍一些类的使用,大家可以放心食用。 注意 : ① 代码中的注释也很重要; ② 不要眼高手低,自己敲一遍才能知道怎么用。 ③ 点击侧边栏目录或者文章开头的目录可以跳转。良工不示人以朴,所有文章都会适时改进。大家如果有什么问题,都可以在评论区一块儿交流,或者私信up。 感谢阅读!
二、Date类简介
Date类,见名知意,日期类。用于操作日期相关信息。
Date类属于java.base 模块,java.util包下(使用时需要导包),如下图所示:
注意,除了util包下,sql包下也有一个Date类。二者有很大差别,sql包下的Date类与数据库相关。大家在导包时要看清楚,不要导错包。如下 :
我们再看查看一下Date类的类图,如下 : (都是老面孔了,这里不再赘述)
三、Date类的构造器
1.Date() :
构造一个日期对象,直接输出Date类对象默认打印当前系统时间。
2.Date(long date) :
构造一个日期对象,时间为自"1970-1-1-00:00:00GMT"起,至指定参数的毫秒数所代表的日期。
Δ演示 :
up以Date_类为例,代码如下 :
package csdn.knowledge.api.date_calendar;
import java.util.Date; //别忘了导包.
public class Date_ {
public static void main(String[] args) {
//演示 : Date类构造器
//1.Date()
Date date_0 = new Date();
System.out.println(date_0);
System.out.println("-------------------------");
//2.Date(long date)
Date date_1 = new Date(666666666);
System.out.println(date_1);
}
}
运行结果 :
四、Date类的使用(重要)
1.SimpleDateFormat类的引入 :
在Date类构造器的演示中可以看到,输出Date类对象默认打印当前系统时间,而且它的格式是固定的。这时,如果想改变日期默认的格式,就需要引入SimpleDateFormat类,见名知意,这个类可以对日期进行格式化。
SimpleDateFormat类属于java.base 模块, java.text包下。如下图所示 :
2.Date类对象的格式化 :
那有了SimpleDateFormat类以后,到底怎么对日期进行格式化呢?
首先我们需要用到SimpleDateFormat类的一个构造器,如下 :
SimpleDateFormat(String pattern)——
该构造器可以构造一个SimpleDateFormat对象,传入的字符串表示你将来想要的日期的格式。
其次,我们还需要通过刚刚创建的SimpleDateFormat类对象来调用SimpleDateFormat类的format方法,该方法需要传入一个Date类对象,并以字符串形式作接收。:
Δ演示 :
up以SimpleDateFormat_类为例,代码如下 :
package csdn.knowledge.api.date_calendar;
import java.text.SimpleDateFormat;
import java.util.Date;
public class SimpleDateFormat_ {
public static void main(String[] args) {
//第一步,利用带参构造创建SimpleDateFormat类对象
SimpleDateFormat sdf = new SimpleDateFormat("yyyy年 MM月dd日 HH:mm:ss E");
//第二步,通过创建好的对象来调用format方法(注意形参和返回值类型)
String format = sdf.format(new Date());
//第三步,打印字符串形式的日期
System.out.println(format);
}
}
运行结果 :
这时候可能就有p小将(Personable小将,指风度翩翩的人)要出来挑刺儿说了:噢,你™是演示了,我也看到了。但你那SimpleDateFormat构造器里传入的那一堆是啥玩意儿?什么yy呀,MM的,你搁这儿yy呢?
不愧是p小将,6。没错,创建SimpleDateFormat对象时传入的那一大堆雀氏是我自己杜撰的,但是,我也仅仅是杜撰了格式,那里面的一些字母,什么yy呀MM的,这可由不得我。这是SimpleDateFormat类的API文档中规定的用法。如下图所示 :
up特意将刚刚我们用到的一些符号给标注了出来。虽然纯英文给部分读者看起来觉得很艹😂,但是其实你细看就会发现——不难。我这里只想强调一个点,就是表格下面那句话"字符往往是可以重复的,字符的个数决定了对应数据的精度。"
什么意思呢?比方说,在SimpleDateFormat构造器传入的字符串中,如果我传入了"yyyy"四个y,就可以打印出"2023";但我如果只传入了"yy"两个y,就只能打印出"23"出来,即最后的效果从"2023年"变成了"23"年。其他也同理。大家感兴趣可以自己挨个儿试试,我们这里就不做过多演示了。
3.对构造Date类对象的补充 :
除了上文中演示的Date类对象的两个构造器外,我们还可以通过方法来创建Date类对象——即通过SimpleDateFormat类的parse方法。使用该方法需要先利用带参构造创建一个SimpleDateFormat类对象,然后通过创建好的对象调用parse方法;传入一个字符串,该字符串中包含了你想保存的日期信息,eg : "2023.3.11 星期日",注意:传入的字符串的格式,必须与你创建SimpleDateFormat对象时传入的字符串格式一致;然后使用Date对象来作接收,eg : Date date = sdf.parse(str_0);。注意,使用该方法,IDEA会报编译器异常ParseException,使用throws关键字抛出即可。
Δ演示 :
up仍以Date_类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date; //别忘了导包.
public class Date_ {
public static void main(String[] args) throws ParseException {
//演示 : Date类创建对象的内容补充
SimpleDateFormat sdf = new SimpleDateFormat("yyyy年 M月dd日 HH:mm, E");
String str_0 = "2023年 3月11日 10:19, 星期六";
Date date = sdf.parse(str_0);
System.out.println(date);
}
}
运行结果 :
可以看到,根据parse方法获取的Date对象仍然是默认格式。这时,你也可以再次结合刚才我们讲过的format方法来打印出日期的自定义格式。如下图所示 :
运行结果 :
4.Date类成员方法 :
Date类成员方法很多都已经过时,用的也不多。因此这里我们只说一个方法——
long getTime() :
该方法可以将日期对象转换成对应时间的毫秒值。
Δ演示 :
仍以Date_类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar;
import java.util.Date; //别忘了导包.
public class Date_ {
public static void main(String[] args) throws ParseException {
//演示 : Date类成员方法
Date date = new Date();
long mm = date.getTime();
System.out.println(mm);
}
}
运行结果 :
五、Calendar类
1.简介
Calendar类可以看作是对Date类的一个升级,用于操作日历相关字段。同Date类不同的是,Calendar类属于抽象类,不可被实例化。因此,获取Calendar类的对象我们一般使用Calendar类的静态方法getInstance(后面会演示到)。
Calendar类属于java.base模块,java.util包下,如下图所示 :
我们再来查看一下Calendar类的类图 :
2.Calendar类字段演示 :
Calendar类中有许多的字段,比如说当前系统的年、月、日等等。如下GIF图所示 :
获取这些字段需要调用Calendar类的get方法,返回给定日历字段的值。up以Calendar_类为演示类, 代码如下 :
package csdn.knowledge.api.date_calendar;
import java.util.Calendar;
/**
* @author : Cyan_RA9
* @version : 21.0
*/
public class Calendar_ {
public static void main(String[] args) {
//演示 : 获取Calender类的字段
//1.获取Calendar类实例
Calendar calendar = Calendar.getInstance();
//2.调用get方法
System.out.println("year = " + calendar.get(Calendar.YEAR));
System.out.println("month = " + (calendar.get(Calendar.MONDAY) + 1));
System.out.println("day = " + calendar.get(Calendar.DAY_OF_MONTH));
System.out.println("hour = " + calendar.get(Calendar.HOUR_OF_DAY));
System.out.println("minute = " + calendar.get(Calendar.MINUTE));
System.out.println("second = " + calendar.get(Calendar.SECOND));
System.out.println("-------------------------------");
//3.自由组合
System.out.print("Calendar = ");
System.out.println(calendar.get(Calendar.YEAR) + "年" +
(calendar.get(Calendar.MONDAY) + 1) + "月" +
calendar.get(Calendar.DAY_OF_MONTH) + "日" +
calendar.get(Calendar.HOUR_OF_DAY) + ":" +
calendar.get(Calendar.MINUTE) + ":" +
calendar.get(Calendar.SECOND));
}
}
运行结果 :
关于以上代码强调两点 :
①月份1-12月由0-11表示,因此,若想输出真实月份,需要在get(Calendar.MONTH)基础上再加一。
②Calendar类没有提供格式化日历的方法,因此我们可以自由随意组合,来调用输出。
3.Calendar类方法演示 :
Calendar类其实一共就3个方法要演示——
①static Calendar getInstance() :
该方法可以根据当前系统时区和语言环境获取日历对象。即可获得Calendar类的实例,进而调用起成员方法。
②int get(int field) :
该方法可以返回给定日历相应字段的值。
③void set(int field, int value) :
该方法可以将给定的日历字段设置为指定的值。(有重载)
不过,前两个方法我们前面都已经演示过了,这里就单演示一下第三个方法。仍以Calendar_类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar;
import java.util.Calendar;
/**
* @author : Cyan_RA9
* @version : 21.0
*/
public class Calendar_ {
public static void main(String[] args) {
//演示 : 获取Calender类的set方法
//1.获取Calendar类实例
Calendar calendar = Calendar.getInstance();
//2.调用set方法
calendar.set(Calendar.YEAR, 2002);
calendar.set(Calendar.MONDAY, 0);
calendar.set(Calendar.DAY_OF_MONTH, 1);
System.out.println("year = " + calendar.get(Calendar.YEAR));
System.out.println("month = " + (calendar.get(Calendar.MONDAY) + 1));
System.out.println("day = " + calendar.get(Calendar.DAY_OF_MONTH));
}
}
运行结果 :
六、关于LocalDate, LocalTime, LocalDateTime类
1.Date 和 Calendar类的一些局限性 :
Date 和 Calendar类都是在jdk版本很低的时候就存在的。在使用时它们都或多或少存在一些问题:①可变性:日期和时间这样的类是不应该被随意修改的;②偏移性:Date中的年份是从1900开始的,而Date中的月份都从0开始,不利于表示;③格式化 : Calendar类没有提供格式化日历的方法;④线程安全性 : Date和Calendar类都不是线程安全的,也不能处理闰秒等。
2.java8新特性 :
为了试图解决Date和 Calendar类的局限性,java8引入了LocalDate,LocalTime,以及LocalDateTime这三个类。分别用于表示日期(年月日),时间(时分秒),以及日期 + 时间(年月日时分秒)。
先来看看LocalDateTime类的类图 :
可以看到,与前面两个类对比明显,复杂了不止一倍😂。
3.LocalDateTime, LocalDate, LocalTime的使用 :
up以Local_类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar.java8;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
/**
* @author : Cyan_RA9
* @version : 21.0
*/
public class Local_ {
public static void main(String[] args) {
//演示 : java8新增的三个操作时间和日期的类。
//1.通过LocalDateTime类的now方法,可以获取LocalDateTime类的实例
LocalDateTime localDateTime = LocalDateTime.now();
System.out.println("当前时期 = " + localDateTime);
System.out.println("-------------------------");
System.out.println("The year = " + localDateTime.getYear());
System.out.println("The month = " + localDateTime.getMonth());
System.out.println("The day = " + localDateTime.getDayOfMonth());
System.out.println("The hour = " + localDateTime.getHour()); //24h制
System.out.println("The minute = " + localDateTime.getMinute());
System.out.println("The second = " + localDateTime.getSecond());
System.out.println("-------------------------");
//2.若只考虑获取年月日(日期),可以通过now方法来获取LocalDate对象
LocalDate localDate = LocalDate.now();
System.out.println("当前年月日 = " + localDate);
//3.若只考虑获取时分秒(时间)可以通过now方法来获取LocalTime对象
LocalTime localTime = LocalTime.now();
System.out.println("当前时分秒 = " + localTime);
}
}
运行结果 :
4.LocalDateTime的格式化 :
通过上面的演示我们可以看到,直接打印LocalDateTime对象,输出结果也是默认值。如果我们想格式化它的输出内容,就需要用到DateTimeFormatter类,DateTimeFormatter类与之前讲到的SimpleDateFormat类类似,在使用上也大同小异,不同的地方在于,DateTimeFormatter类对象不能直接new出来(因为该类构造器为私有),而是要通过DateTimeFormatter类的ofPattern方法来获取实例。
up以Local_2类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar.java8;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
/**
* @author : Cyan_RA9
* @version : 21.0
*/
public class Local_2 {
public static void main(String[] args) {
//演示 : LocalDateTime类对象的格式化
//1.通过ofPattern方法来获取DateTimeFormatter类实例
DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss E");
//2.通过now方法来获取LocalDateTime实例
LocalDateTime localDateTime = LocalDateTime.now();
//3.调用format方法来格式化LocalDateTime类对象,以String类型作接收。
String format = dtf.format(localDateTime);
//4.打印格式化后的字符串
System.out.println(format);
}
}
运行结果 :
5.LocalDateTime类成员方法
首先,我必须陈述两个事实 : ①LocalDateTime类的方法非常多,如下GIF图所示 :
②我们已经介绍了API文档,以后大家遇到什么没见过或者不理解的方法,都可以去API文档中进行查看。
因此,up决定只给大家演示一下比较牛逼,看着特别直观的两个方法,那就是plusDays(long daysToSubtract) 和 minusDays(long daysToSubtract)。up以Local_Methods类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar.java8;
import java.time.LocalDateTime;
/**
* @author : Cyan_RA9
* @version : 21.0
*/
public class Local_Methods {
public static void main(String[] args) {
//演示 : LocalDateTime类的两个成员方法
LocalDateTime l1 = LocalDateTime.now();
System.out.println("当前时间 = " + l1);
LocalDateTime l2 = l1.plusDays(620);
System.out.println("620天后是什么日子:" + l2);
LocalDateTime l3 = l1.minusDays(330);
System.out.println("330天前是什么日子:" + l3);
}
}
运行结果 :
6.关于时间戳 :
java提供了Instant类来表示时间戳,见名知意,Instant就是指瞬时时间,时间戳就是某一瞬时时间的特定值。Instant类可以与Date类相互转化。但是要获取Instant对象,需要用到Instant类的静态方法——now方法。
Δ演示 :
up以Instant_类为演示类,代码如下 :
package csdn.knowledge.api.date_calendar.java8;
import java.time.Instant;
import java.util.Date;
/**
* @author : Cyan_RA9
* @version : 21.0
*/
public class Instant_ {
public static void main(String[] args) {
//演示 : 时间戳Instant
//1.通过静态方法now来获取Instant类的实例
Instant instant = Instant.now();
System.out.println(instant);
System.out.println("--------------------");
//2.Date类静态方法——from方法可以实现Instant ——> Date
Date date = Date.from(instant);
System.out.println(date);
System.out.println("--------------------");
//3.通过Date类对象调用toInstant方法,可以实现Date ——> Instant
Instant instant1 = date.toInstant();
System.out.println(instant1);
}
}
运行结果 :
七、总结 :
🆗,以上就是我们Date, Calendar类的全部内容了。重点在于这些类的使用,因为本身并没有什么难度,没有那些抽象的难理解的东西,就是单纯的工具类,会用就行。对于这些类的方法,up没有一一演示出来,大家也不用担心,我们既已学会如何使用API 文档,有遇到什么方法直接去API 文档查看就彳亍。 下一小节就是我们API-常用类的最后一小节——包装类了,大家不见不散! 感谢阅读!
System.out.println("END---------------------------------------------------------");