<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
Module linking — 16 Linking, Segmentation, and Alignment
En complément des attributs globaux
absolute contient une valeur temporelle absolue.
Statut Recommendé quand applicable
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>.
unit spé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 Recommendé quand applicable
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)
interval spécifie la partie numérique d'un intervalle de temps.
Statut Recommendé quand applicable
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.
since identifie 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 Recommendé quand applicable
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.
Utilisé par
timeline
Peut contenir Elément vide
Declaration 

<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
}
Exemple
<when xml:id="TW3" interval="20" since="#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.