Funciones de fechas y horas estándar específicas de Maintain

En esta sección:

 

Las funciones de fechas y horas estándar se utilizan con fechas que no sean de tipo legacy. Para obtener una definición de las fechas y horas estándar, consulte Funciones de fecha-hora.


Principio de página

x
HHMS: Cómo recuperar la hora actual (Maintain)

Cómo:

La función HHMMSS recupera la hora actual del sistema operativo como una cadena de 8 caracteres, con las horas, minutos y segundos separados por puntos.

Para usar esta función, debe importar la librería de funciones MNTUWS. Para más información sobre la importación de una librería de funciones, consulte Cómo llamar a una función.

Además, existe una función HHMMSS disponible en el lenguaje de informes. Para más información sobre esta función, consulte HHMS: Cómo obtener la hora actual.



x
Sintaxis: Cómo Recuperar la hora actual
HHMMSS()


Ejemplo: Cómo recuperar la hora actual

HHMMSS recupera la hora actual del sistema operativo:

MAINTAIN
Module Import (mntuws);
Case Top
Compute now/a10 = hhmmss();
type "Now = <<now"
EndCase
END

La salida es:

Now = 14.25.33

Principio de página

x
Initial_HHMMSS: Cómo devolver la hora de inicio de la aplicación

Cómo:

La función Initial_HHMMSS devuelve la hora en que se inició la aplicación de Maintain como una cadena de 8 caracteres, con puntos insertados para separara las horas, minutos y segundos.

Para usar esta función, debe importar la librería de funciones MNTUWS. Para más detalles sobre la importación de esta librería, consulte Cómo llamar a una función.



x
Sintaxis: Cómo Recuperar la hora inicial
Initial_HHMMSS()

Principio de página

x
Initial_TODAY: Cómo devolver la hora de inicio de la aplicación

Cómo:

La función Initial_TODAY devuelve la fecha en formato MM/DD/YY cuando la aplicación de Maintain se inició como una cadena de caracteres con barras diagonales insertadas.

Para usar esta función, debe importar la librería de funciones MNTUWS. Para más detalles sobre la importación de esta librería, consulte Cómo llamar a una función.



x
Sintaxis: Cómo Recuperar la fecha inicial
Initial_TODAY()

Principio de página

x
TODAY: Cómo recuperar la fecha actual (Maintain)

Cómo:

La función TODAY recupera la fecha actual del sistema operativo en el formato MM/DD/YY. TODAY siempre devuelve la fecha actual. Por tanto, si está ejecutando una aplicación tarde por la noche, emplee TODAY. Puede eliminar las barras diagonales insertadas utilizando la función EDIT.

Para usar esta función, debe importar la librería de funciones MNTUWS. Para más información sobre la importación de esta librería, consulte Cómo llamar a una función.

Existe una versión de la función TODAY que sólo está disponible en el lenguaje de informes. Para más información acerca de esta función, consulte HTMTOTS o TIMETOTS: Cómo convertir una hora en una marca de tiempo.



x
Sintaxis: Cómo Recuperar la fecha actual
TODAY()


Ejemplo: Cómo recuperar la fecha actual

TODAY recupera la fecha actual del sistema:

MAINTAIN
Module Import (mntuws);
 
Case Top
Compute date1/a8 = today();
type "Date1 = <<date1"
Endcase
END

El resultado es:

Date1 = 07/17/02

Principio de página

x
TODAY2: Cómo devolver la fecha actual

Cómo:

La función TODAY2 recupera la fecha actual del sistema operativo en el formato MM/DD/YYYY. Emplee el formato A10 con la función TODAY2 para asegurarse de que los resultados sean los correctos.

Para usar esta función, debe importar la librería de funciones MNTUWS. Para más información sobre la importación de esta librería, consulte Cómo llamar a una función.



x
Sintaxis: Cómo Recuperar la fecha actual
TODAY2()


Ejemplo: Cómo recuperar la fecha actual

TODAY2 recupera la fecha actual del sistema:

MAINTAIN
Module Import (mntuws);
 
Case Top
Compute date2/a10 = today2();
type "Date2 = <<date2"
Endcase
END

El resultado es:

Date2 = 07/17/2002

Principio de página

x
ADD: Cómo añadir días a una fecha

Cómo:

La función ADD añade un número determinado de días a una fecha.



x
Sintaxis: Cómo Añadir días a una fecha
ADD(date,value)

o

date.ADD(value)

donde:

date
La fecha a la que se va a añadir días, o un campo que la contenga.
value
El número de días en que se va a incrementar la fecha.

Esta función cambia el valor de date.



Ejemplo: Cómo añadir días a una fecha

ADD añade 10 días a cada valor en el campo DateVar:

ADD(DateVar, 10)

A continuación le mostramos valores de ejemplo para DateVar y los valores correspondientes de ADD(DateVar, 10):

DateVar      ADD(DateVar, 10);
-------      -----------------
12/31/1999   01/10/2000
01/01/2000   01/11/2000
01/02/2000   01/12/2000

Principio de página

x
DAY: Cómo extraer el día del mes de una fecha

Cómo:

La función DAY extrae el día del mes de una fecha y devuelve el resultado en forma de número entero.



x
Sintaxis: Cómo Extraer el día del mes de una fecha
DAY(date);

donde:

date
La fecha (en formato de fecha) de la que se va a extraer el día del mes, o un campo que la contenga.


Ejemplo: Cómo extraer el día del mes de una fecha

DAY extrae el día del mes del campo DATE:

DAY(DATE)

A continuación le mostramos valores de ejemplo para DATE y los valores correspondientes de DAY(DATE):

DATE         DAY(DATE)
----         ---------
01/01/2000   1
01/02/2000   2
01/03/2000   3

Principio de página

x
JULIAN: Cómo determinar el número de días transcurridos en un año

Cómo:

La función JULIAN determina el número de días transcurridos en un determinado año hasta una fecha específica, y devuelve el resultado en forma de número entero.



x
Sintaxis: Cómo Determinar el número de días transcurridos en un año
JULIAN(date);

donde:

date
La fecha (en formato de fecha) para la que se va a determinar el número de días transcurridos en un determinado año, o un campo que la contenga.


Ejemplo: Cómo determinar el número de días transcurridos en un año

JULIAN determina el número de días transcurridos en un año hasta la fecha que aparece en el campo DATE:

JULIAN(DATE)

A continuación le mostramos valores de ejemplo para DATE y los valores correspondientes de JULIAN(DATE):

DATE         JULIAN(DATE)
----         ------------
01/01/2000   1
02/01/2000   32
03/01/2000   61

Principio de página

x
MONTH: Cómo extraer el componente del mes de una fecha

Cómo:

La función MONTH extrae el día del mes de una fecha y devuelve el resultado en forma de número entero.



x
Sintaxis: Cómo Extraer el mes de una fecha
MONTH(date);

donde:

date
La fecha (en formato de fecha) de la que se va a extraer el mes, o un campo que la contenga.


Ejemplo: Cómo extraer el componente de mes de una fecha

MONTH extrae el mes de cada valor del campo DATE:

MONTH(DATE)

A continuación le mostramos valores de ejemplo para DATE y los valores correspondientes de MONTH(DATE):

DATE         MONTH(DATE)
----         -----------
01/01/2000   1
02/01/2000   2
03/01/2000   3

Principio de página

x
QUARTER: Cómo determinar el trimestre

Cómo:

La función QUARTER determina el trimestre del año en que cae una fecha y devuelve el resultado en forma de número entero.



x
Sintaxis: Cómo Determinar el trimestre de una fecha
QUARTER(date);

donde:

date
La fecha (en formato de fecha) para la que se va a determinar el trimestre, o un campo que la contenga.


Ejemplo: Cómo determinar el trimestre de una fecha

QUARTER extrae el componente de trimestre de cada valor del campo DATE:

QUARTER(DATE)

A continuación le mostramos valores de ejemplo para DATE y los valores correspondientes de QUARTER(DATE):

DATE         QUARTER(DATE)
----         -------------
01/01/2000   1
04/01/2000   2
07/01/2000   3

Principio de página

x
SETMDY: Cómo establecer el valor en una fecha

Cómo:

La función SETMDY establece un valor en una fecha en base a los valores numéricos que representan el día, mes y año. SETMDY devuelve un 0 si la función ha tenido éxito y un número negativo, si no lo ha tenido.



x
Sintaxis: Cómo Establecer un valor en una fecha
SETMDY(date, month, day, year);

o

date.SETMDY(month, day, year);

donde:

date
Es la fecha, en formato de fecha, o un campo que la contenga.
month
Es un valor de número entero que representa el mes.
day
Es un valor de número entero que representa el día del mes.
year
Es un valor de número entero que representa el año.


Ejemplo: Cómo establecer un valor en una fecha

SETMDY establece el valor de DateVar, que está en formato de fecha y aparece como wrMtrDYY (por ejemplo, Sábado, Enero 1, 2000):

SETMDY(DateVar, month, day, year);

A continuación le mostramos valores de ejemplo de mes, día y año y los valores correspondientes de DateVar:

month  day   year   DateVar
-----  ---   ----   -------
04     05    1965   Monday, April 5, 1965
02     01    1997   Saturday, February 1, 1997
01     01    2000   Saturday, January 1, 2000

Principio de página

x
SUB: Cómo restar un valor a una fecha

Cómo:

La función SUB resta un número determinado de días a una fecha.



x
Sintaxis: Cómo Restar un valor a una fecha
SUB(date,value)

o

date.SUB(value)

donde:

date
La fecha a la que se va a restar el valor, o un campo que la contenga.
value
El valor que se va a restar a la fecha.


Ejemplo: Cómo restar días a una fecha

SUB resta 10 días a cada valor del campo DataVar.

SUB(DateVar, 10)

A continuación le mostramos valores de ejemplo para DateVar y los valores correspondientes de SUB(DateVar, 10):

DateVar      SUB(DateVar, 10);
-------      -----------------
12/31/1999   12/21/2000
01/01/2000   12/22/2000
01/02/2000   12/23/2000

Principio de página

x
WEEKDAY: Cómo determinar el día de la semana de una fecha

Cómo:

La función WEEKDAY determina el día de la semana de una fecha específica, y devuelve el resultado en forma de número entero (1=lunes, 2=martes, etc.).



x
Sintaxis: Cómo Determinar el día de la semana de una fecha
WEEKDAY(date);

donde:

date
La fecha (en formato de fecha) para la que se va a determinar el día de la semana, o un campo que la contenga.


Ejemplo: Cómo determinar el día de la semana de una fecha

WEEKDAY determina el día de la semana de cada fecha que aparece en el campo DATE y almacena ese día como un número correspondiente a un día de la semana:

WEEKDAY(DATE)

A continuación le mostramos valores de ejemplo para DATE y los valores correspondientes de WEEKDAY(DATE):

DATE         WEEKDAY(DATE)
----         -------------
01/01/2000   6
01/02/2000   7
01/03/2000   1

Principio de página

x
YEAR: Extraer el año de una fecha

Cómo:

La función YEAR extrae el año de una fecha.



x
Sintaxis: Cómo Extraer el año de una fecha
YEAR(date);

donde:

date
La fecha de la que se va a extraer el año, o un campo que la contenga.


Ejemplo: Cómo extraer el año de una fecha

YEAR extrae el año del campo DATE y almacena ese año en el campo YEAR(DATE):

YEAR(DATE)

A continuación le mostramos valores de ejemplo para DATE y los valores correspondientes de YEAR(DATE):

DATE          YEAR(DATE)
----          ----------
01/01/2000    2000
02/01/2001    2001
03/01/2002    2002

Information Builders