Output Date (Deprecated)

ui:outputDate

Deprecated as of API version 47.0. We recommend migrating to Lightning Web Components and using the lightning-formatted-date-time component.

For Use In

Lightning Experience, Experience Builder Sites, Salesforce Mobile App, Lightning Out (Beta), Standalone Lightning App

Deprecation Guidelines 

We recommend using Lightning Web Components whenever possible. When migrating to Lightning Web Components, use lightning-formatted-date-time.

For more information, see Aura Components in the ui Namespace Are Deprecated.

Usage Overview (Deprecated) 

A ui:outputDate component represents a date output in the YYYY-MM-DD format and is wrapped in an HTML span tag. We recommend using lightning:formattedDateTime instead of ui:outputDate.

ui:outputDate can be used with ui:inputDate, which takes in a date input. To apply Lightning Design System styling, we recommend that you use lightning:input with type="date" instead of ui:inputDate.

ui:outputDate retrieves the browser’s locale information and displays the date accordingly. To display a date, you can use an attribute value and bind it to the ui:outputDate component.

1<aura:attribute name="myDate" type="Date" default="2014-09-29" />
2
3<ui:outputDate value="{!v.myDate}" />

The previous example renders the following HTML.

1<span class="uiOutputDate">Sep 29, 2014</span>

To display record data for Salesforce objects, use lightning:outputField with lightning:recordViewForm, or use lightning:recordForm. To display record data with a custom layout, use force:recordData.

Note

Attributes 

NameDescriptionTypeDefaultRequired
bodyThe body of the component. In markup, this is everything in the body of the tag.Aura.Component[]
formatA string (pattern letters are defined in java.text.SimpleDateFormat) used to format the date and time of the value attribute.String
langLocaleDeprecated. The language locale used to format date value. It only allows to use the value which is provided by Locale Value Provider, otherwise, it falls back to the value of $Locale.datetimeLocale. It will be removed in an upcoming release.String
valueThe output value of the date. It should be a date string in ISO-8601 format (YYYY-MM-DD).String