---
id: "decimal_year"
kind: "datatype"
status: "draft"
is_pii: false
name: "Decimal year (year with a fraction)"
regexp: "^[12]\\d{3}\\.\\d{1,6}$"
categories: ["datetime", "science"]
langs: ["common"]
quality: 85
url: "https://registry.apicrafter.io/datatype/decimal_year"
---

# Decimal year (year with a fraction) (`decimal_year`)

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

A point in time written as a number: the year and, as a decimal fraction, the part of the year that has passed (1994.83 is late October 1994). Long time series of climate, ocean, geodesy and ecological monitoring use it because it plots and regresses as a plain number; R lubridate writes it with decimal_date(). A whole year without a fraction is year.

- Parent datatype: [`datetime`](https://registry.apicrafter.io/datatype/datetime.md)
- Personal data (PII): no
- Categories: Date and time (datetime), Scientific (science)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^[12]\d{3}\.\d{1,6}$
```

## Examples

- `1994.83` — AIMS Scott Reef coral monitoring (Deci_Year)
- `2019.0417` — mid-January 2019
- `1994` (invalid example) — a whole year: year
- `19.94` (invalid example) — not a year

## Metacrafter rules

1 rules: 1 match the field name, 0 match values.

- `decimalyearbyfield` (field, `common/dateandtime.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Sources

- doc: <https://lubridate.tidyverse.org/reference/decimal_date.html>

## Quality

Score 85/100. Missing: mapping (Wikidata, Schema.org, ...), translation.

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