date-parser · parser technology comparison

Twelve parsers, one date language

The same small language for dates, periods and ranges, implemented with twelve parser generators and parser libraries, from LL(1) to LALR(1), Earley, GLL and PEG. Every implementation passes the same 564 test cases.

The language

Small enough for every tool, rich enough to show their differences: three date notations, periods, business days, IMM and FX spot dates, lists and ranges. A schedule is a rule: a function of the base date T and the market.

2015-06-09one date (ISO)
09.06.2015 + 3M2015-09-09 (German notation)
06/09/2015 + 1W - 2D2015-06-14 (US notation, left to right)
2015-06-09, 1.1.2000 + 1Y2015-06-09, 2001-01-01
[2015-01-15 : 1Q : 2015-12-31]2015-01-15, -04-15, -07-15, -10-15
[2026-01-01 : 3M : 2026-12-31] > EOQ > 3RD WED IN MONTHthe IMM dates of 2026: shifts apply to each element
2015-06-12 + 1B2015-06-15 (business days)
2015-06-09 + 3M > IMM2015-09-16 (next IMM date)
2015-06-12 > SPOT USDCAD2015-06-15 (FX spot, T+1)
T + 2Btwo business days after the base date, in the market of the evaluation
24 DEC IF MON TUE WED THUChristmas Eve from Monday to Thursday, otherwise no date
1 SHAWWAL, 1 ZHENGYUEEid al-Fitr and Chinese New Year in the year of T
@FOMC + 1Bthe business day after each FOMC decision of that year (a named event)
[T : T + 7D] \ {1 JAN, 6 JAN} & 25 DECexclude and include: sorted, without duplicates
[T : 1Y : T + 2Y] > {1 FEB, 1 MAY}dates in year: 1 February and 1 May of three years
5TH [SPOT : 1Q : ] > EOQ > 3RD WED IN MONTHpick: the 5th IMM date after T, from an open series
T > 2ND LAST BD IN MONTHthe second-to-last business day in the month of T
schedule = item { "," item } .
item     = expr { combine } [ condition ]
         | pick ( series | EVENT ) { move } { combine } [ condition ] .
pick     = ORDINAL [ "LAST" ] .            (* the n-th date after T *)
condition = "IF" ( WEEKDAY { WEEKDAY }
                 | "{" WEEKDAY { "," WEEKDAY } "}" ) .
combine  = ( "&" | "\\" ) operand { move } .  (* include, exclude *)
operand  = date | "{" expr { "," expr } "}" .
series   = ( "[" | "]" ) endpoint ":" ( period ":" [ endpoint ] | endpoint )
           ( "]" | "[" ) .             (* ]a, b[: endpoint left out; no end: open *)
endpoint = single_date { move } .
expr     = date { move } .
move     = ("+" | "-") period
         | ">" ( "IMM" | "SPOT" [ PAIR ] | "FIX" [ PAIR ] | ROLL
                 | ("NEXT" | "PREV") [ ORDINAL ] anchor
                 | count select "IN" PERIOD
                 | "{" annual { "," annual } "}" )  (* dates in year *)
         | "{" shift { "," shift } "}" .
shift    = WEEKDAY ("+" | "-") period .
anchor   = target                      (* NEXT 3RD FRI *)
         | "{" target { "," target } "}" .  (* NEXT {MON, FRI} *)
target   = chosen | "LAST" WEEKDAY MONTH .
count    = ORDINAL [ "LAST" ] | "LAST" .  (* 2ND LAST *)
select   = chosen                      (* 3RD WED IN MONTH *)
         | "{" target { "," target } "}" .
chosen   = WEEKDAY | "BD" | "FD" | "IMM" | fixed | EVENT .
date     = single_date | series .
single_date = "T" | "TOM" | "SPOT" [ PAIR ]
         | NUM ( "-" NUM "-" NUM       (* ISO    *)
               | "." NUM "." NUM       (* German *)
               | "/" NUM "/" NUM )     (* US     *)
         | annual | EVENT .
annual   = fixed | "LAST" WEEKDAY MONTH .
fixed    = NUM MONTH                   (* 4 JUL     *)
         | NUM WEEKDAY MONTH           (* 3 MON JAN *)
         | "EASTER"
         | ("EQUINOX" | "SOLSTICE") MONTH [ ZONE ]
         | "SOLARTERM" NUM [ ZONE ] .  (* SOLARTERM 5 UTC+8 *)
period   = NUM ( "D" | "W" | "M"
               | "Q" | "H" | "Y" | "B" | "F" ) .  (* F: fixing days *)
ROLL     = "FOLLOWING" | "PRECEDING" | "MODFOLLOWING"
         | "BOW" | "EOW" | "BOM" | "EOM" | "BOQ" | "EOQ"
         | "BOH" | "EOH" | "BOY" | "EOY" .
PERIOD   = "WEEK" | "MONTH" | "QUARTER" | "HALFYEAR" | "YEAR" .
MONTH    = "JAN" | … | "DEC"           (* Gregorian *)
         | "MUHARRAM" | … | "DHULHIJJAH"  (* Hijri *)
         | "NISAN" | … | "ADARII"     (* Hebrew  *)
         | "ZHENGYUE" | … | "LAYUE" . (* Chinese *)
EVENT    = "@" UPPER { UPPER | DIGIT | "_" } .  (* @FOMC *)
ZONE     = "UTC" ("+" | "-") NUM .     (* UTC+9, one token *)
ORDINAL  = NUM ("ST" | "ND" | "RD" | "TH") .  (* 3RD, one token *)

In grammatical terms (after grammatical category): the upper-case symbols are lexical categories, word classes that the lexer recognises; the lower-case rules are phrasal categories that the parser builds from words. The numbers carry the content, and the grammar adds a few things with a small, closed set of forms: number (one date, or several from a list or range), tense (T is the base date, the anchor date that tense relates to; TOM and SPOT are relative to it, > NEXT and > PREV look forward and back) and definiteness (4 JUL is the one in the year of T, > NEXT 4 JUL the next one).

Every decision is LL(1): after the first number, the separator selects the notation; after a complete date, + or - starts a period. Periods follow java.time: months first, with the day clamped to the end of the month (2016-01-31 + 1M is 2016-02-29), then days. B counts business days, Monday to Friday. > IMM moves to the next IMM date strictly after the date: the third Wednesday of March, June, September or December. > SPOT moves to the FX spot date: + 1B for USD against CAD, TRY, PHP or RUB, + 2B for every other pair (PAIR is six capital letters such as EURUSD).

Parsing a schedule yields a rule, not dates: a function that gets the base date T and a market only when it is evaluated. The grammar never names a market. A market only answers questions about days (which days are business days, and so which day is spot); the meaning of a rule doesn't depend on it, so IMM is the third Wednesday everywhere. Without a market, only Saturdays and Sundays are skipped.

Holiday rules: 4 JUL, 3 MON JAN, LAST MON MAY and EASTER are dates in the year of T. An observance {SAT - 1D, SUN + 1D} shifts a date by the first item for its weekday, so 4 JUL {SAT - 1D, SUN + 1D} is Independence Day as the NYSE observes it. A market can be declared from such rules; the test markets in the case list below are. Rolling, seen from T: TOM and SPOT are dates; > NEXT FRI, > PREV IMM or > NEXT 4 JUL look strictly after or before the date, an ordinal counts (> NEXT 3RD FRI, > NEXT 2ND IMM) and a set is the nearest of its anchors (> NEXT {MON, FRI}, > NEXT {1 FEB, 1 MAY}); > EOM, > EOQ and friends move to the edge of month, quarter, half year or year, and > FOLLOWING, > PRECEDING and > MODFOLLOWING to a business day of the market. Hijri (Umm al-Qura), Hebrew and Chinese months are month names too: 1 SHAWWAL is the day in the year of T, an error if it falls there twice or not at all. 24 DEC IF MON TUE WED THU keeps a date only on these weekdays. EQUINOX MAR, SOLSTICE JUN, EQUINOX SEP and SOLSTICE DEC are the days on which the sun reaches 0, 90, 180 and 270 degrees, SOLARTERM 5 is Qingming (the Chinese solar terms, counted from Lichun at 315 degrees), in UTC or in the offset after it: EQUINOX MAR UTC+9 is Japan's Vernal Equinox Day. Every tool computes them after Meeus.

Try it

The Peggy parser of this project, running in your browser: type a schedule, pick the base date T and a market, and the dates appear as you type, with the syntax tree the parser built: the categories are the rules of the grammar, the words the input. Its bracket notation below the tree can be pasted into a syntax tree generator. The markets and events are the ones of the test cases; a click on a test case below loads it here.

Loading the parser …

The same rules in every tool

Rules expr and date, copied from the grammar files. Pick a tool:

ALL(*) · adaptive LLJava DateSchedule.g4 ↗
// periods are applied from left to right
expr returns [Expr value]
    : date                          { $value = $date.value; }
      ( move[$value]                { $value = $move.value; }
      )*
    ;

// one step, applied to everything on its left
move[Expr before] returns [Expr value]
locals [List<Annual> annuals = new ArrayList<>()]
    : '+' period                    { $value = ScheduleSemantics.plus($before, $period.value); }
    | '-' period                    { $value = ScheduleSemantics.minus($before, $period.value); }
    | '>' 'IMM'                     { $value = ScheduleSemantics.nextImm($before); }
    | '>' spot                      { $value = ScheduleSemantics.spot($before, $spot.pair); }
    | '>' 'FIX' (p=PAIR)?           { $value = ScheduleSemantics.fix($before, $p == null ? null : $p.text); }
    | '>' ROLL                      { $value = ScheduleSemantics.roll($before, $ROLL.text); }
    | '>' 'NEXT' ordinal anchor     { $value = ScheduleSemantics.next($before, $ordinal.n, $anchor.value); }
    | '>' 'PREV' ordinal anchor     { $value = ScheduleSemantics.previous($before, $ordinal.n, $anchor.value); }
    | '>' count select 'IN' PERIOD
                                    { $value = ScheduleSemantics.select($before, $count.n, $count.fromEnd, $select.value, $PERIOD.text); }
      // > {1 FEB, 1 MAY}: the dates of the set in the year of the date
    | '>' '{' a=annual              { $annuals.add($a.value); }
      (',' a=annual                 { $annuals.add($a.value); }
      )* '}'                        { $value = ScheduleSemantics.datesInYear($before, $annuals); }
    | observance                    { $value = ScheduleSemantics.observe($before, $observance.shifts); }
    ;

Pitfall. $start is reserved (the rule's first token), so the range labels are first/last.

Side by side

Size counts non-blank, non-comment lines of the grammar files. The JVM modules also share a 385-line helper (market, context, rule builders, periods, business days, IMM and spot dates, ranges, annual dates, lunar months, rolling, named events); the Python modules a 231-line one.

ToolParsingLinesValues computed byErrors surface as
ANTLR 4 · Java ALL(*) · adaptive LL 99 Actions with returns […] attributes Throwing error listener plus BailErrorStrategy
ANTLR 4 · Python ALL(*) · adaptive LL 67 + 104grammar + visitor Visitor over the parse tree; the grammar has no actions Error listener on lexer and parser that raises
Scala combinators Recursive descent with backtracking 215 ^^ functions, foldLeft over the shifts NoSuccess result, turned into an exception
Coco/R LL(1) 132 (. … .) actions with out parameters errors.count, messages written to a stream
JavaCC LL(k), here LL(1) 143 Java code inside the productions; each declares its locals ParseException, TokenMgrException
SableCC LALR(1) with typed AST 88 + 131grammar + evaluator Separate evaluator walking the generated typed tree ParserException, LexerException
JFlex + CUP LALR(1) 75 + 59parser + lexer {: … :} actions, left-recursive rules parse() throws on the first syntax error
GNU Bison LALR(1) 198incl. hand-written scanner { … } actions, left-recursive rules parse() returns false
Flex + Bison · C LALR(1) 160 + 94parser + scanner { … } actions build a syntax tree, which a C evaluator walks with the context yyparse() returns non-zero; the scanner returns YYerror with its own message
Peggy PEG · ordered choice 275incl. date arithmetic Action blocks; date arithmetic written by hand SyntaxError with expected tokens
Lark Earley and LALR(1), one grammar 47 + 89grammar + transformer Transformer, one method per rule alias UnexpectedInput; VisitError wraps exceptions of the transformer
instaparse GLL · any context-free grammar 44 + 48grammar + transform insta/transform, one function per tag, calling the shared Java helper insta/failure? on the result, turned into an exception

What the comparison shows

The shared test cases

From examples/schedule.txt. Each module has a test that reads this file, so adding a line here tests all twelve implementations. They also read 2186 cases in examples/catalog.txt, generated from a holiday rule catalog, and 3347 in examples/date-holidays.txt, generated from date-holidays (neither listed here).

date notations

2015-06-092015-06-09
09.06.20152015-06-09
06/09/20152015-06-09
1.1.20002000-01-01

date plus / minus periods

09.06.2015 + 3M2015-09-09
06/09/2015 + 1W - 2D2015-06-14
2015-06-09 - 3M2015-03-09
2015-06-09 + 2Q2015-12-09
2015-06-09+10D2015-06-19
2015-06-09 - 1Y + 1D2014-06-10
2015-06-09 + 0D2015-06-09

end of month

2016-02-29 + 1Y2017-02-28
2016-01-31 + 1M2016-02-29
2016-01-31 + 1M - 1M2016-01-29

lists

2015-06-09, 01.01.2000 + 1Y2015-06-09, 2001-01-01
2015-06-09,2015-06-092015-06-09, 2015-06-09

ranges

[2015-01-15 : 1Q : 2015-12-31]2015-01-15, 2015-04-15, 2015-07-15, 2015-10-15
[2016-01-31 : 1M : 2016-04-30]2016-01-31, 2016-02-29, 2016-03-31, 2016-04-30
[2015-06-09 : 1W : 2015-06-09 + 2W]2015-06-09, 2015-06-16, 2015-06-23
[2015-06-09 : 1D : 2015-06-09]2015-06-09
[2015-06-09 : 1D : 2015-06-08]empty list
(2015-01-15 : 1Q : 2015-12-31)error

business days

2015-06-09 + 2B2015-06-11
2015-06-12 + 1B2015-06-15
2015-06-12 + 2B2015-06-16
2015-06-13 + 1B2015-06-15
2015-06-09 + 10B2015-06-23
2015-06-15 - 1B2015-06-12
2015-06-14 - 1B2015-06-12
2015-06-13 + 0B2015-06-13
2015-06-11 + 1M + 1B2015-07-13
2015-06-09 > SPOT + 3B2015-06-16
[2015-06-11 : 1B : 2015-06-16]2015-06-11, 2015-06-12, 2015-06-15, 2015-06-16
[2015-06-13 : 2B : 2015-06-19]2015-06-13, 2015-06-16, 2015-06-18

IMM dates

2015-06-09 > IMM2015-06-17
2015-06-17 > IMM2015-09-16
2015-12-20 > IMM2016-03-16
2016-12-20 > IMM2016-12-21
01.01.2015 > IMM2015-03-18
2015-06-09>IMM2015-06-17
2015-06-09 > IMM > IMM2015-09-16
2015-06-09 + 3M > IMM2015-09-16
2015-06-09 > IMM + 1D2015-06-18
[2015-01-01 > IMM : 1W : 2015-04-01]2015-03-18, 2015-03-25, 2015-04-01

FX spot dates

2015-06-09 > SPOT2015-06-11
2015-06-11 > SPOT2015-06-15
2015-06-12 > SPOT2015-06-16
2015-06-13 > SPOT2015-06-16
2015-12-31 > SPOT2016-01-04
2015-06-09 > SPOT EURUSD2015-06-11
2015-06-09 > SPOT EURCAD2015-06-11
2015-06-09 > SPOT USDCAD2015-06-10
2015-06-09 > SPOT CADUSD2015-06-10
2015-06-12 > SPOT USDCAD2015-06-15
2015-06-09>SPOT USDTRY2015-06-10
2015-06-12 > SPOT USDCAD > SPOT2015-06-17
2015-06-09 > SPOT + 1W2015-06-18
2015-06-09 > SPOT > IMM2015-06-17
[2015-06-09 > SPOT : 1W : 2015-06-30]2015-06-11, 2015-06-18, 2015-06-25

base date and market

market XTEST = 2015-06-10, 2015-07-03, 2015-12-25

[2015-06-09] T2015-06-09
[2015-06-09] T + 1M2015-07-09
[2015-06-09] T > IMM2015-06-17
[2015-06-09] T, 2015-01-012015-06-09, 2015-01-01
[2015-06-09] [T : 1W : T + 2W]2015-06-09, 2015-06-16, 2015-06-23
[2015-06-09] T + 2B2015-06-11
[2015-06-09 XTEST] T + 2B2015-06-12
[2015-06-09 XTEST] T + 1B2015-06-11
[2015-06-11 XTEST] T - 1B2015-06-09
[2015-07-02 XTEST] T + 1B2015-07-06
[2015-06-09 XTEST] 2015-06-09 + 2B2015-06-12
[2015-06-09 XTEST] T > SPOT2015-06-12
[2015-06-09 XTEST] T > SPOT USDCAD2015-06-11
[2015-12-24 XTEST] T > SPOT2015-12-29
[2015-06-09 XTEST] [T : 1B : T + 3B]2015-06-09, 2015-06-11, 2015-06-12, 2015-06-15
[2015-06-09 XTEST] T + 1M2015-07-09
Terror
T + 1Derror

holiday rules

[2025-06-09] 4 JUL2025-07-04
[2025-06-09] 3 MON JAN2025-01-20
[2025-06-09] 1 MON SEP2025-09-01
[2025-06-09] 4 THU NOV2025-11-27
[2025-06-09] 4 THU NOV + 1D2025-11-28
[2025-06-09] LAST MON MAY2025-05-26
[2025-06-09] 5 FRI JAN2025-01-31
[2025-06-09] EASTER2025-04-20
[2025-06-09] EASTER - 2D2025-04-18
[2024-06-09] EASTER + 1D2024-04-01
[2025-06-09] 4 JUL {SAT - 1D, SUN + 1D}2025-07-04
[2026-06-09] 4 JUL {SAT - 1D, SUN + 1D}2026-07-03
[2027-06-09] 4 JUL {SAT - 1D, SUN + 1D}2027-07-05
[2022-06-09] 1 JAN {SUN + 1D}2022-01-01
[2023-06-09] 1 JAN {SUN + 1D}2023-01-02
[2022-06-09] 25 DEC {SAT - 1D, SUN + 1D}2022-12-26
[2024-06-09] 1 JUN {SAT + 1D, SUN + 1D}2024-06-02
[2025-06-09] 4 JUL, 25 DEC2025-07-04, 2025-12-25
[2025-06-09] [15 JAN : 1Q : 31 DEC]2025-01-15, 2025-04-15, 2025-07-15, 2025-10-15
[2024-06-09] 29 FEB2024-02-29
[2025-06-09] 29 FEBerror
[2025-06-09] 31 APRerror
[2025-06-09] 5 MON FEBerror
[2025-06-09] 0 MON JANerror
4 JULerror
EASTERerror
[2025-06-09] 4 JUL 2025error
[2025-06-09] LAST JANerror
[2025-06-09] 4 JUL {SAT}error
[2025-06-09] 4 JUL {}error
[2025-06-09] 4 JUL {SAT - 1D SUN + 1D}error
[2025-06-09] T > SPOT EASTERerror

markets declared from holiday rules

market XNYS = 1 JAN {SUN + 1D}, 3 MON JAN, 3 MON FEB, EASTER - 2D, LAST MON MAY, 19 JUN {SAT - 1D, SUN + 1D}, 4 JUL {SAT - 1D, SUN + 1D}, 1 MON SEP, 4 THU NOV, 25 DEC {SAT - 1D, SUN + 1D}

market XEVE = 1 JAN {SAT - 1D, SUN + 1D}

market XTGT = 1 JAN, EASTER - 2D, EASTER + 1D, 1 MAY, 25 DEC, 26 DEC

[2025-07-03 XNYS] T + 1B2025-07-07
[2026-07-02 XNYS] T + 1B2026-07-06
[2025-04-17 XNYS] T + 1B2025-04-21
[2022-12-23 XNYS] T + 1B2022-12-27
[2021-12-30 XNYS] T + 1B2021-12-31
[2021-12-30 XEVE] T + 1B2022-01-03
[2025-11-26 XNYS] T > SPOT2025-12-01
[2025-01-01 XNYS] 3 FRI APR > PRECEDING2025-04-17
[2025-01-01 XNYS] 3 FRI MAR > PRECEDING2025-03-21
[2025-01-01 XNYS] 1 MAR - 1B2025-02-28
[2025-01-01 XNYS] 20 JAN > FOLLOWING2025-01-21
[2025-01-01] 20 JAN > FOLLOWING2025-01-20

rolling

[2025-06-09] TOM2025-06-10
[2025-06-13] TOM2025-06-16
[2025-11-26 XNYS] TOM2025-11-28
[2025-06-09] SPOT2025-06-11
[2025-06-09] SPOT USDCAD2025-06-10
[2025-06-09] SPOT + 1M2025-07-11
[2025-06-09] T > NEXT FRI2025-06-13
[2025-06-13] T > NEXT FRI2025-06-20
[2025-06-13] T > PREV FRI2025-06-06
[2025-06-13] T > NEXT BD2025-06-16
[2025-06-16] T > PREV BD2025-06-13
[2025-06-09] T > NEXT IMM2025-06-18
[2025-06-09] T > PREV IMM2025-03-19
[2025-06-09] T > NEXT 4 JUL2025-07-04
[2025-07-04] T > NEXT 4 JUL2026-07-04
[2025-12-01] T > NEXT 3 MON JAN2026-01-19
[2025-06-09] T > NEXT LAST MON MAY2026-05-25
[2025-06-09] T > PREV EASTER2025-04-20
[2025-04-20] T > PREV EASTER2024-03-31
[2026-06-09] T > NEXT 4 JUL {SAT - 1D, SUN + 1D}2026-07-03
[2025-06-09] T > BOM2025-06-01
[2025-06-09] T > EOM2025-06-30
[2024-02-10] T > EOM2024-02-29
[2025-06-09] T > BOY2025-01-01
[2025-06-09] T > EOY2025-12-31
2016-01-31 + 1M > EOM2016-02-29
[2025-05-09] T > EOM > PRECEDING2025-05-30
[2025-06-09] T > BOM > FOLLOWING2025-06-02
[2025-05-09] T > EOM > MODFOLLOWING2025-05-30
[2025-05-30 XNYS] T + 1M > MODFOLLOWING2025-06-30
[2025-05-30 XNYS] T > MODFOLLOWING2025-05-30
[2025-06-09] T > NEXTerror
[2025-06-09] T > NEXT 3Merror
[2025-06-09] T > NEXT Terror
[2025-06-09] T > NEXT MONDAYerror
[2025-06-09] TOM TOMerror
[2025-06-09] T > EOM EOMerror
TOMerror

next IMM date from today, tomorrow or spot

[2025-06-16] T > IMM2025-06-18
[2025-06-16] TOM > IMM2025-06-18
[2025-06-16] SPOT > IMM2025-09-17
[2025-06-16] SPOT - 1D > IMM2025-06-18
[2025-06-16] SPOT + 1B > IMM2025-09-17
[2025-06-16] SPOT USDCAD > IMM2025-06-18
[2025-06-16] SPOT EURSEK > IMM2025-09-17
[2025-06-17] TOM > IMM2025-09-17
[2025-06-18] T > IMM2025-09-17
[2025-06-18] T - 1D > IMM2025-06-18

lunar months

[2025-01-01] 1 SHAWWAL2025-03-30
[2025-01-01] [29 RAMADAN : 1D : 3 SHAWWAL]2025-03-29, 2025-03-30, 2025-03-31, 2025-04-01
[2030-01-01] 1 RAMADAN2030-01-05, 2030-12-26
[2030-01-01] 1 RAMADAN + 29D2030-02-03, 2031-01-24
[2030-01-01] [1 RAMADAN + 29D : 1 RAMADAN + 31D]2030-02-03, 2030-02-04, 2030-02-05, 2031-01-24, 2031-01-25, 2031-01-26
[2030-01-01] [1 RAMADAN : 1D : 3 SHAWWAL]error
[2025-01-01] 10 TISHRI2025-10-02
[2025-01-01] 10 TISHRI - 1D2025-10-01
[2024-01-01] 14 ADAR2024-02-23
[2024-01-01] 14 ADARII2024-03-24
[2025-01-01] 14 ADAR2025-03-14
[2025-01-01] 14 ADARIIerror
[2025-01-01] 1 ZHENGYUE2025-01-29
[2025-01-01] 1 ZHENGYUE - 1D2025-01-28
[2025-06-01] T > NEXT 1 ZHENGYUE2026-02-17
[2025-01-01] 3 MON SHAWWALerror
[2025-01-01] T > SPOT TISHRIerror

equinoxes, solstices and solar terms

[2025-01-01] EQUINOX MAR2025-03-20
[2025-01-01] SOLSTICE JUN2025-06-21
[2025-01-01] EQUINOX SEP2025-09-22
[2025-01-01] EQUINOX SEP UTC+92025-09-23
[2025-01-01] SOLSTICE DEC2025-12-21
[2026-01-01] EQUINOX SEP2026-09-23
[2026-01-01] EQUINOX SEP UTC-42026-09-22
[2027-01-01] SOLSTICE DEC2027-12-22
[2027-01-01] SOLSTICE DEC UTC-52027-12-21
[2024-01-01] SOLSTICE JUN UTC-42024-06-20
[2024-01-01] EQUINOX SEP UTC+9, EQUINOX SEP UTC+9 + 1D IF MON2024-09-22, 2024-09-23
[2025-01-01] EQUINOX SEP UTC+9, EQUINOX SEP UTC+9 + 1D IF MON2025-09-23
[2025-01-01] SOLARTERM 5 UTC+82025-04-04
[2026-01-01] SOLARTERM 5 UTC+82026-04-05
[2025-01-01] SOLARTERM 1 UTC+82025-02-03
[2025-01-01] SOLARTERM 23 UTC+82025-01-05
[2025-06-01] T > NEXT EQUINOX MAR2026-03-20
[2025-06-01] T > PREV SOLSTICE DEC2024-12-21
[2025-01-01] [EQUINOX MAR : 1M : SOLSTICE JUN]2025-03-20, 2025-04-20, 2025-05-20, 2025-06-20
[2025-01-01] EQUINOX JUNerror
[2025-01-01] SOLSTICE SEPerror
[2025-01-01] SOLARTERM 25error
[2025-01-01] SOLARTERM 0 UTC+8error
[2025-01-01] EQUINOXerror
EQUINOX MARerror
1 SHAWWALerror

conditional dates

[2025-01-01] 24 DEC IF MON TUE WED THU2025-12-24
[2027-01-01] 24 DEC IF MON TUE WED THUempty list
[2025-01-01] 3 JUL IF MON TUE WED THU, 24 DEC IF FRI2025-07-03
[2025-01-01] 24 DEC IF WED, 25 DEC2025-12-24, 2025-12-25
[2025-01-01] 24 DEC IFerror
[2025-01-01] [24 DEC : 1D : 26 DEC] IF WED2025-12-24
[2025-01-01] [1 JAN : 1M : 1 DEC] > NEXT FRI IF DAY 1..32025-01-03, 2025-05-02, 2025-10-03
[2025-01-01] [1 JAN : 1M : 1 DEC] > NEXT FRI IF DAY 1..3 OCT2025-10-03
[2019-01-01] 3 MON APR \ {EASTER - 6D, EASTER + 1D}, EASTER - 13D IF DAY 8..14 APR, EASTER + 8D IF DAY 22..28 APR2019-04-08
[2022-01-01] 3 MON APR \ {EASTER - 6D, EASTER + 1D}, EASTER - 13D IF DAY 8..14 APR, EASTER + 8D IF DAY 22..28 APR2022-04-25
[2026-01-01] 3 MON APR \ {EASTER - 6D, EASTER + 1D}, EASTER - 13D IF DAY 8..14 APR, EASTER + 8D IF DAY 22..28 APR2026-04-20
[2025-01-01] 3RD [1 JAN : 1D : ] IF DAY 10..122025-01-12
[2025-01-01] 24 DEC IF DAY 25..31empty list
[2025-01-01] 24 DEC IF DAY 3..1error
[2025-01-01] 24 DEC IF DAY 0..3error
[2025-01-01] 24 DEC IF DAY 1..32error
[2025-01-01] 24 DEC IF DAY 1..31 RAMADANerror
[2025-01-01] 24 DEC IF DAY 1error
[2025-01-01] 24 DEC IF DAYerror

named events

event FOMC = 2025-01-29, 2025-03-19, 2025-05-07, 2025-06-18, 2025-07-30, 2025-09-17, 2025-10-29, 2025-12-10

event THANKSGIVING = 4 THU NOV

event NEWYEAR = 1 JAN {SAT - 1D}

event fed.fomc_decision = 2025-01-29, 2025-03-19, 2025-05-07, 2025-06-18, 2025-07-30, 2025-09-17, 2025-10-29, 2025-12-10

[2025-01-01] @FOMC2025-01-29, 2025-03-19, 2025-05-07, 2025-06-18, 2025-07-30, 2025-09-17, 2025-10-29, 2025-12-10
[2025-06-30] @FOMC + 3W2025-02-19, 2025-04-09, 2025-05-28, 2025-07-09, 2025-08-20, 2025-10-08, 2025-11-19, 2025-12-31
[2025-01-01 XNYS] @FOMC + 1B2025-01-30, 2025-03-20, 2025-05-08, 2025-06-20, 2025-07-31, 2025-09-18, 2025-10-30, 2025-12-11
[2025-01-01] @THANKSGIVING + 1D, @FOMC IF FRI2025-11-28
[2025-01-01] [@THANKSGIVING : 1D : @THANKSGIVING + 3D]2025-11-27, 2025-11-28, 2025-11-29, 2025-11-30
[2025-02-01] T > NEXT @FOMC2025-03-19
[2025-03-19] T > NEXT @FOMC2025-05-07
[2025-03-19] T > PREV @FOMC2025-01-29
[2025-01-01] 1 DEC > NEXT @FOMC2025-12-10
[2024-01-01] @FOMCempty list
[2022-01-01] @NEWYEARempty list
[2025-12-15] T > NEXT @FOMCerror
[2025-01-01] [@FOMC : 1D : 31 DEC]error
[2025-01-01] [@FOMC - 1D : 1D : @FOMC]2025-01-28, 2025-01-29, 2025-03-18, 2025-03-19, 2025-05-06, 2025-05-07, 2025-06-17, 2025-06-18, 2025-07-29, 2025-07-30, 2025-09-16, 2025-09-17, 2025-10-28, 2025-10-29, 2025-12-09, 2025-12-10
[2025-01-01] [@FOMC > PREV 2ND SAT : @FOMC + 1D] IF WED2025-01-22, 2025-01-29, 2025-03-12, 2025-03-19, 2025-04-30, 2025-05-07, 2025-06-11, 2025-06-18, 2025-07-23, 2025-07-30, 2025-09-10, 2025-09-17, 2025-10-22, 2025-10-29, 2025-12-03, 2025-12-10
[2025-01-01] @NOPEerror
@FOMCerror
[2025-01-01] @EASTERerror
[2025-01-01] FOMCerror
[2025-01-01] @fomcerror
[2025-01-01] @ FOMCerror
[2025-01-01] @fed.fomc_decision2025-01-29, 2025-03-19, 2025-05-07, 2025-06-18, 2025-07-30, 2025-09-17, 2025-10-29, 2025-12-10
[2025-01-01 XNYS] @fed.fomc_decision + 1B IF THU2025-01-30, 2025-03-20, 2025-05-08, 2025-07-31, 2025-09-18, 2025-10-30, 2025-12-11
[2025-02-01] T > NEXT @fed.fomc_decision2025-03-19
[2025-01-01] @FED.FOMC_DECISIONerror
[2025-01-01] @fed.error
[2025-01-01] @fed..fomc_decisionerror
[2025-01-01] @fed .fomc_decisionerror
[2025-01-01] @_federror
[2025-01-01] @1federror

US employment report (non-farm payrolls)

market XFED = 1 JAN {SAT - 1D, SUN + 1D}, 3 MON JAN, 3 MON FEB, LAST MON MAY, 19 JUN {SAT - 1D, SUN + 1D}, 4 JUL {SAT - 1D, SUN + 1D}, 1 MON SEP, 2 MON OCT, 11 NOV {SAT - 1D, SUN + 1D}, 4 THU NOV, 25 DEC {SAT - 1D, SUN + 1D}

[2025-01-01 XFED] 3 JAN > NEXT FRI, 12 JAN - 1D > NEXT SAT + 20D > PRECEDING, 12 FEB - 1D > NEXT SAT + 20D > PRECEDING, 12 MAR - 1D > NEXT SAT + 20D > PRECEDING, 12 APR - 1D > NEXT SAT + 20D > PRECEDING, 12 MAY - 1D > NEXT SAT + 20D > PRECEDING, 12 JUN - 1D > NEXT SAT + 20D > PRECEDING, 12 JUL - 1D > NEXT SAT + 20D > PRECEDING, 12 AUG - 1D > NEXT SAT + 20D > PRECEDING, 12 SEP - 1D > NEXT SAT + 20D > PRECEDING, 12 OCT - 1D > NEXT SAT + 20D > PRECEDING, 12 NOV - 1D > NEXT SAT + 20D > PRECEDING2025-01-10, 2025-02-07, 2025-03-07, 2025-04-04, 2025-05-02, 2025-06-06, 2025-07-03, 2025-08-01, 2025-09-05, 2025-10-03, 2025-11-07, 2025-12-05
[2024-01-01 XFED] 3 JAN > NEXT FRI, 12 JAN - 1D > NEXT SAT + 20D > PRECEDING, 12 FEB - 1D > NEXT SAT + 20D > PRECEDING, 12 MAR - 1D > NEXT SAT + 20D > PRECEDING, 12 APR - 1D > NEXT SAT + 20D > PRECEDING, 12 MAY - 1D > NEXT SAT + 20D > PRECEDING, 12 JUN - 1D > NEXT SAT + 20D > PRECEDING, 12 JUL - 1D > NEXT SAT + 20D > PRECEDING, 12 AUG - 1D > NEXT SAT + 20D > PRECEDING, 12 SEP - 1D > NEXT SAT + 20D > PRECEDING, 12 OCT - 1D > NEXT SAT + 20D > PRECEDING, 12 NOV - 1D > NEXT SAT + 20D > PRECEDING2024-01-05, 2024-02-02, 2024-03-08, 2024-04-05, 2024-05-03, 2024-06-07, 2024-07-05, 2024-08-02, 2024-09-06, 2024-10-04, 2024-11-01, 2024-12-06
[2026-01-01 XFED] 12 APR - 1D > NEXT SAT + 20D > PRECEDING2026-05-08
[2026-01-01] 1 FRI MAY2026-05-01
[2020-01-01 XFED] 12 JUN - 1D > NEXT SAT + 20D > PRECEDING2020-07-02
[2026-01-01 XFED] 12 JUN - 1D > NEXT SAT + 20D > PRECEDING2026-07-02
[2026-01-01 XFED] 12 FEB - 1D > NEXT SAT + 20D > PRECEDING2026-03-06
[2025-01-01] 3 JAN > NEXT FRI2025-01-10
[2026-01-01] 3 JAN > NEXT FRI2026-01-09
[2019-01-01] 3 JAN > NEXT FRI2019-01-04

ordinals, sets, quarters and half years

[2026-11-02] T > NEXT 3RD FRI2026-11-20
[2026-11-06] T > NEXT 1ST FRI2026-11-13
[2026-11-02] T > PREV 2ND FRI2026-10-23
[2026-11-02] T > NEXT 11TH FRI2027-01-15
[2026-11-02] T > NEXT 2ND BD2026-11-04
[2026-11-02] SPOT > NEXT 2ND IMM2027-03-17
[2026-11-02] T > NEXT 2ND 4 JUL2028-07-04
[2026-11-02] T > PREV 2ND 4 JUL2025-07-04
[2026-11-02] T > NEXT 3 FRI JAN2027-01-15
[2026-11-02] T > NEXT 2ND 3 FRI JAN2028-01-21
[2026-11-02] T > NEXT {MON, FRI}2026-11-06
[2026-11-02] T > PREV {MON, FRI}2026-10-30
[2026-11-02] T > NEXT {SAT, SUN, MON}2026-11-07
[2026-11-02] T > NEXT {FRI}2026-11-06
[2026-11-02] T > NEXT 7TH {MON, FRI}2026-11-27
[2026-11-02] T > NEXT {MON, FRI} IF FRI2026-11-06
[2026-11-02] T > NEXT {1 FEB, 1 MAY}2027-02-01
[2027-02-10] T > NEXT {1 FEB, 1 MAY}2027-05-01
[2026-11-02] T > PREV {1 FEB, 1 MAY}2026-05-01
[2026-11-02] T > NEXT {IMM, 25 DEC}2026-12-16
[2026-12-17] T > NEXT {IMM, 25 DEC}2026-12-25
[2026-11-02] T > NEXT {25 DEC, EASTER} + 1D2026-12-26
[2026-11-02] T > NEXT 0TH FRIerror
[2026-11-02] T > NEXT 2ST FRIerror
[2026-11-02] T > NEXT 3 FRIerror
[2026-11-02] T > NEXT 3RDerror
[2026-11-02] T > NEXT FRI 3RDerror
[2026-11-02] T > NEXT MON FRIerror
[2026-11-02] T > NEXT {MON FRI}error
[2026-11-02] T > NEXT {}error
[2026-11-02] T > NEXT {3RD FRI}error
[2026-11-02] T > BOQ2026-10-01
[2026-11-02] T > EOQ2026-12-31
[2026-02-14] T > EOQ2026-03-31
[2026-05-15] T > BOH2026-01-01
[2026-05-15] T > EOH2026-06-30
[2026-08-15] T > BOH2026-07-01
[2026-08-15] T > EOH2026-12-31
[2026-11-02] T + 1H2027-05-02
2026-08-31 + 1H2027-02-28
2026-08-31 - 2H2025-08-31
[2026-01-01 : 1H : 2027-12-31]2026-01-01, 2026-07-01, 2027-01-01, 2027-07-01
[2026-11-02] T > BOM - 1D + 5B2026-11-06
[2026-11-02] T + 2M > BOM - 1D > NEXT 3RD WED2027-01-20

selection in a period

[2026-11-02] T > 3RD WED IN MONTH2026-11-18
[2026-11-02] T > 3RD WED IN MONTH + 1D2026-11-19
[2026-11-02] T > LAST FRI IN MONTH2026-11-27
[2026-11-02] T > 5TH BD IN MONTH2026-11-06
[2027-01-01] T > 1ST BD IN MONTH2027-01-01
[2027-01-01 XNYS] T > 1ST BD IN MONTH2027-01-04
[2026-11-02] T > 2ND LAST BD IN MONTH2026-11-27
[2026-11-02] T > 4TH LAST BD IN MONTH2026-11-25
[2026-11-02 XNYS] T > 4TH LAST BD IN MONTH2026-11-24
[2027-05-03] T > LAST BD IN MONTH2027-05-31
[2027-05-03 XNYS] T > LAST BD IN MONTH2027-05-28
[2027-05-03 XNYS] T > EOM > PRECEDING2027-05-28
[2026-11-04] T > 1ST {MON, FRI} IN WEEK2026-11-02
[2026-11-08] T > LAST {MON, FRI} IN WEEK2026-11-06
[2026-11-04] T > 2ND IMM IN YEAR2026-06-17
[2025-04-01] T > 1ST @FOMC IN QUARTER2025-05-07
[2025-04-01] T > LAST @FOMC IN HALFYEAR2025-06-18
[2026-11-02] T > LAST BD IN HALFYEAR2026-12-31
[2026-11-02] T > 1ST 4 JUL IN YEAR2026-07-04
[2026-12-10] T > 1ST {MON, 25 DEC} IN MONTH2026-12-07
[2026-11-02] T > 1ST {LAST MON MAY} IN YEAR2026-05-25
[2026-11-04] T > BOW2026-11-02
[2026-11-04] T > EOW2026-11-08
[2026-11-08] T > BOW2026-11-02
[2026-12-31] T > EOW2027-01-03
[2027-03-22] SPOT + 1Q > EOQ > 3RD WED IN MONTH2027-06-16
[2026-11-02] T > 5TH WED IN MONTHerror
[2026-11-02] T > 2ND 4 JUL IN YEARerror
[2026-11-02] T > 0TH WED IN MONTHerror
[2026-11-02] T > 2ST WED IN MONTHerror
[2026-11-02] T > LAST MON MAY IN YEARerror
[2026-11-02] T > 3RD WED INerror
[2026-11-02] T > 3RD WED IN DAYerror
[2026-11-02] T > 3RD IN MONTHerror
[2026-11-02] T > LAST LAST FRI IN MONTHerror
[2026-11-02] T > 3RD WED MONTHerror
4 JUL > 1ST WED IN MONTHerror

series and intervals

[2026-01-30 : 2026-02-02]2026-01-30, 2026-01-31, 2026-02-01, 2026-02-02
]2026-01-30 : 2026-02-02]2026-01-31, 2026-02-01, 2026-02-02
[2026-01-30 : 2026-02-02[2026-01-30, 2026-01-31, 2026-02-01
]2026-01-30 : 2026-02-02[2026-01-31, 2026-02-01
[2026-01-01 : 1W : 2026-01-29[2026-01-01, 2026-01-08, 2026-01-15, 2026-01-22
]2026-01-01 : 1W : 2026-01-29]2026-01-08, 2026-01-15, 2026-01-22, 2026-01-29
]2026-01-01 : 2026-01-01]empty list
[2026-01-01 : 2026-01-01[empty list
[2026-01-01 : 2026-01-01]2026-01-01
[2026-01-02 : 2026-01-01]empty list
[2026-01-01 : 3M : 2026-12-31] > EOQ > 3RD WED IN MONTH2026-03-18, 2026-06-17, 2026-09-16, 2026-12-16
[2026-01-01 : 1M : 2026-03-31] > EOQ2026-03-31, 2026-03-31, 2026-03-31
[2026-01-01 XNYS] [T : 1D : T + 2D] + 1B2026-01-02, 2026-01-05, 2026-01-05
[2026-01-01 XNYS] [T : 1M : T + 5M] > EOM > PRECEDING2026-01-30, 2026-02-27, 2026-03-31, 2026-04-30, 2026-05-29, 2026-06-30
[2026-01-01] [T : T + 30D] IF MON, 25 DEC2026-01-05, 2026-01-12, 2026-01-19, 2026-01-26, 2026-12-25
[2026-01-01] [T : T + 9D] IF {SAT, SUN}2026-01-03, 2026-01-04, 2026-01-10
[2026-01-01] 24 DEC IF {MON, TUE, WED, THU}2026-12-24
[2026-01-01] 26 DEC IF {MON, TUE, WED, THU}empty list
2026-01-01, [2026-01-05 : 2026-01-06], 2026-01-022026-01-01, 2026-01-05, 2026-01-06, 2026-01-02
[2025-01-01] [@THANKSGIVING : @THANKSGIVING + 3D] IF {FRI}2025-11-28
[2026-01-01 : 2026-01-05error
[2026-01-01 : : 2026-01-05]error
[2026-01-01 : 1D : 2026-01-05] + 4 JULerror
[2026-01-01] 24 DEC IF {}error
[2026-01-01] 24 DEC IF {MON TUE}error
[2026-01-01 : 1M]error
[2026-01-01 : 2026-01-05] [2026-01-06 : 2026-01-07]error

include, exclude and dates in year

[2026-01-01 : 2026-01-03] & [2026-01-02 : 2026-01-05]2026-01-01, 2026-01-02, 2026-01-03, 2026-01-04, 2026-01-05
[2026-01-05 : 2026-01-06] & [2026-01-01 : 2026-01-02]2026-01-01, 2026-01-02, 2026-01-05, 2026-01-06
[2026-01-01] [T : T + 7D] \ {1 JAN, 6 JAN}2026-01-02, 2026-01-03, 2026-01-04, 2026-01-05, 2026-01-07, 2026-01-08
[2026-01-01] [T : T + 7D] \ {1 JAN, 6 JAN} & 25 DEC2026-01-02, 2026-01-03, 2026-01-04, 2026-01-05, 2026-01-07, 2026-01-08, 2026-12-25
[2026-01-01] [T : 1W : T + 2W] & [T : 1W : T + 2W]2026-01-01, 2026-01-08, 2026-01-15
[2026-01-01 : 2026-01-03] & 2026-01-10 + 1D2026-01-02, 2026-01-03, 2026-01-04, 2026-01-11
[2026-01-01 : 2026-01-03] + 1D & 2026-01-102026-01-02, 2026-01-03, 2026-01-04, 2026-01-10
[2026-01-01] 1 JAN & {1 JAN + 1D, 6 JAN}2026-01-01, 2026-01-02, 2026-01-06
[2026-01-01] [T : T + 13D] \ [T : 1W : T + 13D] IF {MON, TUE}2026-01-05, 2026-01-06, 2026-01-12, 2026-01-13
[2026-01-01] [T : T + 2D] & 6 JAN, 31 DEC2026-01-01, 2026-01-02, 2026-01-03, 2026-01-06, 2026-12-31
[2025-06-01] [T : T + 29D] \ @FOMC IF WED2025-06-04, 2025-06-11, 2025-06-25
[2026-11-02] T > {1 FEB, 1 MAY}2026-02-01, 2026-05-01
[2026-11-02] [T : 1Y : T + 2Y] > {1 FEB, 1 MAY}2026-02-01, 2026-05-01, 2027-02-01, 2027-05-01, 2028-02-01, 2028-05-01
[2026-11-02] [T : 1Y : T + 1Y] > {3 WED MAR, 3 WED JUN, 3 WED SEP, 3 WED DEC}2026-03-18, 2026-06-17, 2026-09-16, 2026-12-16, 2027-03-17, 2027-06-16, 2027-09-15, 2027-12-15
[2026-11-02] [T : 1Y : T + 1Y] > {LAST MON MAY, 1 MON SEP}2026-05-25, 2026-09-07, 2027-05-31, 2027-09-06
[2026-11-02 XNYS] [T : 1Y : T + 1Y] > {1 FEB, 1 MAY} > FOLLOWING2026-02-02, 2026-05-01, 2027-02-01, 2027-05-03
[2026-11-02] T > {1 MAY, 1 FEB, 1 MAY}2026-02-01, 2026-05-01
[2026-01-01] {1 JAN, 6 JAN}error
[2026-01-01] 1 JAN &error
[2026-01-01] 1 JAN & {}error
[2026-01-01] 1 JAN \ 3Merror
[2026-01-01] 1 JAN & {1 JAN 6 JAN}error
[2026-11-02] T > {}error
[2026-11-02] T > {MON}error
[2026-11-02] T > {@FOMC}error
[2026-11-02] T > {IMM}error

picks

[2026-11-02] 5TH [SPOT : 1Q : ] > EOQ > 3RD WED IN MONTH2027-12-15
[2026-11-02] 7TH [T : 1D : ] IF {MON, FRI}2026-11-27
[2026-11-02] 1ST [T : 1D : ] IF SAT2026-11-07
[2026-11-02] 3RD [2026-01-01 : 1M : ] > EOM2027-01-31
[2026-11-02] 2ND LAST [T : 1D : T + 10D]2026-11-11
[2026-11-02] 1ST LAST [T : 1W : T + 3W]2026-11-23
[2026-11-02] 2ND [T : T + 3D], 5 JAN2026-11-04, 2026-01-05
[2025-04-01] 2ND @FOMC2025-06-18
[2026-11-02] 1ST [T - 3D : 1D : ]2026-11-03
[2026-11-02] [T : 1Q : ]error
[2026-11-02] ]T : 1W : ]error
[2026-11-02] 0TH [T : 1D : ]error
[2026-11-02] 2ST [T : 1D : ]error
[2026-11-02] 1ST LAST [T : 1D : ]error
[2026-11-02] 20000TH [T : 1D : ]error
[2026-11-02] 5TH [T : 1D : T + 2D]error
[2026-11-02] LAST [T : 1D : T + 2D]error
[2026-11-02] 1ST [T : 1D : ] [error
[2026-11-02] [T : 1D : [error
[2026-11-02] 2ND T + 1Derror
[2026-11-02] 1ST LAST MON MAYerror

fixing calendar

[2026-04-01] T + 2F2026-04-03
[2026-04-01 XNYS XTGT] T + 2F2026-04-07
[2026-04-01 XNYS XTGT] T + 2B2026-04-06
[2026-04-01 XNYS XTGT] T > SPOT > FIX2026-04-01
[2026-04-01 XNYS XTGT] T > SPOT USDCAD > FIX USDCAD2026-04-01
[2026-04-07 XNYS XTGT] T - 1F2026-04-02
[2026-04-02 XNYS XTGT] T > NEXT FD2026-04-07
[2026-04-02 XNYS] T > NEXT FD2026-04-03
[2026-04-01 XNYS XTGT] T > 2ND FD IN MONTH2026-04-02
[2026-04-01 XNYS XTGT] T > 3RD LAST FD IN MONTH2026-04-28
[2026-04-01 XNYS XTGT] [T : 1F : T + 7D]2026-04-01, 2026-04-02, 2026-04-07, 2026-04-08
[2026-04-30 XNYS XTGT] T + 1B2026-05-01
[2026-04-30 XNYS XTGT] T + 1F2026-05-04
[2026-04-30 XNYS XTGT] T > NEXT {BD, FD}2026-05-01
[2026-04-01 XNYS XTGT] T > FIX EURerror
[2026-04-01 XNYS XTGT] T + 2FDerror
[2026-04-01 XNYS XTGT] T > FDerror
[2026-04-01 XNYS XTGT] T > FIX USDCAD USDCADerror

MaturityRule: the examples of another maturity rule language (selectors such as "lastday of month(5) of sp")

[2026-11-02] SPOT + 1W2026-11-11
[2026-11-02] SPOT + 4M > EOM2027-03-31
[2026-11-02] SPOT > IMM > IMM2027-03-17
[2027-03-22] SPOT > IMM > IMM2027-09-15
[2027-03-22] SPOT > EOQ > IMM2027-06-16
[2026-11-02] SPOT > EOQ > IMM2027-03-17
[2026-11-02] SPOT > IMM > IMM > IMM > IMM > IMM2027-12-15
[2026-11-02] SPOT > NEXT 5TH IMM2027-12-15
[2026-11-02] T > NEXT 7TH {MON, FRI}2026-11-27
[2026-11-02] SPOT + 1M > BOM - 1D > NEXT 3RD WED2026-12-16
[2027-01-01] 1 JAN - 1D + 5B2027-01-07
[2026-11-02] SPOT > NEXT FRI + 2W2026-11-20
[2026-11-02] SPOT > NEXT 3RD FRI2026-11-20
[2026-11-02] SPOT + 1M > BOM2026-12-01
[2026-11-02] SPOT > EOM2026-11-30
[2026-11-02] SPOT > NEXT {1 FEB, 1 MAY}2027-02-01
[2026-11-02] SPOT + 6M2027-05-04
[2026-11-02] SPOT + 1H2027-05-04
[2026-11-02] SPOT + 3B2026-11-09
[2026-11-02] T + 1D2026-11-03
[2026-11-02] T + 2B2026-11-04
[2026-11-02] T + 1Q2027-02-02
[2026-11-02] T + 1Y2027-11-02
[2026-11-02] T > NEXT 2ND MON2026-11-16
[2026-11-02] T > PREV 2ND MON2026-10-19
[2026-11-02] T > BOW2026-11-02
[2026-11-02] T > EOW2026-11-08
[2026-11-02] T > BOM + 9D2026-11-10
[2026-11-02] T > 3RD WED IN MONTH2026-11-18
[2026-11-02 XNYS] T > 5TH BD IN MONTH2026-11-06
[2026-11-02 XNYS] T > LAST BD IN MONTH2026-11-30
[2026-11-02] T > 2ND BD IN QUARTER2026-10-02
[2026-04-01 XNYS XTGT] T > 3RD FD IN MONTH2026-04-07
[2026-04-01 XNYS XTGT] T + 2F2026-04-07
[2026-04-01 XNYS XTGT] SPOT > FIX2026-04-01
[2026-11-02] T + 2M > BOM2027-01-01
[2026-11-02] T > BOQ + 1M > BOM2026-11-01
[2026-11-02] T > BOM > BOW + 1W2026-11-02
[2026-11-02] T > BOM - 1D > NEXT 2ND 1 JAN2028-01-01
[2026-11-02] 3RD [T > BOM : 1M : ]2027-02-01
[2026-11-02] T > NEXT {MON, FRI}2026-11-06
[2026-11-02] [T > BOW : T > EOW] IF {MON, FRI}2026-11-02, 2026-11-06
[2026-11-02] T > NEXT 3 WED MAR2027-03-17
[2026-11-02] T > NEXT 3 WED JUN2027-06-16
[2026-11-02] T > NEXT 3 WED SEP2027-09-15
[2026-11-02] T > NEXT 3 WED DEC2026-12-16
[2026-12-16] T > NEXT 3 WED DEC2027-12-15
[2026-11-02] 1ST [T > BOY : 1Y : ] + 2M > 3RD WED IN MONTH2027-03-17
[2026-11-02] T > NEXT 2ND 3 WED MAR2028-03-15
[2026-11-02] T > NEXT 2ND 3 WED JUN2028-06-21
[2026-11-02] T > NEXT 2ND 3 WED SEP2028-09-20
[2026-11-02] T > NEXT 2ND 3 WED DEC2027-12-15
[2026-11-02] 2ND [T > BOY : 1Y : ] + 11M > 3RD WED IN MONTH2027-12-15
[2026-11-02] T > NEXT 3RD 3 WED MAR2029-03-21
[2026-11-02] T > NEXT 3RD 3 WED JUN2029-06-20
[2026-11-02] T > NEXT 3RD 3 WED SEP2029-09-19
[2026-11-02] T > NEXT 3RD 3 WED DEC2028-12-20
[2026-11-02] T > NEXT 1 JAN2027-01-01
[2026-11-02] T > NEXT 31 MAR2027-03-31
[2026-11-02] T > NEXT 1 APR2027-04-01
[2026-11-02] T > NEXT 30 JUN2027-06-30
[2026-11-02] T > NEXT 1 JUL2027-07-01
[2026-11-02] T > NEXT 30 SEP2027-09-30
[2026-11-02] T > NEXT 1 OCT2027-10-01
[2026-11-02] T > NEXT 31 DEC2026-12-31
[2026-12-31] T > NEXT 31 DEC2027-12-31
[2026-11-02] T > NEXT 2ND 1 JAN2028-01-01
[2026-11-02] T > NEXT 2ND 31 MAR2028-03-31
[2026-11-02] T > NEXT 2ND 1 APR2028-04-01
[2026-11-02] T > NEXT 2ND 30 JUN2028-06-30
[2026-11-02] T > NEXT 2ND 1 JUL2028-07-01
[2026-11-02] T > NEXT 2ND 30 SEP2028-09-30
[2026-11-02] T > NEXT 2ND 1 OCT2028-10-01
[2026-11-02] T > NEXT 2ND 31 DEC2027-12-31
[2026-11-02] T > NEXT 3RD 1 JAN2029-01-01
[2026-11-02] T > NEXT 3RD 31 MAR2029-03-31
[2026-11-02] T > NEXT 3RD 1 APR2029-04-01
[2026-11-02] T > NEXT 3RD 30 JUN2029-06-30
[2026-11-02] T > NEXT 3RD 1 JUL2029-07-01
[2026-11-02] T > NEXT 3RD 30 SEP2029-09-30
[2026-11-02] T > NEXT 3RD 1 OCT2029-10-01
[2026-11-02] T > NEXT 3RD 31 DEC2028-12-31
[2026-11-02 XNYS] [SPOT + 1M : 1M : SPOT + 3M] > EOM + 2B2027-01-05, 2027-02-02, 2027-03-02
[2026-11-02 XNYS] 2ND [SPOT + 1M : 1M : ] > EOM + 2B2027-02-02
[2026-11-02] T > IMM2026-12-16
[2026-11-02] 1ST [T > BOQ : 1Q : ] + 2M > 3RD WED IN MONTH2026-12-16
[2026-11-02] T + 1M > 2ND WED IN MONTH2026-12-09
[2026-11-02] SPOT + 1M > 3RD WED IN MONTH2026-12-16
[2026-06-19] T + 2B > BOM - 1D > NEXT 1 JUN > 3RD WED IN MONTH2026-06-17
[2026-06-19] T + 2B > NEXT 3 WED JUN2027-06-16

invalid dates

2015-02-29error
2015-13-01error
31.04.2015error

syntax errors

2015-06error
+ 3Merror
2015-06-09 + 3error
2015-06-09 + Merror
2015-06-09 + 3Xerror
2015-06-09 ,error
2015-06-09 2015-06-10error
2015-06.09error
[2015-01-01 : 1M]error
2015-06-09 >error
2015-06-09 IMMerror
2015-06-09 > 3Merror
2015-06-09 > IMerror
2015-06-09 SPOTerror
2015-06-09 > USDCADerror
2015-06-09 > SPOT EURerror
2015-06-09 > SPOT EURUSDXerror
2015-06-09 > SPOT usdcaderror
2015-06-09 > SPOT USDCAD USDCADerror
[2015-06-09] 2015-06-09 + Terror
[2015-06-09] T Terror
2015-06-09 + 2berror
2015-06-09 > 2Berror
[2015-01-01 : 1M : 2015-02-01], 2015-03-012015-01-01, 2015-02-01, 2015-03-01
(empty input)error

step of a range must be positive

[2015-01-01 : 0D : 2015-02-01]error
[2015-06-01 : 0B : 2015-06-05]error

Rule files and holidays-events

A schedule says which dates; a rule file says whose dates they are. Its grammar wraps the schedule language in declarations. It started in the Lark module as rules.lark; now all 12 implementations read rule files with their own tool and pass the 72 cases of examples/rules.txt.

rule xnys.juneteenth for juneteenth in exchange:XNYS valid from 2022-01-01 = 19 JUN {SAT - 1D, SUN + 1D}
  with kind = closed
  cites "NYSE holidays & trading hours" url "https://www.nyse.com/markets/hours-calendars" label official;

rule sa.eid_al_fitr for eid_al_fitr in country:SA
  = ONE OF { 1 RAMADAN + 29D AS ramadan_29, 1 RAMADAN + 30D AS ramadan_30 }
  with kind = closed;

Run it yourself

You need JDK 17 and Maven 3.9. Bison is optional: without it the Bison module builds empty. The Peggy module downloads its own Node.js. The C module needs a compiler, Flex and Bison, or Docker.

git clone https://github.com/hjuergens/date-parser.git
cd date-parser
mvn clean verify                      # all modules
mvn -pl date-rule-coco test           # one module
docker build -t date-rule-flex-bison date-rule-flex-bison
docker run --rm -v "$PWD:/work" -w /work/date-rule-flex-bison date-rule-flex-bison make test   # C