ticktick_convert_datetime_to_ticktick_format
Convert an ISO 8601 datetime string into TickTick's required UTC format (YYYY-MM-DDTHH:MM:SS+0000) using an IANA timezone. Use it to format start or due dates before creating or updating 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 |