---
id: "roman_numeral"
kind: "datatype"
status: "draft"
is_pii: false
categories: ["values"]
langs: ["common"]
quality: 100
url: "http://registry.apicrafter.io/datatype/roman_numeral"
---

# Roman numeral (`roman_numeral`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Number from 1 to 3999 written in Roman numerals, with the letters I, V, X, L, C, D and M in the standard subtractive form, where IV is 4 and CM is 900. Roman numerals number volumes, chapters, monarchs and recurring events, and some copyright notices and inscriptions give years in them. The regexp accepts uppercase standard forms only, not additive variants such as IIII or numbers above 3999.

- Personal data (PII): no
- Categories: All measurable values (percentage, amount and e.t.c) (values)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^(?=[MDCLXVI])M{0,3}(?:CM|CD|D?C{0,3})(?:XC|XL|L?X{0,3})(?:IX|IV|V?I{0,3})$
```

## Examples

- `XIV` — 14
- `MCMXCIX` — 1999
- `MMXXVI` — 2026
- `IV` — 4
- `XIIII` (invalid example) — Additive form of 14
- `IC` (invalid example) — Not a standard form of 99 (XCIX)

## Mappings

- autotype: `roman`

## Supported by tools

- `autotype`
- `greatexpectations`

## Translations

- ru: Римское число: Число от 1 до 3999, записанное римскими цифрами I, V, X, L, C, D и M.

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Roman_numerals>
- other: <https://github.com/congy/AutoType/blob/master/data_release/roman.txt>

## Quality

Score 100/100.

JSON: <http://registry.apicrafter.io/api/v1/datatypes/roman_numeral.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/values/roman_numeral.yaml>