<when>

<when> indique un point dans le temps, soit relatif à d'autres éléments de la même balise chronologique, 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
Valeurs Times may be given in standard form, as specified in the Encoding Declarations section of the header.
Note
Obligatoire pour l'élément désigné comme valeur de l'attribut origin dans la balise <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 a positive number, or the special value unknown.
Note
La valeur unknown indique qu'une incertitude porte 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 qui s'obtient 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 Should point to another when element in the same timeline.
Note
Si cet attribut est omis, et qu'il n'y a pas d'attribut absolute précisé, le point de référence est alors considéré comme l'origine de la balise englobante 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
Pour cet élément, il faut fournir un attribut global xml:id pour ce moment. 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 être en séquence.