amp-date-display

簡介

amp-date-display 元件以各種日期格式和不同地區設定呈現日期資訊。

設定

包含 amp-date-display 元件...

<script async custom-element="amp-date-display" src="https://cdn.ampproject.org/v0/amp-date-display-0.1.js"></script>

...以及標頭中的 amp-mustache 元件

<script async custom-template="amp-mustache" src="https://cdn.ampproject.org/v0/amp-mustache-0.2.js"></script>

基本用法

您必須指定 datetime、timestamp-ms 或 timestamp-seconds 屬性之一。這表示要顯示的日期和時間。

日期資訊透過 amp-mustache 範本呈現。

日、時、分和秒值分別繫結至 {{day}}、{{hour}}、{{minute}} 和 {{second}}。

雙位數格式變體（{{dayTwoDigit}}、{{hourTwoDigit}}、{{minuteTwoDigit}} 和 {{secondTwoDigit}}）會以零填充顯示單位數值。其他值（例如 {{iso}}）也可用

<amp-date-display timestamp-seconds="2147483648" layout="fixed-height" height="20">
  <template type="amp-mustache">
      <a href="https://en.wikipedia.org/wiki/Year_2038_problem">Y2K38</a> will be at {{iso}}
  </template>
</amp-date-display>

可用變數

所有可以顯示的變數都在以下範本中。

變數	值
日	{{day}}
dayName	{{dayName}}
dayNameShort	{{dayNameShort}}
dayPeriod	{{dayPeriod}}
dayTwoDigit	{{dayTwoDigit}}
時	{{hour}}
hour12	{{hour12}}
hour12TwoDigit	{{hour12TwoDigit}}
hourTwoDigit	{{hourTwoDigit}}
iso	{{iso}}
分	{{minute}}
minuteTwoDigit	{{minuteTwoDigit}}
月	{{month}}
monthName	{{monthName}}
monthNameShort	{{monthNameShort}}
monthTwoDigit	{{monthTwoDigit}}
秒	{{second}}
secondTwoDigit	{{secondTwoDigit}}
年	{{year}}
yearTwoDigit	{{yearTwoDigit}}

<amp-date-display datetime="now" layout="fixed" width="360" height="590">
  <template type="amp-mustache">
    <table>
      <thead>
        <tr><th>variable</th><th>value</th></tr>
      </thead>
      <tbody>
        <tr><td>day</td><td>{{day}}</td></tr>
        <tr><td>dayName</td><td>{{dayName}}</td></tr>
        <tr><td>dayNameShort</td><td>{{dayNameShort}}</td></tr>
        <tr><td>dayPeriod</td><td>{{dayPeriod}}</td></tr>
        <tr><td>dayTwoDigit</td><td>{{dayTwoDigit}}</td></tr>
        <tr><td>hour</td><td>{{hour}}</td></tr>
        <tr><td>hour12</td><td>{{hour12}}</td></tr>
        <tr><td>hour12TwoDigit</td><td>{{hour12TwoDigit}}</td></tr>
        <tr><td>hourTwoDigit</td><td>{{hourTwoDigit}}</td></tr>
        <tr><td>iso</td><td>{{iso}}</td></tr>
        <tr><td>minute</td><td>{{minute}}</td></tr>
        <tr><td>minuteTwoDigit</td><td>{{minuteTwoDigit}}</td></tr>
        <tr><td>month</td><td>{{month}}</td></tr>
        <tr><td>monthName</td><td>{{monthName}}</td></tr>
        <tr><td>monthNameShort</td><td>{{monthNameShort}}</td></tr>
        <tr><td>monthTwoDigit</td><td>{{monthTwoDigit}}</td></tr>
        <tr><td>second</td><td>{{second}}</td></tr>
        <tr><td>secondTwoDigit</td><td>{{secondTwoDigit}}</td></tr>
        <tr><td>year</td><td>{{year}}</td></tr>
        <tr><td>yearTwoDigit</td><td>{{yearTwoDigit}}</td></tr>
      </tbody>
    </table>
  </template>
</amp-date-display>

地區設定

國際化的月份和星期名稱可以透過指定 locale 屬性來設定。

例如，以下 amp-date-display 元件以德文、法文、捷克文和英文顯示相同的日期資訊。

<amp-date-display datetime="now" locale="de" layout="fixed" width="360" height="20">
  <template type="amp-mustache">
    <div>de: {{dayName}} {{day}} {{monthName}} {{year}}</div>
  </template>
</amp-date-display>
<amp-date-display datetime="now" locale="fr" layout="fixed" width="360" height="20">
  <template type="amp-mustache">
    <div>fr: {{dayName}} {{day}} {{monthName}} {{year}}</div>
  </template>
</amp-date-display>
<amp-date-display datetime="now" locale="cs" layout="fixed" width="360" height="20">
  <template type="amp-mustache">
    <div>cs: {{dayName}} {{day}} {{monthName}} {{year}}</div>
  </template>
</amp-date-display>
<amp-date-display datetime="now" locale="en-GB" layout="fixed" width="360" height="20">
  <template type="amp-mustache">
    <div>en-GB: {{dayName}} {{day}} {{monthName}} {{year}}</div>
  </template>
</amp-date-display>

需要更多說明嗎？

如果此頁面上的說明未能涵蓋您的所有問題，請隨時與其他 AMP 使用者聯繫，討論您的確切使用案例。

前往 Stack Overflow

未說明的特性？

AMP 專案大力鼓勵您的參與和貢獻！我們希望您能成為我們開放原始碼社群的持續參與者，但我們也歡迎您針對您特別感興趣的問題提供一次性的貢獻。

在 GitHub 上編輯範例

由 @cvializ 撰寫