Funções Padrão de Data e Hora específicas do Maintain

Nesta seção:

 

As funções padrão de data e hora são para uso com datas que não são de legado. Para uma definição de datas e horas padrão, consulte Funções Data-Hora.


Topo da página

x
HHMMSS: Como Obter a Hora Atual (Maintain)

Como:

A função HHMMSS obtém a hora atual a partir do sistema operacional como uma string de oito caracteres, separando as horas, minutos e segundos com pontos.

Para utilizar esta função, você deve importar a biblioteca de funções MNTUWS. Para obter informações sobre como importar uma biblioteca de funções, consulte Como Chamar uma Função.

Também há uma função HHMMSS disponível na linguagem de relatórios. Para obter informações sobre esta função, consulte HHMMSS: Como Obter a Hora Atual.



x
Sintaxe: Como Obter a hora atual
HHMMSS()


Exemplo: Como Obter a Hora Atual

HHMMSS recupera a hora atual do sistema operacional:

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

A saída é:

Now = 14.25.33

Topo da página

x
Initial_HHMMSS: Como Retornar a Hora em que o Aplicativo Foi Iniciado

Como:

A função Initial_HHMMSS retorna a hora em que o aplicativo Maintain foi iniciado como uma string de oito caracteres, com pontos integrados separando as horas, minutos e segundos.

Para utilizar esta função, você deve importar a biblioteca de funções MNTUWS. Para obter detalhes, consulte Como Chamar uma Função.



x
Sintaxe: Como Obter a Hora Inicial
Initial_HHMMSS()

Topo da página

x
Initial_TODAY: Como Retornar a Data em que o Aplicativo Foi Iniciado

Como:

A função Initial_TODAY retorna a data no formato MM/DD/YY em que o aplicativo Maintain foi iniciado como uma string com oito caracteres com barras integradas.

Para utilizar esta função, você deve importar a biblioteca de funções MNTUWS. Para obter detalhes, consulte Como Chamar uma Função.



x
Sintaxe: Como Obter a Data Inicial
Initial_TODAY()

Topo da página

x
TODAY: Como Obter a Data Atual (Maintain)

Como:

A função TODAY obtém a data atual do sistema no formato MM/DD/YY. TODAY sempre exibe a data atual. Portanto, se você estiver executando um aplicativo durante a madrugada, utilize TODAY. Você pode remover as barras incorporadas com a função EDIT.

Para utilizar esta função, você deve importar a biblioteca de funções MNTUWS. Para obter informações, consulte Como Chamar uma Função.

Há uma versão da função TODAY que se encontra disponível apenas na linguagem de relatórios. Para obter informações sobre esta função, consulta HTMTOTS ou TIMETOTS: Como Converter uma Hora em uma Marca Temporal.



x
Sintaxe: Como Obter a Data Atual
TODAY()


Exemplo: Como Obter a Data Atual

TODAY recupera a data atual do sistema:

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

O resultado é:

Date1 = 07/17/02

Topo da página

x
TODAY2: Como Obter a Data Atual

Como:

A função TODAY obtém a data atual do sistema operacional no formato MM/DD/YYYY. Utilize o formato A10 com a função TODAY2 para garantir resultados adequados.

Para utilizar esta função, você deve importar a biblioteca de funções MNTUWS. Para obter informações, consulte Como Chamar uma Função.



x
Sintaxe: Como Obter a Data Atual
TODAY2()


Exemplo: Como Obter a Data Atual

TODAY2 recupera a data atual do sistema:

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

O resultado é:

Date2 = 07/17/2002

Topo da página

x
ADD: Como Adicionar Dias a uma Data

Como:

A função AD adiciona um número especificado de dias a uma data.



x
Sintaxe: Como Adicionar Dias a uma Data
ADD(date,value)

ou

date.ADD(value)

onde:

Data
É a data à qual adicionar dias ou um campo contendo a data.
valor
É o número de dias pelo qual aumentar a data.

Esta função altera o valor de date.



Exemplo: Como Adicionar Dias a uma Data

ADD adiciona 10 dias para cada valor no campo DateVar:

ADD(DateVar, 10)

A seguir, você encontra valores de exemplo para DateVar e os valores correspondentes para 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

Topo da página

x
DAY: Como Extrair o Dia do Mês a partir de uma Data

Como:

A função DAY extrai o dia do mês de uma data e retorna o resultado como um inteiro.



x
Sintaxe: Como Extrair o Dia do Mês a partir de uma Data
DAY(date);

onde:

Data
É a data (no formato de data) da qual extrair o dia do mês ou um campo contendo a data.


Exemplo: Como Extrair o Dia do Mês a partir de uma Data

DAY extrai o dia do mês a partir do campo DATE:

DAY(DATE)

A seguir, você encontra valores de exemplo para DATE e os valores correspondentes para ADD(DATE):

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

Topo da página

x
JULIAN: Como Determinar Quantos Dias se Passaram no Ano

Como:

A função JULIAN determina o número de dias que se passou em um ano especificado até uma data em particular e retorna o resultado como um inteiro.



x
Sintaxe: Como Determinar Quantos Dias se Passaram no Ano
JULIAN(date);

onde:

Data
É a data (no formato de data) para a qual determinar o número de dias decorridos em um ano específico ou um campo contendo a data.


Exemplo: Como Determinar Quantos Dias se Passaram no Ano

JULIAN determina o número de dias que se passou até a data do campo DATE:

JULIAN(DATE)

A seguir, você encontra valores de exemplo para DATE e os valores correspondentes para JULIAN(DATE):

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

Topo da página

x
MONTH: Como Extrair o Mês de uma Data

Como:

A função MONTH extrai o mês de uma data e retorna o resultado como um inteiro.



x
Sintaxe: Como Extrair o Mês de uma Data
MONTH(date);

onde:

Data
É a data (no formato de data) da qual extrair o mês ou um campo contendo a data.


Exemplo: Como Extrair o Mês de uma Data

MONTH extrai o mês de cada valor do campo DATE:

MONTH(DATE)

A seguir, você encontra valores de exemplo para DATE e os valores correspondentes para MONTH(DATE):

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

Topo da página

x
QUARTER: Como Determinar o Trimestre

Como:

A função QUARTER determina o trimestre do ano no qual a data reside e retorna o resultado como um número inteiro.



x
Sintaxe: Como Determinar o Trimestre para uma Data
QUARTER(date);

onde:

Data
É a data (no formato de data) para a qual determinar o trimestre ou um campo contendo a data.


Exemplo: Como Determinar o Trimestre para uma Data

QUARTER extrai o componente do trimestre de cada valor do campo DATE:

QUARTER(DATE)

A seguir, você encontra valores de exemplo para DATE e os valores correspondentes para QUARTER(DATE):

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

Topo da página

x
SETMDY: Como Definir o valor em uma Data

Como:

A função SETMDY define um valor para uma data com base nos valores numéricos representando um dia, mês e ano. SETMDY retorna um 0 se a função for bem-sucedida e um número negativo, caso haja falha na função.



x
Sintaxe: Como Definir um Valor para uma Data
SETMDY(date, month, day, year);

ou

date.SETMDY(month, day, year);

onde:

Data
É a data, no formato de data, ou um campo contendo a data.
mês
É um valor inteiro representando um mês.
dia
É um valor inteiro representando o dia do mês.
ano
É um valor inteiro representando um ano.


Exemplo: Como Definir um Valor para uma Data

SETMDY define o valor de DateVar, que é formatado como uma data que aparece como wrMtrDYY (por exemplo, Sábado, 1 de janeiro de 2000):

SETMDY(DateVar, month, day, year);

Os valores a seguir são exemplos para o mês, dia e ano e as datas correspondentes para 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

Topo da página

x
SUB: Como Subtrair um Valor a partir de uma Data

Como:

A função SUB subtrai um número especificado de dias de uma data.



x
Sintaxe: Como Subtrair um valor de uma Data
SUB(date,value)

ou

date.SUB(value)

onde:

Data
É a data da qual subtrair o valor ou um campo contendo a data.
valor
É o valor a subtrair da data.


Exemplo: Como Subtrair Dias de uma Data

SUB subtrai 10 dias de cada valor no campo DateVar.

SUB(DateVar, 10)

A seguir, você encontra valores de exemplo para DateVar e os valores correspondentes para 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

Topo da página

x
WEEKDAY: Como Determinar o Dia da Semana para uma Data

Como:

A função WEEKDAY determina o dia da semana para uma data e retorna o resultado como um inteiro (1=Segunda, 2=Terça, e assim por diante).



x
Sintaxe: Como Determinar o Dia da Semana para uma Data
WEEKDAY(date);

onde:

Data
É a data (no formato de data) para a qual determinar o dia da semana ou um campo contendo a data.


Exemplo: Como Determinar o Dia da Semana para uma Data

WEEKDAY determina o dia da semana para cada data no campo DATE e armazena este dia como um número correspondente ao dia da semana:

WEEKDAY(DATE)

A seguir, você encontra valores de exemplo para DATE e os valores correspondentes para WEEKDAY(DATE):

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

Topo da página

x
YEAR: Como Extrair o Ano de uma Data

Como:

A função YEAR extrai o ano de uma data.



x
Sintaxe: Como Extrair o Ano de uma Data
YEAR(date);

onde:

Data
É a data da qual extrair o ano ou um campo contendo a data.


Exemplo: Como Extrair um Ano de uma Data

YEAR extrai o ano de um campo DATE e armazena o resultado no campo YEAR(DATE):

YEAR(DATE)

A seguir, você encontra valores de exemplo para DATE e os valores correspondentes para YEAR(DATE):

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

Information Builders