<when>

<when> indique un point dans le temps, soit relatif à d'autres éléments de l'élément timeline dans lequel il est contenu, soit dans l'absolu. [16.5.2 Placing Synchronous Events in Time]
Modulelinking — 16 Linking, Segmentation, and Alignment
Attributsatt.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))
absolutecontient une valeur temporelle absolue.
Statut Optionel
Type de données 

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

Cet attribut est obligatoire pour l'élément when qui est désigné comme cible par l'attribut origin de l'élément <timeline>.

unitspécifie l'unité de temps dans laquelle la valeur de l'attribut interval est exprimée, si elle n'est pas héritée de l'élément parent <timeLine>.
Statut Optionel
Type de données 

<rng:ref name="data.enumerated"/>
data.enumerated
Les valeurs suggérées comprennent:
d
(jours)
h
(heures)
min
(minutes)
s
(secondes)
ms
(millisecondes)
intervalspécifie la partie numérique d'un intervalle de temps.
Statut Optionel
Type de données 

<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"
Valeurs contient un nombre positif, ou la valeur unknown.
Note

La valeur unknown indique une incertitude sur l'intervalle.

sinceidentifie le point de référence pour déterminer la date ou l'heure de l'élément courant when : cette date ou cette heure s'obtiennent en ajoutant la valeur de l'intervalle à la date du point de référence.
Statut Optionel
Type de données 

<rng:ref name="data.pointer"/>
data.pointer
Valeurs Doit pointer vers un autre élément when dans la même frise chronologique timeline.
Note

Si cet attribut est omis, et qu'il n'y a pas d'attribut absolute, le point de référence retenu est alors l'attribut originde l'élément englobant timeline.

Membre du
Contenu dans
linking: timeline
Peut contenirElément vide
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: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,
   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 { xsd:float { minExclusive = "0" } | "unknown" }?,
   attribute since { data.pointer }?,
   empty
}
Exemple
<when xml:id="TW3" interval="20" since="#w2"/>
Exemple
<when xml:id="fr_TW3" interval="20" since="#fr_w2"/>
Note

L'élément when doit avoir un attribut global xml:id pour identifier ce point dans le temps. La valeur utilisée peut être choisie librement, pourvu qu'elle soit unique dans le document et que le nom soit syntaxiquement valide. Les valeurs contenant des nombres ne doivent pas nécessairement former une séquence.