airflowctl datetime field usage and documentation

[bugraoz93]

Apache Airflow version

main (development)

What happened?

airflowctl should have documentation on how to handle datetime fields and fix the bug stated in the pictures.

What you think should happen instead?

The commands in the pictures should work.

How to reproduce

airflowctl auth login --username=admin --api-url=http://localhost:28080 --password
airflowctl dagrun trigger --dag-id=simple_with_tries --logical-date="2025-09-01"
airflowctl dagrun trigger --dag-id=simple_with_tries --logical-date="2025-09-01T04:00:00"

Operating System

linux

Versions of Apache Airflow Providers

airflowctl main branch. Also impacting 1.0.0b1 pre-release.

Deployment

Other

Deployment details

Run the main branch with Breeze on PostgreSQL backend. Run airflow api-server in the container. Run your commands in another terminal.

Are you willing to submit PR?

• Yes I am willing to submit a PR!

Code of Conduct

• I agree to follow this project's Code of Conduct