Merge pull request 'worklog-target.sh 新增 week 子命令，依週五所在月份輸出 yyyy-MM-Wn 工作週編號' (#38 ) from feat/worklog-target-week into develop

Reviewed-on: #38
feat(log): worklog-target.sh 新增 week 子命令，輸出 yyyy-MM-Wn 工作週編號
2026-09-08 03:15:10 +00:00 · 2026-09-08 11:03:45 +08:00
1 changed files with 44 additions and 8 deletions
@@ -4,11 +4,20 @@
 # 用法:
 #   worklog-target.sh <hash> [page|contents|all]
 #   worklog-target.sh friday [基準日期 yyyy-MM-dd]
+#   worklog-target.sh week [基準日期 yyyy-MM-dd]
 #
 # friday 印出一行 yyyy-MM-dd：基準日期所在工作週的週五（基準日期省略時用今天）。
 # 週界不在這裡算，一律問 report-range.sh weekly——週一起算的 ISO 週定義只有那一支說了算，
 # 兩邊各算一次就會在跨月、跨年的那一週各走各的。這裡只做「週一加四天」這一步。
 #
+# week 印出一行 yyyy-MM-Wn（例：輸入 2026-08-31 或 2026-09-06 都印出 2026-09-W1；
+# 輸入 2026-09-11 印出 2026-09-W2）。規則：
+#   1. 先用 friday_of_week 取出該工作週的週五
+#   2. yyyy-MM 一律取週五那天的月份，不看週一——一週橫跨兩個月時（例如週一在八月、
+#      週日在九月），worklog 頁內容照週五整理，跨月的那一週不該被算進週一那個月
+#   3. n 不是 ISO 週次，是「當月第幾個週五」：同月份的週五彼此相距固定 7 天，
+#      (日期-1)/7 取整數再加 1 就是第幾個，不必逐週從月初數起
+#
 # 結束碼: 0=成功 2=用法錯誤 4=系統的 date 不支援日期運算（由 report-range.sh 判定）
 set -eu

@@ -19,6 +28,7 @@ usage() {
 用法:
  worklog-target.sh <hash> [page|contents|all]   組出 LOG_{HASH} 與 LOG_CONTENTS
  worklog-target.sh friday [yyyy-MM-dd]          印出該工作週的週五日期
+  worklog-target.sh week [yyyy-MM-dd]            印出該工作週的 yyyy-MM-Wn
 結束碼: 0=成功 2=用法錯誤 4=系統的 date 不支援日期運算
 EOF
  exit 2
@@ -40,17 +50,43 @@ add_days() { # $1=yyyy-MM-dd $2=要加的天數
 [ "$#" -ge 1 ] || usage
 [ "$#" -le 2 ] || usage

-if [ "$1" = friday ]; then
-  base="${2:-}"
-  if [ -n "$base" ]; then
-    case "$base" in
-      [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]) ;;
-      *) echo "基準日期格式要是 yyyy-MM-dd：$base" >&2; exit 2 ;;
-    esac
-  fi
+# 檢查層：擋掉格式錯誤的基準日期，不算日期。$1=基準日期（例：2026-08-31，可為空）
+#   1. 空字串 -> 放行，呼叫端自己決定要不要用今天
+#   2. yyyy-MM-dd -> 放行
+#   3. 其他任何寫法 -> 印錯誤訊息並 exit 2，不猜使用者的意思
+check_base_format() {
+  case "${1:-}" in
+    '') ;;
+    [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]) ;;
+    *) echo "基準日期格式要是 yyyy-MM-dd：$1" >&2; exit 2 ;;
+  esac
+}
+
+# 邏輯層：算出基準日期所在工作週的週五。$1=基準日期（例：2026-08-31，可為空，
+# 空字串代表用今天）-> 該工作週的週五 yyyy-MM-dd（例：2026-09-04）
+#   1. 格式檢查交給 check_base_format，格式錯誤就地中止，不進到下一步
+#   2. 呼叫 report-range.sh weekly 取得該工作週的週一
+#   3. 週一加 4 天就是週五
+friday_of_week() {
+  base="${1:-}"
+  check_base_format "$base"
  range=$(sh "$HERE/report-range.sh" weekly ${base:+"$base"}) || exit $?
  monday=$(printf '%s\n' "$range" | cut -f1)
  add_days "$monday" 4
+}
+
+if [ "$1" = friday ]; then
+  friday_of_week "${2:-}"
+  exit 0
+fi
+
+if [ "$1" = week ]; then
+  friday=$(friday_of_week "${2:-}")
+  month=$(printf '%s' "$friday" | cut -c1-7)
+  day=$(printf '%s' "$friday" | cut -c9-10)
+  day=${day#0} # 去掉前導零：dash 的 $(()) 沒有 10# 進位前綴語法，前導零會被誤判成八進位
+  nth=$(( (day - 1) / 7 + 1 ))
+  printf '%s-W%s\n' "$month" "$nth"
  exit 0
 fi