# Calculation conventions for the executive timing screen

Version 2.1 uses the bundled lunar-javascript library. The supported civil input range is 1900–2100 inclusive. A calendar date chosen in the planner is evaluated at noon in the selected event time zone. A result describes that sample instant. A solar-term transition later the same day can change the applicable month or year.

* **Civil time.** A named IANA zone and the browser's historical time-zone data resolve wall time. Skipped or repeated times raise an error. The library's solar-term calculation receives the corresponding instant on the UTC+8 clock. A missing zone uses the library's direct wall-clock convention. Birth and event zones are separate inputs.
* **Four Pillars.** The exact solar-term year and month come from the converted instant. The day and hour use the entered local civil clock and EightChar sect 2, with midnight as the change of day. The hour stem follows the bundled library's late-Zi convention. Longitude and apparent solar time corrections are outside this method. Unknown birth time uses noon for three pillars and leaves the hour empty. On a solar-term transition date those three pillars can also be uncertain.
* **Officer.** The local day branch minus the exact solar month branch, modulo twelve, selects the officer beginning with Establish. Break is the month breaker. The opposite day/year branches flag a year breaker. The event day can also clash with the natal day or goal-specific pillar.
* **Personal context.** The five relative generating and controlling relationships between the natal and event day stems supply broad themes. This grouping omits the yin/yang distinctions of a full Ten Gods chart. Six Harmony is a supporting finding. Neither changes a breaker into a favourable result.
* **Hours.** The almanac supplies favourable two-hour branches. The app keeps those within 09:00–16:59 local civil time and removes the branch opposite the event day. Empty results mean the filter produced no windows. A day's noon assessment can be unsuitable for a window on the other side of a solar-term transition.
* **Decision.** Proceed requires an officer fit for a supported activity and no recorded hard exclusions. Property and health requests return preparatory actions. Confidence reflects input completeness and implemented coverage. Ranking breaks ties only through the exposed support rules and cannot estimate the chance of a real-world outcome.

For independent checks, compare Hong Kong dates and solar-term times with the Hong Kong Observatory and time transitions with IANA. For interpretation use the pending practitioner cases. A calendar match alone cannot validate the activity advice. See the [source register](../research/source-register.csv) and [review cases](practitioner-review-cases.csv).
