K
Docs
API Reference→Pieces→Time Check
🌗

Time Check

clock.checkThe ClocktowerTime

Checks the clock in a time zone you choose: which days (Mon-Fri, weekends), which hours (09:00 to 17:00 — or 22:00 to 06:00 overnight) and which dates (2026-12-24, or 12-20 to 01-05 every year). Every rule you fill in must hold for Yes. {{local.weekday}}, {{local.time}} and {{local.date}} say what the clock showed.

When to use this
  • →Until (time) isn't included: 09:00 to 17:00 is Yes at 16:59, No at 17:00
  • →In a timer flow, a Time Check skips weekends or holidays without a second timer

On the canvas

This is what Time Check looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

🌗
Time Check
clock.check
Time
zone
UTC when empty
days
e.g. Mon-Fri, weekends
from
e.g. 09:00
to
e.g. 17:00
dateFrom
e.g. 12-20 (every year)
dateTo
e.g. 01-05
time
Now when empty
asrequired
local
yes
no

Config fields

FieldTypeReqWhat it does
zone
UTC when empty
text—Time zone 🌍
days
e.g. Mon-Fri, weekends
text—On these days 📆
from
e.g. 09:00
text—From (time) 🕘
to
e.g. 17:00
text—Until (time) 🕔
dateFrom
e.g. 12-20 (every year)
text—From (date) 📅
dateTo
e.g. 01-05
text—Until (date) 📅
time
Now when empty
text—Check this moment
as
local
textyesSave it as ✨

Sparks this piece adds

After this piece runs, these values are available as sparks in every node downstream.

{{local.weekday}}stringThe day there, like Wednesday
{{local.day}}stringShort day, like Wed
{{local.time}}stringThe time there, like 13:30
{{local.date}}stringThe date there, like 2026-03-04
{{local.hour}}numberThe hour there, 0-23
{{local.zone}}stringThe time zone it checked

Output ports

yesEvery rule you set holds right now
noAt least one rule doesn't
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
const parts = new Intl.DateTimeFormat("en-US", {
  timeZone: "Europe/Berlin", weekday: "short", hour: "numeric", hourCycle: "h23",
}).formatToParts(new Date());
const day = parts.find((p) => p.type === "weekday").value; // {{local.day}}
const hour = Number(parts.find((p) => p.type === "hour").value);
const open = !["Sat", "Sun"].includes(day) && hour >= 9 && hour < 17; // Yes ✓ / No ✗