Java-日期-时间API

Java-日期-时间API,第1张

Java-日期-时间API

文章目录
    • 本地日期类LocalDate
      • 创建LocalDate对象的方法
      • 常用方法
    • 本地时间类
      • 创建LocalTime对象的方法
      • 常用方法
    • 本地日期时间类LocalDateTime
      • 创建LocalTime对象的方法
      • 常用方法
    • Instant类、Duration类、Period类
      • Instant类
      • Duration类
      • Period类
    • 其他常用类
    • 日期时间解析和格式化
      • 时态数据解析
      • 时态数据格式化

本地日期类LocalDate 创建LocalDate对象方法
  • public static LocalDate now():获得默认时区的系统时钟的当前日期
  • public static LocalDate of(int year,int month,int dayOfMonth):通过指定的年月日获得创建对象,月份的有效值为1-12,日的有效值为1-31,如果指定的值非法则抛出异常

日期-时间API中大多数类创建的对象都是不可变的,即对象一经创建就不能改变,这些对象也是线程安全的。创建日期-时间对象使用工厂方法而不是构造方法,如now()方法、of()方法、from()方法、with()方法等。这些类也没有修改方法。

常用方法
  • plusDays,plusWeeks,plusMonths,plusYears给当前的对象增加几天、几周、几个月或几年
  • minusDays,minusWeeks,minusMonths,minusYears
  • plus,minus:给当前的LocalDate对象增加或减少一个Duration或Period
  • withDayOfMonth,withDayofYear,withMonth,withYear:将月的第几天、年的第几天作为心LocalDate对象返回或将月份或年修改为指定值并返回一个新的LocalDate对象
  • getDayOfWeek/Month/Year:返回星期几/月份中的第几天/年份中的第几天
  • getMonth,getMonthValue:返回Month的枚举值或月份的数字值
  • getYear:返回年份值
  • until:得到两个日期之间的Period对象或指定ChronoUnits的数字
  • isBefore,isAfter:将当前LocalDate对象和另外LocalDate对象比较
  • isLeapYear:返回LocalDate对象是否闰年
  • lengthOfMonth,lengthOfYear:返回月的天数和年的天数
本地时间类

LocalTime对象表示本地时间,包含时、分、秒,它是不可变对象,最小精度是纳秒。时间对象中不包含日期和时区。

创建LocalTime对象的方法
  • public static LocalTime now()
  • public static LocalTime of(int hour,int munute,int second[,int nanoOfSecond])
常用方法

类似LocalDate类

LocalTime类的now()方法创建的对象默认带纳秒时间,也可以用truncatedTo()方法将其截短,不保留纳秒

LocalTime time = LocalTime.now();

LocatTime truncatedTime = time.truncatedTo(ChronoUnit.SECONDS);

本地日期时间类LocalDateTime

该类对象实际是LocalDate和LocalTime对象的组合,用来表示一个特定时间的事件

创建LocalTime对象的方法
  • public static LocalTime now()
  • public static LocalTime of(int year,int month,int dayOfMonth,int hour,int munute[,int second]):无设置秒则秒和纳秒设置为0

LocalDateTime类还定义了from()方法,可以从另一种时态格式转换成LocalDateTime实例

常用方法

类似LocalDate类

Instant类、Duration类、Period类

Instant类表示时间轴上的一个点,Duration类和Period类都表示一段时间,前者是基于时间的(秒、纳秒),后者是基于日期的(年、月、日)

Instant类

Instant.now()返回当前的瞬间时间点(格林尼治时间)

格式为年-月-日T时:分:秒.纳秒Z,如1970-01-01T00:00:00.00000Z

Duration类

Duration对象用来表示机器时间,他的测度是基于秒、纳秒的。如果创建Duration实例结束点在开始点之前,它的值可以为负值

为了计算两个瞬时点的时间差,可以使用静态方法Duration.between()

Instant start = Instant.now();
runAlgorithm();
Instant end = Instant.now();
Duration timeElapsed = Duration.between(start, end);
long millis = timeElapsed.toMillis();//得到算法执行的毫秒数
Period类

Period类表示基于日期(年、月、日)的一段时间,该类提供了getDays()、getMonths()、getYears()等方法从Period中抽取一段时间。整个时间段用年、月、日表示,如果要用单元一段时间单位表示,可以用ChronoUnit.between()方法

LocalDate today = LocalDate.now();
        LocalDate birthday = LocalDate.of(2002, 07, 06);
        Period p = Period.between(birthday, today);
        long p2 = ChronoUnit.DAYS.between(birthday, today);
        System.out.printf("%d岁%d月%d天,共%d天",p.getYears(),p.getMonths(),p.getDays(),p2);
其他常用类

Clock类、Year类、YearMonth类、MonthDay类、Month枚举以及ZonedDateTime与OffsetDateTime等

日期时间解析和格式化

日期-时间API提供了parse()方法解析包含日期和时间信息,还提供了format()方法格式化时态数据

时态数据解析

LocalDate.parse(CharSequence[,DateTimeFormatter])方法使用DateTimeFormatter格式化器解析CharSequence,默认的格式化器为ISO_LOCAL_DATE(用于解析形如“xxxx-xx-xx”的日期)若该字符串不能解析称对应的日期-时间数据则抛出异常,可以使用预定义的格式化器,如BASIC_ISO_DATE(用于解析型日xxxxxxxx的日期)

也可以通过指定的模式定义格式化器

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy:MM:dd");
LocalDate date = LocalDate.parse("2020:10:10",formatter);
System.out.printf("%s%n",date);
//输出结果为:2020-10-10

LocalTime类同样有该方法

时态数据格式化

format(DateTimeFormatter)方法使用指定的格式将时态对象表示成字符串

LocalDateTime date = LocalDateTime.now();
System.out.println(date);
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日ahh点mm分ss秒");
String text = date.format(formatter);
System.out.println(text);
//输出结果:2021-10-02T20:07:20.019260900
//        2021年10月02日下午08点07分20秒

欢迎分享,转载请注明来源:内存溢出

原文地址: https://outofmemory.cn/zaji/5119257.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2022-11-17
下一篇 2022-11-17

发表评论

登录后才能评论

评论列表(0条)

保存