amp-date-display

1.0 0.1

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

用法

amp-date-display 组件显示您可以在 AMP 页面中呈现的时间数据。通过在 amp-date-display 标签中提供特定的 属性，amp-date-display 扩展返回时间参数列表，您可以将其传递给 amp-mustache 模板 以进行呈现。请参阅 每个返回时间参数的以下列表。

<!-- Displays "Wednesday 2 August 2017, 15:05:05" -->
<amp-date-display
  datetime="2017-08-02T15:05:05.000"
  layout="fixed"
  width="360"
  height="20"
>
  <template type="amp-mustache">
    <div>
{{dayName}} {{day}} {{monthName}} {{year}}{{hourTwoDigit}}:{{minuteTwoDigit}}:{{secondTwoDigit}}    </div>
  </template>
</amp-date-display>

返回的时间参数

此表格列出了您可以在 Mustache 模板中指定的格式

属性

您必须指定以下必需属性之一：datetime、timestamp-ms 或 timestamp-seconds。

datetime

datetime 属性指定标准 ISO 8601 日期字符串（例如 2017-08-02T15:05:05.000Z）或字符串 now 中的日期和时间。如果设置为 now，amp-date-display 将使用页面加载时间来呈现其模板。

timestamp-ms

timestamp-ms 属性使用自 1970-01-01T0:00:00.000Z 起的毫秒数指定日期和时间

timestamp-seconds

timestamp-seconds 属性使用自 1970-01-01T0:00:00.000Z 起的秒数指定日期和时间

locale (可选)

每个计时单位的国际化语言字符串。默认值为 en（表示英语）。此属性支持用户浏览器支持的所有值。

display-in (可选)

如果设置为值 utc，display-in 属性将把给定日期转换为 UTC。

offset-seconds (可选)

offset-seconds 属性指定一个整数秒数，用于偏移给定日期。

data-options-* (可选)

data-options-* 支持 Intl.DateTimeFormat.options 参数下指定用于 localeString 格式的格式化样式的所有选项。有效属性包括：data-options-date-style、data-options-time-style 等。

请注意，如果 display-in 属性设置为 utc，data-options-time-zone 的值将自动转换为 UTC。

验证

请参阅 AMP 验证规范中的 amp-date-display 规则。