6

我试过用谷歌搜索，但没有找到这个问题的完整答案：

我可以在 javadoc 中为 @since 注释设置日期格式吗？或者我如何查看设置的格式？

4

6 回答 6

9

@since标记应该用于定义您添加了方法、类等的哪个版本。这是您对其他开发人员的提示，他们应该只在针对特定版本的包运行时才期望该方法。如果您将代码作为供其他人使用的库提供，我会考虑文档中这些非常重要的部分。

/**
 * @author    Firstname Lastname <address @ example.com>
 * @version   1.6        (current version number of program)
 * @since     1.5        (the version of the package this class was first added to)
 */

欲了解更多信息，请访问：

http://en.wikipedia.org/wiki/Javadoc

javadoc：@version 和 @since

于 2013-08-01T10:27:29.387 回答
3

标签@since不用于指定日期，而是用于提供有关最新版本信息的信息

/**    
* @since 1.7
*/
于 2013-08-01T10:24:53.873 回答
2

@从 1.1 开始

因为后跟一个数字，表示某种版本 ID。任何格式都可以，但首选 NN 格式

于 2013-08-01T10:25:39.083 回答
1

@since注释用于描述功能首次存在的时间，它的版本号。

于 2013-08-01T10:27:38.733 回答
1

据我所知@Since，用于指示启动某些实现的版本。

@Since 1.0  // meaning is this method start from version 1.0
于 2013-08-01T10:28:32.177 回答
1

我相信@since 的字符串没有真正的语法，我将我的字符串写为@since 2020.09.22，它似乎是版本或日期。

于 2020-08-23T20:32:36.817 回答