---
schema_version: "1"
id: 9abef7be6a09a19c79e9109e1a4f3c9123eb436d56004fb7381afa4631bfdb78
title: StringToDate()
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/ampscript/references/date-time/mc-ampscript-reference-date-time-string-to-date.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud-ampscript/references/mc-ampscript-date-time/mc-ampscript-reference-date-time-string-to-date.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: bc7654a01b79c7e0f39800463f71a4d8a40b28e5d30202091da264ab0a200441
products:
  - AMPscript for Marketing Cloud
  - Marketing Cloud
---
# StringToDate()

Converts a date string to a different format.

## Availability

<table>
  <tr>
    <td>Marketing Cloud Engagement</td>
    <td>✅ Yes</td>
  </tr>
  <tr>
    <td>Marketing Cloud Next</td>
    <td>✅ Yes, [with some differences](#differences-between-marketing-cloud-engagement-and-marketing-cloud-next)</td>
  </tr>
</table>

This function became available in Marketing Cloud Next during the Summer ’26 release (API version 67.0).

## Differences Between Marketing Cloud Engagement and Marketing Cloud Next

In Marketing Cloud Engagement, this function returns a dateTime object that other functions can reformat.

In Marketing Cloud Next, this function returns a string formatted with the `G` standard format. This format uses a combination of a short date value and a long time value. For example, in the `en_US` locale, this function outputs a timestamp that’s similar to this example: `5/15/2026 1:23:45 PM`. Because the output is a string and is formatted based on locale rules, you can’t reliably pass it through other functions that expect a date-time string, such as `FormatDate()`. If your use case requires you to parse and then format a date, use `FormatDate()` instead.

## Syntax

```
StringToDate(dateString)
```

The `StringToDate()` function has one parameter:

- `dateString` (string): Required. The date or timestamp to format.

## Supported Date Formats

You can specify a date string in several formats, including:

- ISO 8601 timestamp: `2023-08-05T13:41:23-06:00`
- ISO 8601 date: `2023-08-05`
- US date and time notation: `8/5/2023 1:41 PM`
- Long-form notation: `5 August 2023` or `August 5, 2023`
- Date and time: `2023-08-05 1:41:23 PM`
- Time only: `1:41 PM`
- Chinese and Japanese notation: `2023 年 8 月 5 日`
- Korean notation: `2023년 8월 5일`

The function doesn’t support these formats:

- Dates in which the day includes an ordinal suffix, such as `August 5th, 2023` or `5th August 2023`.
- Little-endian numeral notation, such as `5/8/2023` to represent the 5th of August, 2023.
- Month names in languages other than English, such as `5 août 2023`.
- Dates that include any numerals other than Western Arabic numerals, such as `٢٠٢٣/٨/٥`.
- Dates based on any calendar system other than the Gregorian calendar, such as `18 Av, 5783` or `18 Muharram, 1445`.

## Usage

To use this function, pass it a date or timestamp in a supported format.

```
%%[
  Var @endDate
  Set @endDate = "2023년 8월 5일"
]%%
<p>This offer is valid until %%=StringToDate(@endDate)=%%.</p>
```

The example returns the timestamp in a format that aligns with the current locale settings.

```
This offer is valid until 8/5/2023 12:00:00 AM.
```