Skip to content

Document AddDays and AddHours date filters - #3326

Merged
NickJosevski merged 6 commits into
mainfrom
nj/date-filters
Aug 11, 2026
Merged

Document AddDays and AddHours date filters#3326
NickJosevski merged 6 commits into
mainfrom
nj/date-filters

Conversation

@NickJosevski

@NickJosevski NickJosevski commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Documents the AddDays and AddHours variable filters added in Octostache 3.9.3, shipping in Octopus Server 2026.3.11319.

Changes

variable-filters.md — an ### AddDays and AddHours section under Date filters, plus rows in the date-filters table.

Covers negative amounts, fractional amounts (which must be quoted, since an unquoted filter argument can't contain a decimal point), time-zone preservation, and the echo-on-bad-input behaviour. Every value in the examples was produced by running the expression through the implementation rather than written by hand.

The section ends with a worked ServiceNow change-window example, and a warning that Octopus.Task.QueueTime is queue time rather than execution start — so a window derived from it starts counting down while the task is still queued.

Second commit

Fixes pre-existing markdownlint violations in this file. CI lints only changed files, so editing the page surfaces violations that already fail on main. Scoped to what the linter actually reports — two misaligned tables, asterisk list markers, a hard tab, trailing whitespace, duplicate blank lines, a missing blank line after a heading. Each table keeps its own separator style, so the diff stays close to what the rules require.

Note

An earlier revision of this PR also added the filters to the flat list in variable-substitutions.mdx. That list has since been removed on main — the page now links to this one for the full set — so the change was dropped when resolving the merge.

🤖 Generated with Claude Code

Includes a worked ServiceNow change-window example, and a warning that
Octopus.Task.QueueTime is queue time rather than execution start, so a
window derived from it starts counting down while the task is queued.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@team-marketing-branch-protections

Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3326.z22.web.core.windows.net.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.

CI lints only changed files, so editing this page surfaces violations that
already fail on main. Limited to what the linter actually reports: two
misaligned tables, asterisk list markers, a hard tab, trailing whitespace,
duplicate blank lines, and a missing blank line after a heading.

Each table keeps its own separator style, so the diff stays close to what
the rules require.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@NickJosevski
NickJosevski marked this pull request as ready for review August 10, 2026 11:04
NickJosevski and others added 2 commits August 10, 2026 21:05
Includes a worked ServiceNow change-window example, and a warning that
Octopus.Task.QueueTime is queue time rather than execution start, so a
window derived from it starts counting down while the task is queued.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
CI lints only changed files, so editing this page surfaces violations that
already fail on main. Limited to what the linter actually reports: two
misaligned tables, asterisk list markers, a hard tab, trailing whitespace,
duplicate blank lines, and a missing blank line after a heading.

Each table keeps its own separator style, so the diff stays close to what
the rules require.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
# Conflicts:
#	src/pages/docs/projects/variables/variable-substitutions.mdx
… into nj/date-filters

# Conflicts:
#	src/pages/docs/projects/variables/variable-substitutions.mdx
@NickJosevski
NickJosevski enabled auto-merge (rebase) August 11, 2026 09:47
auto-merge was automatically disabled August 11, 2026 09:54

Rebase failed

@NickJosevski
NickJosevski merged commit ef321d7 into main Aug 11, 2026
7 checks passed
@NickJosevski
NickJosevski deleted the nj/date-filters branch August 11, 2026 09:58
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.

3 participants