TimeItem

TimeItem クラスは時間型項目に対して操作を行うためのメンバーを持っています。

継承

SheetItem

インスタンスプロパティ

value

入力されている時間の文字列です。HH:MM の形式で表現されます。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: "11:30"

  // 値を変更
  timeItem.value = "12:30";

  // 変更後の値を確認
  console.log("変更後:", timeItem.value); // 変更後: "12:30"
});

hour

入力されている時を示す数値です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.hour); // 初期値: 11

  // 値を変更
  timeItem.hour = 12;

  // 変更後の値を確認
  console.log("変更後:", timeItem.hour); // 変更後: 12
});

minute

入力されている分を示す数値です。

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.minute); // 初期値: 30

  // 値を変更
  timeItem.minute = 40;

  // 変更後の値を確認
  console.log("変更後:", timeItem.minute); // 変更後: 40
});

インスタンスメソッド

setValue

HH:MM の形式の文字列を受け取り、valueの値を変更します。

構文

setValue(time);

引数

time
HH:MM の形式の文字列です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: "11:30"

  // 値を変更
  timeItem.setValue("12:30");

  // 変更後の値を確認
  console.log("変更後:", timeItem.value); // 変更後: "12:30"
});

setHour

数値を受け取り、hourの値を変更します。

構文

setHour(hour);

引数

hour
時を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.hour); // 初期値: 11

  // 値を変更
  timeItem.setHour(12);

  // 変更後の値を確認
  console.log("変更後:", timeItem.hour); // 変更後: 12
});

setMinute

数値を受け取り、minuteの値を変更します。

構文

setMinute(minute);

引数

minute
分を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.minute); // 初期値: 30

  // 値を変更
  timeItem.setMinute(40);

  // 変更後の値を確認
  console.log("変更後:", timeItem.minute); // 変更後: 40
});

isFulfilled

正しい時間が入力されているかどうかの真偽値を返します。

構文

isFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: hoge

  const result = timeItem.isFulfilled();

  console.log("正しい時間か:", result); // 正しい時間かfalse
});

isEmpty

時間が入力されていないかどうかの真偽値を返します。

構文

isEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: ''

  const result = timeItem.isEmpty();

  console.log("時間が空かどうか:", result); // 時間が空かどうか:true
});

isBefore

value が指定した時間より前の時間かどうかの真偽値を返します。

構文

isBefore(time);

引数

time
比較対象の時間 (HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: 12:30

  const result = timeItem.isBefore("12:40");

  console.log("指定時間より前か:", result); // 指定時間より前か:true
});

isAfter

value が指定した時間より後の時間かどうかの真偽値を返します。

構文

isAfter(time);

引数

time
比較対象の時間 (HH:MM の形式)。

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );

  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: 12:30

  const result = timeItem.isAfter("12:40");

  console.log("指定時間より後か:", result); // 指定時間より後か:false
});

isBetween

value が指定した時間の間にあるかどうかの真偽値を返します。

構文

isBetween(beforeTime, afterTime);

引数

beforeTime
範囲の開始時間 (HH:MM の形式)
afterTime
範囲の終了時間 (HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("customer").onSheetItemsMounted((SheetSaveScreen) => {
  const timeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_time1"
  );
  // 初期値を確認
  console.log("初期値:", timeItem.value); // 初期値: 12:30

  const result = timeItem.isBetween("12:35", "12:40");

  console.log("指定範囲内か:", result); // 指定範囲内か:false
});

関連情報

• SheetItem
• SheetSaveScreen