OSDN Git Service

WayBackTimeParserリファクタリングのためのコメント、テストケース追加
[coroid/inqubus.git] / frontend / src / saccubus / util / WayBackTimeParser.java
index b08c9f9..aa1a696 100644 (file)
@@ -7,7 +7,7 @@ import java.text.SimpleDateFormat;
 import java.util.Date;
 
 /**
- *
+ * 過去ログ取得時に指定する文字列(日付)をパースするユーティリティクラスです.
  * @author yuki
  */
 public final class WayBackTimeParser {
@@ -15,9 +15,17 @@ public final class WayBackTimeParser {
     private WayBackTimeParser() {
     }
 
+    /**
+     * 過去の時点を指定する文字列から、コメント取得フォーマットの"when"に指定する文字列へ変換します.
+     * この文字列は、1970 年 1 月 1 日 00:00:00 GMT からの秒数(一般的なミリ秒ではない)になります.
+     * @param time 時点指定文字列。"YYYY/MM/DD hh:mm:ss", "YYYY/MM/DD hh:mm", 秒数を表す数値,
+     * のいずれかであればパース可能です.
+     * @return パース結果.
+     * @throws IOException パース失敗.
+     */
     public static String parse(String time) throws IOException {
         Date date = null;
-        String waybacktime = "0";
+        String waybacktime;
         try {
             final DateFormat fmt = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
             date = fmt.parse(time);