---
schema_version: "1"
id: 189b04a38c6d93064f75ad4c3eddfaaeca02d1a06c30fc5bfd6d186b8aac2522
title: formatTime()
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-formattime.md
canonical_url: https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-auralocalizationservice-formattime.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 81260b66a911328685e2e9958fca315fa4ea9feafafb85efcc4842a994e16f0e
products:
  - Lightning Aura Components Developer Guide
  - Platform Developer Content
---

# formatTime()

Returns a formatted time.

## Signature

`formatTime (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 time string.

## Sample Code

```javascript
var date = new Date();
// Returns a date in the format "9:00:00 AM"
var now = $A.localizationService.formatTime(date);
```