<when>

<when> indicates a point in time either relative to other elements in the same timeline tag, or absolutely. [16.5.2 Placing Synchronous Events in Time]
Modulelinking — Linking, Segmentation, and Alignment
Attributesatt.global (@xml:id, @n, @xml:lang, @rend, @style, @rendition, @xml:base, @xml:space) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change))
absolutesupplies an absolute value for the time.
Status Optional
Datatype 

<rng:ref name="data.temporal.w3c"/>
data.temporal.w3c
Note

This attribute should always be specified on a when element which serves as the target for the origin attribute of a <timeLine>.

unitspecifies the unit of time in which the interval value is expressed, if this is not inherited from the parent timeline. Suggested values include: 1] d(days) ; 2] h(hours) ; 3] min(minutes) ; 4] s(seconds) ; 5] ms(milliseconds)
Status Optional
Datatype 

<rng:ref name="data.enumerated"/>
data.enumerated
Suggested values include:
d
(days)
h
(hours)
min
(minutes)
s
(seconds)
ms
(milliseconds)
intervalspecifies a time interval either as a number or as one of the keywords defined by the datatype data.interval
Status Optional
Datatype 

<rng:ref name="data.interval"/>
data.interval
sinceidentifies the reference point for determining the time of the current when element, which is obtained by adding the interval to the time of the reference point.
Status Optional
Datatype 

<rng:ref name="data.pointer"/>
data.pointer
Note

This attribute should point to another when element in the same timeline. If no value is supplied, and the absolute attribute is also unspecified, then the reference point is understood to be the origin of the enclosing timeline tag.

Contained by
linking: timeline
May containEmpty element
Declaration

<rng:element name="when">
 <rng:ref name="att.global.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: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:ref name="data.interval"/>
  </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,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   attribute absolute { data.temporal.w3c }?,
   attribute unit { "d" | "h" | "min" | "s" | "ms" | xsd:Name }?,
   attribute interval { data.interval }?,
   attribute since { data.pointer }?,
   empty
}
Example
<when xml:id="TW3" interval="20" since="#w2"/>
Note

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.