when

<when>

<when> 同じ要素<timeline>中にある他の要素に対応する時点，または絶対的な時点を示す． 16.5.2 Placing Synchronous Events in Time

モジュール

linking — 16 Linking, Segmentation, and Alignment

属性

absolute

当該時点の，絶対時間を示す．

状態	使えるならば必須
データ型	<rng:ref name="data.temporal.w3c"/> data.temporal.w3c
値	Times may be given in standard form, as specified in the Encoding Declarations section of the header.
解説	Required for the element designated as the value of the origin attribute in the timeline tag.

unit

親要素<timeLine>から継承されない場合，属性 intervalで示される時間の単位を示す．

状態	使えるならば必須
データ型	<rng:ref name="data.enumerated"/> data.enumerated
提案する値は以下の通り:	d (days) h (hours) min (minutes) s (seconds) ms (milliseconds)

interval

時間幅を数値で示す．

状態	使えるならば必須
データ型	<rng:choice> <rng:data type="float"> <rng:param name="minExclusive">0</rng:param> </rng:data> <rng:value>unknown</rng:value> </rng:choice> xsd:float { minExclusive = "0" } \| "unknown"
値	a positive number, or the special value unknown.
解説	The value unknown indicates uncertainty about the interval.

since

当該要素<when>の時間となる参照時点を示す．参照時点に時間幅を足すことで得られる．

状態	使えるならば必須
データ型	<rng:ref name="data.pointer"/> data.pointer
値	Should point to another <when> element in the same <timeline>.
解説	If this attribute is omitted, and the absolute attribute is not specified, then the reference point is understood to be the origin of the enclosing <timeline> tag.

当該モジュールを使用するもの

timeline

下位

空要素

宣言


<rng:element name="when">
<rng:ref name="att.global.attributes"/>
<rng:optional>
 <rng:attribute name="absolute">
  <rng:ref name="data.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:data type="Name"/>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="interval">
  <rng:choice>
   <rng:data type="float">
    <rng:param name="minExclusive">0</rng:param>
   </rng:data>
   <rng:value>unknown</rng:value>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="since">
  <rng:ref name="data.pointer"/>
 </rng:attribute>
</rng:optional>
<rng:empty/>
</rng:element>

element when
{
   att.global.attributes,
   attribute absolute { data.temporal.w3c }?,
   attribute unit { "d" | "h" | "min" | "s" | "ms" | xsd:Name }?,
   attribute interval { xsd:float { minExclusive = "0" } | "unknown" }?,
   attribute since { data.pointer }?,
   empty
}

例

解説

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.

P5: TEIガイドライン

<when>