Home/HighLevel/Features/SaaS Configurator/HighLevel Date/Time Formatter: format and compare dates

Agency, Settings and Integrations

HighLevel Date/Time Formatter: format and compare dates

In short

The Date/Time Formatter action in HighLevel lets you change how a date or a date time appears and lets you compute the number of days between two dates. It works inside a workflow and provides a token you can use in later steps.

AreaSaaS Configurator · SaaS Mode
Used forSaaS subscription service, Real estate agency, Online course platform
Setup steps17 steps in 3 tasks
Last updatedNovember 16, 2026

01Who this is for

  • Founders who need to align incoming webhook dates with the format required by another app.
  • Small agencies that send appointment reminders and must show dates in a regional format.
  • Businesses that track contract deadlines and want to calculate remaining days automatically.

02Date/time formatter actions, explained

The Date/Time Formatter action lives in the workflow builder. It can take a date field, a date time field, or a custom value and output the same information in a different layout. You first choose the source field, then tell the action what the current layout looks like, and finally pick the new layout you need. The action returns a token that other workflow steps can reference.

When you use the compare mode, the action accepts two dates, each with its own source and format. It calculates the difference in days, using the formula End Date minus Start Date, and it makes the result available as a token. A negative result indicates the start date occurs after the end date.

All of these capabilities are accessed from the workflow action menu, and the tokens are inserted with the double curly brace syntax shown in the tooltips.

03How businesses use the date/time formatter action

  • SaaS subscription service. Select the inbound webhook date field, set the From Format to match the incoming pattern, choose the required output format, and store the formatted date in a contact custom field for later reporting.
  • Real estate agency. Pick the lease end date as the End Date, use the current date as the Start Date, set both formats as needed, and use the days token in an email reminder to tenants.
  • Online course platform. Choose the class start date time from the appointment record, define the existing pattern, select the target pattern required by an external calendar, and pass the formatted value to a custom webhook.

04The numbers and rules that matter

  • Output token for formatted date: {{datetime_formatter.1.date}}.
  • Output token for formatted date time: {{datetime_formatter.1.datetime}}.
  • Output token for day difference: {{datetime_formatter.1.days}}.

05How to set up and use the date/time formatter action in HighLevel

Format a date

  1. Open the workflow and add the Date/Time Formatter action.
  2. Choose a date source such as Specific Date, Current Date, a contact date field, an appointment date, a custom value, or a webhook trigger.
  3. If the source is a system field, the action auto detects its layout; otherwise pick the exact layout that matches the custom value.
  4. Select the desired output layout from the provided list.
  5. Insert the resulting token {{datetime_formatter.1.date}} into any following workflow step.

Format a date and time

  1. Add the Date/Time Formatter action to the workflow.
  2. Select a date time source such as Specific Date and Time, Current Date and Time, an appointment start/end time, a custom value, or a webhook trigger.
  3. Remember that contact custom fields cannot hold a date time structure.
  4. When the source is a system field the format is auto detected; for custom values choose the matching layout manually.
  5. Pick the required output layout from the list.
  6. Use the token {{datetime_formatter.1.datetime}} in subsequent actions.

Compare two dates

  1. Add the Date/Time Formatter action and select Compare Dates mode.
  2. Choose the first date as the Start Date from any supported source.
  3. Set the Start Date Format, letting system fields auto detect or manually matching a custom value.
  4. Choose the second date as the End Date from any supported source.
  5. Define the End Date Format with the same auto detect or manual matching rule.
  6. Insert the token {{datetime_formatter.1.days}} which contains End Date minus Start Date; a negative number means the start occurs later.

06What it looks like in HighLevel

07Settings that matter

  • Field. Specifies which date or date time value the action will reformat or compare.
  • From Format. Tells the action what layout the incoming value currently uses; system fields are detected automatically.
  • To Format. Defines the layout that the action should output after conversion.
  • Output. Provides the token that holds the formatted date, date time, or day difference for later workflow steps.
  • Start Date. The first date used when calculating a day difference.
  • Start Date Format. The layout of the start date; auto detected for system fields or manually set for custom values.
  • End Date. The second date used for the day difference calculation.
  • End Date Format. The layout of the end date; follows the same auto detect or manual selection rule as the start date.

08Things to know before you rely on it

  • Contact custom fields cannot store a date time structure at present.
  • The day difference result may be negative if the start date is later than the end date.

09How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Businesses often receive dates in one format but need to send them in another, or they need to know how many days are left until a deadline. The Date/Time Formatter action lets you reshape dates and calculate day differences inside a workflow.

The first thing to get right is the "From Format" when you use a custom value or webhook source. If the format doesn’t match exactly, the action can’t translate the date correctly, which throws off downstream steps.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 16, 2026

Common questions

Common questions about the date/time formatter action.

How do I change a date from MM/DD/YYYY to DD/MM/YYYY in a workflow?

Add the Date/Time Formatter action, set the Field to the source date, choose MM/DD/YYYY as the From Format, pick DD/MM/YYYY as the To Format, and use the {{datetime_formatter.1.date}} token in the next step.

Can I reformat a date time value as well as a date only?

Yes. Select a date time source, let the From Format auto detect or specify it, choose the target layout, and then use the {{datetime_formatter.1.datetime}} token.

What does the Compare Dates action return?

It returns the number of days between the End Date and the Start Date as the token {{datetime_formatter.1.days}}. The calculation uses End minus Start, so a negative number means the start date is later.

Are contact custom fields supported for date time formatting?

No. Contact custom fields do not support the date time structure in this action.

Which token do I use after formatting only a date?

The token {{datetime_formatter.1.date}} holds the formatted date value.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.