Conversió de valors de dates
Les funcions següents converteixen els valors de dates en xifres calculables i viceversa.
Funció DateValue
Torna un valor de data d'una cadena de data. La cadena de data és una data completa en un únic valor numèric. També podeu utilitzar aquest número de sèrie per determinar la diferència entre dues dates.
Funció Day
Torna un valor que representa el dia del mes basat en un número de data de sèrie generat per DateSerial o per DateValue.
Funció Month
Torna el mes d'un any des d'una data de sèrie que es genera amb les funcions DateSerial o DateValue.
Funció WeekDay
Torna el número corresponent al dia de la setmana representat per un número de data de sèrie que es genera amb les funcions DateSerial o DateValue.
Funció Year
Torna l'any des d'un número de data de sèrie que es genera amb les funcions DateSerial o DateValue.
Funció CDateToIso
Retorna la data en format ISO sense separadors (YYYYMMDD) des d'un número de data de sèrie que es genera amb les funcions DateSerial, DateValue o CDateFromIso.
La part de l'any té com a mínim quatre dígits, amb zeros inicials si el valor absolut és inferior a 1000; pot ser negatiu amb un signe de menys inicial si la data vençuda correspon a un any anterior a l'era actual (aC) i pot tenir més de quatre dígits si el valor absolut és superior a 9999. La cadena formatada retornada pot oscil·lar entre "-327680101" i "327671231".
Es permet l'ús d'anys inferiors a 100 i superiors a 9999 des del LibreOffice 5.4
Funció CDateFromIso
Retorna el número de data interna d'una cadena que conté una data en format ISO (YYYYMMDD o YYYY-MM-DD).
La part de l'any ha de tenir o bé dos (només se'n permet l'ús en el format YYMMDD sense separadors per motius de compatibilitat) o bé com a mínim quatre dígits. Amb quatre dígits, els zeros inicials s'han de posar si el valor absolut és inferior a 1000; pot ser negatiu amb un signe de menys inicial si la data vençuda correspon a un any anterior a l'era actual (aC) i pot tenir més de quatre dígits si el valor absolut és superior a 9999. La cadena formatada pot oscil·lar entre "-327680101" i "327671231", o "-32768-01-01" i "32767-12-31".
Una data no vàlida produeix un error. L'any 0 no s'accepta, l'últim dia aC és el -0001-12-31 i el següent dia de l'era actual és el 0001-01-01. Les dates d'abans del 1582-10-15 són al calendari gregorià prolèptic.
Quan es converteix un número de sèrie d'una data en una cadena imprimible, per exemple per a l'ordre Impressió o MsgBox, es fa servir el calendari per defecte de la configuració local i a la data de transició del 1582-10-15 por canviar al calendari julià, la qual cosa pot fer que es mostri una data diferent de l'esperada. Feu servir la Funció CDateToIso per convertir el número d'aquesta data en una representació de cadena del calendari gregorià prolèptic.
Es permet l'ús del format YYYY-MM-DD amb separadors des del LibreOffice 5.3.4. Els anys inferiors a 100 o superiors a 9999 s'acepten des del LibreOffice 5.4 si no està en mode de compatibilitat VBA.
CDateFromUnoDate Function
Converteix una estructura com.sun.star.util.Data de l'UNO a un valor de data.
CDateToUnoDateTime Function
Retorna la part horària de la data com a una estructura com.sun.star.util.DateTime de l'UNO
CDateFromUnoDateTime Function
Converteix una estructura com.sun.star.util.DateTime de l'UNO a un valor de data.
Funció DateAdd
Afegeix un interval de data en una data determinada un nombre de cops i torna la data resultant.