---
schema_version: "1"
id: 3c13e986ed39d849a1287fa620ac3208b7799e653ff42d1cc55cb8d60fce970e
title: formatDateTime()
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/aura-platform/guides/aura/ref-jsapi/ref-jsapi-auralocalizationservice-formatdatetime.md
canonical_url: https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formatdatetime.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 01eb6e2b5b4bbfc6bb7bac40b68d786bba589ce6f5b61349fb2c1cb8ff56b890
products:
  - Lightning Aura Components Developer Guide
  - Platform Developer Content
---

# formatDateTime()

Returns a formatted date time.

## Signature

`formatDateTime (string | number | Date date, string formatString, string locale)`

## Parameters

**_date_**

Type: `string | number | Date`

A datetime string in ISO8601 format , or a timestamp in milliseconds, or a `Date` object. If you provide a String value, use ISO 8601 format to avoid parsing warnings. If no timezone is specified, defaults to the browser timezone offset.

**_formatString_**

Type: `string`

Optional. A string containing tokens to format the given date. For example, `"yyyy-MM-dd"` formats 15th January, 2017 as "2017-01-15". The default format string comes from the `$Locale` value provider. For details on available tokens, see [Formatting Dates in JavaScript](https://developer.salesforce.com/docs/platform/aura-platform/js-cb/js-cb-format-dates.md).

**_locale_**

Type: `string`

Optional. A locale to format the given date. The default value is `$Locale.langLocale`. We strongly recommended that you use the locale value from `$Locale`. We fall back to the value in `$Locale.langLocale` if you use an unavailable locale.

## Returns

**Type: `string`** A formatted and localized date time string.

## Sample Code

```javascript
var date = new Date();
// Returns datetime in the format "Oct 9, 2015 9:00:00 AM"
$A.localizationService.formatDateTime(date);
```