Contenido

# Conversión de valores de fechas

Las funciones siguientes convierten valores de fecha para calcular números y viceversa.

## Función DateSerial

Returns a Date value for a specified year, month, and day.

## Función DateValue

Returns a Date object from a string representing a date.

The returned object is represented internally as a single numeric value corresponding to the specified date. This value can be used to calculate the number of days between two dates.

## Función Day

Devuelve un valor que representa el día del mes a partir de un número de fecha serie generado por DateSerial o DateValue.

## Función Month

Devuelve el mes de un año a partir de una fecha serie que genera la función DateSerial o DateValue.

## Función WeekDay

This function returns the number corresponding to the weekday represented by a serial date number that is generated by the DateSerial or the DateValue functions.

## Función Year

Devuelve el año a partir de una fecha serie que genera la función DateSerial o DateValue.

## Función CDate

Convierte cualquier cadena de caracteres o expresión numérica en un valor de fecha.

## Función CDateToIso

Devuelve la fecha en formato ISO sin separadores (AAAAMMDD) a partir de un número de serie de fecha generado por DateSerial, DateValue o la función CDateFromIso.

La parte del año consiste de cuatro dígitos por lo menos, con ceros a la izquierda si el valor absoluto es menor que 1000; puede ser negativo y mostrar un signo «−» antepuesto si la fecha pasada indica un año anterior a nuestra era y puede contener más de cuatro dígitos si el valor supera 9999. La cadena formateada devuelta puede ubicarse entre el intervalo comprendido entre −327680101 y 327671231.

A partir de LibreOffice 5.4 se admiten años menores que 100 y mayores que 9999.

## Función CDateFromIso

Devuelve el número de fecha interno a partir de una cadena que contiene una fecha en formato ISO (AAAAMMDD o AAAA-MM-DD).

La parte del año debe consistir, bien de dos dígitos (admitidos únicamente en el formato AAMMDD sin separadores, por compatibilidad), bien de cuatro dígitos por lo menos. Con cuatro dígitos, se deben proporcionar ceros a la izquierda en caso de que el valor sea menor que 1000; el valor puede ser negativo y mostrar un signo «−» antepuesto si la fecha pasada indica un año anterior a nuestra era y puede contener más de cuatro dígitos si el valor absoluto supera 9999. La cadena formateada puede ubicarse entre el intervalo comprendido entre −327680101 y 327671231, o bien, entre «−32768-01-01» y «32767-12-31».

Una fecha no válida producirá un error. No se acepta el año 0: el último día antes de nuestra era es −0001-12-31 y el día que sigue es 0001-01-01. Las fechas anteriores al 15 de octubre de 1582 están en el calendario gregoriano proléptico.

Al convertir un número de serie de fecha en una cadena de caracteres imprimible, por ejemplo, para las órdenes Print y MsgBox, se utiliza el calendario predeterminado de la configuración regional y, en caso de tratar fechas anteriores al 15 de octubre de 1582, puede cambiarse al calendario juliano, lo cual puede causar que se muestren fechas distintas de las esperadas. Utilice la función CDateToIso para convertir ese número de fecha en una representación de cadena en el calendario gregoriano proléptico.

El formato AAAA-MM-DD, con separadores, se admite a partir de LibreOffice 5.3.4. Los años menores que 100 y mayores que 9999 se admiten a partir de LibreOffice 5.4 a no ser que se encuentre en el modo de compatibilidad de VBA.

## Función CDateToUnoDate

Devuelve la fecha como una estructura com.sun.star.util.Date de UNO.

## Función CDateFromUnoDate

Convierte una estructura com.sun.star.util.Date de UNO a un valor de fecha.

## Función CDateToUnoDateTime

Devuelve la parte horaria de la fecha como una estructura com.sun.star.util.DateTime de UNO.

## Función CDateFromUnoDateTime

Convierte una estructura UNO com.sun.star.util.DateTime a un valor Fecha

## Función DateAdd

Suma un intervalo de fechas u horas a una fecha dada un determinado número de veces y devuelve la fecha resultante.

## Función DateDiff

Devuelve el número de intervalos de fecha o de hora entre dos fechas que se indiquen.

## Función DatePart

La función DatePart devuelve una parte concreta de una fecha.