Begreb Data og historik · Datafordeler

# Virkningstid og registreringstid

Virkningstid er den periode, hvor en oplysning var sand i virkeligheden. Registreringstid er den periode, hvor registret havde oplysningen noteret. Sammen er de de to akser i en bitemporal historik.

Også kaldt: Virkningstid, Registreringstid, Valid time, Transaction time

## Et eksempel

En bolig bliver udvidet med 20 m² i marts. Ejeren indberetter det i september, og registret opdateres. Arealændringen har **virkning** fra marts — det er, da bygningen blev større. Den er **registreret** fra september — det er, da registret fik den at vide. Spørger man registret i juni om arealet, får man det gamle tal, fordi registret endnu ikke vidste det. Spørger man i dag om arealet i juni, kan man få det nye, fordi ændringen gælder fra marts.

Hver version har derfor fire tidsstempler: start og slut for virkningen og start og slut for registreringen. Den aktuelle version har en åben slutning på begge akser.

## Faldgruber

- De to tider er ofte ens, men ikke altid. Antag ikke, at en registrering er sket den dag, ændringen fandt sted.
- En version med `registrering_til` udfyldt er erstattet i registret — ikke nødvendigvis fordi virkeligheden ændrede sig, men måske fordi en fejl blev rettet.
- Sorter efter den akse, dit spørgsmål handler om: virkning for "hvad var sandt", registrering for "hvad stod der".

Begrebsparret stammer fra databaseteorien, hvor man taler om valid time og transaction time, og det bruges på samme måde i de danske grunddataregistre. Når du læser en registreringshistorik, er det derfor en god vane altid at angive, hvilken af de to tider et tal eller en dato refererer til.

## Felterne i API’et

Alle historik-svar bærer de fire felter på hver version: `registrering_fra`, `registrering_til`, `virkning_fra` og `virkning_til`. `*_til` er `null` på den gældende version. Versionerne kommer nyeste først fra [`/v1/bbr/ejendom/:bfe/historik`](https://grundfast.dk/docs/api/bbr-historik), [`/v1/matrikel/ejendom/:bfe/historik`](https://grundfast.dk/docs/api/matrikel-historik) og [`/v1/adresse/:uuid/historik`](https://grundfast.dk/docs/api/adresse-historik), og hver BBR-version har de værdier, der var registreret dengang: anvendelse, opførelsesår, areal, materialer og varme.

Et opslag med `?asOf=` skærer begge akser på samme tidspunkt: registreringstid og virkningstid sættes til det øjeblik, du angiver. Begge dele kræver Scale. Se [bitemporalitet](https://grundfast.dk/begreber/bitemporalitet) og [Historik og asOf](https://grundfast.dk/docs/historik).

## I API’et

- [Historik og asOf](https://grundfast.dk/docs/historik)
- [BBR-versioner med tidsstempler](https://grundfast.dk/docs/api/bbr-historik)
- [Adressens versioner](https://grundfast.dk/docs/api/adresse-historik)

## Slå det op på en rigtig ejendom

Med en gratis nøgle får du begrebet som felt i svaret — oversat, med WGS84-geometri og på tværs af registrene med samme BFE-nummer.

[Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) [Alle begreber](https://grundfast.dk/begreber)

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0

Relaterede begreber

- [Bitemporalitet Bitemporalitet betyder, at hver version af en oplysning har to tidsakser: hvornår den gjaldt i virkeligheden, og hvornår registret noterede den. BBR, Matriklen og adresseregistret er bitemporale.](https://grundfast.dk/begreber/bitemporalitet)
- [BBR BBR, Bygnings- og Boligregistret, er det landsdækkende register over Danmarks bygninger og deres enheder: anvendelse, opførelsesår, arealer, materialer, etager og varmeforhold.](https://grundfast.dk/begreber/bbr)
- [DAR DAR, Danmarks Adresseregister, er det officielle register over alle danske adresser: vejnavne, husnumre, enhedsadresser, postnumre og adressepunkter. Det er kilden, som andre registre og systemer henter deres adresser fra.](https://grundfast.dk/begreber/dar)