FORMATTED-TIME
説明
FORMATTED-TIME 関数は、標準の数値時刻形式で指定された時刻に基づき、時刻の文字列を要求された形式で返す。この関数の型は、次のように argument-1 の型に依存する。
| argument-1 の型 | 関数の型 |
|---|---|
| 英数字 | 英数字 |
| 各国文字 | 各国文字 |
| UTF-8 | UTF-8 |
一般形式
FUNCTION FORMATTED-TIME (argument-1, argument-2,[argument-3])
引数
- argument-1 は、字類が英数字、UTF-8、または各国文字の定数とし、時刻形式を含むものとする。詳細については、「日付と時刻の形式」を参照。
- argument-2 は、深夜 0 時から経過した秒数として時刻を表す標準の数値時刻形式の値でなければならない。詳細については、「日付と時刻の形式」の「標準の数値時刻形式」を参照。
- argument-3 は、指定する場合、協定世界時 (UTC) からのオフセットを分単位で表す整数とする。大きさは 1439 (1 日より 1 分短い値) 以下でなければならない。「日付と時刻の形式」の「UTC オフセット値」を参照。
- argument-1 の形式が UTC またはオフセット時間を要求しない場合、argument-3 を指定してはならない。argument-1 の形式が UTC またはオフセット時間を要求するが、argument-3 を指定しない場合、関数の評価時にオフセット値 0 が想定される。
戻り値
- 返却値は、argument-1 に対応する形式で、argument-2 の時刻を含む文字列となる。
- argument-1 の形式が、UTC で表された返却値を要求する場合、argument-2 のローカル時刻は argument-3 のオフセットで調整される。
- argument-1 の形式が、オフセット時間で表された返却値を要求する場合、argument-2 の値は返却値の時刻部分で直接表され、argument-3 の UTC からのオフセットは返却値のオフセット部分で直接表される。