Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script

Manipulação de Data e Hora

Retornar a Página Principal


$Now

Descrição

Uma função definida pelo sistema que retorna à hora atual.

Sintaxe

 FUNCTION $Now: TIME;

Exemplo

  VARIABLES
 t: Time;
 ACTIONS
 t:=$Now;

$Today

Descrição

Uma função definida pelo sistema que retorna à data atual.

Sintaxe

 FUNCTION $Today: DATE;

Exemplo

  VARIABLES
 d: Date;
 ACTIONS
 d:=$Today;

DateAdd

Descrição

Inclui dias, meses e anos em uma data.

Sintaxe

 FUNCTION DateAdd (VAL d: DATE, VAL n: INTEGER [,$DAYS|$MONTHS|$YEARS] ): DATE;

Notas do Argumento

Nome do Argumento Descrição
d A data na qual n unidades devem ser incluídas.
n O número a ser incluído. Este deve estar em uma das unidades definidas.
$DAYS
$MONTHS
$YEARS
$DAYS, $MONTHS, $YEARS As unidades utilizadas para expressar n. Se este argumento for omitido, o padrão será $DAYS.

Notas

Esta função retorna uma data que é o número do argumento n de dias, meses ou anos a partir da data do argumento d. Se o argumento n for positivo, o resultado seguirá a data fornecida. Se o argumento n for negativo irá anteceder a data fornecida.

Os resultados são ajustados para desempenhar datas válidas. Quando o parâmetro de unidades é $MONTHS, o resultado é ajustado para permitir meses de dias 28 e 30.

Quando o parâmetro de unidades é $YEARS, o resultado é ajustado para permitir anos bissextos. Por exemplo, se você incluir um mês em uma data base de 31 de Janeiro de 1999, o resultado será 3 de Março de 1999, não 31 de Fevereiro de 1999.

Exemplo

dueDate := DateAdd(billingDate, 30);

Códigos de Retorno

O resultado do cálculo é retornado.

Consulte também


DateDif

Descrição

Calcula a diferença entre duas datas.

Sintaxe

FUNCTION DateDif (VAL day1: DATE,
                  VAL day2: DATE [,$DAYS|$MONTHS|$YEARS]
                    ): INTEGER;

Notas do Argumento

Nome do Argumento Descrição
day1 Uma expressão de data.
day2 Uma expressão de data.
$DAYS, $MONTHS ou $YEARS As unidades utilizadas para expressar a diferença entre datas. Se este argumento for omitido, o padrão será $DAYS.

Notas

DateDif calcula a diferença entre duas datas subtraindo o argumento day2 a partir do argumento day1 e retorna um resultado de número inteiro em dias, meses ou anos.

Nota: Se o argumento day2 for mais recente do que o argumento day1, um número negativo será retornado.

Exemplo

 VARIABLES
        i: INTEGER;
 ACTIONS
i:= DateDif ($Today,{1,1,1998}:
             DATE,$Days);
(* calcula quantos dias ele tem desde 1/1/1998 *)

Consulte também

DateAdd


DateFormat

Descrição

Inspeciona ou altera o formato do texto padrão para os valores de data.

Sintaxe

FUNCTION DateFormat [ ( VAL format: INTEGER ) ] : INTEGER;

Notas do Argumento

Nome do Argumento Descrição
format Se fornecido, este argumento substituirá o formato padrão

Notas

Esta função é utilizada para inspecionar e alterar o formato padrão, quando um valor de data é convertido em uma forma de texto. Se chamado sem argumento, DateFormat retornará o formato de data padrão atual.

Se um argumento for fornecido, este valor se tornará o novo formato de data padrão. DateFormat retorna o formato de data padrão antigo.

Nota: Para uma lista de constantes de formato de exibição, consulte "Sinalizadores de Formato DataType."

Exemplo

CONSTANTS
oracleDate IS $FmtDateYearMonthDay
 + $FmtDateTruncateCentury
 + $FmtDateDashSeparators
 + $FmtDateNamedMonth
 + $FmtDateShortNames
 + $FmtDateAllCaps
 + $FmtZeroPad;
 VARIABLES
oldFormat: INTEGER;

 ACTIONS
oldFormat := DateFormat
(oracleFormat);

...

DateFormat (oldFormat);
              END;

Consulte também


TimeAdd

Descrição

Inclui segundos, minutos ou horas em uma hora nas unidades especificadas.

Sintaxe

FUNCTION TimeAdd (VAL t: TIME,
                  VAL n: INTEGER [, $SECONDS|$MINUTES|$HOURS]
                  ): TIME;

Notas do Argumento

Nome do Argumento Descrição
t A hora original.
n Quantidade de hora incluída. As opções são:
  • $SECONDS
  • $MINUTES
  • $HOURS

As unidades padrão nas quais a soma de t+n é retornada é $SECONDS.

Códigos de Retorno

TimeAdd retorna a nova hora nas unidades especificadas.


TimeDif

Descrição

Retorna a diferença entre as dias horas em horas, minutos ou segundos.

Sintaxe

FUNCTION TimeDif (VAL t1, t2: TIME
                  [,$SECONDS|$MINUTES|$HOURS]
                    ): INTEGER;

Notas do Argumento

Nome do Argumento Descrição
t1 A expressão de hora.
t2 A expressão de hora. As opções são:
  • $SECONDS
  • $MINUTES
  • $HOURS

O padrão para unidades nas quais a diferença devem ser retornadas é $SECONDS.

Notas

TimeDif calcula a diferença entre as duas expressões de hora e retorna a diferença. O segundo argumento é subtraído do primeiro (time_1-time_2) e é expresso em horas, minutos ou segundos, dependendo da constante do sistema transmitida como o terceiro argumento.

Quando o terceiro argumento é $MINUTES ou $HOURS, o resultado é truncado. Assim, a diferença entre {7,0,0}:TIME e {8,59,59}:TIME é 7199 segundos ou 119 minutos ou 1 hora.

Exemplo

 VARIABLES
        i: INTEGER;
 ACTIONS
 i:=TimeDif($Now,{8,30,0}: TIME,$Minutes);
 (* i = número de minutos desde 8:30 esta manhã *)
 i:=TimeDif ($Now, TimeAdd({8,30,0}:TIME, 30, $MINUTES),
$HOURS);
 (* i=número de horas desde 8:30 da manhã, arredondado para *)
 (* a próxima hora *)

Códigos de Retorno

Código de Retorno Descrição
any A diferença de hora.

TimeFormat

Descrição

Inspeciona ou altera o formato do texto padrão para os valores de hora.

Sintaxe

FUNCTION TimeFormat [ ( VAL format: INTEGER ) ] : INTEGER;

Notas do Argumento

Nome do Argumento Descrição
format Se fornecido, este argumento substituirá o padrão.

Notas

TimeFormat inspeciona ou altera o formato padrão sempre que um valor deste tipo é convertido em uma forma de texto.

Se chamado sem argumento, TimeFormat retornará o padrão existente. Se um argumento for fornecido, este valor se tornará o novo padrão. (O padrão antigo é retornado.)

Exemplo

 VARIABLES
oldFormat: INTEGER;
 ACTIONS
oldFormat :=
TimeFormat(BitOr($FmtTimeAMPM,
 $FmtTimeWithoutSeconds));

...

TimeFormat(oldFormat);
              END;

Consulte também

Para obter uma explicação de formatos de exibição, consulte Sinalizadores de Formato de Tipo de Data.


Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script

Retornar à Página Principal

Copyright