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
- Insert Today's Date:
{{todayDate}}
- Basic Syntax:
{{todayDate "format"}}
- Usage Examples:
- Basic Syntax:
Today is {{todayDate "YYYY-MM-DD"}}
Starting from {{todayDate "M/D"}} today
Scheduled for {{todayDate "MMM D, YYYY"}}
- Insert Date After Specified Days:
{{addDays}}
- Basic Syntax:
{{addDays days "format"}}
- Usage Examples:
- Basic Syntax:
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"}}
- 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:
- Basic Syntax:
{{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
▼ Actual Message Display
Testing and Verification
- Token Display Verification
- Perform a test message delivery to confirm that tokens display in the correct date format
- Date Calculation Verification
- Verify that relative dates using
addDays
are calculated correctly
- Verify that relative dates using
- 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.