Skip to content

DateAdd Token ​

[[DateAdd:n,unit,format]] returns a date relative to today. Use it for "today plus 7 days" cutoffs, "first of next month" filters, or just to render today's date in a specific format.

Syntax ​

[[DateAdd:number,interval,format]]

To get today's date, supply zero as the number — [[DateAdd:0]]. The token only fires when at least one argument is present.

Arguments ​

PositionRequiredValuesMeaning
numberrequiredinteger (positive, negative, or zero)How many intervals to add. Negative goes into the past
intervalrequired if number is setd w m yDay, week, month, year
formatoptional.NET date format patternHow to render the result. If omitted, the system default format is used

Examples ​

TokenResult (assuming today is 2026-08-01)
[[DateAdd:0]]Today's date in the system default format
[[DateAdd:0,d,MM/dd/yyyy]]08/01/2026
[[DateAdd:1,w]]2026-08-08 (next week, default format)
[[DateAdd:-1,m,yyyy-MM]]2026-07 (last month)
[[DateAdd:5,y,yyyy-MM-dd]]2031-08-01 (five years from now)
[[DateAdd:7,d,dddd]]Saturday (day name 7 days from now)

For the full list of date format specifiers, see Microsoft's custom date and time format strings docs.

Example ​

html
<xmod:Template>
  <ListDataSource CommandText="SELECT * FROM Articles WHERE PublishDate >= @cutoff">
    <Parameter Name="cutoff" Value="[[DateAdd:-7,d,yyyy-MM-dd]]" DataType="DateTime" />
  </ListDataSource>
  <HeaderTemplate>
    <h1>Articles from the past 7 days</h1>
    <p>As of [[DateAdd:0,d,MMMM d, yyyy]]</p>
  </HeaderTemplate>
  <ItemTemplate>
    <p><strong>[[Title]]</strong> — [[PublishDate]]</p>
  </ItemTemplate>
</xmod:Template>

See the Tokens Overview for the standard rules that apply to all tokens.