Format specifiers

​Output templates support providing format specifiers for properties after a semicolon: {prop:format}.
There's generic support for IFormattable values that allows to use format specifiers defined for standard primitives (numeric types, TimeSpan, DateTime, etc.) as well as customize rendering of custom complex types.
Here are some basic examples of property formats: 
{Timestamp:yy-mm-dd}
{RandomDouble:0.###}
​
Special formats
Whitespace insertion
Ordinary properties can be augmented with one of three special formats to insert surrounding whitespaces:
W — inserts a leading whitespace next to property value.
w — inserts a trailing whitespace next to property value.
wW — inserts both leading and trailing whitespaces next to property value.
Note that no whitespaces are inserted when there's no property with given name in log event. This allows to chain multiple optional properties in the output template and avoid having multiples in rendered message spaces when none of these properties are present.
Log level formats
Special Level property in output templates supports custom formats consisting of case and width.
Allowed  case specifiers are u (uppercase), w (lowercase) and t (title case).
Allowed width ranges from 1 to 5.
Here's how the Error value is rendered with different level formats:
u5 --> ERROR
u3 --> ERR
w5 --> error
w3 --> err
t5 --> Error
t3 --> Err  

Special properties

Source context

Last modified 3yr ago

Copy link

Contents

Special formats