Skip to content

Date/Time Modifiers

Below is a set of modifiers that can be used with the RECEIVED field to transform it to the required date/time format.

For the examples below, the {RECEIVED} field equals ISO formatted 2023-04-01T09:20:01.000000-0700.

Date Format

Spec Description
%y The last two decimal digits of the year.
%Y The year as a decimal number.
%b Abbreviated month name.
%B Full month name.
%m Month as a decimal number (January is 01), prefixed with 0 if needed.
%d Day of the month as a decimal number, prefixed with 0 if needed.
%e Day of the month as a decimal number, prefixed with a space if needed.
%D Equivalent to "%m/%d/%y".
%F Equivalent to "%Y-%m-%d".

Example

{RECEIVED|%B %e, %Y} converts to April 1, 2023
{RECEIVED|%F} converts to 2023-04-01

Weekday Format

Spec Description
%a Abbreviated weekday name.
%A Full weekday name.
%u Weekday as a decimal number (1-7), where Monday is 1.
%w Weekday as a decimal number (0-6), where Sunday is 0.

Example

{RECEIVED|%A} converts to Saturday

Time Format

Spec Description
%H Hour (24-hour clock) as a decimal number, prefixed with 0 if needed.
%I Hour (12-hour clock) as a decimal number, prefixed with 0 if needed.
%p Locale's equivalent of the AM/PM designations associated with a 12-hour clock.
%M Minutes as a decimal number, prefixed with 0 if needed.
%S Seconds as a decimal number (prefixed with 0 if needed) followed by the fractional part of the second, if present in the timestamp.
%T Equivalent to "%H:%M:%S".

Example

{RECEIVED|%I:%M:%S %p} converts to 09:20:01.000000 AM
{RECEIVED_S|%I:%M:%S %p} converts to 09:20:01 AM

Timezone Format

Spec Description
%Z Time zone abbreviation.
%z Offset from UTC, e.g. -0430 means 4 hours 30 minutes behind UTC. +0000 if the offset is zero.
%Ez Same as %z with a : between the hours and minutes (e.g., -04:30).

Miscellaneous

Spec Description
%Q Microseconds since UNIX epoch (January 1, 1970 00:00:00 UTC). It is also a unique message identifier in the syslog storage.
%j Day of the year as a decimal number (January 1 is 001). It is left-padded with 0 to three digits.
%U Week number of the year as a decimal number, prefixed with 0 if needed. The first Sunday of the year is the first day of week 01. Days of the same year prior to that are in week 00.
%W Week number of the year as a decimal number, prefixed with 0 if needed. The first Monday of the year is the first day of week 01. Days of the same year prior to that are in week 00.
%x Locale's date representation.
%c Locale's date and time (rounded to seconds) representation.

Example

{RECEIVED|%Q} converts to 1680366001000000
{RECEIVED|%j} converts to 091