Funciones de fechas
Devuelve la fecha incrementada los dÃas.
addDays(fecha, dÃas)fecha
Expresión de tipo fecha a la que sumaremos los dÃas. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
dÃas
Número de dÃas que sumaremos a la fecha.
Devuelve la fecha incrementada el número de dÃas que hayamos pasado como parámetro, teniendo en cuenta años bisiestos.
FECHA = 01/12/2012
addDays(FECHA, 11 ) = 12/12/2012Devuelve la fecha incrementada los meses.
addMonths(fecha, meses)fecha
Expresión de tipo fecha a la que sumaremos los meses. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
meses
Número de meses que sumaremos a la fecha.
Devuelve la fecha incrementada el número de meses que hayamos pasado como parámetro.
FECHA=12/09/2012
addMonths(FECHA, 3 ) = 12/12/2012Devuelve la fecha incrementada los años.
addYears(fecha, años)fecha
Expresión de tipo fecha a la que sumaremos los años. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
años
Número de años que sumaremos a la fecha.
Devuelve la fecha incrementada el número de años que hayamos pasado como parámetro.
FECHA = 12/12/2001
addYears(FECHA, 11 ) = 12/12/2012Devuelve la edad del nacido en la fecha pasada como parámetro.
age(fecha)fecha
Expresión de tipo fecha fecha cuya diferencia con el dÃa en curso queremos conocer. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
Devuelve el número de años entre la fecha del sistema y la fecha que pasamos como parámetro.
Devuelve la fecha actual.
currentDate()No tiene.
currentDate() = 04-Dic-2008Indica si la fecha pasada como parámetro es válida.
dateIsValid(fecha)fecha
Expresión de tipo fecha con la fecha que queremos comprobar. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
La función retornará true (1) si la fecha es correcta y false (0) si no está conformada correctamente.
Tiene en cuenta el número de dÃas del mes y si el año es bisiesto o no. Cualquier fecha antes del 2 de enero de 4713 A.D. se considerará incorrecta.
FECHA = 10/10/2010
dateIsValid(FECHA) = 1FECHA = 32/33/2010
dateIsValid(FECHA) = 0Devuelve la fecha como una cadena según las indicaciones del formato. Sigue el estándar Unicode Common Locale Data Repository.
dateToString(fecha, cadenaFormato)fecha
Expresión de tipo fecha a partir de la cual queremos generar una cadena. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
cadenaFormato
Cadena de formato que especifica cómo crear la cadena a partir de la fecha.
Formato
DÃa: d (1-31) dd (01-31) ddd (lu.-do.) dddd (lunes-domingo)
Mes: M (1-12) MM (01-12) MMM (ene.-dic.) MMMM (enero-diciembre)
Año: yy (00-99) yyyy (0000-9999)
La abreviatura del dÃa o del mes será distinta según la plataforma. Windows, macOS e iOS usan la información del sistema, Linux y Android hacen uso del estándar ICU.
Por ejemplo si el dÃa es miércoles y usamos la cadena para devolver el nombre del dÃa abreviado, según el sistema podrá devolvernos: "mi.", "mié" o "mié.".
El resto de caracteres en la cadena de formato serán tratados como texto. También los caracteres que estén entre comillas simples (‘) en la cadena de formato serán tratados como texto, lo que nos permite tratar los caracteres especÃficos de formato (d, dd, M, MM, etc.) como texto.
FECHA = 01/12/2003
dateToString(FECHA, "d’MM’MMcaryyyy" ) = 1MM12car2003FECHA = 30/01/1900
dateToString(FECHA, "M.d" ) = 1.30FECHA = 10/01/2000
dateToString(FECHA, "yyyyMMdd" ) = 20000110FECHA = 10/01/2000
dateToString(FECHA,"yyyyMd" ) = 2000110Devuelve el dÃa de la fecha.
day(fecha)fecha
Expresión de tipo fecha cuyo dÃa queremos obtener. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
FECHA = 20/07/1969
day(FECHA) = 20Devuelve el nombre del dÃa de la semana que pasemos como parámetro (1 a 7). Si el parámetro abreviatura es true (1), devuelve la forma corta del nombre.
dayName(dia, abreviatura)dia
Número del dÃa de la semana (1-7) cuyo nombre queremos conocer en el idioma local del sistema.
abreviatura
Si el parámetro es true (1), devuelve la forma corta del nombre, si es false (0) devolverá el nombre completo.
dayName(1,0) = “Lunesâ€Devuelve el dÃa de la semana (1 al 7) de la fecha.
dayOfWeek(fecha)fecha
Expresión de tipo fecha que contenga la fecha de la que queremos conocer qué dÃa de la semana es. Comienza a contar desde el lunes, del 1 al 7.
FECHA = 20-11-2008
daysOfWeek(FECHA) = 4Devuelve el dÃa del año (1 al 366) de la fecha.
dayOfYear(fecha)fecha
Expresión de tipo fecha de la que queremos conocer qué dÃa del año es comenzando a contar desde el 1 de enero, del 1 al 366.
FECHA = 02-Feb-2008
dayOfYear(FECHA) = 41Devuelve los dÃas del mes (28 al 31) de la fecha.
daysInMonth(fecha)fecha
Expresión de tipo fecha de cuyo mes queremos conocer cuántos dÃas tiene: 28 ó 29, en función del mes y de si el año es bisiesto o no.
FECHA = 10-Feb-2008
daysInMonth(FECHA) = 28Devuelve los dÃas del año (365 ó 366) de la fecha.
daysInYear(fecha)fecha
Expresión de tipo fecha de cuyo año queremos conocer cuántos dÃas tiene: 365 ó 366, en función de si es bisiesto o no.
FECHA = 10-Feb-2008
daysInYear(FECHA) = 365Devuelve los dÃas entre fechaDesde y fechaHasta.
daysTo(fechaDesde, fechaHasta)fechaDesde
Expresión de tipo fecha con la fecha inicial.
fechaHasta
Expresión de tipo fecha con la fecha final. El resultado será negativo si fechaHasta es menor que fechaDesde.
FECHA_INICIO = 10-Oct-2008, FECHA_FIN= 20-Oct-2008
daysTo(FECHA_INICIO, FECHA_FIN ) = 10Devuelve true (1) si el año que pasemos como parámetro es bisiesto y false (0) si no lo es.
isLeapYear(año)año
Expresión numérica con el año del que queremos saber si es bisiesto o no.
Devuelve 1 si el año que pasemos como parámetro es bisiesto y 0 si no lo es.
isLeapYear(2000) = 0Devuelve el mes de la fecha.
month(fecha)fecha
Expresión de tipo fecha cuyo número de mes queremos obtener.
Devolverá el número de mes de la fecha.
FECHA = 01-Dic-2008
month(FECHA) = 12Devuelve el nombre del mes que pasemos com parámetro.
monthName(mes, abreviatura)mes
Número del mes cuyo nombre queremos obtener.
abreviatura
Si el parámetro es 0, devolverá el nombre completo. Si el parámetro es 1, devolverá la forma corta del nombre.
El nombre será devuelto de acuerdo a la configuración de idioma del sistema en el que se solicita. Cuando escogemos idioma de sistema, en Windows se tomará el formato establecido en la configuración regional del sistema. En el caso de Linux y MacOS, al escoger el idioma del sistema, la configuración regional del sistema la toma del estándar ICU.
monthName(9, 0) = septiembre (Windos, Linux y MacOS)
monthName(9, 1) = sep. (WIndows) sept (Linux y MacOS)Devuelve el trimestre de la fecha.
quarter(fecha)fecha
Expresión de tipo fecha de la que queremos conocer el trimestre al que pertenece.
quarter( setDate( 2000, 1, 1 ) ) = 1Crea una fecha.
setDate(año, mes, dÃa)Año
Año de la fecha.
Mes
Mes de la fecha.
DÃa
DÃa de la fecha.
Si la fecha especificada no es válida, la función retornará una fecha nula, no devolverá nada. Cualquier fecha antes del 2 de enero de 4713 A.D. se considerará incorrecta.
setDate(1976, 4, 15) = 15 de abril de 1976Devuelve la fecha de una cadena según las indicaciones del formato.
stringToDate(cadena, cadenaFormato)cadena
Cadena que contiene la fecha.
cadenaFormato
Permite indicar cuál es el formato de la fecha en la cadena. Las cadenas de formato disponibles son:
DÃa
d (1-31)
dd (01-31)
ddd (lu.-do.)
dddd (lunes-domingo)
Mes
M (1-12)
MM (01-12)
MMM (ene.-dic.)
MMMM (enero-diciembre)
Esta función sigue el estándar Unicode Common Locale Data Repository y para el idioma español, en el caso del mes abreviado, el formato es el nombre del mes abreviado seguido de un punto. Ejemplo: "ene."
stringToDate("01-jun.-2010", "dd-MMM-yyyy" ).
Año
yy (00-99)
yyyy (0000-9999)
El resto de caracteres en la cadena de formato serán tratados como texto. También los caracteres que estén entre comillas simples (‘) en la cadena de formato serán tratados como texto, lo que nos permite tratar los caracteres especÃficos de formato (d, dd, M, MM, etc.) como texto.
Si la cadena no se corresponde con el formato especificado la devolverá una fecha nula, no devolverá nada. Esto puede incluir casos en los que se espere ceros por la izquierda u otras incoherencias con el formato esperado.
Las funciones de conversión de fechas tienen por defecto la fecha 1 de enero de 1900 por si no se completan datos. Por lo tanto, los valores que se tomarán por defecto para cualquier dato de la fecha no especificado en el formato son:
Año: 1900
Mes: 1
DÃa: 1
stringToDate("1MM12car2003", "d’MM’MMcaryyyy" ) = 1 de diciembre de 2003
stringToDate("1.30", "M.d" ) = 30 de enero de 1900
stringToDate("20000110", "yyyyMMdd" ) = 10 de enero de 2000
stringToDate("20000110", "yyyyMd" ) = 10 de enero de 2000
stringToDate("02/10/10", "dd/MM/yy") = 02/10/1910
stringToDate("01-Jun.-2010", "dd-MMM-yyyy" ) = 02-Jun.-2010Devuelve la semana del año (1 a 53) de la fecha.
weekOfyear(fecha)fecha
Expresión de tipo fecha cuyo número de semana queremos obtener. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
FECHA = 14-Nov-2008
weekOfYear(FECHA) = 46Según dicha norma, la semana comienza en lunes y el primer jueves de un año pertenece siempre a la primera semana de ese año. Muchos años tienen 52 semanas, pero algunas tienen 53.
Se considera la primera semana de un año (semana W01) aquella que contiene el primer jueves de dicho año, o lo que es lo mismo, aquella que contiene el dÃa 4 de enero.
Por ejemplo, el 1 de enero de 2012 es domingo, por lo tanto, es el último dÃa de la última semana del año 2011.
Devuelve el año de la fecha.
year(fecha)fecha
Expresión de tipo fecha cuyo año queremos obtener. Esta fecha puede ser un literal, una variable, un campo, el retorno de una función, etc.
FECHA = 20-Jul-1969
year(FECHA) = 1969Última actualización 2yr ago