現在の時刻を得る。
gettime <strvar> [<format>]
現在の時刻を文字列変数 <strvar> に <format> に従った形式で格納する。書式は strftime と同じ物が使える。
formatが省略された場合、格納される形式は"HH:MM:SS"となる。(<format> に %H:%M:%S を指定したのと同じ)
formatが指定されたgettimeは、同じformatが指定されたgetdateと動作が等しくなる。
このコマンドの実行結果はシステム変数 result に格納される。変数 result の値の意味は以下のとおり。
| 値 | 意味 |
|---|---|
| 0 | 正常に値が <strvar> に格納された。 |
| 1 | 生成された文字列の長さが上限(255文字)を超えた等の理由で、<strvar> への値の格納が正常に行われなかった。 |
| 2 | <format> の指定が不正である。 |
;現在の日付をtimestrに格納。形式はHH:MM:SS。
gettime timestr
;現在の日時を元にしてログファイル名を生成し、変数logfileに格納。形式はlog-YYYYMMDD-HHMMSS.txt
gettime logfile "log-%Y%m%d-%H%M%S.txt"