# CronDelete

取消先前透過 `CronCreate` 排程的定時任務，立即將其從記憶體會話儲存中移除。若任務已被自動刪除（單次任務觸發後自動移除，週期性任務在 7 天後自動過期），則此操作無效。

## 使用時機

- 使用者要求在 7 天自動過期前停止某個週期性定時任務。
- 單次任務不再需要，希望在觸發前予以取消。
- 需要變更現有任務的排程表達式——先以 `CronDelete` 刪除，再以 `CronCreate` 搭配新的表達式重新建立。
- 清理多個過期任務，保持會話儲存整潔。

## 參數

- `id`（string，必填）：`CronCreate` 建立任務時回傳的任務 ID。此值必須完全相符，不支援模糊搜尋或依名稱查找。

## 範例

### 範例 1：取消正在執行的週期性任務

先前建立了一個 ID 為 `"cron_abc123"` 的週期性任務，使用者要求停止它。

```
CronDelete({ id: "cron_abc123" })
```

該任務從會話儲存中移除，不會再次觸發。

### 範例 2：在觸發前移除過期的單次任務

一個 ID 為 `"cron_xyz789"` 的單次任務被排程為 30 分鐘後執行，但使用者決定不再需要它。

```
CronDelete({ id: "cron_xyz789" })
```

任務被取消，原定觸發時間到來時不會執行任何動作。

## 注意事項

- `id` 必須來自 `CronCreate` 的回傳值。無法透過描述或回呼查找任務——若日後可能需要取消，請事先保存 ID。
- 若任務已被自動刪除（作為單次任務觸發，或達到 7 天週期過期），以該 ID 呼叫 `CronDelete` 為無操作，不會產生錯誤。
- `CronDelete` 僅影響目前的記憶體會話。若執行環境不跨重新啟動持久化定時任務狀態，則無論是否呼叫 `CronDelete`，重新啟動後任務均會遺失。
- 沒有批次刪除操作，需使用各自的 `id` 逐一取消每個任務。
