日期类的理解学习

迷南。 2023-09-28 16:13 1阅读 0赞

#### 文章目录 ####

*  基本介绍
 *   *  Date（第一代日期类）
     *  Calendar（第二代日期类）
     *  第三代日期类
     *   *  DateTimeFormatter格式日期类
         *  Instant时间戳
 *  全部方法
 *   *  Date（第一代日期类）
     *  Calendar（第二代日期类）
     *  第三代日期类
     *   *  LocalDate
         *  LocalTime
         *  LocalDateTime
         *  DateTimeFormatter
         *  Instant

## 基本介绍 ##

### Date（第一代日期类） ###

/**
     * @author:雷子杰
     * @date:2022/7/21
     */
    public class Date01 {
        
        public static void main(String[] args) throws ParseException {
        
            //1. 获取当前系统时间
            //2. 这里的 Date 类是在 java.util 包
            //3. 默认输出的日期格式是国外的方式, 因此通常需要对格式进行转换
            Date d1 = new Date(); //获取当前系统时间
            System.out.println("当前日期=" + d1);
            Date d2 = new Date(9234567); //通过指定毫秒数得到时间
            System.out.println("d2=" + d2); //获取某个时间对应的毫秒数
    
            //1. 创建 SimpleDateFormat 对象，可以指定相应的格式
            //2. 这里的格式使用的字母是规定好，不能乱写
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy 年 MM 月 dd 日 hh:mm:ss E");
            String format = sdf.format(d1); // format:将日期转换成指定格式的字符串
            System.out.println("当前日期=" + format);
    
            //1. 可以把一个格式化的 String 转成对应的 Date
            //2. 得到 Date 仍然在输出时，还是按照国外的形式，如果希望指定格式输出，需要转换
            //3. 在把 String -> Date ， 使用的 sdf 格式需要和你给的 String 的格式一样，否则会抛出转换异常
            String s = "1996 年 01 月 01 日 10:20:30 星期一";
            Date parse = sdf.parse(s);
            System.out.println("parse=" + sdf.format(parse));
        }
    }

![image-20220721225028108][]

### Calendar（第二代日期类） ###

/**
     * @author:雷子杰
     * @date:2022/7/21
     */
    public class Calendar_ {
        
        public static void main(String[] args) {
        
            //1. Calendar 是一个抽象类， 并且构造器是 private
            //2. 可以通过 getInstance() 来获取实例
            //3. 提供大量的方法和字段提供给程序员
            //4. Calendar 没有提供对应的格式化的类，因此需要程序员自己组合来输出(灵活)
            //5. 如果我们需要按照 24 小时进制来获取时间， Calendar.HOUR ==改成=> Calendar.HOUR_OF_DAY
            Calendar c = Calendar.getInstance(); //创建日历类对象//比较简单，自由
            System.out.println("c=" + c);
            //2.获取日历对象的某个日历字段
            System.out.println("年：" + c.get(Calendar.YEAR));
            // 这里为什么要 + 1, 因为 Calendar 返回月时候，是按照 0 开始编号
            System.out.println("月：" + (c.get(Calendar.MONTH) + 1));
            System.out.println("日：" + c.get(Calendar.DAY_OF_MONTH));
            System.out.println("小时：" + c.get(Calendar.HOUR));
            System.out.println("分钟：" + c.get(Calendar.MINUTE));
            System.out.println("秒：" + c.get(Calendar.SECOND));
            //Calender 没有专门的格式化方法，所以需要程序员自己来组合显示
            System.out.println(c.get(Calendar.YEAR) + "-" + (c.get(Calendar.MONTH) + 1) + "-" +c.get(Calendar.DAY_OF_MONTH) +
                    " " + c.get(Calendar.HOUR_OF_DAY) + ":" + c.get(Calendar.MINUTE) + ":" + c.get(Calendar.SECOND) );
        }
    }

![image-20220721225009748][]

### 第三代日期类 ###

> **于JDK8加入**
> 
>  *  LocalDate（日期/年月日）：只包含日期，可以获取日期字段
>  *  LocalTime（时间/时分秒）：只包含时间，可以获取时间字段
>  *  LocalDateTime（日期时间/年月日时分秒）：包含日期+时间，可以获取日期和时间字段

/**
     * @author:雷子杰
     * @date:2022/7/21
     */
    public class LocalDate_ {
        
        public static void main(String[] args) {
        
            //第三代日期
            //1. 使用 now() 返回表示当前日期时间的 对象
            LocalDateTime ldt = LocalDateTime.now(); //LocalDate.now();//LocalTime.now()
            System.out.println(ldt);
            //2. 使用 DateTimeFormatter 对象来进行格式化
            // 创建 DateTimeFormatter 对象
            DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            String format = dateTimeFormatter.format(ldt);
            System.out.println("格式化的日期=" + format);
            System.out.println("年=" + ldt.getYear());
            System.out.println("月=" + ldt.getMonth());
            System.out.println("月=" + ldt.getMonthValue());
            System.out.println("日=" + ldt.getDayOfMonth());
            System.out.println("时=" + ldt.getHour());
            System.out.println("分=" + ldt.getMinute());
            System.out.println("秒=" + ldt.getSecond());
            LocalDate now = LocalDate.now(); //可以获取年月日
            LocalTime now2 = LocalTime.now();//获取到时分秒
            //提供 plus 和 minus 方法可以对当前时间进行加或者减
            //看看 890 天后，是什么时候 把 年月日-时分秒
            LocalDateTime localDateTime = ldt.plusDays(890);
            System.out.println("890 天后=" + dateTimeFormatter.format(localDateTime));
            //看看在 3456 分钟前是什么时候，把 年月日-时分秒输出
            LocalDateTime localDateTime2 = ldt.minusMinutes(3456);
            System.out.println("3456 分钟前 日期=" + dateTimeFormatter.format(localDateTime2));
        }
    }

![image-20220721224951813][]

#### DateTimeFormatter格式日期类 ####

> DateTimeFormatter

//使用 DateTimeFormatter 对象来进行格式化
    //创建 DateTimeFormatter 对象
    DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    String format = dateTimeFormatter.format(日期对象);

#### Instant时间戳 ####

/**
     * @author:雷子杰
     * @date:2022/7/21
     */
    public class Instant_ {
        
        public static void main(String[] args) {
        
            //1.通过 静态方法 now() 获取表示当前时间戳的对象
            Instant now = Instant.now();
            System.out.println("now:"+now);
            //2. 通过 from 可以把 Instant 转成 Date
            Date date = Date.from(now);
            System.out.println("date:"+date);
            //3. 通过 date 的 toInstant() 可以把 date 转成 Instant 对象
            Instant instant = date.toInstant();
    
        }
    }

![image-20220721224913706][]

## 全部方法 ##

> 具体的可以查阅相关api文档

### Date（第一代日期类） ###

<table> 
 <thead> 
  <tr> 
   <th>Modifier and Type</th> 
   <th>Method and Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>after(Date when)</code> 测试此日期是否在指定日期之后。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>before(Date when)</code> 测试此日期是否在指定日期之前。</td> 
  </tr> 
  <tr> 
   <td><code>Object</code></td> 
   <td><code>clone()</code> 返回此对象的副本。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>compareTo(Date anotherDate)</code> 比较两个日期进行订购。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>equals(Object obj)</code> 比较两个日期来平等。</td> 
  </tr> 
  <tr> 
   <td><code>static Date</code></td> 
   <td><code>from(Instant instant)</code> 从 <code>Instant</code>对象获取一个 <code>Date</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getDate()</code> 已弃用 截至JDK 1.1版，由<code>Calendar.get(Calendar.DAY_OF_MONTH)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getDay()</code> 已弃用 截至JDK 1.1版，由<code>Calendar.get(Calendar.DAY_OF_WEEK)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getHours()</code> 已弃用 截至JDK 1.1版，由<code>Calendar.get(Calendar.HOUR_OF_DAY)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getMinutes()</code> 已弃用 截至JDK 1.1版，由<code>Calendar.get(Calendar.MINUTE)</code>取代。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getMonth()</code> 已弃用 截至JDK 1.1版，由<code>Calendar.get(Calendar.MONTH)</code>取代。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getSeconds()</code> 已弃用 截至JDK 1.1版，由<code>Calendar.get(Calendar.SECOND)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>long</code></td> 
   <td><code>getTime()</code> 返回自1970年1月1日以来，由此 <code>Date</code>对象表示的00:00:00 GMT的毫秒 <code>数</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getTimezoneOffset()</code> 已弃用 自JDK 1.1版起，由<code>-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)</code>取代。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getYear()</code> 已弃用 从JDK 1.1版开始，由<code>Calendar.get(Calendar.YEAR) - 1900</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>hashCode()</code> 返回此对象的哈希码值。</td> 
  </tr> 
  <tr> 
   <td><code>static long</code></td> 
   <td><code>parse(String s)</code> 已弃用 从JDK 1.1版开始，由<code>DateFormat.parse(String s)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setDate(int date)</code> 已弃用 从JDK 1.1版开始，由<code>Calendar.set(Calendar.DAY_OF_MONTH, int date)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setHours(int hours)</code> 已弃用 从JDK 1.1版开始，由<code>Calendar.set(Calendar.HOUR_OF_DAY, int hours)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setMinutes(int minutes)</code> 已弃用 从JDK 1.1版开始，由<code>Calendar.set(Calendar.MINUTE, int minutes)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setMonth(int month)</code> 已弃用 从JDK 1.1版开始，由<code>Calendar.set(Calendar.MONTH, int month)</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setSeconds(int seconds)</code> 已弃用 从JDK 1.1版起，由<code>Calendar.set(Calendar.SECOND, int seconds)</code>取代。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setTime(long time)</code> 设置此 <code>Date</code>对象以表示1970年1月1日00:00:00 GMT后的 <code>time</code>毫秒的时间点。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>setYear(int year)</code> 已弃用 截至JDK 1.1版，由<code>Calendar.set(Calendar.YEAR, year + 1900)</code>取代。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>toGMTString()</code> 已弃用 截至JDK 1.1版，由<code>DateFormat.format(Date date)</code> ，使用GMT <code>TimeZone</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>Instant</code></td> 
   <td><code>toInstant()</code> 将此 <code>Date</code>对象转换为 <code>Instant</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>toLocaleString()</code> 已弃用 从JDK 1.1版开始，由<code>DateFormat.format(Date date)</code>替换。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>toString()</code> 将此 <code>Date</code>对象转换为 <code>String</code>的形式：</td> 
  </tr> 
  <tr> 
   <td><code>static long</code></td> 
   <td><code>UTC(int year, int month, int date, int hrs, int min, int sec)</code> 已弃用 截至JDK 1.1版，由<code>Calendar.set(year + 1900, month, date, hrs, min, sec)</code>或<code>GregorianCalendar(year + 1900, month, date, hrs, min, sec)</code> ，使用UTC <code>TimeZone</code> ，其次是<code>Calendar.getTime().getTime()</code> 。</td> 
  </tr> 
 </tbody> 
</table>

### Calendar（第二代日期类） ###

<table> 
 <thead> 
  <tr> 
   <th>Modifier and Type</th> 
   <th>Field and Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>ALL_STYLES</code> <code>getDisplayNames</code>的样式说明符， <a rel="nofollow">表示</a>所有样式的名称，如“1月”和“1月”。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>AM</code> <a rel="nofollow"><code>AM_PM</code></a>字段的值表示从午夜到中午之前的一天中的一段时间。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>AM_PM</code> 对于现场数 <code>get</code>和 <code>set</code>指示是否 <code>HOUR</code>是前或中午之后。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>APRIL</code> <a rel="nofollow"><code>MONTH</code></a>字段的价值 <a rel="nofollow">指示</a>了格里高利和朱利安日历中的第四个月。</td> 
  </tr> 
  <tr> 
   <td><code>protected boolean</code></td> 
   <td><code>areFieldsSet</code> 如果 <code>fields[]</code>与当前设置的时间同步，则为真。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>AUGUST</code> <a rel="nofollow"><code>MONTH</code></a>领域的价值 <a rel="nofollow">指示</a>了公历和朱利安日历中的第八个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DATE</code> <code>get</code>和 <code>set</code>字段编号表示该月的日期。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DAY_OF_MONTH</code> <code>get</code>字段编号和 <code>set</code>本月的日期。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DAY_OF_WEEK</code> <code>get</code>字段编号和 <code>set</code>表示一周中的日期。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DAY_OF_WEEK_IN_MONTH</code> <code>get</code>字段编号和 <code>set</code>当月的 <code>set</code>几的序号。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DAY_OF_YEAR</code> <code>get</code>和 <code>set</code>字段编号， <code>set</code>本年度的日数。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DECEMBER</code> <a rel="nofollow"><code>MONTH</code></a>字段的值表示公历和朱利安日历中的第十二个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>DST_OFFSET</code> <code>get</code>和 <code>set</code>字段编号 <code>get</code>夏令时偏移量（以毫秒为单位）。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>ERA</code> <code>get</code>和 <code>set</code>字段号表示时代，例如在儒略历中的AD或BC。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>FEBRUARY</code> <a rel="nofollow"><code>MONTH</code></a>字段的价值表示今年第二个月在公历和朱利安日历。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>FIELD_COUNT</code> <code>get</code>和 <code>set</code>的不同字段的数量。</td> 
  </tr> 
  <tr> 
   <td><code>protected int[]</code></td> 
   <td><code>fields</code> 该日历的当前设置时间的日历字段值。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>FRIDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示周五。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>HOUR</code> <code>get</code>和 <code>set</code>字段编号， <code>get</code>上午或下午的小时。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>HOUR_OF_DAY</code> <code>get</code>字段编号和 <code>set</code>当天的小时数。</td> 
  </tr> 
  <tr> 
   <td><code>protected boolean[]</code></td> 
   <td><code>isSet</code> 说明是否设置日历的指定日历字段的标志。</td> 
  </tr> 
  <tr> 
   <td><code>protected boolean</code></td> 
   <td><code>isTimeSet</code> 如果那么那么 <code>time</code>的值是有效的。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>JANUARY</code> <a rel="nofollow"><code>MONTH</code></a>字段的价值表示今年首次在公历和朱利安日历。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>JULY</code> <a rel="nofollow"><code>MONTH</code></a>字段的值代表了 <a rel="nofollow">公历</a>和朱利安日历中的第七个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>JUNE</code> <a rel="nofollow"><code>MONTH</code></a>字段的价值 <a rel="nofollow">指示</a>了公历和朱利安日历中的第六个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>LONG</code> <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code></a>相当于 <code>LONG_FORMAT</code>的样式说明 <a rel="nofollow">符</a> 。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>LONG_FORMAT</code> <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> ， <a rel="nofollow">表示</a>用于格式的长名称。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>LONG_STANDALONE</code> 一个 <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> ， <a rel="nofollow">表示</a>一个独立使用的长名称，例如月份名称作为日历头。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>MARCH</code> <a rel="nofollow"><code>MONTH</code></a>字段的值代表了 <a rel="nofollow">公历</a>和朱利安日历中的第三个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>MAY</code> <a rel="nofollow"><code>MONTH</code></a>领域的价值 <a rel="nofollow">指示</a>了公历和朱利安日历中的第五个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>MILLISECOND</code> <code>get</code>和 <code>set</code>字段号表示 <code>get</code>内的 <code>set</code>数。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>MINUTE</code> <code>get</code>和 <code>set</code>字段编号表示小时内的分钟。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>MONDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示星期一。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>MONTH</code> <code>get</code>和 <code>set</code>字段号表示月份。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>NARROW_FORMAT</code> <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> ， <a rel="nofollow">表示</a>用于格式的窄名称。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>NARROW_STANDALONE</code> <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> <a rel="nofollow">独立地</a>表示一个狭义的名称。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>NOVEMBER</code> <a rel="nofollow"><code>MONTH</code></a>领域的价值 <a rel="nofollow">指示</a>了公历和朱利安日历中的第十一个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>OCTOBER</code> <a rel="nofollow"><code>MONTH</code></a>字段的价值表示在公历和朱利安日历中的一年中的第十个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>PM</code> <a rel="nofollow"><code>AM_PM</code></a>字段的值表示从中午到午夜之前的一天中的一段时间。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SATURDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示星期六。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SECOND</code> <code>get</code>和 <code>set</code>字段编号表示分钟内的第二个。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SEPTEMBER</code> <a rel="nofollow"><code>MONTH</code></a>字段的值代表了 <a rel="nofollow">公历</a>和朱利安日历中的第九个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SHORT</code> <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> ， <a rel="nofollow">相当于</a> <a rel="nofollow"><code>SHORT_FORMAT</code></a> 。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SHORT_FORMAT</code> <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> ， <a rel="nofollow">表示</a>用于格式的短名称。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SHORT_STANDALONE</code> 一个用于 <a rel="nofollow"><code>getDisplayName</code></a>和 <a rel="nofollow"><code>getDisplayNames</code>的</a>样式说明 <a rel="nofollow">符</a> ， <a rel="nofollow">表示</a>一个简单的名称，例如一个月缩写作为日历头。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>SUNDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示星期天。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>THURSDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示星期四。</td> 
  </tr> 
  <tr> 
   <td><code>protected long</code></td> 
   <td><code>time</code> 这个日历的当前设定时间，以1970年1月1日，格林尼治标准时间0:00:00之后的毫秒表示。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>TUESDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示周二。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>UNDECIMBER</code> <a rel="nofollow"><code>MONTH</code></a>字段的值表示一年的第十三个月。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>WEDNESDAY</code> <a rel="nofollow"><code>DAY_OF_WEEK</code></a>字段的值表示周三。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>WEEK_OF_MONTH</code> <code>get</code>和 <code>set</code>字段编号， <code>set</code>当月的周数。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>WEEK_OF_YEAR</code> <code>get</code>和 <code>set</code>字段编号， <code>set</code>本年度的周数。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>YEAR</code> <code>get</code>现场编号和 <code>set</code>表示年份。</td> 
  </tr> 
  <tr> 
   <td><code>static int</code></td> 
   <td><code>ZONE_OFFSET</code> <code>get</code>和 <code>set</code>字段编号， <code>get</code> GMT以毫秒为 <code>get</code>的原始偏移量。</td> 
  </tr> 
 </tbody> 
</table>

### 第三代日期类 ###

#### LocalDate ####

<table> 
 <thead> 
  <tr> 
   <th>Modifier and Type</th> 
   <th>Method and Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>Temporal</code></td> 
   <td><code>adjustInto(Temporal temporal)</code> 调整指定的时间对象与此对象的日期相同。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>atStartOfDay()</code> 将此日期与午夜时间结合 <code>LocalDateTime</code> ，在此日期开始时创建一个 <code>LocalDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>ZonedDateTime</code></td> 
   <td><code>atStartOfDay(ZoneId zone)</code> 根据时区中的规则，在最早的有效时间内从此日期返回划分的日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>atTime(int hour, int minute)</code> 结合此日期与时间创建一个 <code>LocalDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>atTime(int hour, int minute, int second)</code> 结合此日期与时间创建一个 <code>LocalDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>atTime(int hour, int minute, int second, int nanoOfSecond)</code> 结合此日期与时间创建一个 <code>LocalDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>atTime(LocalTime time)</code> 结合此日期与时间创建一个 <code>LocalDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>OffsetDateTime</code></td> 
   <td><code>atTime(OffsetTime time)</code> 将此日期与偏移时间相结合以创建 <code>OffsetDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>compareTo(ChronoLocalDate other)</code> 将此日期与另一个日期进行比较。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>equals(Object obj)</code> 检查这个日期是否等于另一个日期。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>format(DateTimeFormatter formatter)</code> 使用指定的格式化程序格式化此日期。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>from(TemporalAccessor temporal)</code> 从时间对象获取一个 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>get(TemporalField field)</code> 从此日期获取指定字段的 <code>int</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>IsoChronology</code></td> 
   <td><code>getChronology()</code> 获取这个日期的时间顺序，即ISO日历系统。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getDayOfMonth()</code> 获取月份字段。</td> 
  </tr> 
  <tr> 
   <td><code>DayOfWeek</code></td> 
   <td><code>getDayOfWeek()</code> 获取星期几字段，这是一个枚举 <code>DayOfWeek</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getDayOfYear()</code> 获得日期字段。</td> 
  </tr> 
  <tr> 
   <td><code>Era</code></td> 
   <td><code>getEra()</code> 获得这个时代适用的时代。</td> 
  </tr> 
  <tr> 
   <td><code>long</code></td> 
   <td><code>getLong(TemporalField field)</code> 从此日期获取指定字段的值为 <code>long</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>Month</code></td> 
   <td><code>getMonth()</code> 使用 <code>Month</code>枚举获取月份字段。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getMonthValue()</code> 将月份字段从1到12。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getYear()</code> 获取年份字段。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>hashCode()</code> 这个日期的哈希码。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isAfter(ChronoLocalDate other)</code> 检查此日期是否在指定日期之后。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isBefore(ChronoLocalDate other)</code> 检查此日期是否在指定日期之前。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isEqual(ChronoLocalDate other)</code> 检查此日期是否等于指定的日期。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isLeapYear()</code> 根据ISO培训日历系统规则，检查年份是否是闰年。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isSupported(TemporalField field)</code> 检查指定的字段是否受支持。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isSupported(TemporalUnit unit)</code> 检查指定的单位是否受支持。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>lengthOfMonth()</code> 返回由此日期表示的月份的长度。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>lengthOfYear()</code> 返回由此日期表示的年份的长度。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>minus(long amountToSubtract, TemporalUnit unit)</code> 返回此日期的副本，减去指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>minus(TemporalAmount amountToSubtract)</code> 返回此日期的副本，减去指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>minusDays(long daysToSubtract)</code> 返回此 <code>LocalDate</code>的副本，并减去指定的天数。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>minusMonths(long monthsToSubtract)</code> 返回此 <code>LocalDate</code>的副本，指定的时间间隔减去。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>minusWeeks(long weeksToSubtract)</code> 返回此 <code>LocalDate</code>一个副本，其中指定的周期以周为单位减去。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>minusYears(long yearsToSubtract)</code> 返回此 <code>LocalDate</code>的副本，以减去的年份为单位。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>now()</code> 从默认时区的系统时钟获取当前日期。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>now(Clock clock)</code> 从指定的时钟获取当前日期。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>now(ZoneId zone)</code> 从指定时区的系统时钟获取当前日期。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>of(int year, int month, int dayOfMonth)</code> 从一年，一个月和一天获得一个 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>of(int year, Month month, int dayOfMonth)</code> 从一年，一个月和一天获得一个 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>ofEpochDay(long epochDay)</code> 从时代天数获得一个 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>ofYearDay(int year, int dayOfYear)</code> 从一年和一年的一年中获得 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>parse(CharSequence text)</code> 从一个文本字符串（如 <code>2007-12-03</code>获取一个 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDate</code></td> 
   <td><code>parse(CharSequence text, DateTimeFormatter formatter)</code> 使用特定格式化 <code>LocalDate</code>从文本字符串获取 <code>LocalDate</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>plus(long amountToAdd, TemporalUnit unit)</code> 返回此日期的副本，并添加指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>plus(TemporalAmount amountToAdd)</code> 返回此日期的副本，并添加指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>plusDays(long daysToAdd)</code> 返回指定天数的 <code>LocalDate</code>的副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>plusMonths(long monthsToAdd)</code> 返回这个 <code>LocalDate</code>的副本，其指定的时间段以月为单位。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>plusWeeks(long weeksToAdd)</code> 返回这个 <code>LocalDate</code>的副本，并以指定的周期添加周数。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>plusYears(long yearsToAdd)</code> 返回这个 <code>LocalDate</code>的副本，其中指定的时间段以添加的年数表示。</td> 
  </tr> 
  <tr> 
   <td><code>&lt;R&gt; R</code></td> 
   <td><code>query(TemporalQuery&lt;R&gt; query)</code> 使用指定的查询查询此日期。</td> 
  </tr> 
  <tr> 
   <td><code>ValueRange</code></td> 
   <td><code>range(TemporalField field)</code> 获取指定字段的有效值的范围。</td> 
  </tr> 
  <tr> 
   <td><code>long</code></td> 
   <td><code>toEpochDay()</code> 将此日期转换为大纪元日。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>toString()</code> 将此日期输出为 <code>String</code> ，如 <code>2007-12-03</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>Period</code></td> 
   <td><code>until(ChronoLocalDate endDateExclusive)</code> 将此日期和其他日期之间的期间计算为 <code>Period</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>long</code></td> 
   <td><code>until(Temporal endExclusive, TemporalUnit unit)</code> 根据指定的单位计算直到另一个日期的时间量。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>with(TemporalAdjuster adjuster)</code> 返回此日期的调整副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>with(TemporalField field, long newValue)</code> 返回此日期的副本，并将指定的字段设置为新值。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>withDayOfMonth(int dayOfMonth)</code> 返回此日期的副本，并更改日期。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>withDayOfYear(int dayOfYear)</code> 返回此日期的副本，并更改日期。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>withMonth(int month)</code> 返回这个日期的副本，并更改年月日。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>withYear(int year)</code> 返回此日期的副本，并更改年份。</td> 
  </tr> 
 </tbody> 
</table>

#### LocalTime ####

#### LocalDateTime ####

<table> 
 <thead> 
  <tr> 
   <th>Modifier and Type</th> 
   <th>Method and Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>Temporal</code></td> 
   <td><code>adjustInto(Temporal temporal)</code> 调整指定的时间对象与此对象具有相同的日期和时间。</td> 
  </tr> 
  <tr> 
   <td><code>OffsetDateTime</code></td> 
   <td><code>atOffset(ZoneOffset offset)</code> 将此日期时间与偏移量相结合以创建 <code>OffsetDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>ZonedDateTime</code></td> 
   <td><code>atZone(ZoneId zone)</code> 将此日期时间与时区相结合以创建 <code>ZonedDateTime</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>compareTo(ChronoLocalDateTime&lt;?&gt; other)</code> 将此日期时间与其他日期时间进行比较。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>equals(Object obj)</code> 检查这个日期时间是否等于另一个日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>format(DateTimeFormatter formatter)</code> 使用指定的格式化程序格式化此日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>from(TemporalAccessor temporal)</code> 从时间对象获取一个 <code>LocalDateTime</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>get(TemporalField field)</code> 从此日期时间获取指定字段的值为 <code>int</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getDayOfMonth()</code> 获取月份字段。</td> 
  </tr> 
  <tr> 
   <td><code>DayOfWeek</code></td> 
   <td><code>getDayOfWeek()</code> 获取星期几字段，这是一个枚举 <code>DayOfWeek</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getDayOfYear()</code> 获得日期字段。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getHour()</code> 获取时间字段。</td> 
  </tr> 
  <tr> 
   <td><code>long</code></td> 
   <td><code>getLong(TemporalField field)</code> 从此日期时间获取指定字段的值为 <code>long</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getMinute()</code> 获取小时字段。</td> 
  </tr> 
  <tr> 
   <td><code>Month</code></td> 
   <td><code>getMonth()</code> 使用 <code>Month</code>枚举获取月份字段。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getMonthValue()</code> 将月份字段从1到12。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getNano()</code> 获得纳秒第二场。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getSecond()</code> 获得第二分钟的字段。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>getYear()</code> 获取年份字段。</td> 
  </tr> 
  <tr> 
   <td><code>int</code></td> 
   <td><code>hashCode()</code> 这个日期时间的哈希码。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isAfter(ChronoLocalDateTime&lt;?&gt; other)</code> 检查这个日期时间是否在指定的日期之后。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isBefore(ChronoLocalDateTime&lt;?&gt; other)</code> 检查此日期时间是否在指定的日期时间之前。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isEqual(ChronoLocalDateTime&lt;?&gt; other)</code> 检查此日期时间是否等于指定的日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isSupported(TemporalField field)</code> 检查指定的字段是否受支持。</td> 
  </tr> 
  <tr> 
   <td><code>boolean</code></td> 
   <td><code>isSupported(TemporalUnit unit)</code> 检查指定的单位是否受支持。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minus(long amountToSubtract, TemporalUnit unit)</code> 返回此日期时间的副本，并减去指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minus(TemporalAmount amountToSubtract)</code> 返回此日期时间的副本，并减去指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusDays(long days)</code> 返回此 <code>LocalDateTime</code>的副本，其中指定的时间间隔以天为单位。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusHours(long hours)</code> 以指定的时间段返回此 <code>LocalDateTime</code>的副本，以减少的小时数。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusMinutes(long minutes)</code> 返回此 <code>LocalDateTime</code>的副本，以指定的时间间隔减去。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusMonths(long months)</code> 返回此 <code>LocalDateTime</code>的副本，指定的时间以月为单位减去。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusNanos(long nanos)</code> 返回这个 <code>LocalDateTime</code>的副本，以指定的时间减去纳秒。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusSeconds(long seconds)</code> 返回此 <code>LocalDateTime</code>的副本，其中指定的时间间隔以秒为单位。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusWeeks(long weeks)</code> 返回此 <code>LocalDateTime</code>的副本，其中指定的周期以周为单位减去。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>minusYears(long years)</code> 返回此 <code>LocalDateTime</code>的副本，并以减去的年份为单位。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>now()</code> 从默认时区的系统时钟获取当前的日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>now(Clock clock)</code> 从指定的时钟获取当前的日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>now(ZoneId zone)</code> 从指定时区的系统时钟获取当前的日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(int year, int month, int dayOfMonth, int hour, int minute)</code> 从年，月，日，小时和分钟获得 <code>LocalDateTime</code>的实例，将第二和纳秒设置为零。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(int year, int month, int dayOfMonth, int hour, int minute, int second)</code> 从年，月，日，小时，分钟和秒获得 <code>LocalDateTime</code>的实例，将纳秒设置为零。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)</code> 获取的实例 <code>LocalDateTime</code>从年，月，日，小时，分钟，秒和纳秒。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(int year, Month month, int dayOfMonth, int hour, int minute)</code> 从年，月，日，小时和分钟获得 <code>LocalDateTime</code>的实例，将第二和纳秒设置为零。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(int year, Month month, int dayOfMonth, int hour, int minute, int second)</code> 从年，月，日，小时，分钟和秒获得 <code>LocalDateTime</code>的实例，将纳秒设置为零。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)</code> 获取的实例 <code>LocalDateTime</code>从年，月，日，小时，分钟，秒和纳秒。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>of(LocalDate date, LocalTime time)</code> 从日期和时间获取 <code>LocalDateTime</code>一个实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>ofEpochSecond(long epochSecond, int nanoOfSecond, ZoneOffset offset)</code> 使用从1970-01-01T00：00：00Z的时代开始的秒数获得一个 <code>LocalDateTime</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>ofInstant(Instant instant, ZoneId zone)</code> 从 <code>Instant</code>和区域ID获取一个 <code>LocalDateTime</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>parse(CharSequence text)</code> 从一个文本字符串（如 <code>2007-12-03T10:15:30</code>获取一个 <code>LocalDateTime</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>static LocalDateTime</code></td> 
   <td><code>parse(CharSequence text, DateTimeFormatter formatter)</code> 使用特定的格式化 <code>LocalDateTime</code>从文本字符串获取 <code>LocalDateTime</code>的实例。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plus(long amountToAdd, TemporalUnit unit)</code> 返回此日期时间的副本，并添加指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plus(TemporalAmount amountToAdd)</code> 返回此日期时间的副本，并添加指定的金额。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusDays(long days)</code> 返回此 <code>LocalDateTime</code>的副本，并以指定的时间段添加天数。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusHours(long hours)</code> 以指定的时间（以小时为单位）返回此 <code>LocalDateTime</code>的副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusMinutes(long minutes)</code> 以指定的时间（以分钟为单位）返回此 <code>LocalDateTime</code>的副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusMonths(long months)</code> 返回这个 <code>LocalDateTime</code>的副本，其中指定的时间段以月为单位。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusNanos(long nanos)</code> 返回这个 <code>LocalDateTime</code>的副本，其指定时间以纳秒为单位。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusSeconds(long seconds)</code> 以指定的时间段返回此 <code>LocalDateTime</code>的副本，以秒为单位。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusWeeks(long weeks)</code> 返回这个 <code>LocalDateTime</code>的副本，并以指定的周期添加周数。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>plusYears(long years)</code> 返回这个 <code>LocalDateTime</code>的副本，其中指定的时间段以添加的年数表示。</td> 
  </tr> 
  <tr> 
   <td><code>&lt;R&gt; R</code></td> 
   <td><code>query(TemporalQuery&lt;R&gt; query)</code> 使用指定的查询查询此日期时间。</td> 
  </tr> 
  <tr> 
   <td><code>ValueRange</code></td> 
   <td><code>range(TemporalField field)</code> 获取指定字段的有效值的范围。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDate</code></td> 
   <td><code>toLocalDate()</code> 获得这个日期时间的 <code>LocalDate</code>一部分。</td> 
  </tr> 
  <tr> 
   <td><code>LocalTime</code></td> 
   <td><code>toLocalTime()</code> 获得这个日期时间的 <code>LocalTime</code>一部分。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>toString()</code> 将此日期时间输出为 <code>String</code> ，例如 <code>2007-12-03T10:15:30</code> 。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>truncatedTo(TemporalUnit unit)</code> 返回此 <code>LocalDateTime</code>的副本， <code>LocalDateTime</code>时间。</td> 
  </tr> 
  <tr> 
   <td><code>long</code></td> 
   <td><code>until(Temporal endExclusive, TemporalUnit unit)</code> 根据指定的单位计算到另一个日期时间的时间量。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>with(TemporalAdjuster adjuster)</code> 返回此日期时间的调整副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>with(TemporalField field, long newValue)</code> 返回此日期时间的副本，并将指定的字段设置为新值。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withDayOfMonth(int dayOfMonth)</code> 返回此 <code>LocalDateTime</code>的副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withDayOfYear(int dayOfYear)</code> 返回这个 <code>LocalDateTime</code>的副本，并更改日期。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withHour(int hour)</code> 返回此日期值更改的 <code>LocalDateTime</code>的副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withMinute(int minute)</code> 返回这个 <code>LocalDateTime</code>的副本，小时值更改。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withMonth(int month)</code> 返回此年份更改的 <code>LocalDateTime</code>的副本。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withNano(int nanoOfSecond)</code> 返回这个 <code>LocalDateTime</code>的副本，纳秒变化值。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withSecond(int second)</code> 返回这个 <code>LocalDateTime</code>的副本，其中 <code>LocalDateTime</code>了第二分钟的值。</td> 
  </tr> 
  <tr> 
   <td><code>LocalDateTime</code></td> 
   <td><code>withYear(int year)</code> 返回这个 <code>LocalDateTime</code>的副本，年份被更改。</td> 
  </tr> 
 </tbody> 
</table>

#### DateTimeFormatter ####

<table> 
 <thead> 
  <tr> 
   <th>Modifier and Type</th> 
   <th>Method and Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>format(TemporalAccessor temporal)</code> 使用此格式化程序格式化日期时间对象。</td> 
  </tr> 
  <tr> 
   <td><code>void</code></td> 
   <td><code>formatTo(TemporalAccessor temporal, Appendable appendable)</code> 格式化一个日期时间对象到 <code>Appendable</code>使用这个格式化程序。</td> 
  </tr> 
  <tr> 
   <td><code>Chronology</code></td> 
   <td><code>getChronology()</code> 获得在格式化期间使用的压倒一记的年表。</td> 
  </tr> 
  <tr> 
   <td><code>DecimalStyle</code></td> 
   <td><code>getDecimalStyle()</code> 获取在格式化期间使用的DecimalStyle。</td> 
  </tr> 
  <tr> 
   <td><code>Locale</code></td> 
   <td><code>getLocale()</code> 获取格式化期间要使用的区域设置。</td> 
  </tr> 
  <tr> 
   <td><code>Set&lt;TemporalField&gt;</code></td> 
   <td><code>getResolverFields()</code> 获取在解析期间使用的解析器字段。</td> 
  </tr> 
  <tr> 
   <td><code>ResolverStyle</code></td> 
   <td><code>getResolverStyle()</code> 获取在解析过程中使用的解析器样式。</td> 
  </tr> 
  <tr> 
   <td><code>ZoneId</code></td> 
   <td><code>getZone()</code> 获取在格式化期间使用的覆盖区域。</td> 
  </tr> 
  <tr> 
   <td><code>static DateTimeFormatter</code></td> 
   <td><code>ofLocalizedDate(FormatStyle dateStyle)</code> 返回ISO年表的区域设置特定日期格式。</td> 
  </tr> 
  <tr> 
   <td><code>static DateTimeFormatter</code></td> 
   <td><code>ofLocalizedDateTime(FormatStyle dateTimeStyle)</code> 返回ISO时代的区域设置特定的日期时间格式化程序。</td> 
  </tr> 
  <tr> 
   <td><code>static DateTimeFormatter</code></td> 
   <td><code>ofLocalizedDateTime(FormatStyle dateStyle, FormatStyle timeStyle)</code> 返回ISO时代的特定日期和时间格式。</td> 
  </tr> 
  <tr> 
   <td><code>static DateTimeFormatter</code></td> 
   <td><code>ofLocalizedTime(FormatStyle timeStyle)</code> 返回ISO时代的区域设置特定时间格式。</td> 
  </tr> 
  <tr> 
   <td><code>static DateTimeFormatter</code></td> 
   <td><code>ofPattern(String pattern)</code> 使用指定的模式创建格式化程序。</td> 
  </tr> 
  <tr> 
   <td><code>static DateTimeFormatter</code></td> 
   <td><code>ofPattern(String pattern, Locale locale)</code> 使用指定的模式和区域设置创建格式化程序。</td> 
  </tr> 
  <tr> 
   <td><code>TemporalAccessor</code></td> 
   <td><code>parse(CharSequence text)</code> 完全解析产生时间对象的文本。</td> 
  </tr> 
  <tr> 
   <td><code>TemporalAccessor</code></td> 
   <td><code>parse(CharSequence text, ParsePosition position)</code> 使用此格式化器解析文本，提供对文本位置的控制。</td> 
  </tr> 
  <tr> 
   <td><code>&lt;T&gt; T</code></td> 
   <td><code>parse(CharSequence text, TemporalQuery&lt;T&gt; query)</code> 完全解析产生指定类型对象的文本。</td> 
  </tr> 
  <tr> 
   <td><code>TemporalAccessor</code></td> 
   <td><code>parseBest(CharSequence text, TemporalQuery&lt;?&gt;... queries)</code> 完全解析产生指定类型之一的对象的文本。</td> 
  </tr> 
  <tr> 
   <td><code>static TemporalQuery&lt;Period&gt;</code></td> 
   <td><code>parsedExcessDays()</code> 一个查询，可以访问已解析的多余天数。</td> 
  </tr> 
  <tr> 
   <td><code>static TemporalQuery&lt;Boolean&gt;</code></td> 
   <td><code>parsedLeapSecond()</code> 提供访问是否解析了跨越秒的查询。</td> 
  </tr> 
  <tr> 
   <td><code>TemporalAccessor</code></td> 
   <td><code>parseUnresolved(CharSequence text, ParsePosition position)</code> 使用此格式化程序解析文本，而无需解析结果，用于高级用例。</td> 
  </tr> 
  <tr> 
   <td><code>Format</code></td> 
   <td><code>toFormat()</code> 将此格式化程序作为 <code>java.text.Format</code>实例返回。</td> 
  </tr> 
  <tr> 
   <td><code>Format</code></td> 
   <td><code>toFormat(TemporalQuery&lt;?&gt; parseQuery)</code> 将此格式化器返回为 <code>java.text.Format</code>实例，将使用指定的查询进行解析。</td> 
  </tr> 
  <tr> 
   <td><code>String</code></td> 
   <td><code>toString()</code> 返回底层格式化程序的描述。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withChronology(Chronology chrono)</code> 使用新的覆盖年表返回此格式化程序的副本。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withDecimalStyle(DecimalStyle decimalStyle)</code> 使用新的DecimalStyle返回此格式化程序的副本。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withLocale(Locale locale)</code> 使用新的语言环境返回此格式化程序的副本。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withResolverFields(Set&lt;TemporalField&gt; resolverFields)</code> 使用一组新的解析器字段返回此格式化程序的副本。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withResolverFields(TemporalField... resolverFields)</code> 使用一组新的解析器字段返回此格式化程序的副本。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withResolverStyle(ResolverStyle resolverStyle)</code> 使用新的解析器样式返回此格式化程序的副本。</td> 
  </tr> 
  <tr> 
   <td><code>DateTimeFormatter</code></td> 
   <td><code>withZone(ZoneId zone)</code> 使用新的覆盖区域返回此格式化程序的副本。</td> 
  </tr> 
 </tbody> 
</table>

#### Instant ####

[image-20220721225028108]: https://img-blog.csdnimg.cn/img_convert/38ad7b7e2a34857d1cbb070fc9d73026.png
[image-20220721225009748]: https://img-blog.csdnimg.cn/img_convert/5344d4eb22fb66826f7117b4afad4641.png
[image-20220721224951813]: https://img-blog.csdnimg.cn/img_convert/ded7d67c7b48c71502c6572b83116ccd.png
[image-20220721224913706]: https://img-blog.csdnimg.cn/img_convert/59f27b135a51a932b9fd4574e6de51ff.png