# 07 — Symbolic Dates
## Endur Treasury System — Symbolic Date Token Reference

---

## Overview

Symbolic dates can be entered into most date fields in Endur (e.g. Start Date, End Date, Pivot Date Offset, Before Pivot Offset, After Offset). Each field has a **date origin** — for example, the origin for the End Date of a deal is typically its Start Date, so entering `0d` sets End Date equal to Start Date.

When a symbolic date is entered, Endur resolves and displays the resulting real date. Use the **F1 key** on most deal input screens to inspect the underlying symbolic date value (useful when verifying templates).

> **Critical:** Most symbolic dates produce **Good Business Day (GBD)** results. The only tokens that can resolve to a weekend or holiday are plain numbers (`1` to `31`), `cd`, and `fom`.

---

## Symbolic Date Token Reference

| Token | Name | Description | Examples |
|---|---|---|---|
| `1`–`31` | Day of Month | Enter the day of the month directly. If the day is **less than** the current day, the result is that day in the **next** month; otherwise it is in the current month. May fall on a weekend or holiday. | `25`, `1`, `31` |
| `boy` | Beginning of Year | Nth beginning of year. | `1boy`, `2boy`, `3boy` |
| `cd` | Calendar Days | Offset in calendar days. May land on a weekend or holiday. | `0cd`, `1cd`, `2cd` |
| `cm` | Start of Calendar Month | Nth start of calendar month. | `1cm`, `2cm`, `3cm` |
| `cq` | Calendar Quarter | Start of the month for Jan, Apr, Jul, Oct (quarterly anchor). | `1cq`, `2cq`, `3cq` |
| `cy` | Calendar Year | Nth start of calendar year. | `1cy`, `2cy` |
| `d` | Good Business Day | Nth good business day (GBD). Skips weekends and holidays. | `1d`, `2d`, `-1d` |
| `eom` | End of Month | Nth end of month. | `1eom`, `2eom` |
| `eoy` | End of Year | Nth end of year. | `1eoy`, `2eoy` |
| `fom` | First of Month (calendar) | First calendar day of the Nth next month. May fall on a holiday. Example: if reference date = Jan-06, `1fom` returns Feb-01 even if it is a holiday. | `1fom`, `2fom` |
| `fri` | Friday | Nth Friday. | `1fri`, `2fri`, `3fri` |
| `imm` | IMM Date | Third Wednesday of Mar, Jun, Sep, Dec. See env var `AB_INT_DSEQ_ROLL_ON_SETTLE`. | `1imm`, `2imm` |
| `immq` | IMM Quarter | Start of the month for Mar, Jun, Sep, Dec. See env var `AB_INT_DSEQ_ROLL_ON_SETTLE`. | `1immq`, `2immq` |
| `low` | Last of Week (Friday) | Last calendar day of the current week (Friday). Used in After Offset for weekly methods. | `1low` |
| `lom` | Last of Month | Last calendar day of the current month. May be non-GBD — rolls per Roll Boundary Resets direction. Used in After Offset for monthly methods. | `1lom`, `-1lom`, `-2lom` |
| `m` | Month | Offset in months. | `3m` (3 months) |
| `med` | Movement End Date | Movement End Date of the relevant parcel. Only available in the Payment Date Offset field on Comm-Phys and Comm-Fee deals with Pricing Adj Lvl = Parcel. | — |
| `mimm` | Monthly IMM Day | Next monthly IMM Day (3rd Wednesday of any month, Jan–Dec). See env var `AB_INT_DSEQ_ROLL_ON_SETTLE`. | `1mimm`, `2mimm` |
| `mon` | Monday | Nth Monday. | `1mon`, `2mon` |
| `monday` | Monday (offset syntax) | Monday of the current (`0monday`) or prior (`-1monday`) week. Used in Pivot Date Offset for weekly methods. | `0monday`, `-1monday` |
| `msd` | Movement Start Date | Movement Start Date of the relevant parcel. Only available in the Payment Date Offset field on Comm-Phys deals with Pricing Adj Lvl = Parcel. | `10cd>msd` |
| `som` | Start of Month | Nth start of month. | `1som`, `2som` |
| `thu` | Thursday | Nth Thursday. | `1thu`, `2thu` |
| `tue` | Tuesday | Nth Tuesday. | `1tue`, `2tue` |

---

## Composite Expressions Used in Projection Methods

These compound symbolic expressions appear as **Pivot Date Offset** values in the Endur Projection Method configuration:

| Expression | Resolves To | Used By |
|---|---|---|
| `1d>-2lom` | First GBD **after** last calendar day of 2 months ago = first GBD of the **prior** month | EventPMANOWE |
| `1cd>-2lom` | First calendar day **after** last of 2 months ago = first calendar day of the **prior** month (may be Sat/Sun) | EventPMAWE |
| `1d>-1lom` | First GBD **after** last calendar day of prior month = first GBD of the **current** month | CMANOWE, FX_Ref |
| `1cd>-1lom` | First calendar day **after** last of prior month = first calendar day of the **current** month (may be Sat/Sun) | CMAWE |
| `0monday` | Monday of the week containing the BOL date | EventCWA |
| `-1monday` | Monday of the **week before** the BOL date's week | EventPWA |
| `1d>-2arg_trm` | First GBD after the second-previous arg_trm sequence date (= Window_Start for TMA Argus/Platts) | TMA Argus/Platts |
| `1d>-2dmo_one_cme_xxv_minusgbd_three` | First GBD after the second-previous CME sequence date (= Window_Start for TMA Nymex/CME) | TMA Nymex/CME |
| `1arg_trm` | Current arg_trm sequence date = currDate from TMA lookup (= Window_End for TMA Argus/Platts) | TMA Argus/Platts |
| `1dmo_one_cme_xxv_minusgbd_three` | Current CME sequence date = currDate from TMA lookup (= Window_End for TMA Nymex/CME) | TMA Nymex/CME |

---

## Notes

- **`lom` vs `eom`:** Both refer to the end of the month, but `eom` is typically used in payment scheduling contexts. In projection methods, `lom` (last of month) is the standard for Window_End.
- **`low`:** Refers to the last calendar day of the **week** (Friday). Used as After Offset for EventCWA and EventPWA. May roll per Roll Boundary Resets if it falls on a holiday.
- **`med` and `msd`:** Only applicable to Comm-Phys/Comm-Fee deals with parcel-level pricing. Not relevant to standard projection method window calculation.
- **Negative prefixes:** `-1lom` = last day of the month **before** the pivot month; `-2lom` = last day two months before. The `>` operator then adds 1 GBD or 1 calendar day to advance to the first of the target month.

---

*Source: Endur system documentation (symbolic_dates.docx), user domain knowledge*