when

<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

Attributs

absolute

contient une valeur temporelle absolue.

Statut	Requis 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	Required for the element designated as the value of the origin attribute in the timeline tag.

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	Requis 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	Requis 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	The value unknown indicates uncertainty about the interval.

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	Requis 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	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.

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

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.

P5: Principes directeurs pour l'encodage et l'échange de textes électroniques

<when>