如何在 JavaDoc @since 标记日期格式中包含文字“W”？

Question

我正在尝试在我的 JavaDoc @since 标记中指定 ISO 周日期 格式，其中包含代表一年中的第几周的文字“W”。

目前，当我使用

${currentDate:date('YYYY-w-u HH.mm.ss.SS Z')}

时，它将日期格式设置为

2024-36-4 20.02.42.06 -0400

。但是，我希望格式包含“W”，如下所示：

2024-W36-4 20.02.42.06 -0400

。

我尝试在日期格式字符串中使用

'W'

、

"W"

和

\W

，但它们要么导致格式不正确，要么被错误解释（例如，

\W

变为

\1

）。

如何转义“W”字符，以便在

${currentDate}

函数或类似机制中将其视为日期格式字符串中的文字？

JavaDoc 示例：

/**
 * Description of your class or method.
 *
 * @since 2024-W36-4 20.02.42.06 -0400
 */
public class MyClass {
    // Code here
}

任何用文字“W”实现所需日期格式的见解或替代方法将不胜感激。谢谢！

Answer 1

Eclipse 代码模板日期使用

SimpleDateFormat

模式。

SimpleDataFormat 需要一个单引号字符作为 W 的转义符 - 所以

'W

但是代码模板解析器不支持在模式中间转义

'

，因此您无法使用单个变量来执行此操作。

您可以使用两个变量来完成此操作，其中 W 作为它们之间的纯文本：

 @since ${part1:date('yyyy-')}W${part2:date('w-u HH.mm.ss.SS Z')}