Skip to content

Bars Specification 0.1.0 — Environment Property: @env/now

Value kind: dateTime · Since: 0.1.0

The date-time at which the rendering environment was created.

Resolves to a date-time value captured once when the environment is built, so every reference to @env/now within a single render observes the same instant. It flows directly into the date-time transforms (format_date_time, as_date_time, and so on). A sub-pointer into it (e.g. @env/now/foo) renders empty, because a date-time is not a container element.

Sourcing: Clock-seeded at environment-construction time; the specific clock is implementation-defined (kBars reads kotlin.time.Clock). Only the observable value-kind and resolution behavior are pinned — never a specific instant.

Worked examples

Given the environment was created at 2026-06-22T12:00:00Z:

{{ @env/now }}

2026-06-22T12:00:00Z

Given the environment was created at 2026-06-22T12:00:00Z:

{{ @env/now | format_date_time: 'yyyy' }}

2026

Full fixture: env-properties/env-now.json