現在の通常テキストチャンネルで、指定した期間内の投稿を削除するモデレーション用コマンドです。削除前に確認ボタンが表示されます。
使い方
| 項目 |
内容 |
| 形式 |
/purge start_at:<開始日時> end_at:<終了日時> |
| 必須引数 |
start_at, end_at |
| 任意引数 |
なし |
| カテゴリー |
管理・設定 |
引数
| 引数 |
説明 |
start_at |
必須。削除対象期間の開始日時です。YYYY-MM-DD HH:MM または YYYY-MM-DD HH:MM:SS で指定します。JSTとして扱われます。 |
end_at |
必須。削除対象期間の終了日時です。YYYY-MM-DD HH:MM または YYYY-MM-DD HH:MM:SS で指定します。JSTとして扱われます。 |
応答・返り値
- 条件確認画面を実行者本人だけに表示します。
削除を実行 を押すまで削除は開始されません。
- 削除中は走査済み件数、削除済み件数、失敗件数が更新されます。
- 中止ボタンで停止リクエストを出せます。
- 入力形式不正、権限不足、期間超過、未来日時指定などの場合は実行者本人だけにエラーを返します。
必要条件・権限
- 実行者には管理者権限が必要です。
- bot にはメッセージ送信、メッセージの管理、メッセージ履歴を読む権限が必要です。
- サーバー内の通常テキストチャンネルでのみ実行できます。
- 開始日時は終了日時より前にしてください。
- 1回で指定できる期間は最大500日です。
- 1回で削除対象にできる投稿は最大5000件です。
- 終了日時に未来の時刻は指定できません。
使用例
/purge start_at:2026-06-24 20:00 end_at:2026-06-24 21:00
エラー・注意点
- 削除操作は元に戻せません。Discordの仕様上、古いメッセージは一括削除できないため個別削除になります。
コメント