日期和API

Posted 2020-10-03 forever_elf

　　Java1.0对日期和时间的支持只能依赖java.util.Date类，年份的起始选择是1900你那，月份的起始是从0开始计算的。它的返回值中包含了JVM的默认市区CET，即中欧时间。在Java1.1中使用java.util.Calendar类替代Date。同时格式化和解析日期的DateFormat也只存在于Date中，并且线程不安全。Date和Calendar都是可变的。Java8在java.time中整合了很多Joda-Time的特性。

　　java.time提供了LocalDate，LocalTime，Instant，Duration和Period。

　　

　　LocalDate和LocalTime

　　　　LocalDate和LocalTime的实例都是一个不可变对象，LocalDate只提供了简单的日期，并不包含当天的时间信息，它也不附带任何跟时区相关任何信息。LocalTime只提供了时间。

　　　　TemporalField是一个接口，它可以定义访问temporal对象某个字段的值。ChronoField枚举实现了这个接口，可以使用LocalDate.get(ChronoField)获取某个枚举元素的值。

　　　　　　int year = LocalDate.now().get(ChronoField.YEAR);

　　　　LocalDate和LocalTime都可以通过parse()方法解析代表它们的字符串创建。也可以向parse()方法传递一个DateTimeFormatter，它是替换java.util.DateFormat的替代品。一旦传递的字符串参数无法被解析为合法的LocalDate或LocalTime对象，这两个parse方法都会抛出DateTimeParseException异常。

　　　　　　LocalDate date = LocalDate.parse("2017-07-24");

　　　　　　LocalTime time = LocalTime.parse("12:25:05");

 

　　LocalDateTime

　　　　LocalDateTime是LocalDate和LocalTime的合体，表示了日期和时间，但不带有时区。可以LocalDate和LocalTime可以通过atTime()和atDate()方法创建一个LocalDateTime对象，也可调用LocalDateTime的toLocalDate()和toLocalTime()方法生成LocalDate和LocalTime对象。

　　　　LocalDateTime dateTime = LocalDateTime.of(2017, Month.JULY, 24, 11, 11, 11);
　　　　LocalDate date = LocalDate.now();
　　　　LocalTime time = LocalTime.now();
　　　　LocalDateTime dateTime1 = LocalDateTime.of(date, time);
　　　　LocalDateTime dateTime2 = date.atTime(11, 11);
　　　　LocalDateTime dateTime3 = date.atTime(time);
　　　　LocalDateTime dateTime4 = time.atDate(date);
　　　　LocalDate date1 = dateTime.toLocalDate();
　　　　LocalTime time1 = dateTime1.toLocalTime();

 

　　从计算机的角度来看，建模时间最自然的格式是表示一个持续时间段上某个点的单一大整型数。java.time.Instant类对时间建模的方式是以Unix元年时间开始所经历的秒数进行计算。可以通过静态工厂方法ofEpochSecond传递一个代表描述的值创建一个该类的实例，它也可以接收第二个以秒为单位的参数值，对传入作为描述的参数进行调整。重载的版本会调整纳秒参数，确保保存的纳秒分片在0到999999传入作为秒数的参数进行调整。Instant类支持静态工厂方法now，它能够帮你获取当前时刻的时间戳。

　　　　Instant.ofEpochSecond(3);

　　　　Instant.ofEpochSecond(2, 1000000000); //2s后再加上1s

　　　　Instant.ofEpochSecond(2, -1000000000); //2s之前1s

 

　　Duration或Period

　　　　Temporal接口定义了如何读取和操纵为时间建模的对象的值。Duration类的静态工厂between可以计算两个Temporal对象之间的duration。

　　　　　　Duration d1 = Duration.between(time1, time2);

　　　　　　Duration d2 = Duration.between(datetime1, datetime2);

　　　　　　Duration d3 = Duration.between(instant1, instant1);

　　　　若试图在Instant和LocalDateTime对象之间创建duration，会触发DateTimeException异常。

　　　　若需要以年，月或日的方式对多个时间建模，可以用Period类。

　　　　　　Period tenDays = Period.between(LocalDate.of(2014, 3, 18), LocalDate.of(2014, 3, 18));

　　

　　　　static between　　创建两个时间点之间的interval

　　　　static from　　　  由一个临时时间点创建interval

　　　　static of　　　　　由它的组成部分创建interval实例

　　　　static parse　　    由字符串创建interval的实例

　　　　addTo　　　　　  创建该interval的副本，并将其叠加到某个指定的temporal对象

　　　　get　　　　　　   读取该interval的副本，并将其叠加到某个指定的temporal对象

　　　　isNegative　　　  检查该interval是否为负值，不包含0

　　　　isZero　　　　     检查该interval的时常是否为0

　　　　minus　　　　　  通过减去一定的时间创建该interval的副本

　　　   multipliedPlay      将interval的值乘以某个标量创建该interval的副本

　　　　negated　　   　  以忽略某个时长的方式创建该interval副本

　　　　plus　　　　　　  以增加某个指定的时长的方式创建该interval的副本

　　　　substractFrom     从指定的temporal对象中减去该interval　　

　　

　　创建一个LocalDate对象的修改版，最简单的方式withAttribute方法。withAttribute方法对创建对象的一个副本，并按照需要修改它的属性。通过使用get和with方法，可以将Temporal对象值读取和修改区分开。若Temporal对象不支持请求访问的字段，它会抛出一个UnsupportedTemporalTypeException异常。

　　　　LocalDate date1 = LocalDate.of(2014, 3, 18);

　　　　LocalDate date2 = date1.withYear(2011);

　　　　LocalDate date3 = date2.withDayOfMonth(25);

　　　　LocalDate date4 = date3.with(ChronoField.MONTH_OF_YEAR, 9);

 

　　　　表示时间点的日期-时间类的通用方法

　　static from　　依据传入的Temporal对象创建对象实例

　　static now　　 依据系统时钟创建Temporal对象

　　static of　　　 由Temporal镀锡爱过你的某个部分创建该对象的实例

　　static parse　  由字符串创建Temporal对象的实例

　　atOffset　　　 将Temporal对象和某个时区偏移相结合

　　atZone　　  　 将Temporal对象和某个时区相结合

　　format　　　　使用某个指定的格式将Temporal对象转换为字符串

　　get　　　　　  读取Temporal对象的某一部分的值

　　minus　　　　 创建Temporal对象的一个副本，通过将当前的Temporal对象的值减去一定时长创建该副本

　　plus　　　　　 创建Temporal对象的一个副本，通过将当前的Temporal对象的值加上一顶时长创建该副本

　　with　　　　　以该Temporal对象为模板，对某些状态进行修改创建该对象的副本

 

　　TemporalAdjuster　　

　　　　LocalDate的with方法可以接受一个TemporalAdjuster对象。

　　　　　　LocalDate date1 = LocalDate.of(2014, 3, 18);

　　　　　　LocalDate date2 = date1.with(nextOrSame(DayOfWeek.SUNDAY));

 

　　　　　　TemporalAdjuster类中的工厂方法

　　dayOfWeekInMonth　　创建一个新的日期，它的值为同一个月中每一周的第几天

　　firstDayOfMonth　　　 创建一个新的日期，它的值为当月的第一天

　　firstDayOfNextMonth    创建一个新的日期，它的值为下月的第一天

　　firstDayOfNextYear　　创建一个新的日期，它的值为明年的第一天

　　firstDayOfYear　　　　创建一个新的日期，它的值为当年的第一天

　　firstInMonth　　　　　 创建一个新的日期，它的值为当月的第一天

　　lastDayOfMonth　　　 创建一个新的日期，它的值为当月的最后一天

　　lastDayOfNextMonth    创建一个新的日期，它的值为下个月的最后一天

　　lastDayOfNextYear      创建一个新的日期，它的值为明年的最后一天

      lastDayOfYear　　　　创建一个新的日期，它的值为今年最后一天

　　lastInMonth　　　　    创建一个新的日期，它的值为同一个月中，最后一个符合星期几要求的值

　　next/previous　　　　 创建一个新的日期，并将其设定为日期调整后或者调整前，第一个符合指定星期内要求的日期

　　nextOrSame／previousOrSame　　创建一个新的日期，并将其值设定为日期调整后或调整前，第一个符合指定星期几要求的日期，若该日期已经符合要求，直接返回该对象

　　

 

　　@FunctionalInterface

　　public interface TemporalAdjuster{

　　　　Temporal adjustInto(Temporal temporal);

　　}

　　

public class NextWorkingDay implements TemproalAdjuster{
  public Temporal adjustInto(Temporal temporal){
    DayOfWeek dow = DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
    int dayOfAdd = 1;
    if( dow == DayOfWeek.FRIDAY)
        dayOfAdd = 3;
    else if( dow == DayOfWeek.SATURDAY){
        dayOfAdd = 2;
    }
    return temporal.plus(dayToAdd, ChronoUnit.DAYS);
  }
}

date = date.with( temporal -> {
    public Temporal adjustInto(Temporal temporal){
    DayOfWeek dow = DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
    int dayOfAdd = 1;
    if( dow == DayOfWeek.FRIDAY)
        dayOfAdd = 3;
    else if( dow == DayOfWeek.SATURDAY){
        dayOfAdd = 2;
    }
    return temporal.plus(dayToAdd, ChronoUnit.DAYS);
});


TemporalAdjuster nextWorkingDay = TemporalAdjuster.ofDateAdjust(
  temporal -> {
    DayOfWeek dow = DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
    int dayOfAdd = 1;
    if( dow == DayOfWeek.FRIDAY)
        dayOfAdd = 3;
    else if( dow == DayOfWeek.SATURDAY){
        dayOfAdd = 2;
    }
    return temporal.plus(dayToAdd, ChronoUnit.DAYS);
});    

date = date.with(nextWorkingDay)

 

　　java.time.format用于格式化及解析日期-时间。DateTimeFormatter实例用于以一定的格式创建代表特定日期或时间的字符串，并且线程安全。

　　　　LocalDate date = LocalDate.of(2017, 8, 9);

　　　　String s1 = data.format(DateTimeFormatter.BASIC_ISO_DATE); //20170809

　　　　String s2 = data.format(DateTimeFormatter.ISO_LOCAL_DATE); //2017-08-09

　　　　LocalDate date1 = LocalDate.parse("20170809", DateTimeFormatter.BASIC_ISO_DATE);

　　DateTimeFormatter.ofPattern()方法可以按照某个特定的模式创建格式器，ofPattern()方法还可以创建某个Locale的格式器

　　　　DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");

　　　　DateTimeFormatter italianFormatter = DateTimeFormatter.ofPattern("d. MMMM yyyy", Locale.ITALIAN);

　　　　

 

　　java.time.ZoneId的目的是让你无需为时区处理复杂和繁琐操心。通过调用ZoneId.getRules()得到指定的市区规则。每个特定的ZoneId对象都由一个地区ID标识。

　　　　ZoneId romeZone = ZoneId.of("Europe/Rome");

　　地区ID都为“区域／城市”的格式，这些地区集合的设定都由英特网编号分配机构IANA的时区数据库提供。可以通过toZoneId将一个老时区对象转换为ZoneId。ZoneId与LocalDate，LocalDateTime或Instant整合可以得到ZonedDateTime实例

　　　　ZoneId zoneId = ZoneId.getDefault().toZoneId();

　　　　LocalDate date = LocalDate.of(2014, Month.MARCH, 10);

　　　　ZonedDateTime zdt = date.atStartOfDay(zoneId);

 

　　　　LocalDateTime datetime = LocalDateTime.of(2014, Month.MARCH, 10, 18, 13, 45);

　　　　zdt = datetime.atZone(romeZone);

 

　　　　Instant instant = Instant.now();

　　　　zdt = instant.atZone(romeZone);

 

　　　　Instant instantFromDateTime = dateTime.toInstant(romeZone);

　　　　LocalDateTime dateTimeFromInstant = LocalDateTime.ofInstant(instant, romeZone);

 

　　ISO-8601日历系统是世界文明日历系统的实施标准。Java8还提供呢了4种其它的日历系统。分别是ThaiBuddhistDate,MinguoDate,JapaneseDate以及HijrahDate。这些类及LocalDate都实现了ChronoLocalDate接口。

　　　　LocalDate date = LocalDate.of(2014, Month.MARCH, 10);

　　　　JapeneseDate jDate = JapeneseDate.from(date);

 

　　　　Chronology japaneseChronology = Chronology.ofLocale(Locale.JANPAN);

　　　　ChronoLocalDate now = japaneseChronology.dateNow();