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 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 se agregará. Arg2 es un número que contiene la cantidad de partes que se agregarán. Arg3 es la columna Los argumentos válidos para Arg1 son: ' ' ' ' ' ' ' ' ' ' ' Ejemplos:
|
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 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: ' ' ' ' ' ' ' ' ' ' ' ' ' ' Ejemplo:
Para ver 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 , Time o 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 datos subyacentes del cálculo son enteros , pero la configuración regional determina la salida con formato para algunos de los argumentos ("mm ", "qq ", "dw "). Los argumentos válidos para Arg1 son: ' ' ' ' ' ' ' ' ' ' ' ' ' ' Ejemplo:
|
DateTimeNow()
|
Devuelve la hora actual del sistema. Tenga en cuenta que cuando se ejecuta la expresión en un cliente web o se utiliza Automation Services, lo que se devuelve es la hora en la zona horaria del servicio (en el servidor). Ejemplo:
Para ver ejemplos, consulteCá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:
|
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:
|
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:
|
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:
|
Days(Arg1)
|
Devuelve el número de días de un TimeSpan como un valor Integer entre -10675199 y 10675199; o, si el argumento es un valor Ejemplos:
|
FiscalMonth(Arg1, Arg2)
|
Devuelve el mes fiscal de una fecha. El primer argumento es la columna Si no se especifica el segundo argumento, se utilizará el valor de la propiedad de documento Cuando se usa en las jerarquías, el método
La jerarquía en la imagen se construye usando la siguiente expresión::
Ejemplos:
|
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 Ejemplos:
|
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 Ejemplos:
|
Hour(Arg1)
|
Extrae la hora de la columna de DateTime o Time . Devuelve un número entero del 0 al 23. Ejemplo:
|
Hours(Arg1)
|
Devuelve el número de horas de un TimeSpan como un valor Integer entre 0 y 23; o, si el argumento es un valor Ejemplos:
|
ISOWeek(Arg1)
|
Devuelve la semana ISO según la norma ISO 8601 para una fecha (Date o DateTime) como un número entero entre 1 y 53. Ejemplo:
|
ISOYear(Arg1)
|
Devuelve el año de numeración de semanas ISO según la norma ISO 8601 para una fecha (Date o DateTime) como un número entero. Ejemplo:
|
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:
|
Milliseconds(Arg1)
|
Devuelve el número de milisegundos para un TimeSpan como un valor entero entre 0 y 999 o, si el argumento es un Ejemplos:
|
Minute(Arg1)
|
Extrae los minutos de la columna de DateTime o Time . Devuelve un número entero del 0 al 59. Ejemplo:
|
Minutes(Arg1)
|
Devuelve el número de minutos de un TimeSpan como un valor Integer entre 0 y 59; o, si el argumento es un valor Ejemplos:
|
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:
|
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:
|
Second(Arg1)
|
Extrae los segundos de la columna de DateTime o Time . Devuelve un número entero del 0 al 59. Ejemplo:
|
Seconds(Arg1)
|
Devuelve el número de segundos de un TimeSpan como un valor Integer entre 0 y 59; o, si el argumento es un valor Ejemplos:
|
Today()
|
Devuelve la fecha actual. Tenga en cuenta que cuando se ejecuta la expresión en un cliente web o se utiliza Automation Services, lo que se devuelve es la fecha en la zona horaria del servicio (en el servidor). Ejemplo:
|
TotalDays(Arg1)
|
Devuelve el número de días de un TimeSpan como un valor real expresado en días completos o fracciones. Ejemplo:
|
TotalHours(Arg1)
|
Devuelve el número de horas de un TimeSpan como un valor real expresado en horas completas o fracciones. Ejemplo:
|
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:
|
TotalMinutes(Arg1)
|
Devuelve el número de minutos de un TimeSpan como un valor real expresado en minutos completos o fracciones. Ejemplo:
|
TotalSeconds()
|
Devuelve el número de segundos de un TimeSpan como un valor real expresado en segundos completos o fracciones. Ejemplo:
|
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:
|
Year(Arg1)
|
Extrae el año de la columna de Date o DateTime . El resultado es un valor Integer . Ejemplo:
|
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:
|