Funciones de fecha y hora
La siguiente lista muestra las funciones de fecha y hora que se pueden utilizar en expresiones.
| Función | Descripción |
|---|---|
| DateAdd(Arg1, Arg2, Arg3) | Agrega un intervalo a una Date, una Time o una DateTime. El método puede agregar un TimeSpan o un Integer que represente una fecha especificada o un período de tiempo (por ejemplo, un número de días). Si se va a agregar TimeSpan, se necesitan dos argumentos: una columna DateTime y una columna TimeSpan. Si se va a agregar un valor de número entero a una fecha o a un período, se usan tres argumentos:Arg1 es una cadena que describe qué parte agregar.Arg2 es un número que contiene el número de partes a agregar.Arg3 es la columna Date, Time o DateTime. Los argumentos válidos para Arg1 son: "year" o "yy": el año. "quarter" o "qq": el trimestre. "month" o "mm": el mes. "day" o "dd": el día. "week" o "wk": la semana. "hour" o "hh": la hora. "minute" o "mi": los minutos. "second" o "ss": los segundos. "millisecond" o "ms": los milisegundos. Ejemplos: DateAdd([Date Column], [TimeSpan Column]) DateAdd('year', 2, [Date Column]) DateAdd('month', 1, [Date Column]) |
| DateDiff(Arg1, Arg2, Arg3) | Calcula la diferencia entre dos columnas de Date, Time o DateTime. El resultado se presenta como un TimeSpan o como un valor real que representa un período de tiempo especificado (por ejemplo, un número de días). Si se usan dos argumentos (una columna de fecha de inicio y otra de fecha de final), el resultado será un valor de TimeSpan que muestra la diferencia total. Si se usan tres argumentos, el primero debe ser la parte que se va a comparar. El segundo argumento es la columna de fecha de inicio y el tercero es la columna de fecha de final. El resultado de la operación es un valor real. Los argumentos válidos para Arg1 son: "year" o "yy": el año. "quarter" o "qq": el trimestre. "month" o "mm": el mes. "day" o "dd": el día. "week" o "wk": la semana. "hour" o "hh": la hora. "minute" o "mi": los minutos. "second" o "ss": los segundos. "millisecond" o "ms": los milisegundos. Ejemplo: DateDiff([Order Date], [Delivery Date]) DateDiff('day', [Order Date], [Delivery Date]) Para obtener ejemplos, consulte Cálculos de las diferencias temporales y Cálculo de periodos de tiempo. |
| DatePart(Arg1, Arg2) | Devuelve una parte especificada de una Date, una Time o una DateTime. Arg1 es una cadena que describe la parte de la fecha que se debe obtener, mientras que Arg2 corresponde a la columna de Date, Time o DateTime. Los argumentos válidos para Arg1 son: "year" o "yy": el año. "quarter" o "qq": el trimestre. "month" o "mm": el mes. "day of year" o "dy": el día del año. "day" o "dd": el día. "year and week" o "yywk": el año y la semana. "week" o "wk": la semana. "day of week" o "dw": el día de la semana. "hour" o "hh": la hora. "minute" o "mi": los minutos. "second" o "ss": los segundos. "millisecond" o "ms": los milisegundos. Ejemplo: DatePart('year', [Date Column]) |
| DateTimeNow() | Devuelve la hora actual del sistema. Ejemplo: DateTimeNow() Para obtener ejemplos, consulte Cálculos de las diferencias temporales y Cálculo de periodos de tiempo. |
| Day(Arg1) | Extrae el día del mes de la columna de Date o DateTime. El resultado es un número entero entre el 1 y el 31. Ejemplo: Day([Date Column]) |
| DayOfMonth(Arg1) | Extrae el día del mes de la columna de Date o DateTime. El resultado es un número entero entre el 1 y el 31. Ejemplo: DayOfMonth([Date Column]) |
| DayOfWeek(Arg1) | Extrae el día de la semana de la columna de Date o DateTime. Los datos subyacentes son un número entero entre 0 (domingo) y 6 (sábado), pero la configuración regional determina el día de inicio de la semana y el formato de salida de la nueva columna. Ejemplo: DayOfWeek([Date Column]) |
| DayOfYear(Arg1) | Extrae el día del año de la columna de Date o DateTime. Devuelve un número entero del 1 al 366. Ejemplo: DayOfYear([Date Column]) |
| Days(Arg1) | Devuelve el número de días de un TimeSpan con forma de valor Integer entre -10675199 y 10675199. O bien, si el argumento es un valor Integer, crea una columna de TimeSpan donde la entrada es el número de días. Ejemplos: Days([TimeSpan Column]) Days(3) |
| FiscalMonth(Arg1, Arg2) | Devuelve el mes fiscal de una fecha. El primer argumento es la columna Date. El segundo argumento (opcional) es el número de meses que se va a cambiar. Si no se especifica el segundo argumento, se utilizará el valor de la propiedad de documento FiscalYearOffset. La configuración regional determina el formato de salida. Cuando se usa en las jerarquías, el método FiscalMonth realiza un seguimiento del orden de los meses para que los elementos de visualización se muestren en el orden correcto. Por ejemplo, si el año fiscal finaliza en enero, el siguiente año fiscal debería comenzar en febrero (véase a continuación) y no en enero: La jerarquía en la imagen se crea con la siguiente expresión: <FiscalYear([Date Column],1) NEST FiscalMonth([Date Column],1)> Ejemplos: FiscalMonth([Date Column], 1) FiscalMonth([Date Column]) |
| FiscalQuarter (Arg1, Arg2) | Devuelve el trimestre fiscal correspondiente a una fecha (Arg1), en función de un cambio especificado en los meses (Arg2). El segundo argumento es opcional. Si no se especifica el segundo argumento, se utilizará el valor de la propiedad de documento FiscalYearOffset. Ejemplos: FiscalQuarter([Date Column], 1) FiscalQuarter([Date Column]) |
| FiscalYear (Arg1, Arg2) | Devuelve el año fiscal correspondiente a una fecha (Arg1), en función de un cambio especificado en los meses (Arg2). El segundo argumento es opcional. Si no se especifica el segundo argumento, se utilizará el valor de la propiedad de documento FiscalYearOffset. Ejemplos: FiscalYear([Date Column], 1) FiscalYear([Date Column]) |
| Hour(Arg1) | Extrae la hora de la columna de DateTime o Time. Devuelve un número entero del 0 al 23. Ejemplo: Hour([Time Column]) |
| Hours(Arg1) |
Devuelve el número de horas de un TimeSpan con forma de valor Integer entre 0 y 23. O bien, si el argumento es un valor Integer, crea una columna de TimeSpan donde la entrada es el número de horas. Ejemplos: Hours([TimeSpan Column]) Hours(10) |
| Millisecond(Arg1) |
Extrae las milésimas de segundo de la columna de DateTime o Time. Devuelve un número entero del 0 al 999. Ejemplo: Millisecond([Time Column]) |
| Milliseconds(Arg1) |
Devuelve el número de milésimas de segundo de un TimeSpan como un valor Real entre 0,0 y 999,0. O bien, si el argumento es un valor Real, crea una columna de TimeSpan donde la entrada es el número de milésimas de segundo. Ejemplos: Milliseconds([TimeSpan Column]) Milliseconds(123.45) |
| Minute(Arg1) | Extrae los minutos de la columna de DateTime o Time. Devuelve un número entero del 0 al 59. Ejemplo: Minute([Time Column]) |
| Minutes(Arg1) |
Devuelve el número de minutos de un TimeSpan con forma de valor Integer entre 0 y 59. O bien, si el argumento es un valor Integer, crea una columna de TimeSpan donde la entrada es el número de minutos. Ejemplos: Minutes([TimeSpan Column]) Minutes(50) |
| Month(Arg1) | Extrae el mes de la columna de Date o DateTime. Los datos subyacentes son un número entero entre 1 y 12, pero la configuración regional determina el formato de salida de la nueva columna. Ejemplo: Month([Date Column]) |
| Quarter(Arg1) | Extrae el trimestre de la columna de Date o DateTime. Los datos subyacentes son un número entero entre 1 y 4, pero la configuración regional determina el formato de salida de la nueva columna. Ejemplo: Quarter([Date Column]) |
| Second(Arg1) | Extrae los segundos de la columna de DateTime o Time. Devuelve un número entero del 0 al 59. Ejemplo: Second([Time Column]) |
| Seconds(Arg1) | Devuelve el número de segundos de un TimeSpan con forma de valor Integer entre 0 y 59. O bien, si el argumento es un valor Integer, crea una columna de TimeSpan donde la entrada es el número de segundos. Ejemplos: Seconds([TimeSpan Column]) Seconds(10) |
| Today() | Devuelve la fecha actual. Ejemplo: Today() |
| TotalDays(Arg1) | Devuelve el número de días de un TimeSpan como un valor real expresado en días completos o fracciones. Ejemplo: TotalDays([TimeSpan Column]) |
| TotalHours(Arg1) | Devuelve el número de horas de un TimeSpan como un valor real expresado en horas completas o fracciones. Ejemplo: TotalHours([TimeSpan Column]) |
| TotalMilliseconds(Arg1) | Devuelve el número de milésimas de segundo de un TimeSpan como un valor real expresado en milésimas de segundo completas o en fracciones. Ejemplo: TotalMilliseconds([TimeSpan Column]) |
| TotalMinutes(Arg1) | Devuelve el número de minutos de un TimeSpan como un valor real expresado en minutos completos o fracciones. Ejemplo: TotalMinutes([TimeSpan Column]) |
| TotalSeconds() | Devuelve el número de segundos de un TimeSpan como un valor real expresado en segundos completos o fracciones. Ejemplo: TotalSeconds([TimeSpan Column]) |
| Week(Arg1) | Extrae la semana de una columna de Date o DateTime en forma de número entero entre 1 y 54, donde la primera semana del año depende de la configuración regional. Ejemplo: Week([Date Column]) |
| Year(Arg1) | Extrae el año de la columna de Date o DateTime. El resultado es un valor Integer. Ejemplo: Year([Date Column]) |
| YearAndWeek(Arg1) | Extrae el año y la semana de la columna de Date o DateTime. Devuelve un valor Integer (Año*100 + Número de semana); por ejemplo, la fecha 2005-10-13 se convierte en 200541. Ejemplo: YearAndWeek([Date Column]) |
