temporal schedule list-matching-times previews schedule times
Introduced 2026-07-10 · score 0.98
HOW TO USE IT
When you need to preview a schedule over a time range, run `temporal schedule list-matching-times` with its Schedule ID and required start and end timestamps. It lists matching times without running the scheduled actions.
temporal schedule list-matching-times \
--schedule-id "<ScheduleID>" \
--start-time "<RFC3339 start timestamp>" \
--end-time "<RFC3339 end timestamp>"WHY THIS HELPS
Preview when a schedule would fire within a given time range without executing workflows.
REQUIREMENTS AND LIMITATIONS
- Version: v1.8.0
- --schedule-id (required): Schedule ID.
- --start-time (required): Start of time range to list matching times; timestamp.
- --end-time (required): End of time range to list matching times; timestamp.
- Prerequisite: The command is marked Experimental in v1.8.0 CLI documentation.
FIRST-PARTY EVIDENCE
- https://github.com/temporalio/cli/releases/tag/v1.8.0
- https://github.com/temporalio/cli/pull/1047
- https://raw.githubusercontent.com/temporalio/cli/v1.8.0/internal/temporalcli/commands.yaml
Check the installed version and the source before using it. Entry JSON