lightning:relativeDateTime
ソースの日時と指定された日時の相対的な時差を表示します。
タイムスタンプまたは JavaScript の Date オブジェクトを指定すると、lightning:relativeDateTime には、現在の時刻と指定された時刻の相対時間を表す文字列が表示されます。
使用される単位は、指定された時刻からどれだけの時間が過ぎたかに対応します。たとえば、「数秒前」または「5 分前」などです。将来の時刻を指定すると、「7 か月後」または「5 年後」などの相対時間が返されます。
この例では、現在の時刻と過去および将来の指定時刻との相対時間を返します。時差は init ハンドラによって設定されます。
1<aura:component>
2 <aura:handler name="init" value="{! this }" action="{! c.init }" />
3 <aura:attribute name="past" type="Object"/>
4 <aura:attribute name="future" type="Object"/>
5 <p><lightning:relativeDateTime value="{! v.past }"/></p>
6 <p><lightning:relativeDateTime value="{! v.future }"/></p>
7</aura:component>クライアント側コントローラは、コンポーネントの初期化中にコールされます。past 属性と future 属性は、次のような値を返します。
- 2 時間前
- 2 日後
1({
2 init: function (cmp) {
3 cmp.set('v.past', Date.now()-(2\*60\*60\*1000));
4 cmp.set('v.future', Date.now()+(2\*24\*60\*60\*1000));
5 }
6})出力例には他に次のものがあります。
- 相対的な過去: 数秒前、1 分前、2 分前、1 時間前、2 時間前、2 日前、2 か月前、2 年前
- 相対的な将来: 数秒後、1 分後、2 分後、1 時間後、2 時間後、2 日後、2 か月後、2 年後
時間の単位はユーザのロケール (en-US などの言語コードを返す) を使用してローカライズされます。次の時間の単位がサポートされています。
- seconds
- minutes
- 時間
- 日
- か月
- 年
認証
| 属性名 | 属性型 | 説明 | 必須 |
|---|---|---|---|
| body | Component[] | コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。 | |
| value | Object | 書式設定の対象となるタイムスタンプまたは JavaScript の Date オブジェクト。 | 可 |