Date Token Feature

Dynamically insert "today's date," "date X days from today," or "HubSpot date/time property values" into messages using custom tokens

Updated: August 25, 2025

Benefits of Using This Feature

  • Automatically insert customized dates into your messages
  • Support flexible date formatting with various display options
  • Automatically calculate dates a specified number of days from today through relative date calculation
  • Send HubSpot date/time property values in your specified format
  • Reflect the latest customized date information each time you send a message

When using this feature, please note the following:

  • Dates are calculated at customized timing
  • When displaying time information, date variables containing time data are required

Available Tokens and Data Flow

  1. Insert Today's Date:{{todayDate}}
    • Basic Syntax:{{todayDate "format"}}
    • Usage Examples:
Today is {{todayDate "YYYY-MM-DD"}}
Starting from {{todayDate "M/D"}} today
Scheduled for {{todayDate "MMM D, YYYY"}}
  1. Insert Date After Specified Days:{{addDays}}
    • Basic Syntax:{{addDays days "format"}}
    • Usage Examples:
Results announcement on {{addDays 7 "M/D"}}
Application deadline is {{addDays 14 "YYYY-MM-DD"}}
We will contact you on {{addDays 3 "MMM D, YYYY"}}
  1. Format HubSpot Date/Time Properties:{{formatDate}}
    • Basic Syntax:{{formatDate dateTimePropertyInternalName "format" "locale"}
    • By specifying the internal name of a HubSpot date/time property, you can send that property's value in your specified format
    • Usage Examples:
{{formatDate day_naibumei "MMM D, YYYY (ddd) HH:mm" "en"}}
{{formatDate interview_date "YYYY/MM/DD HH:mm" "en"}}
{{formatDate deadline "Due by MMM D" "en"}}

Setup Instructions

1. Date Format Reference The following formats are available for use.

Format Example Output Description
YYYY-MM-DD 2024-08-25 Year-Month-Day (ISO format)
M/D 8/25 Month/Day (simple)
MM/DD 08/25 Month/Day (zero-padded)
YYYY/MM/DD 2024/08/25 Year/Month/Day
MMM D, YYYY Aug 25, 2024 Month Day, Year
MMM D, YYYY (ddd) Aug 25, 2024 (Mon) Month Day, Year + Weekday
MMM D, YYYY (ddd) HH:mm Aug 25, 2024 (Mon) 14:30 Month Day, Year + Weekday + Time
HH:mm 14:30 Time only

2. Using in Messages Insert tokens at the required locations to create your messages.

Practical Usage Examples 

🎉 Registration starts today {{todayDate "MMM D"}}!
You can get an offer on {{addDays 14 "M/D"}} 😍

Interview Date: {{formatDate interview_date "MMM D, YYYY (ddd) HH:mm" "en"}}
Please arrive by {{formatDate interview_date "HH:mm" "en"}} on the day

Application Deadline: {{addDays 10 "YYYY-MM-DD"}}

When today is August 25, 2025, and the date/time property with internal name "interview_date" is September 5, 2025 12:00 GMT+9 August 25, 2025 08:00 GMT+9, it will appear as follows:

▼ LITTLE HELP CONNECT Configuration Screen

スクリーンショット 2025-08-25 11.48.01

▼ Actual Message Display

スクリーンショット 2025-08-25 11.48.49

Testing and Verification

  1. Token Display Verification
    • Perform a test message delivery to confirm that tokens display in the correct date format
  2. Date Calculation Verification
    • Verify that relative dates using addDays are calculated correctly
  3. Format Verification
    • Confirm that dates are displayed according to your specified format

Troubleshooting

Common Issues

Q: Dates are not displaying correctly A: Please check the format string. Case sensitivity matters.

Q: Weekdays appear in a different language A: Specify locale as "en" in formatDate.

Q: Time is not displaying A: Verify that the date/time property you're using contains time information. Time formats (such as HH:mm) cannot be used with properties that don't contain time data.

Reference: About HubSpot Date/Time Properties Date/time property internal names used with formatDate must be internal names of properties defined in HubSpot. You can check available date/time property internal names in your HubSpot property settings.