lightning:formattedDateTime (ベータ)
書式設定された日付と時刻を表示します。
lightning:formattedDateTime コンポーネントは、書式設定された日付と時刻を表示します。このコンポーネントは、Intl.DateTimeFormat JavaScript オブジェクトを使用して、日付値の書式を設定します。アプリケーションのユーザ設定に設定されているロケールによって書式が決まります。
en-US のロケールに基づく例をいくつか示します。
表示: 8/2/2016
1<aura:component>
2 <lightning:formattedDateTime value="1470174029742" />
3</aura:component>表示: Tuesday, Aug 02, 16
1<aura:component>
2 <lightning:formattedDateTime value="1470174029742" year="2-digit" month="short" day="2-digit" weekday="long"/>
3</aura:component>表示: 8/2/2016, 3:15 PM PDT
1<aura:component>
2 <lightning:formattedDateTime value="1470174029742" year="numeric" month="numeric" day="numeric" hour="2-digit" minute="2-digit" timeZoneName="short" />
3</aura:component>このコンポーネントは、Apple Safari 10 以下でフォールバック動作を提供します。次のフォーマッティングオプションには、古いブラウザでフォールバック動作を使用するときに例外があります。
- era はサポートされていません。
- timeZoneName は、短縮形では GMT、長い形式では GMT-h:mm または GMT+h:mm を追加します。
- timeZone は UTC をサポートします。別のタイムゾーン値を使用する場合、lightning:formattedDateTime はブラウザのタイムゾーンを使用します。
属性
| 属性名 | 属性型 | 説明 | 必須項目 |
|---|---|---|---|
| body | Component[] | コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。 | |
| day | String | 使���できる値は、numeric または 2-digit です。 | |
| era | String | 使用できる値は、narrow、short、long です。 | |
| hour | String | 使用できる値は、numeric または 2-digit です。 | |
| hour12 | Boolean | 時刻が 12 時間として表示されるかどうかを決定します。false の場合、時刻は 24 時間として表示されます。デフォルト設定は、ユーザのロケールによって決まります。 | |
| minute | String | 使用できる値は、numeric または 2-digit です。 | |
| month | String | 使用できる値は、2-digit、narrow、short、long です。 | |
| second | String | 使用できる値は、numeric または 2-digit です。 | |
| timeZone | String | 使用するタイムゾーン。実装には、IANA タイムゾーンデータベースにリストされている任意のタイムゾーンを含めることができます。デフォルトは、ランタイムのデフォルトのタイムゾーンです。この属性は、デフォルトのタイムゾーンを上書きする場合のみ使用します。 | |
| timeZoneName | String | 使用できる値は、short または long です。たとえば、太平洋タイムゾーンは、「short」を選択すると「PST」、「long」を選択すると「Pacific Standard Time」と表示されます。 | |
| value | Object | 書式設定される値で、日付オブジェクトまたはタイムスタンプになります。 | はい |
| weekday | String | 使用できる値は、narrow、short、long です。 | |
| year | String | 使用できる値は、numeric または 2-digit です。 |