tei: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]

Element Information

Model

Attributes

QName Type Fixed Default Use Inheritable Annotation
absolute union of(xs:date, xs:gYear, xs:gMonth, xs:gDay, xs:gYearMonth, xs:gMonthDay, xs:time, xs:dateTime) optional 
supplies an absolute value for the time.
ana restriction of list of xs:anyURI optional 
(analysis) indicates one or more elements containing interpretations of
the element on which the ana attribute appears.
cert union of(xs:double, restriction of xs:token) optional 
(certainty) signifies the degree of certainty associated with the
intervention or interpretation.
change restriction of list of xs:anyURI optional 
points to one or more change elements documenting a state or revision
campaign to which the element bearing this attribute and its children have been assigned
by the encoder.
copyOf xs:anyURI optional 
points to an element of which the current element is a
copy.
corresp restriction of list of xs:anyURI optional 
(corresponds) points to elements that correspond to the current element in
some way.
exclude restriction of list of xs:anyURI optional 
points to elements that are in exclusive alternation with the current
element.
facs restriction of list of xs:anyURI optional 
(facsimile) points to all or part of an image which corresponds with the
content of the element.
interval union of(xs:float, restriction of xs:token) optional 
specifies a time interval either as a number or as one of the keywords
defined by the datatype data.interval
n xs:string optional 
(number) gives a number (or other label) for an element, which is not
necessarily unique within the document.
next xs:anyURI optional 
points to the next element of a virtual aggregate of which the current
element is part.
prev xs:anyURI optional 
(previous) points to the previous element of a virtual aggregate of which
the current element is part.
rend restriction of list of restriction of xs:token optional 
(rendition) indicates how the element in question was rendered or
presented in the source text.
rendition restriction of list of xs:anyURI optional 
points to a description of the rendering or presentation used for this
element in the source text.
resp restriction of list of xs:anyURI optional 
(responsible party) indicates the agency responsible for the intervention
or interpretation, for example an editor or transcriber.
sameAs xs:anyURI optional 
points to an element that is the same as the current
element.
select restriction of list of xs:anyURI optional 
selects one or more alternants; if one alternant is selected, the
ambiguity or uncertainty is marked as resolved. If more than one alternant is selected,
the degree of ambiguity or uncertainty is marked as reduced by the number of alternants
not selected.
since xs:anyURI optional 
identifies 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.
style xs:string optional 
contains an expression in some formal style definition language which
defines the rendering or presentation used for this element in the source
text
synch restriction of list of xs:anyURI optional 
(synchronous) points to elements that are synchronous with the current
element.
unit union of(restriction of xs:token, restriction of xs:token, restriction of xs:token, restriction of xs:token, restriction of xs:token, restriction of xs:token) optional 
specifies 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)
xml:base xs:anyURI optional 
provides a base URI reference with which applications can resolve relative URI references into absolute URI references.
xml:id xs:ID optional 
(identifier) provides a unique identifier for the element bearing the attribute.
xml:lang union of(xs:language, restriction of xs:token) optional 
(language) indicates the language of the element content using a tag generated according to BCP 47.
xml:space restriction of xs:token optional 
signals an intention about how white space should be managed by applications.

Used By

Element tei:timeline

Source 

<xs:element name="when">
  <xs:annotation>
    <xs:documentation>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]</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:attributeGroup ref="tei:att.global.attributes"/>
    <xs:attribute name="absolute">
      <xs:annotation>
        <xs:documentation>supplies an absolute value for the time.</xs:documentation>
      </xs:annotation>
      <xs:simpleType>
        <xs:union memberTypes="xs:date xs:gYear xs:gMonth xs:gDay xs:gYearMonth xs:gMonthDay xs:time xs:dateTime"/>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="unit">
      <xs:annotation>
        <xs:documentation>specifies 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)</xs:documentation>
      </xs:annotation>
      <xs:simpleType>
        <xs:union>
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:enumeration value="d">
                <xs:annotation>
                  <xs:documentation>(days)</xs:documentation>
                </xs:annotation>
              </xs:enumeration>
            </xs:restriction>
          </xs:simpleType>
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:enumeration value="h">
                <xs:annotation>
                  <xs:documentation>(hours)</xs:documentation>
                </xs:annotation>
              </xs:enumeration>
            </xs:restriction>
          </xs:simpleType>
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:enumeration value="min">
                <xs:annotation>
                  <xs:documentation>(minutes)</xs:documentation>
                </xs:annotation>
              </xs:enumeration>
            </xs:restriction>
          </xs:simpleType>
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:enumeration value="s">
                <xs:annotation>
                  <xs:documentation>(seconds)</xs:documentation>
                </xs:annotation>
              </xs:enumeration>
            </xs:restriction>
          </xs:simpleType>
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:enumeration value="ms">
                <xs:annotation>
                  <xs:documentation>(milliseconds)</xs:documentation>
                </xs:annotation>
              </xs:enumeration>
            </xs:restriction>
          </xs:simpleType>
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:pattern value="(\p{L}|\p{N}|\p{P}|\p{S})+"/>
            </xs:restriction>
          </xs:simpleType>
        </xs:union>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="interval">
      <xs:annotation>
        <xs:documentation>specifies a time interval either as a number or as one of the keywords defined by the datatype data.interval</xs:documentation>
      </xs:annotation>
      <xs:simpleType>
        <xs:union memberTypes="xs:float">
          <xs:simpleType>
            <xs:restriction base="xs:token">
              <xs:enumeration value="regular"/>
              <xs:enumeration value="irregular"/>
              <xs:enumeration value="unknown"/>
            </xs:restriction>
          </xs:simpleType>
        </xs:union>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="since" type="xs:anyURI">
      <xs:annotation>
        <xs:documentation>identifies 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.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

Sample