HTML 5 快速導覽 - 文字階層元素 <time>

<time> 為 HTML 文件的文字階層元素 (element) ,用來標記時間格式的內容。



<time> 除了全域屬性外,另有定義兩個屬性 (attribute)
  • datetime
  • pubdate


datetime 就是機器識別的時間值, pubdate 設定是否與親代元素有相同的發佈時間。


<time> 內容必須是有效的時間格式字串,不然就得在 datetime 中設定。有效的時間格式字串如下
<!-- 月份 -->
<time>2011-12</time>

<!-- 日期 -->
<time>2011-12-30</time>

<!-- 缺少年份的日期 -->
<time>12-30</time>

<!-- 時間 -->
<time>14:54</time>
<time>14:54:39</time>
<time>14:54:39.92922</time>

<!-- 當地日期與時間 -->
<time>2011-12-30T14:54</time>
<time>2011-12-30T14:54:39</time>
<time>2011-12-30T14:54:39.92922</time>
<time>2011-12-30 14:54</time>
<time>2011-12-30 14:54:39</time>
<time>2011-12-30 14:54:39.92922</time>

<!-- 時差 -->
<time>Z</time>
<time>+0000</time>
<time>+00:00</time>
<time>-0800</time>
<time>-08:00</time>

<!-- 全球日期與時間 -->
<time>2011-12-30T14:54Z</time>
<time>2011-12-30T14:54:39Z</time>
<time>2011-12-30T14:54:39.92922Z</time>
<time>2011-12-30T14:54+0000</time>
<time>2011-12-30T14:54:39+0000</time>
<time>2011-12-30T14:54:39.92922+0000</time>
<time>2011-12-30T14:54+00:00</time>
<time>2011-12-30T14:54:39+00:00</time>
<time>2011-12-30T14:54:39.92922+00:00</time>
<time>2011-12-30T06:54-0800</time>
<time>2011-12-30T06:54:39-0800</time>
<time>2011-12-30T06:54:39.92922-0800</time>
<time>2011-12-30T06:54-08:00</time>
<time>2011-12-30T06:54:39-08:00</time>
<time>2011-12-30T06:54:39.92922-08:00</time>
<time>2011-12-30 14:54Z</time>
<time>2011-12-30 14:54:39Z</time>
<time>2011-12-30 14:54:39.92922Z</time>
<time>2011-12-30 14:54+0000</time>
<time>2011-12-30 14:54:39+0000</time>
<time>2011-12-30 14:54:39.92922+0000</time>
<time>2011-12-30 14:54+00:00</time>
<time>2011-12-30 14:54:39+00:00</time>
<time>2011-12-30 14:54:39.92922+00:00</time>
<time>2011-12-30 06:54-0800</time>
<time>2011-12-30 06:54:39-0800</time>
<time>2011-12-30 06:54:39.92922-0800</time>
<time>2011-12-30 06:54-08:00</time>
<time>2011-12-30 06:54:39-08:00</time>
<time>2011-12-30 06:54:39.92922-08:00</time>

<!-- 週數 -->
<time>2011-W52</time>

<!-- 年 -->
<time>2011</time>

<!-- 期間 -->
<time>PT4H18M3S</time>
<time>4h 18m 3s</time>


此外, <time> 的文件物件模型 (DOM) 介面為 HTMLTimeElement ,另有定義幾個屬性
  • datetime
  • pubdate
  • valueAsDate


舉例如下
<!DOCTYPE html>  
<html>  
  <head>  
     <title>HTML 5 DEMO</title> 
     <style>
       header, nav, section, article, footer {
         display: block;
       }
       header, nav, section, article, footer {
         color: white;
       }
       header, footer {
         text-align: center;
         width: 100%;
       }
       header {
         background-color: red;
         font-size: 36px;
         font-weight: bold;
       }
       nav {
         position: fixed;
         top: 40px;
         right: 25px;
         background-color: blue;
         width: 100px;
       }
       section {
         width: 86%;
         background-color: gray;
         padding: 20px;
         margin: 20px;
       }
       footer {
         background-color: green;
         font-size: 10px;
       }
     </style> 
  </head>  
  <body>  
    <header>  
       header  
    </header>  
    <nav>  
      <ul>
        <li>nav 1</li>
        <li>nav 2</li>
      </ul>  
    </nav>
    <section>
      <article>
        <time>2011-12-30 14:54</time>
      </article>
    </section>      
    <footer>  
      <p>
        footer © 2011 
      </p>       
    </footer>  
  </body>  
</html>  

<!-- 《程式語言教學誌》的範例程式
     http://pydoing.blogspot.com/
     檔名:timetest.html
     功能:示範 HTML 5 標記語言 
     作者:張凱慶
     時間:西元 2011 年 12 月 -->


此例, <time> 放在 <article> 中
<section>
  <article>
    <time>2011-12-30 14:54</time>
  </article>
</section>


利用 Firefox 開啟如下



中英文術語對照
元素element
屬性attribute
文件物件模型DOM


您可以繼續參考
JavaScript 範例

文字階層元素


相關目錄
HTML 5 快速導覽
HTML, CSS 教材
首頁


參考資料
http://www.whatwg.org/specs/web-apps/current-work/multipage/text-level-semantics.html#the-time-element
http://www.w3.org/TR/2011/WD-html5-20110525/text-level-semantics.html#the-time-element

沒有留言: