Skip to content
This repository was archived by the owner on Jul 2, 2026. It is now read-only.
/ docs Public archive

Document reference year parsing - #412

Open
zedoraps wants to merge 5 commits into
mainfrom
topic/parse-time-reference-year
Open

Document reference year parsing#412
zedoraps wants to merge 5 commits into
mainfrom
topic/parse-time-reference-year

Conversation

@zedoraps

Copy link
Copy Markdown
Contributor

🔍 Problem

  • The parse_time reference did not explain how to resolve year-less timestamps.
  • Syslog docs showed RFC 3164 timestamps as strings without a follow-up for converting them safely.

🛠️ Solution

  • Document the reference argument for parse_time.
  • Add BSD/RFC 3164 syslog examples for year resolution and explicit timezone offsets.
  • Cross-link the guidance from parse_syslog and read_syslog.

💬 Review

  • Check that the examples make the year and timezone assumptions explicit.
⚙️ Code PR: tenzir/tenzir#6380

@github-actions github-actions Bot added the reference Reference documentation label Jun 24, 2026
@github-actions

github-actions Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

📦 Preview  ·  View →  ·  🟢 Live

Verified for d2d31d8  ·  Auto-updates on push

@zedoraps
zedoraps marked this pull request as ready for review June 24, 2026 12:27
@zedoraps
zedoraps requested review from jachris and raxyte June 24, 2026 12:27
@zedoraps
zedoraps force-pushed the topic/parse-time-reference-year branch from 3d4186e to e8bae33 Compare June 24, 2026 13:00

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e8bae33b07

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/content/docs/reference/functions/parse_time.mdx
Comment thread src/content/docs/reference/functions/parse_syslog.mdx Outdated
Comment thread src/content/docs/reference/functions/parse_time.mdx Outdated
@zedoraps
zedoraps force-pushed the topic/parse-time-reference-year branch 2 times, most recently from 6c534dc to c69e010 Compare June 25, 2026 08:53
Explain how parse_time resolves year-less formats and show the explicit follow-up needed for RFC 3164 syslog timestamps, including timezone offsets supplied with %z.

Assisted-by: GPT-5 (Codex)
@zedoraps
zedoraps force-pushed the topic/parse-time-reference-year branch from c69e010 to 2404c1a Compare June 25, 2026 13:22
zedoraps and others added 3 commits June 26, 2026 14:27
Document that reference fills missing years and fully missing dates, but does not fill only month or day or resolve week-based dates without a year.

Assisted-by: GPT-5 (Codex)
Describe only the supported reference completion cases and state that other incomplete date formats return null with a warning.

Assisted-by: GPT-5 Codex (Codex)
Time-only formats now choose the date closest to the reference instead
of copying it verbatim, and ISO week fields next to a complete calendar
date no longer make the format unsupported. Update the reference
section and add a midnight example.

Co-Authored-By: Claude Fable 5 <[email protected]>
Assisted-by: Claude Fable 5 (Claude Code)

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 28e1372bc6

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/content/docs/reference/functions/parse_time.mdx
Comment thread src/content/docs/reference/functions/parse_syslog.mdx
The fixed-reference example only showed the parse_time assignment but
was followed by an output block. Include the from and parse_syslog
setup so readers can reproduce the shown result; verified against the
tenzir/tenzir#6380 build.

Co-Authored-By: Claude Fable 5 <[email protected]>
Assisted-by: Claude Fable 5 (Claude Code)
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

reference Reference documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants