ticktick_convert_datetime_to_ticktick_format
Convert ISO 8601 datetimes to TickTick's storage format, enabling accurate setting of startDate or dueDate on tasks.
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 |
|---|---|---|---|
| tz | Yes | ||
| datetime_iso_string | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |