VP Get value コマンドは指定されたセルのレンジからセルの値を取得します。
rangeObj 引数には、値を取得したいセルのレンジを渡します。
返されたオブジェクトにはvalue プロパティと、日付値の場合に返されるtime プロパティが格納されています:
プロパティ | 型 | 詳細 |
value | 倍長整数、実数、ブール、テキスト、日付 | rangeObj 引数のレンジ内にある値(ただし時間型を除く) |
time | 実数 | rangeObj 引数の値がjs 日付型だった場合の時間値(秒単位) |
返されたオブジェクトに日付型あるいは時間型が含まれている場合、"日付時間"として扱われ、以下のように補完されます:
- 時間値 - 日付部分はdd/MM/yyyy フォーマットの、1899年12月30日(30/12/1899)として補完されます。
- 日付値 - 時間部分はHH:mm:ss フォーマットの、真夜中(00:00:00)として補完されます。
rangeObj 引数のレンジが複数のセル/複数のレンジを含む場合、最初のセルの値が返されます。またコマンドは、セルがからの場合にはNull オブジェクトを返します。