TEI: Guidelines for Electronic Text Encoding and Interchange

P5 Version 4.10.2. Last updated on 4th September 2025, revision bcfa98f42

<num>

<num> (number) contains a number, written in any form. [3.6.3 Numbers and Measures]

Module core — Elements Available in All TEI Documents

Attributes

att.global
- @xml:id
- @n
- @xml:lang
- @xml:base
- @xml:space
- att.global.analytic
  - @ana
- att.global.change
  - @change
- att.global.facs
  - @facs
- att.global.linking
  - @corresp
  - @synch
  - @sameAs
  - @copyOf
  - @next
  - @prev
  - @exclude
  - @select
- att.global.rendition
  - @rend
  - @style
  - @rendition
- att.global.responsibility
  - @cert
  - @resp
- att.global.source
  - @source
att.cmc
- @generatedBy
att.ranging
- @atLeast
- @atMost
- @min
- @max
- @confidence
att.typed
- type
- @subtype

type type⚓︎ indicates the type of numeric value.

Derived from att.typed

Status Optional

Datatype teidata.enumerated

Suggested values include:

cardinal: absolute number, e.g. 21, 21.5
ordinal: ordinal number, e.g. 21st
fraction: fraction, e.g. one half or three-quarters
percentage: a percentage

Note

If a different typology is desired, other values can be used for this attribute.

value value⚓︎ supplies the value of the number in standard form.

Status Optional

Datatype teidata.numeric

Values a numeric value.

Note

The standard form used is defined by the TEI datatype teidata.numeric.

Member of

model.measureLike

Contained by

analysis: cl phr s span

cmc: post

core: abbr add addrLine author bibl biblScope citedRange corr date del desc distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure measureGrp meeting mentioned name note num orig p pubPlace publisher q quote rb ref reg resp rs rt said sic soCalled speaker stage street term textLang time title unclear unit

corpus: activity channel constitution derivation domain factuality interaction locale preparedness purpose

dictionaries: case colloc def dictScrap entryFree etym form gen gram gramGrp hyph iType lang lbl mood number orth per pos pron re sense stress subc syll tns usg xr

drama: actor camera caption castItem role roleDesc sound tech view

figures: cell figDesc

header: authority catDesc change classCode creation distributor edition extent funder geoDecl handNote language licence principal rendition scriptNote sponsor tagUsage

iso-fs: fDescr fsDescr

linking: ab seg

msdescription: accMat acquisition additions catchwords collation collection colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit institution layout material musicNotation objectType origDate origPlace origin provenance repository rubric secFol signatures source stamp summary support surrogates typeNote watermark

namesdates: addName affiliation age birth bloc country death district education eventName faith floruit forename genName gender geogFeat geogName langKnown location nameLink nationality objectName occupation offset orgName persName persPronouns placeName region residence roleName settlement sex socecStatus surname

spoken: u writing

tagdocs: eg valDesc

textcrit: lem rdg wit witDetail witness

textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer

transcr: damage fw metamark mod restore retrace secl supplied surplus

verse: metSym rhyme

May contain

analysis: c cl interp interpGrp m pc phr s span spanGrp w

certainty: certainty precision respons

core: abbr add address binaryObject cb choice cit corr date del distinct ellipsis email emph expan foreign gap gb gloss graphic hi index lb measure measureGrp media mentioned milestone name note noteGrp num orig pb ptr q quote ref reg rs ruby said sic soCalled term time title unclear unit

dictionaries: lang oRef pRef

figures: figure formula notatedMusic

gaiji: g

header: idno

iso-fs: fLib fs fvLib

linking: alt altGrp anchor join joinGrp link linkGrp seg timeline

msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material objectType origDate origPlace secFol signatures stamp watermark width

namesdates: addName affiliation bloc climate country district eventName forename genName geo geogFeat geogName location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait

spoken: incident kinesic pause shift vocal writing

tagdocs: att code gi ident listRef specDesc specList tag val

textcrit: app witDetail

textstructure: floatingText

transcr: addSpan am damage damageSpan delSpan ex fw handShift listTranspose metamark mod redo restore retrace secl space subst substJoin supplied surplus undo

verse: caesura rhyme

character data

Note

Detailed analyses of quantities and units of measure in historical documents may also use the feature structure mechanism described in chapter 19 Feature Structures. The num element is intended for use in simple applications.

Example

<p>I reached <num type="cardinal" value="21">twenty-one</num> on
my <num type="ordinal" value="21">twenty-first</num> birthday</p>
<p>Light travels at <num value="3E10">×ばつ10<hi rend="sup">10</hi>
</num> cm per second.</p>

Show all ⚓︎

Content model

<content>
 <macroRef key="macro.phraseSeq"/>
</content>

Schema Declaration

<rng:element name="num">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.global.source.attributes"/>
 <rng:ref name="att.cmc.attributes"/>
 <rng:ref name="att.ranging.attributes"/>
 <rng:ref name="att.typed.attribute.subtype"/>
 <rng:optional>
 <rng:attribute name="type">
  <rng:choice>
  <rng:value>cardinal</rng:value>
  <rng:value>ordinal</rng:value>
  <rng:value>fraction</rng:value>
  <rng:value>percentage</rng:value>
  <rng:ref name="teidata.enumerated"/>
  </rng:choice>
 </rng:attribute>
 </rng:optional>
 <rng:optional>
 <rng:attribute name="value">
  <rng:ref name="teidata.numeric"/>
 </rng:attribute>
 </rng:optional>
 <rng:ref name="macro.phraseSeq"/>
</rng:element>

element num
{
 att.global.attributes,
 att.global.analytic.attributes,
 att.global.change.attributes,
 att.global.facs.attributes,
 att.global.linking.attributes,
 att.global.rendition.attributes,
 att.global.responsibility.attributes,
 att.global.source.attributes,
 att.cmc.attributes,
 att.ranging.attributes,
 att.typed.attribute.subtype,
 attribute type
 {
 "cardinal" | "ordinal" | "fraction" | "percentage" | teidata.enumerated
 }?,
 attribute value { teidata.numeric }?,
 macro.phraseSeq
}

[English] [Deutsch] [Español] [Italiano] [Français] [日本語] [한국어] [中文]

TEI Guidelines P5 Version 4.10.2. Last updated on 4th September 2025, revision bcfa98f42. This page generated on 2025年09月04日T16:27:03Z.