Stacks Documentation
SkillsChangelog
TeamSponsorsPartnersPostcardwareAwesome StacksContributing

DateTime

Copy page
Copy page as Markdown for LLMs
View as Markdown
View this page as plain text
Open in ChatGPT
Copy content and open ChatGPT
Open in Claude
Copy content and open Claude
Open in Perplexity
Search with Perplexity AI
On this page 2

stacks-datetime · Native Stacks · model-invoked

Use when working with dates and times in Stacks - the DateTime class with Carbon-like API (add/sub, comparison, formatting, start/end of day/month/year), date parsing, format tokens, timezone handling, wall-clock times in a named zone across DST, or YYYY-MM-DD calendar dates (today in a zone, day arithmetic, ISO weeks). Covers @stacksjs/datetime.

Read the skill for the implementation workflow and its current signatures. The Native capabilities catalog maps the package to source and retained evidence; driver limits are explicit.

Inside the skill

  • Key Paths
  • Architecture
  • DateTime Class (now.ts)
  • Standalone format() Function (format.ts)
  • Standalone parse() Function (parse.ts)
  • Named-zone instants and calendar months
  • Calendar dates (YYYY-MM-DD strings)
  • Current-time helper example
  • Gotchas

Using it

This skill is model-invoked. Your agent can select it for matching tasks, and you can call it directly.

/stacks-datetime

Source: stacks-datetime/SKILL.md.

It ships in @stacksjs/defaults with its supporting files. Run buddy setup:ai to refresh the agent setup. Override it per project with app/Skills/stacks-datetime/SKILL.md. See Using skills.