Package 'theRefdate'

Title: Simple and Fast Date Manipulation on Character Strings in Format 'DD.MM.YYYY'
Description: Provides simple and fast date manipulation functions operating on character strings in the format 'DD.MM.YYYY'. Functions include extraction of day, month, and year components, computation of differences between two dates, and addition or subtraction of months.
Authors: Prem Lueers [aut, cre] (ORCID: <https://orcid.org/0009-0003-3315-1438>)
Maintainer: Prem Lueers <[email protected]>
License: LGPL-3
Version: 1.0.0
Built: 2026-05-24 05:45:34 UTC
Source: https://github.com/cran/theRefdate

Help Index

addiereMonate

Description

Addiert oder subtrahiert eine Anzahl Monate zu einem Termin im Format "TT.MM.JJJJ". Verwendet rekursive Jahresschritte fuer Betraege groesser 12.

Usage

addiereMonate(termin = NA_character_, monateHinzu = NA_real_)

Arguments

termin

Ausgangstermin im Format "TT.MM.JJJJ"
monateHinzu

Anzahl Monate (positiv: addieren, negativ: subtrahieren)

Value

Termin im Format "TT.MM.JJJJ"

dateAddMonths

Description

Addiert oder subtrahiert eine Anzahl Monate zu einem Termin im Format "TT.MM.JJJJ".

Usage

dateAddMonths(termin = NA_character_, monthsToBeAdded = NA_real_)

Arguments

termin

Ausgangstermin im Format "TT.MM.JJJJ"
monthsToBeAdded

Anzahl Monate (positiv: addieren, negativ: subtrahieren)

Value

Termin im Format "TT.MM.JJJJ"

Examples

dateAddMonths("01.01.2000", -3 ) == "01.10.1999"

dateDiff

Description

Berechnet die Differenz zwischen zwei Terminen im Format "TT.MM.JJJJ". Liefert Jahres-, Monats- und Gesamtdifferenz als benannte Liste.

Usage

dateDiff(frueher = NA_character_, spaeter = NA_character_)

Arguments

frueher

Datum im Format "TT.MM.JJJJ" (frueherer Termin)
spaeter

Datum im Format "TT.MM.JJJJ" (spaeterer Termin)

Value

list mit diffJ (Jahre), diffM (Monate), diffDauer (Bruchjahre), diffDauerM (Gesamtmonate)

Examples

dateDiff("01.01.2000", "01.12.1999")$diffDauerM == -1

datumsDifferenz

Description

Berechnet die Differenz zwischen zwei Terminen im Format "TT.MM.JJJJ". Gibt eine Liste mit Jahres-, Monats- und Gesamtdifferenz zurueck.

Usage

datumsDifferenz(frueher = NA_character_, spaeter = NA_character_)

Arguments

frueher

Datum im Format "TT.MM.JJJJ"
spaeter

Datum im Format "TT.MM.JJJJ"

Value

list mit diffJ (Jahre), diffM (Monate), diffDauer (Bruchjahre), diffDauerM (Gesamtmonate)

flavour

Description

Gibt den Flavour (Auspraegung) des Packages theRefdate zurueck.

Usage

flavour()

Value

character string, either "LP" or "VK"

Examples

flavour() == "LP"

Funktion 'jahr'

Description

Extrahiert die Jahreszahl aus uebergebenem Datumsstring als 'numeric'

Usage

jahr(datumstring = NA_character_)

Arguments

datumstring

Datumsstring im Format "TT.MM.JJJJ"

Value

numeric

Examples

jahr("02.02.2002") == 2002

Funktion 'monat'

Description

Extrahiert die Monatszahl aus uebergebenem Datumsstring als 'numeric'

Usage

monat(datumstring = NA_character_)

Arguments

datumstring

Datumsstring im Format "TT.MM.JJJJ"

Value

numeric

Examples

monat("02.02.2000") == 2

Funktion 'tag'

Description

Extrahiert die Tageszahl aus uebergebenem Datumsstring als 'numeric'

Usage

tag(datumstring = NA_character_)

Arguments

datumstring

Datumsstring im Format "TT.MM.JJJJ"

Value

numeric

Examples

tag("03.02.2000") == 3