TEI element when

<when>

<when> 指出一個時間點，相對或絕對於同一時間進程標籤裡的其他元素。 [16.4.2 Placing Synchronous Events in Time]

組件

linking — Linking, Segmentation, and Alignment

屬性

att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source))

absolute absolute¶

提供一個絕對時間值。

狀態	非必備的
資料類型	teidata.temporal.w3c

unit unit¶

若未由父元素<timeLine>得到時間單位資訊，則在此指明屬性interval所使用的時間單位。

狀態	非必備的
資料類型	teidata.enumerated
被推薦的值包含:	d (days) h (hours) min (minutes) s (seconds) ms (milliseconds)

interval interval¶

指明時間區段中的數值部份

狀態	非必備的
資料類型	teidata.interval

since since¶

指出一個參照點，用以確定現有元素when的時間，可於參照點的時間內加入區段而取得。

狀態	非必備的
資料類型	teidata.pointer

可包含在於

linking: timeline

可包含

空白元素

註

On this element, the global xml:id attribute must be supplied to specify an identifier for this point in time. The value used may be chosen freely provided that it is unique within the document and is a syntactically valid name. There is no requirement for values containing numbers to be in sequence.

例子

例子

Content model

<content>
</content>

宣告

<rng:element name="when">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.global.source.attributes"/>
 <rng:optional>
  <rng:attribute name="absolute">
   <rng:ref name="teidata.temporal.w3c"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="unit">
   <rng:choice>
    <rng:value>d</rng:value>
    <rng:value>h</rng:value>
    <rng:value>min</rng:value>
    <rng:value>s</rng:value>
    <rng:value>ms</rng:value>
    <rng:ref name="teidata.enumerated"/>
   </rng:choice>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="interval">
   <rng:ref name="teidata.interval"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="since">
   <rng:ref name="teidata.pointer"/>
  </rng:attribute>
 </rng:optional>
 <rng:empty/>
</rng:element>

element when
{
   att.global.attributes,
   att.global.rendition.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.global.responsibility.attributes,
   att.global.source.attributes,
   attribute absolute { teidata.temporal.w3c }?,
   attribute unit { "d" | "h" | "min" | "s" | "ms" | teidata.enumerated }?,
   attribute interval { teidata.interval }?,
   attribute since { teidata.pointer }?,
   empty
}

P5: TEI指引

<when>