JP1 Version 8 JP1/Script(UNIX(R)用)

[目次][用語][索引][前へ][次へ]

CalcTime(指定した時刻に加算減算を行う)

機能

指定した時刻に,指定した時,分,または秒を足したり引いたりした時刻を返します。

形式

CalcTime ( Time , Calc , 〔Hours〕 , 〔Minutes〕 , 〔Seconds〕 〔, DaysBuff〕 )

指定項目

Time

時刻をhh:mm:ssの形式で指定します。

hhに存在しない不正な値を指定した場合は,エラーになります。

mmとssに存在しない不正な値を指定した場合は,存在する時刻に置き換えて結果を返します。例えば,19:00:61(存在しない時刻)を指定した場合,19:01:01(存在する時刻)に置き換えます。

Calc

演算方法を次の値で指定します。

意味
Minus Timeで指定した時刻から,HoursMinutesSecondsで指定した時,分,秒を引いた日付を返します(減算)。
Plus Timeで指定した時刻に,HoursMinutesSecondsで指定した時,分,秒を足した日付を返します(加算)。

Hours

時を0以上の数値,または値を格納した変数名で指定します。

この値は省略できます。省略した場合,0を仮定します。

Minutes

分を0以上の数値,または値を格納した変数名で指定します。

この値は省略できます。省略した場合,0を仮定します。

Seconds

秒を0以上の数値,または値を格納した変数名で指定します。

この値は省略できます。省略した場合,0を仮定します。

DaysBuff

Timeで指定した時刻を基点として求めた時刻が,日を超えた回数を受け取るための変数名を指定します。日を超えなかった場合は,0を受け取ります。この変数名の指定は省略できます。

説明

指定した時刻に,指定した時,分,または秒を足したり引いたりした時刻を求め,求めた時刻を hh:mm:ss の形式で返します。

エラーが発生した場合は,長さ0の文字列("")を返します。

' 現在の時刻から7時間45分後の時間を求める。
Dim  resTime ,resdate ,daysBuff
resTime = CalcTime ( Time() ,Plus ,7 ,45 , ,daysBuff )
resDate = CalcDate ( Date() , Plus , , ,daysBuff )