Astro Date Offset

Half the time you don't want today's chart - you want the chart from three weeks ago, or the reading for next Tuesday. Astro Date Offset is the Time Utils node from Comfyui-Kerykeion that takes any date and slides it forward or backward by a number of days, so you can point the pack's transit nodes at any window without doing calendar math in your head.

It's the middle sibling of a small family: Astro Current Date gives you today, Astro Parse Date turns text into a date, and this one moves a date you already have.

How it works

Give it a year, month, day, and a days_offset, and it adds that offset to the date - datetime + timedelta, essentially. The offset can be negative, which is the whole point: -30 rewinds a month, +7 jumps a week. The node handles the messy real-world calendar stuff for you (month lengths, year boundaries) because it's all happening in Python's date math. It returns the shifted date both as separate new_year, new_month, new_day integers and as a new_date_string in DD/MM/YYYY format.

If the input date is invalid - say you hand it February 30 - it doesn't crash. It prints a warning to the console and falls back to the current date, which is either merciful or maddening depending on how much you like silent defaults.

The inputs that matter

Only four, and only one of them is interesting:

• year, month, day - the starting date.
• days_offset - how many days to shift. Positive goes forward, negative goes back. This is the input you'll actually fiddle with.

What to wire it into

The natural move: connect the year/month/day of your chosen date in, set days_offset to -7 or +30, and feed the offset outputs into a Transit Data Calculator or a Natal Chart Calculator. Chain it after Astro Current Date and you've built a "what was the sky a week ago" or "next month's forecast" pipeline that's fully automatic.

It's also genuinely useful for non-astro workflows - any graph where you need "date plus N days" as integers, like scheduling or filename stamping. It costs you nothing to have it around.

Installing it

Part of the Comfyui-Kerykeion pack, so the install is the same as the rest of the family:

cd ComfyUI/custom_nodes
git clone https://github.com/Meisoftcoltd/Comfyui-Kerykeion
cd Comfyui-Kerykeion
pip install -r requirements.txt

or just search "ComfyUI-Kerykeion" in ComfyUI Manager and restart. Like its Time Utils siblings this node is pure stdlib - no geocoding, no network, no model files - so it's the least likely node in the pack to give you install grief. The heavier dependencies in requirements.txt exist for the astral calculators, not for this one.

Gotchas

• The silent-fallback trap. An invalid starting date (like the February 30 above) doesn't error out - you get "today" back with only a console warning. If your offsets suddenly produce nonsense, check the ComfyUI console for the Warning: Error en DateOffset line.
• Keep the DD/MM/YYYY format of new_date_string in mind if you pipe it into a text node that expects ISO format.

For moving dates around in an astrology workflow, this is the lowest-friction option in the pack - two widgets and you're done.