SpringBoot操作日期和时间

1、数据库中的日期和时间

注意:在数据库中常用的有三种类型用来操作日期和时间,如下所示:

1: date    存储的数据类型为年月日,例如:2019-01-02。

2: time    存储的数据类型为时分秒,例如:12:09:22。

3:datetime   存储的数据类型为日期和时间,即年月日时分秒,例如:2018-01-01 10:29:11 。

以上三种类型在 java 类中均使用Date 类型表示。

2、日期和时间类型数据的添加和查找

数据库中t_admin表格的sql如下:
DROP TABLE IF EXISTS `t_admin`;
CREATE TABLE `t_admin` (
  `admin_id` int NOT NULL AUTO_INCREMENT,
  `admin_name` varchar(255) DEFAULT NULL,
  `admin_birth` date DEFAULT NULL,
  PRIMARY KEY (`admin_id`)
) ENGINE=InnoDB AUTO_INCREMENT=16 DEFAULT CHARSET=utf8;

2.1、数据添加

<!DOCTYPE html>
<html lang="zh-cn">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>
<body>
<div class="container">
    <div class="line bouncein">
        <div class="xs6 xm4 xs3-move xm4-move">
            <div style="height:150px;"></div>
            <div class="media media-y margin-big-bottom">           
            </div>         
            <form action="..." method="post">
            <div class="panel loginbox">
                <div class="panel-body" >
                    <div class="form-group">
                        <div class="field field-icon-right">
                            <input type="text"  name="adminName" />
                            <span class="icon icon-user margin-small"></span>
                        </div>
                    </div>
                    <div class="form-group">
                        <div class="field field-icon-right">
                            <input type="password" name="adminPassword" />
                            <span class="icon icon-key margin-small"></span>
                        </div>
                    </div>
                    <div class="form-group">
                        <div class="field field-icon-right">
                            <input type="text"  name="adminBirth" />
                            <span class="icon icon-key margin-small"></span>
                        </div>
                    </div>
                    </div>
                </div>
                <div style="padding:30px;">
                          <input type="submit" value="注册">
                </div>
            </div>
            </form>          
        </div>
    </div>
</div>
</body>
</html>

我们都知道,在前台传入数据的时候通常是字符串,我们在前台输入字符串日期,然后传输到后台,并封装到对应的日期或者时间字段中。对于表单来说,我们通常使用表单的name属性和数据库的pojo类别中的字段名保持一致,这样就可以自动映射过去,但是由于前台的字符串类型和pojo类中的Date类型不一致,所以无法直接映射,我们需要先进行类型转换,以下是两种类型转换的方式

2.1.1、@DateTimeFormat注解

如下所示:

@Data //lombok注解,省略了get,set,toString等
public class TAdmin implements Serializable {
    private Integer adminId;
    private String adminPassword;
    private String adminName;
    @DateTimeFormat(pattern ="yyyy-MM-dd HH:mm:ss")    private Date adminBirth;
}
使用@DateTimeFormat(pattern = “yyyy-MM-dd HH:mm:ss”)注解在实体字段上。
这种方式的优点是:可以灵活的定义接收的类型
缺点很明显:不能全局统一处理,需要为每个需要转换字段都加注解太麻烦

2.1.2、全局日期处理器

自定义DateConverterConfig实现一下spring提供的Converter,重写里面的convert方法:

//全局日期处理
@Component
public class MyDateConvertConfig implements Converter<String, Date> {
    private static final List<String> formarts = new ArrayList<>(4);
    //定义四种日期类型
    static {
        formarts.add("yyyy-MM");
        formarts.add("yyyy-MM-dd");
        formarts.add("yyyy-MM-dd hh:mm");
        formarts.add("yyyy-MM-dd hh:mm:ss");
    }
    @Override
    public Date convert(String source) {
        String value = source.trim();
        if ("".equals(value)) {
            return null;
        }
        if (value.matches("^\\d{4}-\\d{1,2}$")) {
            //第一种
            return parseDate(value, formarts.get(0));
        } else if (value.matches("^\\d{4}-\\d{1,2}-\\d{1,2}$")) {
            //第二种
            return parseDate(value, formarts.get(1));
        } else if (value.matches("^\\d{4}-\\d{1,2}-\\d{1,2} {1}\\d{1,2}:\\d{1,2}$")) {
            //第三种
            return parseDate(value, formarts.get(2));
        } else if (value.matches("^\\d{4}-\\d{1,2}-\\d{1,2} {1}\\d{1,2}:\\d{1,2}:\\d{1,2}$")) {
            //第四种
            return parseDate(value, formarts.get(3));
        } else {
            throw new IllegalArgumentException("Invalid boolean value '" + value + "'");
        }
    }
    //格式化日期
    public Date parseDate(String dateStr, String format) {
        Date date = null;
        try {
            DateFormat dateFormat = new SimpleDateFormat(format);
            date = dateFormat.parse(dateStr);
        } catch (Exception e) {

        }
        return date;
    }
}

我这里是springboot项目通过@Component注解将这个类交给spring容器托管的,如果springmvc项目还需要到xml配置文件注册这个类。优点很明显了:足够灵活,在静态代码块里自定义任意格式日期,在重写的方法里在配上对应的正则表达式就行,也可以做到全局统一处理。


访问上面的注册页面,请求到达Controller层:

@RequestMapping("/check")
    @ResponseBody
    public String regCheck(TAdmin admin ){
        System.out.println(admin);
        adminService.insertAdmin(admin);
        return "success";
    }

service层省略,dao层使用逆向工程自动生成的即可。


注意:数据库中admin_birth的类型为date类型,所以插入到数据库中的结果如下:

 admin_id       admin_name    admin_birth
        15                 syw          2021-01-31

注意:以上是数据库中为 date 类型的字段的插入,time类型和datetime类型也是一样。

2.2、数据查找

注意我们需要设置一下返回的类型,否则返回的日期可能不是我们想要的,我们通过在实体类的日期属性上,加上@JsonFormat注解,利用它的pattern属性来进行时间的格式化,利用timezone属性来解决时差问题。“GMT+8”表示我们在东八区,不然我们查询到的结果可能相差8个小时。

这里我们仍然以TAdmin中的adminBirth字段进行查询,如下所示:

这里写出我们的controller和service,dao依赖使用逆向工程生成的,没有改动。

controller层:

 @RequestMapping("/searchByDate")
    @ResponseBody
    public List<TAdmin> selectByDate() throws ParseException {
        return adminService.findAdminByTime();
    }

service层:

public List<TAdmin> findAdminByTime() throws ParseException {
        String date="2021-01-29"; //要查询的日期
        TAdminExample tAdminExample = new TAdminExample();
        TAdminExample.Criteria criteria = tAdminExample.createCriteria();
        //使用工具类,把字符串转换成指定的日期类型
        criteria.andAdminBirthEqualTo(DateUtils.parseDate(date,"yyyy-MM-dd"));
        return adminMapper.selectByExample(tAdminExample);
    }
2.2.1、对应字段没有使用@JsonFormat注解的情况

TAdmin中的adminBirth字段如果没有添加对应的注解,访问localhost/searchByDate得到的结果如下:


可以看到,其中adminBirth中的日期和我们查询的日期直接存在时差,大概八个小时左右。这与数据库中的真实日期并不一致。

2.2.1、使用@JsonFormat注解的情况

需要在pom文件中引入相应的jar包:如果是web项目,则jackson-annotations不需要引入,因为springboot-web中已经带有了

   <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-annotations</artifactId>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
    </dependency>

对应的实体类如下:

@Data
public class TAdmin implements Serializable {
    private Integer adminId;
    private String adminName;
    ...
    //@DateTimeFormat(pattern ="yyyy-MM-dd HH:mm:ss")
    @JsonFormat(pattern = "yyyy-MM-dd",timezone = "GMT+8")   //设置查询返回的日期格式和时区
    private Date adminBirth;
}

可以看到我们的adminBirth字段已经加上了注解,此时访问localhost/searchByDate得到的结果如下:


可以看到此时我们的查询结果才是正确的。

3、Java8中的日期

关键类

  • Instant:瞬时实例。
  • LocalDate:本地日期,不包含具体时间 例如:2014-01-14 可以用来记录生日、纪念日、加盟日等。
  • LocalTime:本地时间,不包含日期。
  • LocalDateTime:组合了日期和时间,但不包含时差和时区信息。
  • ZonedDateTime:最完整的日期时间,包含时区和相对UTC或格林威治的时差。

新API还引入了 ZoneOffSet 和 ZoneId 类,使得解决时区问题更为简便。解析、格式化时间的 DateTimeFormatter    类也全部重新设计。

实战

在教程中我们将通过一些简单的实例来学习如何使用新API,因为只有在实际的项目中用到,才是学习新知识以及新技术最快的方式。

1. 获取当前的日期

Java 8 中的LocalDate用于表示当天日期。和 java.util.Date不同,它只有日期,不包含时间。当你仅需要表示日期时就用这个类。

//获取今天的日期
public void getCurrentDate(){
    LocalDate today = LocalDate.now();
    System.out.println("Today's Local date : " + today);
    //这个是作为对比
    Date date = new Date();
    System.out.println(date);
}


上面的代码创建了当天的日期,不含时间信息。打印出的日期格式非常友好,不像 Date类 打印出一堆没有格式化的信息。

2. 获取年、月、日信息

LocalDate提供了获取年、月、日的快捷方法,其实例还包含很多其它的日期属性。通过调用这些方法就可以很方便的得到需要的日期信息,不用像以前一样需要依赖java.util.Calendar类了。

//获取年、月、日信息
public void getDetailDate(){
    LocalDate today = LocalDate.now();
    int year = today.getYear();
    int month = today.getMonthValue();
    int day = today.getDayOfMonth();      
    System.out.printf("Year : %d  Month : %d  day : %d t %n", year, month, day);
}


3.处理特定日期

在第一个例子里,我们通过静态工厂方法now()非常容易地创建了当天日期。我们还可以调用另一个有用的工厂方法LocalDate.of()创建任意日期, 该方法需要传入年、月、日做参数,返回对应的LocalDate实例。这个方法的好处是没再犯老API的设计错误,比如年度起始于1900,月份是从0开始等等。日期所见即所得,就像下面这个例子表示了1月21日,直接明了。

//处理特定日期
public void handleSpecilDate(){
    LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);
    System.out.println("The specil date is : " + dateOfBirth);
}


4.判断两个日期是否相等

现实生活中有一类时间处理就是判断两个日期是否相等。在项目开发的时候总会遇到这样子的问题。

下面这个例子会帮助你用Java 8的方式去解决,LocalDate重载了equal方法。注意,如果比较的日期是字符型的,需要先解析成日期对象再作判断。

请看下面的例子:

//判断两个日期是否相等
public void compareDate(){
    LocalDate today = LocalDate.now();
    LocalDate date1 = LocalDate.of(2018, 01, 21);        
    if(date1.equals(today)){
           System.out.printf("TODAY %s and DATE1 %s are same date %n", today, date1);
    }
}


5.检查像生日这种周期性事件

Java 中另一个日期时间的处理就是检查类似生日、纪念日、法定假日(国庆以及春节)、或者每个月固定时间发送邮件给客户 这些周期性事件。

Java中如何检查这些节日或其它周期性事件呢?答案就是MonthDay类。这个类组合了月份和日,去掉了年,这意味着你可以用它判断每年都会发生事件。和这个类相似的还有一个YearMonth类。这些类也都是不可变并且线程安全的值类型。下面我们通过MonthDay来检查周期性事件:

//处理周期性的日期
public void cycleDate(){
    LocalDate today = LocalDate.now();
    LocalDate dateOfBirth = LocalDate.of(2018, 01, 21);    
    MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
    MonthDay currentMonthDay = MonthDay.from(today);
    if(currentMonthDay.equals(birthday)){
       System.out.println("Many Many happy returns of the day !!");
    }else{
       System.out.println("Sorry, today is not your birthday");
    }
}


6.获取当前时间

与 获取日期 例子很像,获取时间使用的是LocalTime类,一个只有时间没有日期的LocalDate近亲。可以调用静态工厂方法now()来获取当前时间。默认的格式是hh:mm:ss:nnn

//获取当前时间
public void getCurrentTime(){
    LocalTime time = LocalTime.now();
    System.out.println("local time now : " + time);
}


7.在现有的时间上增加小时

Java 8 提供了更好的 plusHours() 方法替换 add() ,并且是兼容的。注意,这些方法返回一个全新的LocalTime实例,由于其不可变性,返回后一定要用变量赋值。

//增加小时
public void plusHours(){
    LocalTime time = LocalTime.now();
    LocalTime newTime = time.plusHours(2); // 增加两小时
    System.out.println("Time after 2 hours : " +  newTime);
}


8.如何计算一个星期之后的日期

和上个例子计算两小时以后的时间类似,这个例子会计算一周后的日期。LocalDate日期不包含时间信息,它的plus()方法用来增加天、周、月,ChronoUnit类声明了这些时间单位。由于LocalDate也是不变类型,返回后一定要用变量赋值。

可以用同样的方法增加1个月、1年、1小时、1分钟甚至一个世纪,更多选项可以查看Java 8 API中的ChronoUnit类。

//如何计算一周后的日期
public void nextWeek(){
    LocalDate today = LocalDate.now();
    LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);    //使用变量赋值
    System.out.println("Today is : " + today);
    System.out.println("Date after 1 week : " + nextWeek);
}


9.计算一年前或一年后的日期

接着上面的例子中我们通过LocalDateplus()方法增加天数、周数或月数,这个例子我们利用minus()方法计算一年前的日期。

//计算一年前或一年后的日期
public void minusDate(){
    LocalDate today = LocalDate.now();
    LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
    System.out.println("Date before 1 year : " + previousYear);
    LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
    System.out.println("Date after 1 year : " + nextYear);
}


10.使用Java 8的Clock时钟类

Java 8增加了一个 Clock 时钟类用于获取当时的时间戳,或当前时区下的日期时间信息。以前用到System.currentTimeInMillis() 和 TimeZone.getDefault() 的地方都可用Clock替换。

public void clock(){
    // 根据系统时间返回当前时间并设置为UTC。
    Clock clock = Clock.systemUTC();
    System.out.println("Clock : " + clock);
    // 根据系统时钟区域返回时间
    Clock defaultClock = Clock.systemDefaultZone();
    System.out.println("Clock : " + clock);
}


11.判断日期是早于还是晚于另一个日期

LocalDate 类有两类方法isBefore()isAfter()用于比较日期。调用isBefore()方法时,如果给定日期小于当前日期则返回 true。

//如何用Java判断日期是早于还是晚于另一个日期
public void isBeforeOrIsAfter(){
    LocalDate today = LocalDate.now();     
    LocalDate tomorrow = LocalDate.of(2018, 1, 29);
    if(tomorrow.isAfter(today)){
        System.out.println("Tomorrow comes after today");
    }
    //减去一天
    LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);
    if(yesterday.isBefore(today)){
        System.out.println("Yesterday is day before today");
    }
}


12.处理时区

Java 8不仅分离了日期和时间,也把时区分离出来了。现在有一系列单独的类如 ZoneId 来处理特定时区,ZoneDateTime 类来表示某时区下的时间。

//获取特定时区下面的时间
public void getZoneTime(){
    //设置时区
    ZoneId america = ZoneId.of("America/New_York");
    LocalDateTime localtDateAndTime = LocalDateTime.now();    
    ZonedDateTime dateAndTimeInNewYork  = ZonedDateTime.of(localtDateAndTime, america );
    System.out.println("现在的日期和时间在特定的时区 : " + dateAndTimeInNewYork);
}


13.如何体现出固定日期

例如:表示信用卡到期这类固定日期。与 MonthDay 检查重复事件的例子相似,YearMonth是另一个组合类,用于表示信用卡到期日、FD到期日、期货期权到期日等。

还可以用这个类得到 当月共有多少天,YearMonth 实例的lengthOfMonth()方法可以返回当月的天数,在判断2月有28天还是29天时非常有用。

//使用 YearMonth类处理特定的日期
public void checkCardExpiry(){
    YearMonth currentYearMonth = YearMonth.now();
    System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());
    YearMonth creditCardExpiry = YearMonth.of(2028, Month.FEBRUARY);
    System.out.printf("Your credit card expires on %s %n", creditCardExpiry);
}


14.检查闰年

LocalDate类有一个很实用的方法isLeapYear()判断该实例是否是一个闰年,如果你还是想重新发明轮子,这有一个代码示例,纯Java逻辑编写的判断闰年的程序。

//检查闰年
public void isLeapYear(){
    LocalDate today = LocalDate.now();
    if(today.isLeapYear()){
        System.out.println("This year is Leap year");
    }else {
        System.out.println("2018 is not a Leap year");
    }
}


15.计算两个日期之间的天数和月数

有一个常见日期操作是计算两个日期之间的天数、周数或月数。在Java 8中可以用java.time.Period类来做计算。下面这个例子中,我们计算了当天和将来某一天之间的月数。

下面的例子:现在是一月份,距离到五月份,中间相隔3月

//计算两个日期之间的天数和月数
public void calcDateDays(){
    LocalDate today = LocalDate.now();
    LocalDate java8Release = LocalDate.of(2018, Month.MAY, 14);
    Period periodToNextJavaRelease = Period.between(today, java8Release);
    System.out.println("Months left between today and Java 8 release : "
                                           + periodToNextJavaRelease.getMonths() );
}


16.包含时差信息的日期和时间

ZoneOffset类用来表示时区,举例来说印度与GMT或UTC标准时区相差+05:30,可以通过ZoneOffset.of()静态方法来 获取对应的时区。一旦得到了时差就可以通过传入LocalDateTime和ZoneOffset来创建一个OffSetDateTime对象。

public void ZoneOffset(){
    LocalDateTime datetime = LocalDateTime.of(2018, Month.FEBRUARY, 14, 19, 30);
    ZoneOffset offset = ZoneOffset.of("+05:30");
    OffsetDateTime date = OffsetDateTime.of(datetime, offset);  
    System.out.println("Date and Time with timezone offset in Java : " + date);
}


17.获取当前的时间戳

Instant类有一个静态工厂方法now()会返回当前的时间戳,如下所示:

public void getTimestamp(){
    Instant timestamp = Instant.now();
    System.out.println("What is value of this instant " + timestamp);
}


18.使用预定义的格式化工具去解析或格式化日期

Java 8引入了全新的日期时间格式工具,线程安全而且使用方便。它自带了一些常用的内置格式化工具。

下面这个例子使用了BASIC_ISO_DATE格式化工具将2018年2月10日格式化成20180210。

// 使用预定义的格式化工具去解析或格式化日期
public void formateDate(){
    String dayAfterTommorrow = "20180210";
    LocalDate formatted = LocalDate.parse(dayAfterTommorrow, DateTimeFormatter.BASIC_ISO_DATE);
    System.out.printf("Date generated from String %s is %s %n", dayAfterTommorrow, formatted);
}



全部评论