Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script
Retornar a Página Principal
Uma função definida pelo sistema que retorna à hora atual.
FUNCTION $Now: TIME;
VARIABLES t: Time; ACTIONS t:=$Now;
Uma função definida pelo sistema que retorna à data atual.
FUNCTION $Today: DATE;
VARIABLES d: Date; ACTIONS d:=$Today;
Inclui dias, meses e anos em uma data.
FUNCTION DateAdd (VAL d: DATE, VAL n: INTEGER [,$DAYS|$MONTHS|$YEARS] ): DATE;
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. |
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.
dueDate := DateAdd(billingDate, 30);
O resultado do cálculo é retornado.
Calcula a diferença entre duas datas.
FUNCTION DateDif (VAL day1: DATE, VAL day2: DATE [,$DAYS|$MONTHS|$YEARS] ): INTEGER;
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. |
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.
VARIABLES i: INTEGER; ACTIONS i:= DateDif ($Today,{1,1,1998}: DATE,$Days); (* calcula quantos dias ele tem desde 1/1/1998 *)
DateAdd
Inspeciona ou altera o formato do texto padrão para os valores de data.
FUNCTION DateFormat [ ( VAL format: INTEGER ) ] : INTEGER;
Nome do Argumento | Descrição |
format | Se fornecido, este argumento substituirá o formato padrão |
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."
CONSTANTS oracleDate IS $FmtDateYearMonthDay + $FmtDateTruncateCentury + $FmtDateDashSeparators + $FmtDateNamedMonth + $FmtDateShortNames + $FmtDateAllCaps + $FmtZeroPad; VARIABLES oldFormat: INTEGER; ACTIONS oldFormat := DateFormat (oracleFormat); ... DateFormat (oldFormat); END;
Inclui segundos, minutos ou horas em uma hora nas unidades especificadas.
FUNCTION TimeAdd (VAL t: TIME, VAL n: INTEGER [, $SECONDS|$MINUTES|$HOURS] ): TIME;
Nome do Argumento | Descrição |
t | A hora original. |
n | Quantidade de hora incluída. As opções são:
As unidades padrão nas quais a soma de t+n é retornada é $SECONDS. |
TimeAdd
retorna a nova hora nas unidades especificadas.Retorna a diferença entre as dias horas em horas, minutos ou segundos.
FUNCTION TimeDif (VAL t1, t2: TIME [,$SECONDS|$MINUTES|$HOURS] ): INTEGER;
Nome do Argumento | Descrição |
t1 | A expressão de hora. |
t2 | A expressão de hora. As opções são:
O padrão para unidades nas quais a diferença devem ser retornadas é $SECONDS. |
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.
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ódigo de Retorno | Descrição |
any | A diferença de hora. |
Inspeciona ou altera o formato do texto padrão para os valores de hora.
FUNCTION TimeFormat [ ( VAL format: INTEGER ) ] : INTEGER;
Nome do Argumento | Descrição |
format | Se fornecido, este argumento substituirá o padrão. |
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.)
VARIABLES oldFormat: INTEGER; ACTIONS oldFormat := TimeFormat(BitOr($FmtTimeAMPM, $FmtTimeWithoutSeconds)); ... TimeFormat(oldFormat); END;
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