FEEL expression language: built-in functions and syntax
86 built-in functions · 18 language constructs · DMN 1.6
FEEL (Friendly Enough Expression Language) is the expression language of the OMG DMN 1.6 standard (Decision Model and Notation). Decision table cells, literal expressions and boxed expressions in a DMN model are written in FEEL. This reference covers its built-in functions and the grammar around them. To try an expression, type it into the bar above and press Enter. The FEEL playground has a context editor for variables.
Built-in functions
FEEL defines 86 built-in functions. They are grouped below into 7 pages, one per kind of value,
and each function has its own section there with its signature, parameters, examples and the cases that return
null. 2 more functions, marked extension, are not in the standard but are
supported by the engine behind this site.
Function names in FEEL may contain spaces (string length, day of week), and every
argument can also be passed by name.
Functions by group
- FEEL boolean functions (4): truth tables for and, or and not with null, is() versus =, and the list quantifiers all() and any().
- FEEL string functions (14): the rules all of them share, string concatenation, regex pitfalls and every function side by side.
- FEEL numeric functions (15): a side-by-side rounding table, how FEEL number equality works, and every numeric function with its edge cases.
- FEEL list functions (23 + 1 extension): how positions, nulls and single values behave across all of them, aggregating over lists of contexts, and every function side by side.
- FEEL date and time functions (11 + 1 extension): date arithmetic, the two kinds of duration, time zones, and every temporal function side by side.
- FEEL range functions (14): how points and ranges relate: before, after, meets, overlaps, includes and during.
- FEEL context functions (5): reading entries by a key known only at runtime, and building changed copies of a context.
All functions A to Z
| Function | Group | What it does |
|---|---|---|
| abs | Numeric functions | Returns the absolute value of a number or duration |
| after | Range functions | Returns true if a lies entirely after b with no overlap |
| all | Boolean functions | Returns true if every element is true, false if any element is false, and null otherwise |
| any | Boolean functions | Returns true if at least one element is true, false if all are false, and null otherwise |
| append | List functions | Returns a new list with the items added to the end |
| before | Range functions | Returns true if a lies entirely before b with no overlap |
| ceiling | Numeric functions | Rounds towards positive infinity at the given scale |
| coincides | Range functions | Returns true if two points are equal or two ranges have identical endpoints and closures |
| concatenate | List functions | Returns one list containing the elements of all argument lists, in order |
| contains | String functions | Returns true if the string contains match anywhere, false otherwise |
| context | Context functions | Builds a context from a list of {key, value} pairs, the inverse of get entries |
| context merge | Context functions | Combines a list of contexts into one; later entries overwrite earlier ones with the same key |
| context put | Context functions | Returns a copy of the context with the entry set, added or replaced |
| count | List functions | Returns the number of elements in the list |
| date | Date and time functions | Creates a date from an ISO 8601 string, from year/month/day components, or by truncating a date and time value |
| date and time | Date and time functions | Creates a date and time from an ISO 8601 string or by combining a date with a time |
| day of week | Date and time functions | Returns the English weekday name of the date |
| day of year | Date and time functions | Returns the ordinal day within the year, 1 to 366 |
| decimal | Numeric functions | Rounds n to the given scale using banker's rounding (round half to even) |
| distinct values | List functions | Returns the list with duplicate elements removed, preserving first-seen order |
| duplicate values | List functions | Returns the values that appear more than once in the list |
| duration | Date and time functions | Creates a days-and-time or years-and-months duration from an ISO 8601 string |
| during | Range functions | Returns true if a lies fully inside range, the mirror of includes |
| ends with | String functions | Returns true if the string ends with match |
| even | Numeric functions | Returns true if the number is an even integer |
| exp | Numeric functions | Returns e raised to the given power |
| finished by | Range functions | Returns true if range ends exactly where a ends and contains it, the mirror of finishes |
| finishes | Range functions | Returns true if a ends exactly where range ends and lies within it |
| flatten | List functions | Returns a flat list with all nested lists recursively expanded in place |
| floor | Numeric functions | Rounds towards negative infinity at the given scale |
| get entries | Context functions | Returns the context as a list of {key, value} pairs, enabling iteration over entries |
| get value | Context functions | Returns the value of the named entry, or null if the key does not exist |
| includes | Range functions | Returns true if range fully contains a, endpoints included |
| index of | List functions | Returns the positions of all occurrences of match, as an ascending list of 1-based indexes |
| insert before | List functions | Returns a new list with newItem inserted before the given position |
| is | Boolean functions | Returns true if both values are the same in the FEEL semantic domain |
| last day of month extension | Date and time functions | Returns the day number of the last day of the value's month (28, 29, 30 or 31), handy for billing-period and deadline logic |
| list contains | List functions | Returns true if the list contains the element |
| list replace | List functions | Returns a new list with the element at the position, or every element accepted by the matcher function, replaced by newItem |
| log | Numeric functions | Returns the natural logarithm |
| lower case | String functions | Returns the string with every character converted to lower case |
| matches | String functions | Returns true if the input matches the regular expression |
| max | List functions | Returns the largest element |
| mean | List functions | Returns the arithmetic average of the numbers; null for an empty list |
| median | List functions | Returns the median: the middle element of the sorted values, or the mean of the two middle elements for an even count |
| meets | Range functions | Returns true if range1 ends exactly where range2 begins, with both endpoints included |
| met by | Range functions | Returns true if range1 begins exactly where range2 ends, the mirror of meets |
| min | List functions | Returns the smallest element |
| mode | List functions | Returns the most frequent value(s) as a list; ties produce several results in ascending order |
| modulo | Numeric functions | Returns the remainder of the division |
| month of year | Date and time functions | Returns the English month name of the date |
| not | Boolean functions | Logical negation with three-valued logic: not(true) is false, not(false) is true, and anything else, including null, yields null |
| now | Date and time functions | Returns the current date and time |
| number | Numeric functions | Parses a string into a number, optionally describing which grouping and decimal separators the string uses |
| odd | Numeric functions | Returns true if the number is an odd integer |
| overlaps | Range functions | Returns true if the ranges share at least one point, in either order |
| overlaps after | Range functions | Returns true if range1 ends after range2 and they overlap without either containing the other, the mirror of overlaps before |
| overlaps before | Range functions | Returns true if range1 starts before range2 and they overlap without either containing the other |
| partition extension | List functions | Splits the list into consecutive chunks of the given size; the last chunk may be shorter |
| product | List functions | Returns the product of the numbers |
| remove | List functions | Returns a new list with the element at the given position removed |
| replace | String functions | Returns the input with every match of the regular expression replaced by the replacement, which may reference capture groups as $1, $2, … |
| reverse | List functions | Returns the list in reverse order |
| round down | Numeric functions | Rounds towards zero at the given scale |
| round half down | Numeric functions | Rounds to the nearest value; ties round towards zero |
| round half up | Numeric functions | Rounds to the nearest value; ties round away from zero (the rounding most people learn in school) |
| round up | Numeric functions | Rounds away from zero at the given scale |
| sort | List functions | Returns the list sorted by the precedes function |
| split | String functions | Splits the string at every match of the delimiter pattern and returns the parts as a list of strings |
| sqrt | Numeric functions | Returns the square root; null for negative input |
| started by | Range functions | Returns true if range begins exactly where a begins and contains it, the mirror of starts |
| starts | Range functions | Returns true if a begins exactly where range begins and lies within it |
| starts with | String functions | Returns true if the string begins with match |
| stddev | List functions | Returns the sample standard deviation of the numbers |
| string | String functions | Converts any FEEL value to its string representation |
| string join | String functions | Concatenates a list of strings into one string, optionally separated by a delimiter |
| string length | String functions | Returns the number of characters in the string |
| sublist | List functions | Returns the slice of the list starting at start position, running to the end or for length elements |
| substring | String functions | Returns the part of the string that starts at start position |
| substring after | String functions | Returns everything after the first occurrence of match; the empty string if match does not occur |
| substring before | String functions | Returns everything before the first occurrence of match; the empty string if match does not occur |
| sum | List functions | Returns the sum of the numbers |
| time | Date and time functions | Creates a time from an ISO 8601 string, from components, or by extracting the time of a date and time value |
| today | Date and time functions | Returns the current date |
| union | List functions | Returns all elements of the argument lists with duplicates removed, preserving first-seen order |
| upper case | String functions | Returns the string with every character converted to upper case |
| week of year | Date and time functions | Returns the ISO 8601 week number of the date |
| years and months duration | Date and time functions | Returns the duration between two dates as whole years and months, dropping smaller units |
Language guides
Besides its built-in functions, FEEL has conditionals, iteration, quantifiers, list filters, ranges, operators and inline function definitions. The five guides below cover the whole grammar, each construct with its syntax and examples evaluated by the engine that runs the playground.
FEEL conditionals and loops
FEEL has no statements. if … then … else picks one of two values, for … in … return builds a new list from an old one, and some and every test the elements of a list. Each of them is an expression that returns a value, so you can nest them and use them anywhere a value fits.
In this guide: if … then … else · for … in … return · some … satisfies · every … satisfies
FEEL lists, filters and contexts
Most DMN input data is a list of records: order lines, applicants, past claims. FEEL handles it with four pieces of syntax. Square brackets filter a list or pick one element, a dot reads an entry from a context, the same dot on a list of contexts collects that entry from every element, and braces build a context.
In this guide: list filter […] · list projection (path on a list) · path access (.) · context literal {…}
FEEL unary tests and ranges
A FEEL unary test is the content of a DMN decision table input cell. The cell value is matched against the column's input: [18..65) matches 18 up to but not including 65, "gold", "silver" matches either string, and not(< 10) matches 10 or more. An empty cell, or -, matches anything.
In this guide: unary tests (decision table cells) · range / interval · in · between … and
FEEL operators
FEEL operators look like the ones in most languages, with a few differences that matter in decision logic. Numbers are decimals, so 0.1 + 0.2 is exactly 0.3. Equality is a single =. and and or are words, and negation is the function not(). A type mismatch gives null instead of an error.
In this guide: arithmetic operators · comparison and boolean operators · instance of
FEEL types, null and temporal literals
Why does my FEEL expression return null? In standard FEEL a type error does not raise an exception. It produces null, and null spreads through the rest of the expression: "total: " + 5 is null because a string and a number cannot be added. The usual causes are a mistyped path, a missing input, or two values of different types.
In this guide: null and error propagation · temporal literals @"…" · function definition
Grammar map
Every construct of the grammar, its syntax, and the guide that explains it.
| Construct | Syntax | Guide |
|---|---|---|
| if … then … else | if condition then expression else expression | Conditionals and loops |
| for … in … return | for name in list return expression | Conditionals and loops |
| some … satisfies | some name in list satisfies condition | Conditionals and loops |
| every … satisfies | every name in list satisfies condition | Conditionals and loops |
| list filter […] | list[condition] · list[index] | Lists, filters and contexts |
| list projection (path on a list) | listOfContexts.entryName | Lists, filters and contexts |
| path access (.) | context.entryName | Lists, filters and contexts |
| context literal {…} | { name: expression, name: expression } | Lists, filters and contexts |
| range / interval | [a..b] · (a..b) · [a..b) | Unary tests and ranges |
| in | value in list · value in range · value in (test, test) | Unary tests and ranges |
| unary tests (decision table cells) | < 10 · [1..10] · 1, 2, 3 · not(1, 2) | Unary tests and ranges |
| between … and | value between low and high | Unary tests and ranges |
| instance of | value instance of type | Operators |
| function definition | function(param, param) expression | Types, null and literals |
| arithmetic operators | + - * / ** | Operators |
| comparison and boolean operators | = != < <= > >= · and or | Operators |
| temporal literals @"…" | @"2026-07-01" · @"P3D" · @"10:30:00" | Types, null and literals |
| null and error propagation | null | Types, null and literals |
For copy-ready patterns, see the examples cheat sheet; for the business-friendly dialect, see B-FEEL.
Every result on this page was computed by the Impulse FEEL engine 0.9.1, the interpreter that runs the playground. Last updated .
Defined by the OMG DMN 1.6 specification, chapter 10.3 (the FEEL grammar, semantics and built-in functions).