ticktick_convert_datetime_to_ticktick_format
Convert ISO 8601 datetime strings to TickTick's YYYY-MM-DDTHH:MM:SS+0000 format for use in task startDate and dueDate fields.
Instructions
Convert an ISO 8601 datetime string into TickTick's storage format.
TickTick uses YYYY-MM-DDTHH:MM:SS+0000 (UTC offset, no colon).
Args:
datetime_iso_string (str): ISO 8601 datetime, e.g.
"2026-04-13T20:45:00+01:00". Naive strings are accepted
and interpreted in tz.
tz (str): IANA timezone name used for the UTC conversion, e.g.
"Europe/London" or "America/Los_Angeles".
Returns:
On success: {"ticktick_format": "2026-04-13T19:45:00+0000"}.
On parse error: {"error": "Invalid datetime format...",
"status": "error"}. On any other conversion error:
{"error": "Conversion failed: ...", "status": "error"}.
Agent Usage Guide:
- Call this when you need to set startDate or dueDate on
a task dict by hand. The ticktick_create_task and
ticktick_update_task tools accept ISO strings directly and
run this conversion internally.
Example: ticktick_convert_datetime_to_ticktick_format( datetime_iso_string="2026-04-13T20:45:00+01:00", tz="Europe/London", )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| datetime_iso_string | Yes | ||
| tz | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |