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 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 Zeichenkette kann im Bereich von "-327680101" bis "327680101" liegen.
Jahreszahlen kleiner als 100 und größer als 9999 werden seit Collabora Office 5.4 unterstützt.
Funktion CDateFromIso
Gibt aus einer Zeichenkette 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 Kombatibilitä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 voran gestellt 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 Zeichenkette 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 Zeichenkette 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 Zeichenkette zu konvertieren, die dem Gregorianischen Kalender entspricht.
Das Format JJJJ-MM-TT mit Separatoren wird seit Collabora Office 5.3.4 unterstützt. Jahreszahlen kleiner als 100 oder größer als 9999 werden seit Collabora Office 5.4 akzeptiert, sofern nicht im VBA-Kombatibilitätsmodus.