朋友们大家好，今天我给大家带来一个控制台小程序——打印当月的日历，效果如下图：

笔者运行这个程序的时候是2022年7月30日，所以在日期的30后面加了一个*符号。

这个程序很简单，但有些知识点我也会为大家详细介绍，接下来按这个顺序来为大家讲解：

0. java.util.Calendar类的使用
1. 控制台布局的设计
2. 程序分步实现
3. 完整代码清单
4. 结束语

一. java.util.Calendar类的使用

在Java类库中有一个类：java.util.Calendar类，它是一个“抽象类”，它里面定义了一些方法，可以进行日期的运算，从而我们可以计算出某年某月的日历。

1.1 获取对象

通过API文档我们可以发现，Calendar类是一个“抽象类”，不能直接new对象，我们可以使用它的子类：
java.util.GregorianCalendar，例如：

Calendar cal = new GregorianCalendar();

这种方式可以获取封装了当前系统日期和时间的GregorianCalendar对象。当然，它还有其它构造方法，全部构造方法如下图：

1.2 获取字段

在Calendar类中提供了一个get(int field)方法，可以获取某个字段的值，例如，下例我们获取这个GregorianCalendar对象的：年、月、日、小时、分、秒、星期等信息：

public class CalendarDemo01 {
    public static void main(String[] args) {
        //1.获取Calendar的子类对象
        Calendar gc = new GregorianCalendar();
        System.out.println(gc);
        //2.成员方法：public int get(int field)：获取某个字段的值
        int year = gc.get(Calendar.YEAR);
        int month = gc.get(Calendar.MONTH) + 1;
        int day = gc.get(Calendar.DAY_OF_MONTH);
//        int hour = gc.get(Calendar.HOUR);//12小时
        int hour = gc.get(Calendar.HOUR_OF_DAY);//24小时
        int minute = gc.get(Calendar.MINUTE);
        int second = gc.get(Calendar.SECOND);
        int week = gc.get(Calendar.DAY_OF_WEEK);//返回值：1--7，表示：星期日，星期一，星期二，...,星期六
        System.out.println(year + "年" + month + "月" + day + "日 " + hour + ":" + minute + ":" + second);
        System.out.println(getWeek(week));
    }

    //定义一个方法，接收一个int的值，返回：星期日，星期一，星期二，...,星期六
    public static String getWeek(int w) {//1,2,3,4,5,6,7
        //查表法
        String[] weeks = {"星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"};
        //         索引：    [0]      [1]      [2]      [3]      [4]      [5]      [6]
        return weeks[w - 1];
    }
}

1.3 设置字段

如果我们已有一个表示当前系统日期和时间的GregorianCalendar对象，想计算1949年10月01日那天是星期几，我们可以对这个GregorianCalendar对象的年、月、日重新设置。

Calendar类中提供了一个set(int field,int value)方法，可以设置某个字段的值。设置后，当前对象的其它相关字段都会被设置到新设置的日期上，比如：设置了新的日期，"星期"字段会自动更改为新日期的星期值，示例代码如下：

public class CalendarDemo02 {
    public static void main(String[] args) {
        //1.获取Calendar的子类对象
        Calendar gc = new GregorianCalendar();
        System.out.println(gc);

        //2.成员方法：public void set(int field,int value)：设置字段的值
        //将gc对象设置为：1949年10月01日
        gc.set(Calendar.YEAR, 1949);
        gc.set(Calendar.MONTH, 10- 1);
        gc.set(Calendar.DAY_OF_MONTH, 1);

        //3.获取周几
        int w = gc.get(Calendar.DAY_OF_WEEK);
        String week1 = getWeek(w);
        System.out.println("1949年10月01日那天是：" + week1);
    }

    //定义一个方法，接收一个int的值，返回：星期日，星期一，星期二，...,星期六
    public static String getWeek(int w) {//1,2,3,4,5,6,7
        //查表法
        String[] weeks = {"星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"};
        //         索引：    [0]      [1]      [2]      [3]      [4]      [5]      [6]
        return weeks[w - 1];
    }
}

1.4 为某个字段增加/减少指定的值

如果我们已有一个表示当前系统日期和时间的GregorianCalendar对象，想计算200天后的年、月、日、星期几，我们可以使用add(int field,int value)方法，示例代码如下：

public class CalendarDemo03 {
    public static void main(String[] args) {
        //1.获取Calendar的子类对象
        Calendar gc = new GregorianCalendar();
        System.out.println(gc);

        //2.成员方法：public void add(int field,int value)：增加/减少指定字段的值
        //将日期增加200
        gc.add(Calendar.DAY_OF_MONTH, 200);
        //3).获取年、月、日，星期
        int year = gc.get(Calendar.YEAR);
        int month = gc.get(Calendar.MONTH) + 1;
        int day = gc.get(Calendar.DAY_OF_MONTH);
        int w = gc.get(Calendar.DAY_OF_WEEK);
        System.out.println("200天后是：" + year + "年" + month + "月" + day + "日 " + getWeek(w));
    }

    //定义一个方法，接收一个int的值，返回：星期日，星期一，星期二，...,星期六
    public static String getWeek(int w) {//1,2,3,4,5,6,7
        //查表法
        String[] weeks = {"星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"};
        //         索引：    [0]      [1]      [2]      [3]      [4]      [5]      [6]
        return weeks[w - 1];
    }
}

Calendar和子类GregorianCalendar中还有很多其它方法，大家可以参考API文档。

二. 控制台布局设计

在控制台上，如果想将多行的每列数据对齐，我们需要进行一些设计，主要是结合"空格"和"制表符"使多行中的多列数据实现对齐的效果。本例的设计思路如下图：

说明：

0. 每列之间用一个制表符分隔；
1. 每列的单元格内部使用两个字符位。

三. 程序分步实现

根据上面的设计思路，我们就可以进行分步骤的编写代码了。

3.1 打印头部

我们设计一个类CalendarShow，内部包含一个成员属性：GregorianCalendar对象，并且在构造方法时为其初始化为当前日期：

public class CalendarShow {
    private Calendar cal;
    public CalendarShow() {
        cal = new GregorianCalendar();
    }
    public String toString() {
        StringBuilder sb = new StringBuilder(top() + "\n");//把top添加进来并换行
        return sb.toString();
    }

    private String top() {
        int year = cal.get(Calendar.YEAR);//获取年
        int month = cal.get(Calendar.MONTH) + 1;//获取月
        String yearOrMonth = year + "年" + month + "月";//年月字符串
        String weekTop = "日\t一\t二\t三\t四\t五\t六";//日历头
        return yearOrMonth + "\n" + weekTop;
    }

    public static void main(String[] args) {
        CalendarShow cs = new CalendarShow();
        System.out.println(cs);
    }
}

运行后，效果如下：

3.2 打印日期

接下来我们填充下面的日期部分。

• 首先，我们先计算本月1日是星期几：
• int today = cal.get(Calendar.DAY_OF_MONTH);//获取当前是几号
  cal.set(Calendar.DAY_OF_MONTH, 1);//设置为本月一号
  int weekOfOne = cal.get(Calendar.DAY_OF_WEEK);//获取一号是周几
• 由于我们要在"今天"的日期右侧添加一个*符号，所以，在设置日期前，将当前日期先取出。
• 获取星期后，假如是星期五，那么为了在五的下面输出1，我们先在前面的：日、一、二、三、四的每列上添加两个空格和一个制表符：
• for(int i = Calendar.SUNDAY; i < weekOfOne; i++) {//在一号前添加前置空格，使一号显示在对应的星期头下方
  sb.append(" \t");
  }
• 输出日期：
• int month = cal.get(Calendar.MONTH);//获取当前是几月
  while(month == cal.get(Calendar.MONTH)) {//循环中会对日期不断增加，当增加到下个月时就跳出循环
  int day = cal.get(Calendar.DAY_OF_MONTH);//获取当前日期
  if(day < 10) {//如果日期小于10，在前面加前导空格（填充补位的作用）
  sb.append(" " + day);
  } else {
  sb.append(day);//如果日期大于等于10，说明是两位数的日期，无需添加空格
  }
  if(day == today) {//如果日期是当天，在后面添加星号和空格，表示当天的意思
  sb.append("* ");
  } else {
  sb.append("\t");//如果日期不是当天，在后面添加一个制表符
  }
  int week = cal.get(Calendar.DAY_OF_WEEK);//获取当前是星期几
  if(week == Calendar.SATURDAY) {//如果是星期六换行
  sb.append("\n");
  }
  cal.add(Calendar.DAY_OF_MONTH, 1);//把日期加1
  }
  return sb.toString();

四. 完整代码清单

package com.heima.se;

import java.util.Calendar;
import java.util.GregorianCalendar;

/**
 * 在控制台打印日历：要求使用的控制台字体必须一个汉字的宽度对应两个字符的宽度。
 *
 */
public class CalendarShow {
    private Calendar cal;
    public CalendarShow() {
        cal = new GregorianCalendar();
    }
    public String toString() {
        StringBuilder sb = new StringBuilder(top() + "\n");//把top添加进来并换行
        int today = cal.get(Calendar.DAY_OF_MONTH);//获取当前是几号
        cal.set(Calendar.DAY_OF_MONTH, 1);//设置为本月一号

        int weekOfOne = cal.get(Calendar.DAY_OF_WEEK);//获取一号是周几
        for(int i = Calendar.SUNDAY; i < weekOfOne; i++) {//在一号前添加前置空格，使一号显示在对应的星期头下方
            sb.append("   \t");
        }

        int month = cal.get(Calendar.MONTH);//获取当前是几月
        while(month == cal.get(Calendar.MONTH)) {//循环中会对日期不断增加，当增加到下个月时就跳出循环
            int day = cal.get(Calendar.DAY_OF_MONTH);//获取当前日期
            if(day < 10) {//如果日期小于10，在前面加前导空格（填充补位的作用）
                sb.append(" " + day);
            } else {
                sb.append(day);//如果日期大于等于10，说明是两位数的日期，无需添加空格
            }
            if(day == today) {//如果日期是当天，在后面添加星号和空格，表示当天的意思
                sb.append("* ");
            } else {
                sb.append("\t");//如果日期不是当天，在后面添加制表符
            }
            int week = cal.get(Calendar.DAY_OF_WEEK);//获取当前是星期几
            if(week == Calendar.SATURDAY) {//如果是星期六换行
                sb.append("\n");
            }
            cal.add(Calendar.DAY_OF_MONTH, 1);//把日期加1
        }
        return sb.toString();
    }

    private String top() {
        int year = cal.get(Calendar.YEAR);//获取年
        int month = cal.get(Calendar.MONTH) + 1;//获取月
        String yearOrMonth = year + "年" + month + "月";//年月字符串
        String weekTop = "日\t一\t二\t三\t四\t五\t六";//日历头
        return yearOrMonth + "\n" + weekTop;
    }

    public static void main(String[] args) {
        CalendarShow cs = new CalendarShow();
        System.out.println(cs);
    }
}

五. 结束语

在本文中，我们了解了Calendar及其子类GregorianCalendar的基本使用，以及对控制台输出内容进行对齐的一些小技巧，通过这些，我们就可以很美观的打印某年某月的一个日历，是不是很酷！后续的文章，我会为大家带来更多、更有趣、更实用的一些案例，请大家持续关注哦！