Dátumértékek átalakítása
Az alábbi függvények a dátumértékek számmá alakítására, valamint visszaalakítására szolgálnak.
DateValue függvény
Visszaad egy dátumértéket egy dátum-karakterláncból. A dátum-karakterlánc egy teljes dátum egy numerikus értékben. Ezt a sorozatszámot a két dátum közötti különbség meghatározásához is használhatja.
Day függvény
A hónap napját ábrázoló értéket ad vissza a DateSerial vagy DateValue által létrehozott soros dátumszám alapján.
Month függvény
A DateSerial vagy a DateValue függvénnyel létrehozott soros dátumérték alapján meghatározott év egy hónapját adja vissza.
WeekDay függvény
Visszaadja a DateSerial vagy DateValue függvény által meghatározott soros dátumértéknek megfelelő hétköznap számát.
Year függvény
Visszaadja a DateSerial vagy DateValue függvény által meghatározott soros dátumértéknek megfelelő évet.
CDateToIso függvény
Visszaadja a dátumot ISO formátumban, elválasztók nélkül (YYYYMMDD) a dátum sorszámból, amelyet a DateSerial, a DateValue vagy a CDateFromIso függvény állított elő.
Az év rész legalább négy számjegyből áll, vezető nullákkal, ha az abszolút értéke kisebb mint 1000; negatív is lehet egy vezető mínusz jel megadásával, ha időszámítás előtti évet jelöl; és több mint négy számjegyből is állhat, ha az abszolút értéke nagyobb mint 9999. A visszaadott formázott karakterlánc a „-327680101” és „327671231” közé esik.
A 100-nál kisebb, és 9999-nél nagyobb évek a LibreOffice 5.4 óta támogatottak.
CDateFromIso függvény
Visszaadja a belső dátumszámot egy olyan karakterláncból, amely ISO formátumú (YYYYMMDD vagy YYYY-MM-DD) dátumot tartalmaz.
Az év résznek vagy kettő (a kompatibilitás érdekében csak YYMMDD formátumban támogatott, elválasztók nélkül), vagy legalább négy számjegyből kell állnia. Négy számjegy esetén kezdő nullákat kell használni, ha az érték kisebb mint 1000; mínuszjel használatával lehet negatív, ekkor időszámítás előtti évet jelöl; és lehet négy számnál hosszabb is, ha az abszolútértéke nagyobb mint 9999. A formázott karakterlánc „-327680101” és „327671231” között, illetve „-32768-01-01” és „-32767-12-31” között lehet.
Az érvénytelen dátum hibát okoz. A 0. év nem elfogadott, az időszámítás előtti utolsó nap -0001-12-32, a következő nap pedig 0001-01-01. Az 1582-10-15 előtti dátumok a proleptikus Gergely-naptár szerint értendőek.
When converting a date serial number to a printable string, for example for the Print or MsgBox command, the locale's default calendar is used and at that 1582-10-15 cutover date may switch to the Julian calendar, which can result in a different date being displayed than expected. Use the CDateToIso Function to convert such date number to a string representation in the proleptic Gregorian calendar.
Az YYYY-MM-DD formátum elválasztókkal LibreOffice 5.3.4 óta támogatott. A 100-nál korábbi vagy 9999-nél későbbi évek LibreOffice 5.4 óta elfogadottak, ha nincs bekapcsolva a VBA kompatibilitási mód.
CDateToUnoDateTime függvény
Visszaadja a dátum idő részét com.sun.star.util.DateTime UNO struktúraként.
CDateFromUnoDateTime függvény
Egy com.sun.star.util.DateTime UNO struktúrát Date (dátum) értékké alakít.
DateAdd függvény
A megadott dátumhoz hozzáad adott számszor egy dátumintervallumot, és visszaadja az eredményként kapott dátumot.