Skip to content

Document imprecise date support in TICK syntax#407

Open
bluestreak01 wants to merge 1 commit intomainfrom
vi_tick2
Open

Document imprecise date support in TICK syntax#407
bluestreak01 wants to merge 1 commit intomainfrom
vi_tick2

Conversation

@bluestreak01
Copy link
Copy Markdown
Member

Summary

  • New section: "Imprecise dates" in the main TICK reference covering month-level ([2024-01]), year-level ([2024]), month bracket ranges (2024-[01..03]), bare forms, mixed-precision lists, expansion order, and calendar handling
  • Grammar & quick reference updated: literal_date now defines three precision levels; quick reference table adds 4 new rows for month-level, year-level, month range, and mixed-precision lists
  • Examples modernized: Replaced verbose 2024-01-[01..31] patterns with concise [2024-01] shorthand across 5 secondary doc pages (where.md, date-time.md, exchange-calendars.md, timestamps-timezones.md, designated-timestamp.md)
  • New error messages: Invalid date: 00 and Invalid date: 13 for out-of-range month values
  • Cross-references: Forward/backward links between "Optional brackets", "Bare imprecise dates", and "Mixed-precision date lists" sections

Files changed

File What changed
documentation/query/operators/tick.md New Imprecise dates section, grammar update, quick reference rows, before/after examples, error messages, cross-references, Key Points bullet
documentation/query/sql/where.md XNYS example uses concise form
documentation/query/operators/date-time.md Tip box + IN examples use concise form
documentation/query/operators/exchange-calendars.md Opening example uses concise form
documentation/concepts/timestamps-timezones.md London/NYSE/perf examples use concise form
documentation/concepts/designated-timestamp.md NYSE example uses concise form

Test plan

  • yarn build passes without broken links or MDX errors
  • Verify anchor links (#imprecise-dates, #bare-imprecise-dates, #optional-brackets-for-date-variables) resolve correctly
  • Spot-check rendering of new tables in Imprecise dates section

🤖 Generated with Claude Code

TICK expressions now accept month-level (YYYY-MM) and year-level (YYYY)
dates, expanding them to all constituent days before applying suffixes.
This replaces verbose bracket ranges like `2024-01-[01..31]` with concise
`[2024-01]` shorthand.

Updates the main TICK reference with grammar changes, a new "Imprecise
dates" section, and refreshes examples across 5 secondary doc pages.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 5, 2026

🚀 Build success!

Latest successful preview: https://preview-407--questdb-documentation.netlify.app/docs/

Commit SHA: c719fd1

📦 Build generates a preview & updates link on each commit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant