@@ -163,8 +163,18 @@ const CronScheduleSchema = Type.Optional(
163163anchorMs: Type.Optional(
164164Type.Number({ description: "Optional start anchor in milliseconds (kind=every)" }),
165165),
166-expr: Type.Optional(Type.String({ description: "Cron expression (kind=cron)" })),
167-tz: Type.Optional(Type.String({ description: "IANA timezone (kind=cron)" })),
166+expr: Type.Optional(
167+Type.String({
168+description:
169+'Cron expression (kind=cron) written in the supplied tz\'s local wall-clock time, or the Gateway host local timezone when tz is omitted; do not convert the requested local time to UTC first. Example: 6pm Shanghai daily is "0 18 * * *" with tz "Asia/Shanghai".',
170+}),
171+),
172+tz: Type.Optional(
173+Type.String({
174+description:
175+'IANA timezone for interpreting cron wall-clock fields (kind=cron), e.g. "Asia/Shanghai"; if omitted, cron uses the Gateway host local timezone.',
176+}),
177+),
168178staggerMs: Type.Optional(Type.Number({ description: "Random jitter in ms (kind=cron)" })),
169179},
170180{ additionalProperties: true },
@@ -569,10 +579,13 @@ SCHEDULE TYPES (schedule.kind):
569579 { "kind": "at", "at": "<ISO-8601 timestamp>" }
570580- "every": Recurring interval
571581 { "kind": "every", "everyMs": <interval-ms>, "anchorMs": <optional-start-ms> }
572-- "cron": Cron expression
573- { "kind": "cron", "expr": "<cron-expression>", "tz": "<optional-timezone>" }
582+- "cron": Cron expression evaluated in the supplied timezone, or the Gateway host local timezone when tz is omitted
583+ { "kind": "cron", "expr": "<cron-expression>", "tz": "<optional-IANA-timezone>" }
584+ Write expr in the selected timezone's local wall-clock time; do not convert the requested local time to UTC first.
585+ If tz is omitted, do not assume UTC; the Gateway host local timezone is used.
586+ Example: "Remind me every day at 6pm Shanghai time" -> { "kind": "cron", "expr": "0 18 * * *", "tz": "Asia/Shanghai" }
574587575-ISO timestamps without an explicit timezone are treated as UTC.
588+For schedule.kind="at", ISO timestamps without an explicit timezone are treated as UTC.
576589577590PAYLOAD TYPES (payload.kind):
578591- "systemEvent": Injects text as system event into session
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。