Konvertering af datoværdier
Følgende funktioner konverterer datoværdier til beregnbare tal og tilbage.
DateValue-funktion
Returnerer en datoværdi fra en datostreng. Datostrengen er en komplet dato i en enkelt numerisk værdi. Du kan også bruge dette løbende tal til at fastslå forskellen mellem to datoer.
Day-funktion
Returnerer en værdi, som repræsenterer dagen i måneden baseret på et serielt datotal genereret med DateSerial eller DateValue.
Month-funktion
Returnerer måneden på et år fra en seriel dato, der er genereret med DateSerial eller DateValue-funktionen.
WeekDay-funktion
Returnerer tallet svarende til ugedagen repræsenteret ved et serielt datotal, som genereres af DateSerial- eller DateValue-funktionen.
Year-funktion
Returnerer året fra et serielt datotal, som genereres af DateSerial- eller DateValue-funktionen.
CDateTolso-funktion
Returnerer datoen i ISO-format uden separatorer (DDMMÅÅÅÅ) fra et serielt datotal, som genereres af DateSerial- eller DateValue- eller CDataFromIso-funktionen.
Årsdelen består af mindst fire cifre, med foranstillede nuller hvis absolutværdien er mindre end 1000. Kan den være negativ med et foranstillet minustegn, hvis datoen er før vores tidsalder (f.Kr), og det kan have flere end fire cifre, hvis absolutværdien er større end 9999. Den formaterede streng, der returneres, kan ligge i området "-327680101" til "327671231".
År tidligere end 100 og senere end 9999 understøttes fra og med LibreOffice 5.4
CDateFromIso-fuktion
Returnerer det interne datotal fra en streng, der indeholder en dato i ISO-format (ÅÅÅÅMMDD eller ÅÅÅÅ-MM-DD).
Årsdelen skal bestå af enten to (kun understøttet i YYMMDD-formatet uden separatorer) eller mindst fire cifre. Med fire cifre skal der foranstilles nuller, hvis absolutværdien er mindre end 1000. Kan være negativ med et foranstående minustegn, hvis datoen er før den vor tidsalder (f.Kr.), og den kan have mere end fire cifre, hvis den absolutte værdi er større end 9999. Den formaterede streng kan ligge i området "-327680101" til "327671231" eller "-32768-01-01" til "32767-12-31".
En ugyldig dato resulterer i en fejl. År 0 accepteres ikke, den sidste dag f.Kr er -0001-12-31 og den næste dag er e.Kr 0001-01-01. Datoer før 1582-10-15 er i den proleptiske gregorianske kalender.
Når en seriel datoangivelse konverteres til en printbar streng, fx med kommandoerne Print eller MsgBox, bruges områdets standardkalender og overgangsdatoen 15-10-1582 kan skifte til den julianske kalender og give en anden dato en forventet. Brug CDateTolso-funktionen for at konvertere en sådan datoangivelse til en streng, der passer med den gregorianske kalender.
Formatet ÅÅÅÅ-MM-DD med adskillere er understøttet fra og med LibreOffice 5.3.4. Årstal tidligere end 100 eller senere end 9999 accepteres fra og med LibreOffice 5.4 hvis VBA-kompatibilitet ikke er aktiveret.
CDateToUnoDateTime-funktion
Returnerer tidsdelen af en dato som en UNO com.sun.star.util.DateTime struktur.
CDateFromUnoDateTime-funktion
Konverterer en UNO com.sun.star.util.DateTime-struktur til en datoværdi.
DateAdd-funktion
Lægger et datointerval til en given dato et antal gange og returnerer den resulterende dato.