Inhalte

# Umwandeln von Datumswerten

Die folgenden Funktionen konvertieren Datumswerte in Zahlen, mit denen Sie Berechnungen anstellen können, und die Ergebnisse wieder zurück in Datumswerte.

## Funktion DateSerial

Gibt einen Datumswert für eine Datumsangabe aus Jahr, Monat und Tag zurück.

## Funktion DateValue

Gibt ein Objekt Date von einer Zeichenfolge zurück, die ein Datum darstellt.

Das zurückgegebene Objekt wird intern als einzelner numerischer Wert dargestellt, der dem angegebenen Datum entspricht. Dieser Wert kann verwendet werden, um die Anzahl der Tage zwischen zwei Daten zu berechnen.

## Funktion Day

Gibt die Tageskomponente einer mit DateSerial oder DateValue erzeugten seriellen Datumsangabe zurück.

## Funktion Month

Gibt aus einem seriellen Datum, das durch die Funktionen DateSerial oder DateValue erzeugt wurde, die Monatskomponente zurück.

## Funktion WeekDay

Diese Funktion gibt die Zahl zurück, die dem Wochentag entspricht, der durch eine fortlaufende Datumszahl dargestellt wird, die von der Funktion DateSerial oder der Funktion DateValue erzeugt wird.

## Funktion Year

Gibt aus einem seriellen Datum, das durch die Funktionen DateSerial oder DateValue erzeugt wurde, die Jahreskomponente zurück.

## Funktion CDate

Konvertiert Zeichenfolgen- oder numerische Ausdrücke in Datumswerte.

## Funktion CDateToIso

Gibt aus einem seriellen Datum, das durch die Funktionen DateSerial, DateValue oder CDateFromIso erzeugt wurde, das Datum im ISO-Format ohne Separatoren in der Form YYYYMMDD zurück.

Die Jahreszahl besteht mindestens aus vier Ziffern mit führenden Nullen, falls der Betrag kleiner als 1000 ist, sie kann mit einem vorangestellten Minuszeichen negativ sein, falls das übergebene Datum in einem Jahr vor unserer Zeitrechnung (BC) liegt, und kann mehr als vier Ziffern haben, falls der Betrag größer als 9999 ist. Die zurückgegebene formatierte Zeichenfolge kann im Bereich von "-327680101" bis "327680101" liegen.

Jahreszahlen kleiner als 100 und größer als 9999 werden seit LibreOffice 5.4 unterstützt.

## Funktion CDateFromIso

Gibt aus einer Zeichenfolge mit einem Datum im ISO-Format eine Datumszahl im internen seriellen Format zurück (YYYYMMDD oder YYYY-MM-DD).

Die Jahreszahl muss entweder 2 (was aus Gründen der Kompatibilität nur in dem Format YYMMDD ohne die jeweiligen Separatoren möglich ist) oder eben dann mindestens 4 Ziffern enthalten. Bei Jahreszahlen kleiner als 4 Ziffern, beispielsweise dem 09. Mai 658, muss die Null vorangestellt werden, also beispielsweise 09.05.0658. Bei Zeitangaben vor unserer Zeitrechnung (auch bekannt als B.C. - Before Christ) kann die Jahreszahl ebenfalls mehr als vier Ziffern beinhalten, falls deren Betrag größer als 9999 ist. Die formatierte Zeichenfolge kann derzeit im Bereich "--327680101" bis "327671231" oder "01.01.-32768" bis "31.12.32767" liegen.

Ein ungültiges Datum führt zu einem Fehler. Das Jahr 0 gibt es nicht, der letzte Tag vor unserer Zeitrechnung ist der 31.12.-0001 und der nächste Tag unserer Zeitrechnung der 01.01.0001. Daten vor dem 15.10.1582 liegen im Gregorianischen Kalender.

Wenn eine serielle Datumsangabe in eine druckbare Zeichenfolge konvertiert wird, beispielsweise für die Befehle Print oder MsgBox, wird der Standardkalender des Gebietsschemas verwendet und das zusammengesetzte Datum 15.10.1582 kann in den Julianischen Kalender wechseln, wodurch ein anderes Datum als erwartet angezeigt wird. Verwenden Sie die Funktion CDateToIso, um solch eine Datumsangabe in eine Zeichenfolge zu konvertieren, die dem Gregorianischen Kalender entspricht.

Das Format JJJJ-MM-TT mit Separatoren wird seit LibreOffice 5.3.4 unterstützt. Jahreszahlen kleiner als 100 oder größer als 9999 werden seit LibreOffice 5.4 akzeptiert, sofern nicht im VBA-Kompatibilitätsmodus.

## Funktion CDateToUnoDate

Gibt das Datum als eine UNO com.sun.star.util.Date Struktur zurück.

## Funktion CDateFromUnoDate

Wandelt eine UNO com.sun.star.util.date Struktur in ein Datumswert um.

## Funktion CDateToUnoDateTime

Liefert den Zeit-Anteil des Datums als eine Uno com.sun.star.util.DateTime Struktur zurück.

## Funktion CDateFromUnoDateTime

Wandelt eine UNO com.sun.star.util.DateTime Struktur in ein Datumswert um.

## Funktion DateAdd

Fügt einem bestimmten Datum mehrmals ein Datums- oder Uhrzeitintervall hinzu und gibt das resultierende Datum zurück.

## Funktion DateDiff

Gibt die Anzahl der Datums- oder Zeitintervalle zwischen zwei angegebenen Datumswerten zurück.

## Funktion DatePart

Die Funktion "DatePart" liefert einen bestimmten Teil eines Datums.