使用 Java 预定义类（学习 Java 编程语言 025）

预定义类就是 Java 类库（或第三方库）中已经定义好的类。

在 Java 中，没有类就无法做任何事情，然而，并不是所有的类都具有面向对象特征。例如，Math 类和 Date 类。

Date 类的实例有一个状态，即特定的时间点。尽管在使用 Date 类时不必知道这一点，但时间使用距离一个固定时间点的毫秒数（可正可负）表示的，这个点就是所谓的纪元（epoch），它是 UTC 时间 1970-01-01 00:00:00。UTC 是 Coordinated Universal Time（国际协调时间）的缩写，与大家熟悉的 GMT （即 Greenwich Mean Time，格林威治时间）一样，是一种具有实践意义的科学标准时间。

Date 类对于处理人类记录日期的日历信息并不是很有用，如 “December 31, 1999, 23:59:59”。这种特定的描述方法遵循了世界上大多数地区使用的 Gregorian 阳历。但是，同样的这个时间点采用中国或希伯来的阴历就很不一样了。

1. 对象与对象变量

在 Java 中要使用构造器构造新实例。

构造器（onstructor，或称构造方法）的名字应该与类名相同，是一种特殊的方法，用来构造并初始化对象。

要想使用对象，就必须首先构造对象，并制定其初始状态。然后，对对象应用方法。

以使用 Date 类的 toString 方法为例：

创建对象。要想构造一个 Date 对象，需要在构造器前面加上 new 操作符：
new Date();
这个表达式构造了一个新对象。
创建并初始化对象变量。要对构造的对象可以多次使用，需要将对象存放在一个变量中：
Date birthday = new Date();
对象变量 birthday 引用了新构造的对象。
对对象应用方法。Date 类中有一个 toString 方法。这个方法将返回日期的字符串描述：
String s = birthday.toString();

在对象与对象变量之间存在着一个重要的区别：
Date deadline; // deadling doesn't refer to any object
定义了一个对象变量 deadling，它可以引用 Date 类型的对象。但是，一定要认识到：变量 deadline 不是一个对象，实际上也没有引用对象。此时还不能在这个变量上使用任何 Date 方法。 下面的语句：
s = dealine.toString(); // not yet
将产生编译错误。

一定要认识到：一个对象变量并没有实际包含一个对象，而仅仅引用一个对象。

在 Java 中，任何对象变量的值都是对存储在另外一个地方的一个对象的引用。new 操作符的返回值也是一个引用。下面的语句：
Date deadling = new Date();
有两个部分。表达式 new Date() 构造了一个 Date 类型的对象，它的值是对新创建对象的一个引用。这个引用存储在变量 deadling 中。

可以显示地将对象变量设置为 null，表明这个对象目前没有引用任何对象。

deadling = null;
...
if (deadline != null)
    System.out.println(deadline);

局部变量不会自动的初始化为 null，而必须通过调用 new 或将他们设置为 null 进行初始化。

2. Java 类库中的 LocalDate 类

类库设计者决定将保存时间与给定时间点命名分开。将时间度量与日历分开是一种很好的面向对象设计。

所以标准 Java 类库分别包含了两个类：一个是用来表示时间点的 Date 类；另一个是用大家熟悉的日历表示法表示日期的 LocalDate 类。

LocalDate 类封装了实例字段来维护所设置的日期。

不要使用构造器来构造 LocalDate 类的对象。实际上，应当使用静态工厂方法（factory method），它会代表你调用构造器：
LocalDate.now();
会构造一个新对象，表示构造这个对象的日期。

可以提供年、月和日来构造对应一个特定日期的对象：
LocalDate newLifeDay = LocalDate.of(2020, 12, 1);
有了 LocalDate 对象，就可以调用 getYear、getMonthValue 和 getDayOfMonth 得到年、月和日。

int year = newLifeDay.getYear(); // 2020
int month = newLifeDay.getMonthValue(); // 12
int day = newLifeDay.getDayOfMonth(); // 1

LocalDate newYearsEve = LocalDate.of(1999, 12, 31);
LocalDate aThousandDaysLater = newYearsEve.plusDays(1000);

plusDays 方法会生成一个新的 LocalDate 对象，然后把这个新对象赋给 aThousandDaysLater 变量。原来的对象不做任何改动。

3. 更改器方法和访问器方法

更改器方法（mutator method）

更改器方法会更改对象的状态的方法。例如 GregorianCalendar.add 方法是一个更改器方法。
访问器方法（accessor method）

访问器方法只访问对象而不修改对象的方法。例如，LocalDate.getYear 和 GregorianCalendar.get 就是访问器方法。

4. 打印日历

星期一 星期二 星期三 星期四 星期五 星期六 星期日
        1     2     3     4*    5     6   
  7     8     9    10    11    12    13   
 14    15    16    17    18    19    20   
 21    22    23    24    25    26    27   
 28    29    30    31

源代码：

import java.time.DayOfWeek;
import java.time.LocalDate;

public class CalendarTest {
    public void print() {
        // 获得当前日期
        LocalDate date = LocalDate.now();
        // 获得当前月
        int month = date.getMonthValue();
        // 获得当前日
        int today = date.getDayOfMonth();

        // 获得当前月的第 1 天
        date = date.minusDays(today - 1);

        DayOfWeek weekDay = date.getDayOfWeek();
        // 获得当前月第 1 天的星期
        int value = weekDay.getValue();

        System.out.println("星期一 星期二 星期三 星期四 星期五 星期六 星期日");
        // 在当前月第 1 天打印空格
        for(int i = 1; i < value; i++) {
            System.out.print("      ");
        }
        while (date.getMonthValue() == month) {
            System.out.printf("%3d", date.getDayOfMonth());

            if (date.getDayOfMonth() == today) {
                // 当前日打印 * 号
                System.out.print("*  ");
            } else {
                System.out.print("   ");
            }

            date = date.plusDays(1);
            // 如果是星期一打印换行符
            if (date.getDayOfWeek().getValue() == 1){
                System.out.println();
            }
        }
        if(date.getDayOfWeek().getValue() != 1) {
            System.out.println();
        }
    }

    public static void main(String[] args) {
        CalendarTest test = new CalendarTest();
        test.print();
    }
}

5. API

java.time.LocalDate 8

static LocalDate now()

构造一个表示当前日期的对象。
static LocalDate of(int year, int month, int day)

构造一个表示给定日期的对象。
int getYear()

得到当前日期的年。
int getMonthValue()

得到当前日期的月。
int getDayOfMonth()

得到当前日期的日。
DayOfWeek getDayOfWeek

得到档期日期是星期几，作为 DayOfWeek 类的一个实例返回。调用 getValue 来得到 1~7 之间的一个数，表示这是星期几，1 表示星期一，7 表示星期日。
LocalDate plusDays(int n)

生成当前日期之后 n 天的日期。
LocalDate minusDays(int n)

生成当前日期之前 n 天的日期。