java.time.Year

1 java.time.Year介绍

Java Year类是代表一年的不可变日期时间对象。它继承了Object类并实现Comparable接口。

2 java.time.Year声明

让我们看一下java.time.Year类的声明。

public final class Year extends Object implements Temporal, TemporalAdjuster, Comparable<Year>, Serializable  

3 java.time.Year方法

方法 描述
Temporal adjustInto(Temporal temporal) 调整指定的时间对象以获得年份。
LocalDate atDay(int dayOfYear) 将年份与年中的日期相结合,创建一个LocalDate。
YearMonth atMonth(int month) 将年份与一个月份结合起来创造一个YearMonth。
YearMonth atMonth(Month month) 将年份与一个月份结合起来创造一个YearMonth。
LocalDate atMonthDay(MonthDay monthDay) 将年份与月份相结合以创建LocalDate。
int compareTo(Year other) 将此年份到另一年份比较。
boolean equals(Object otherYear) 检查引年份是否等于指定的年份。
String format(DateTimeFormatter formatter) 此年份使用指定的格式化程序格式化。
static Year from(TemporalAmount amount) 从时间量获得Year的实例。
int get(TemporalField field) 从int获取此年份指定字段的值。
long getLong(TemporalField field) 获取所请求单位的值。
int getValue() 获取年份值。
int hashCode() 此年份的哈希码。
boolean isAfter(Year other) 检查此年份是否在指定的年份之后。
boolean isBefore(Year other) 检查此年是否在指定年份之前。
boolean isLeap() 根据ISO符号日历系统规则,检查年份是否为闰年。
boolean isLeap(long year) 根据ISO符号日历系统规则,检查年份是否为闰年。
boolean isSupported(TemporalField field) 检查是否支持指定的字段。
boolean isSupported(TemporalUnit unit) 检查指定的单元是否受支持。
boolean isValidMonthDay(MonthDay monthDay) 检查月份是否对此年份有效。
int length() 以天为单位获取此年份的长度。
Year minus(long amountToSubtract, TemporalUnit unit) 返回此年份的副本,减去指定的总量。
Year minus(TemporalAmount amountToSubtract) 返回此年份的副本,并减去指定的年份。
Year minusYears(long yearsToSubtract) 返回此年份的副本,减去指定的年份。
static Year now() 在默认时区中从系统时钟获取当前年份。
static Year now(Clock clock) 从指定的时钟获得当前年份。
static Year now(ZoneId zone) 从指定时区的系统时钟获取当前年份。
static Year of(int years) 获得Year的实例。
static Year parse(CharSequence text) 从文本字符串(例如2007)获取Year值。
static Year parse(CharSequence text, DateTimeFormatter formatter) 使用特定格式化程序从文本字符串中获取Year的实例。
Year plus(long amountToAdd, TemporalUnit unit) 返回添加了指定年份的本年份副本。
Year plus(TemporalAmount amountToAdd) 返回添加了指定年份的本年份副本。
Year plusMonths(long monthsToAdd) 返回指定月份的本年份副本。
Year plusYears(long yearsToAdd) 返回添加了指定年份的本年份副本。
<R> R query(TemporalQuery<R> query) 使用指定Query查询当前年份
ValueRange range(TemporalField field) 获取指定字段的有效值范围。
String toString() 将此年份输出为String。
long until(Temporal endExclusive, TemporalUnit unit) 按指定单位计算直到另一年的时间量。
Year with(TemporalAdjuster adjuster) 返回此年份的调整副本。

4 java.time.Year案例1

package com.yiidian;

/**
 * 一点教程网: http://www.yiidian.com
 */
import java.time.Year;  
public class YearExample1 {  
  public static void main(String[] args) {  
    Year y = Year.now();  
    System.out.println(y);  
  }  
}  

输出结果为:

2017

5 java.time.Year案例2

package com.yiidian;

/**
 * 一点教程网: http://www.yiidian.com
 */
import java.time.LocalDate;  
import java.time.Year;  
public class YearExample2{  
  public static void main(String[] args) {  
    Year y = Year.of(2017);  
    LocalDate l = y.atDay(123);  
    System.out.println(l);  
  }  
}

输出结果为:

2017-05-03

 

热门文章

优秀文章