小白如何使用API帮助文档

177 阅读2分钟

Java开发中API帮助文档真的特别特别重要,作为小白怎么使用正确的姿势去使用呢? 本文,即本Java小白在使用API帮助文档时的心得体会。

我们将从写“一百天后的日期”的题中来一步步解析我当时的心路历程。

题目

获取100天后的时间,并且打印,格式(yyyy-MM-dd HH:mm:ss)

先放解答:

public class Test {  
public static void main(String[] args) {  

//获取当前时间的对象 
Calendar c = Calendar.getInstance();  
  
//使用Calendar中的add方法,得到100天后的日期  
c.add(Calendar.DATE,100);  
  
//格式化日期,并使用getTime()方法,获取100天后的日期  
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
String format = simpleDateFormat.format(c.getTime());  
  
//打印出100天后的日期  
System.out.println("100天后的日期: " + format);  
}  
}

抛出问题

//获取当前时间的对象
Calendar c = Calendar.getInstance();

为什么要使用getInstance()方法?

//使用Calendar中的add方法,得到100天后的日期
c.add(Calendar.DATE,100);

add的方法?怎么知道的?怎么用呀? 后面的Calendar.DATE,又是怎么知道的?

//格式化日期,并使用getTime()方法,获取100天后的日期
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String format = simpleDateFormat.format(c.getTime());

格式化日期的方法怎么知道的?怎么运用呀?

//打印出100天后的日期
System.out.println("100天后的日期: " + format);

解决问题

(这里我以使用谷歌的API文档为例子)

  1. 打开API帮助文档,在搜索栏搜索你想找的类名or other

image.png 后面出现的是这样的界面

image.png

  1. 查找,了解它的基本结构

image.png

image.png

  1. 使用属性

静态属性(类属性),即前有static修饰的,我们是可以直接使用类名进行调用

image.png

像这个属性,DATE,我们就可以直接通过类名进行调用使用

即前面的“(Calendar.DATE)”

  1. 想使用它的相关方法,我们得注意它后面括号中的要求的类型!!! 例如 add 的方法

image.png

add(int field, int amount)

注意哦!括号内的都是int类型

“将指定的时间量添加或减去给定的日历字段”

int field -> 给定的日历字段 --> 指什么啊啊啊?

int amount -> 指定的时间量 --> 即本题中的100天

“给定的时间字段” --> 我们本题是在今天的日历的基础上将时间调至100天后

现在我们就需要获取是int类型的字段,还能获取今日的时间的属性 or 方法

Calendar.DATE

类似的格式化日期也可以从中找出来使用

OKK,fine. 要是写的还可以,还有一点帮助,给个小赞吧~~