ScheduleTimeItem

ScheduleItem クラスはスケジュールアプリの日時に対して操作を行うためのメンバーを持っています。

継承

SheetItem

インスタンスプロパティ

allDay

終日の予定かどうかを示す真偽値です。

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.allDay); // 初期値: false

  // 値を変更
  scheduleTimeItem.allDay = true;

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.allDay); // 変更後: true
});

beginDatetime

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDatetime); // 初期値: "2024/12/18 11:30"

  // 値を変更
  scheduleTimeItem.beginDatetime = "2024/12/31 11:40";

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginDatetime); // 変更後: "2024/12/31 11:40"
});

beginDate

入力されている日付の文字列です。YYYY/MM/DD の形式で表現されます。

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDate); // 初期値: "2024/12/18"

  // 値を変更
  scheduleTimeItem.beginDate = "2024/12/31";

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginDate); // 変更後: "2024/12/31"
});

beginYear

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginYear); // 初期値: 2024

  // 値を変更
  scheduleTimeItem.beginYear = 2025;

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginYear); // 変更後: 2025
});

beginMonth

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginMonth); // 初期値: 10

  // 値を変更
  scheduleTimeItem.beginMonth = 12;

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

beginDay

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDay); // 初期値: 18

  // 値を変更
  scheduleTimeItem.beginDay = 31;

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginDay); // 変更後: 31
});

beginTime

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.beginTime = "12:30";

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

beginHour

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.beginHour = 12;

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

beginMinute

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.beginMinute = 40;

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

endDatetime

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDatetime); // 初期値: "2024/12/18 11:30"

  // 値を変更
  scheduleTimeItem.endDatetime = "2024/12/31 11:40";

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endDatetime); // 変更後: "2024/12/31 11:40"
});

endDate

入力されている日付の文字列です。YYYY/MM/DD の形式で表現されます。

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDate); // 初期値: "2024/12/18"

  // 値を変更
  scheduleTimeItem.endDate = "2024/12/31";

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endDate); // 変更後: "2024/12/31"
});

endYear

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endYear); // 初期値: 2024

  // 値を変更
  scheduleTimeItem.endYear = 2025;

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endYear); // 変更後: 2025
});

endMonth

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endMonth); // 初期値: 10

  // 値を変更
  scheduleTimeItem.endMonth = 12;

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

endDay

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDay); // 初期値: 18

  // 値を変更
  scheduleTimeItem.endDay = 31;

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endDay); // 変更後: 31
});

endTime

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.endTime = "12:30";

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

endHour

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.endHour = 12;

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

endMinute

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

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.endMinute = 40;

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

インスタンスメソッド

setAllDay

真偽値を受け取り、allDayの値を変更します。

構文

setAllDay(boolean);

引数

boolean
変更する allDay の真偽値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.allDay); // 初期値: false

  // 値を変更
  scheduleTimeItem.setAllDay(true);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.allDay); // 変更後: true
});

isAllDay

終日の予定かどうかの真偽値を返します。

構文

isAllDay();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.allDay); // 初期値: false

  const result = scheduleTimeItem.isAllDay();

  // 変更後の値を確認
  console.log("結果:", result); // 結果:: false
});

rangeSpanOverDays

beginDatetimeとendDatetime が日をまたいでいるかどうかを判定します。

構文

rangeSpanOverDays();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18"
  console.log("endDate:", scheduleTimeItem.beginDatetime); // endDate: "2024/12/19"

  const result = scheduleTimeItem.rangeSpanOverDays();

  // 変更後の値を確認
  console.log("日をまたいでいるかどうか:", result); // 日をまたいでいるかどうか: true
});

rangeIncludes

beginDatetimeとendDatetime の間に指定した日時が含まれているかを判定します。

構文

rangeIncludes(datetime);

引数

datetime
対象の日時 (YYYY/MM/DD HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18 12:00"
  console.log("endDate:", scheduleTimeItem.endDatetime); // endDate: "2024/12/20 12:00"

  const result = scheduleTimeItem.rangeIncludes("2024/12/19 12:00");

  console.log("対象日時が含まれているかどうか:", result); // 対象日時が含まれているかどうか: true
});

rangeLengthEqualsTo

beginDatetimeとendDatetime の差分が指定された数値と同じかどうかを判定します。
差分は切り捨てられます。例えばtypeにDAYを指定していて、beginDatetimeが2025/1/1 9:00でendDatetimeが2025/1/3 8:59の場合、差分は 1 となりrangeLengthEqualsTo(1, "DAY")はtrueとなります。

構文

rangeLengthEqualsTo(number);
rangeLengthEqualsTo(number, type);

引数

number
比較対象の数値です。

type
判定する時間の単位を指定します。以下のいずれかを選択してください:

• DAY (日)
• HOUR (時間)
• MINUTE (分)

デフォルトはDAYです。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18 12:00"
  console.log("endDate:", scheduleTimeItem.endDatetime); // endDate: "2024/12/18 13:00"

  const result = scheduleTimeItem.rangeLengthEqualsTo(60, "Day");

  console.log("60分かどうか:", result); // 60分どうか: true
});

rangeLengthIsGreaterThan

beginDatetimeとendDatetime の差分が指定した数値より大きいかどうかを判定します。
差分は切り捨てられます。例えばtypeにDAYを指定していて、beginDatetimeが2025/1/1 9:00でendDatetimeが2025/1/3 8:59の場合、差分は 1 となりrangeLengthIsGreaterThan(1, "DAY")はfalseとなります。

構文

rangeLengthIsGreaterThan(number);
rangeLengthIsGreaterThan(number, type);

引数

number
比較対象の数値です。

type
判定する時間の単位を指定します。以下のいずれかを選択してください:

• DAY (日)
• HOUR (時間)
• MINUTE (分)

デフォルトはDAYです。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18 12:00"
  console.log("endDate:", scheduleTimeItem.endDatetime); // endDate: "2024/12/20 13:00"

  const result = scheduleTimeItem.rangeLengthIsGreaterThan(30, "HOUR");

  console.log("30時間より大きいか:", result); // 30時間より大きいか: true
});

rangeLengthIsGreaterThanOrEqual

beginDatetimeとendDatetime の差分が指定した数値以上かどうかを判定します。
差分は切り捨てられます。例えばtypeにDAYを指定していて、beginDatetimeが2025/1/1 9:00でendDatetimeが2025/1/3 8:59の場合、差分は 1 となりrangeLengthIsGreaterThanOrEqual(2, "DAY")はfalseとなります。

構文

rangeLengthIsGreaterThanOrEqual(number);
rangeLengthIsGreaterThanOrEqual(number, type);

引数

number
比較対象の数値です。

type
判定する時間の単位を指定します。以下のいずれかを選択してください:

• DAY (日)
• HOUR (時間)
• MINUTE (分)

デフォルトはDAYです。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18 12:00"
  console.log("endDate:", scheduleTimeItem.endDatetime); // endDate: "2024/12/20 13:00"

  const result = scheduleTimeItem.rangeLengthIsGreaterThanOrEqual(30, "HOUR");

  console.log("30時間以上か:", result); // 30時間以上か: true
})

rangeLengthIsLessThan

beginDatetimeとendDatetime の差分が指定した数値より小さいかどうかを判定します。
差分は切り捨てられます。例えばtypeにDAYを指定していて、beginDatetimeが2025/1/1 9:00でendDatetimeが2025/1/3 8:59の場合、差分は 1 となりrangeLengthIsLessThan(1, "DAY")はfalseとなります。

構文

rangeLengthIsLessThan(number);
rangeLengthIsLessThan(number, type);

引数

number
比較対象の数値です。

type
判定する時間の単位を指定します。以下のいずれかを選択してください:

• DAY (日)
• HOUR (時間)
• MINUTE (分)

デフォルトはDAYです。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18 12:00"
  console.log("endDate:", scheduleTimeItem.endDatetime); // endDate: "2024/12/20 12:00"

  const result = scheduleTimeItem.rangeLengthIsLessThan(7, "DAY");

  console.log("7日未満か:", result); // 7日未満か: true
});

rangeLengthIsLessThanOrEqual

beginDatetimeとendDatetime の差分が指定した数値以下かどうかを判定します。
差分は切り捨てられます。例えばtypeにDAYを指定していて、beginDatetimeが2025/1/1 9:00でendDatetimeが2025/1/3 8:59の場合、差分は 1 となりrangeLengthIsLessThanOrEqual(0, "DAY")はfalseとなります。

構文

rangeLengthIsLessThanOrEqual(number);
rangeLengthIsLessThanOrEqual(number, type);

引数

number
比較対象の数値です。

type
判定する時間の単位を指定します。以下のいずれかを選択してください:

• DAY (日)
• HOUR (時間)
• MINUTE (分)

デフォルトはDAYです。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("beginDate:", scheduleTimeItem.beginDatetime); // beginDate: "2024/12/18 12:00"
  console.log("endDate:", scheduleTimeItem.endDatetime); // endDate: "2024/12/20 12:00"

  const result = scheduleTimeItem.rangeLengthIsLessThanOrEqual(7);

  console.log("7日以下か:", result); // 7日以下か: true
});

setBeginDatetime

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

構文

setBeginDatetime(dateTime);

引数

dateTime
YYYY/MM/DD HH:MM の形式の文字列です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDatetime); // 初期値: "2024/12/18 11:30"

  // 値を変更
  scheduleTimeItem.setBeginDatetime("2024/12/31 11:40");

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginDatetime); // 変更後: "2024/12/31 11:40"
});

beginDatetimeIsFulfilled

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

構文

beginDatetimeIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginDatetimeIsFulfilled();

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

beginDatetimeIsEmpty

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

構文

beginDatetimeIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginDatetimeIsEmpty();

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

beginDatetimeIsBefore

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

構文

beginDatetimeIsBefore(dateTime);

引数

dateTime
比較対象の日時 (YYYY/MM/DD HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDatetime); // 初期値: 2024/12/18  12:40

  const result = scheduleTimeItem.beginDatetimeIsBefore("2024/12/20 12:40");

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

beginDatetimeIsAfter

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

構文

beginDatetimeIsAfter(dateTime);

引数

dateTime
比較対象の日時 (YYYY/MM/DD HH:MM の形式)。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDatetime); // 初期値: 2024/12/18  12:40

  const result = scheduleTimeItem.beginDatetimeIsAfter("2024/12/20  12:40");

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

beginDatetimeIsBetween

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

構文

beginDatetimeIsBetween(beforeDatedTime, afterDateTime);

引数

beforeDateTime
範囲の開始日 (YYYY/MM/DD HH:MM の形式)
afterDateTime
範囲の終了日 (YYYY/MM/DD HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDatetime); // 初期値: 2024/12/18  12:40

  const result = scheduleTimeItem.beginDatetimeIsBetween(
    "2024/12/15 12:40",
    "2024/12/20 12:50"
  );

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

setBeginDate

YYYY/MM/DD の形式の文字列を受け取り、BeginDate の値を変更します。

構文

setBeginDate(date);

引数

date
YYYY/MM/DD の形式の文字列です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDate); // 初期値: "2024/12/18"

  // 値を変更
  scheduleTimeItem.setBeginDate("2024/12/31");

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginDate); // 変更後: "2024/12/31"
});

setBeginYear

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

構文

setBeginYear(year);

引数

year
年を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginYear); // 初期値: 2024

  // 値を変更
  scheduleTimeItem.setBeginYear(2025);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginYear); // 変更後: 2025
});

setBeginMonth

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

構文

setBeginMonth(month);

引数

month
月を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginMonth); // 初期値: 12

  // 値を変更
  scheduleTimeItem.setBeginMonth(11);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginMonth); // 変更後: 11
});

setBeginDay

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

構文

setBeginDay(day);

引数

day
日を表す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDay); // 初期値: 18

  // 値を変更
  scheduleTimeItem.setBeginDay(20);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.beginDay); // 変更後: 20
});

beginDateIsFulfilled

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

構文

beginDateIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginDateIsFulfilled();

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

beginDateIsEmpty

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

構文

beginDateIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginDateIsEmpty();

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

beginDateIsBefore

beginDate が指定した日付より前の日付かどうかの真偽値を返します。

構文

beginDateIsBefore(date);

引数

date
比較対象の日付 (YYYY/MM/DD の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDate); // 初期値: 2024/12/18

  const result = scheduleTimeItem.beginDateIsBefore("2024/12/20");

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

beginDateIsAfter

beginDate が指定した日付より後の日付かどうかの真偽値を返します。

構文

beginDateIsAfter(date);

引数

date
比較対象の日付 (YYYY/MM/DD の形式)。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDate); // 初期値: 2024/12/18

  const result = scheduleTimeItem.beginDateIsAfter("2024/12/20");

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

beginDateIsBetween

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

構文

beginDateIsBetween(beforeDate, afterDate);

引数

beforeDate
範囲の開始日 (YYYY/MM/DD の形式)
afterDate
範囲の終了日 (YYYY/MM/DD の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginDate); // 初期値: 2024/12/18

  const result = scheduleTimeItem.beginDateIsBetween(
    "2024/12/15",
    "2024/12/20"
  );

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

setBeginTime

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

構文

setBeginTime(time);

引数

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

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.setBeginTime("12:30");

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

setBeginHour

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

構文

setBeginHour(hour);

引数

hour
時を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.setBeginHour(12);

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

setBeginMinute

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

構文

setBeginMinute(minute);

引数

minute
分を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.setBeginMinute(40);

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

beginTimeIsFulfilled

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

構文

beginTimeIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginTimeIsFulfilled();

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

beginTimeIsEmpty

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

構文

beginTimeIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginTimeIsEmpty();

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

beginTimeIsBefore

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

構文

beginTimeIsBefore(time);

引数

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

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginTimeIsBefore("12:40");

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

beginTimeIsAfter

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

構文

beginTimeIsAfter(time);

引数

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

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.beginTimeIsAfter("12:40");

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

beginTimeIsBetween

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

構文

beginTimeIsBetween(beforeTime, afterTime);

引数

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

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.beginTime); // 初期値: 12:30

  const result = scheduleTimeItem.beginTimeIsBetween("12:35", "12:40");

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

setEndDatetime

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

構文

setEndDatetime(dateTime);

引数

dateTime
YYYY/MM/DD HH:MM の形式の文字列です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDatetime); // 初期値: "2024/12/18 11:30"

  // 値を変更
  scheduleTimeItem.setEndDatetime("2024/12/31 11:40");

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endDatetime); // 変更後: "2024/12/31 11:40"
});

endDatetimeIsFulfilled

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

構文

endDatetimeIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endDatetimeIsFulfilled();

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

endDatetimeIsEmpty

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

構文

endDatetimeIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endDatetimeIsEmpty();

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

endDatetimeIsBefore

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

構文

endDatetimeIsBefore(dateTime);

引数

dateTime
比較対象の日時 (YYYY/MM/DD HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDatetime); // 初期値: 2024/12/18  12:40

  const result = scheduleTimeItem.endDatetimeIsBefore("2024/12/20 12:40");

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

endDatetimeIsAfter

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

構文

endDatetimeIsAfter(dateTime);

引数

dateTime
比較対象の日時 (YYYY/MM/DD HH:MM の形式)。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDatetime); // 初期値: 2024/12/18  12:40

  const result = scheduleTimeItem.endDatetimeIsAfter("2024/12/20  12:40");

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

endDatetimeIsBetween

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

構文

endDatetimeIsBetween(beforeDatedTime, afterDateTime);

引数

beforeDateTime
範囲の開始日 (YYYY/MM/DD HH:MM の形式)
afterDateTime
範囲の終了日 (YYYY/MM/DD HH:MM の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDatetime); // 初期値: 2024/12/18  12:40

  const result = scheduleTimeItem.endDatetimeIsBetween(
    "2024/12/15 12:40",
    "2024/12/20 12:50"
  );

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

setEndDate

YYYY/MM/DD の形式の文字列を受け取り、endDate の値を変更します。

構文

setEndDate(date);

引数

date
YYYY/MM/DD の形式の文字列です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDate); // 初期値: "2024/12/18"

  // 値を変更
  scheduleTimeItem.setEndDate("2024/12/31");

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endDate); // 変更後: "2024/12/31"
});

setEndYear

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

構文

setEndYear(endYear);

引数

endYear
年を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endYear); // 初期値: 2024

  // 値を変更
  scheduleTimeItem.setEndYear(2025);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endYear); // 変更後: 2025
});

setEndMonth

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

構文

setEndMonth(endMonth);

引数

endMonth
月を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endMonth); // 初期値: 12

  // 値を変更
  scheduleTimeItem.setEndMonth(11);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endMonth); // 変更後: 11
});

setEndDay

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

構文

setEndDay(endDay);

引数

endDay
日を表す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDay); // 初期値: 18

  // 値を変更
  scheduleTimeItem.setEndDay(20);

  // 変更後の値を確認
  console.log("変更後:", scheduleTimeItem.endDay); // 変更後: 20
});

endDateIsFulfilled

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

構文

endDateIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endDateIsFulfilled();

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

endDateIsEmpty

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

構文

endDateIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endDateIsEmpty();

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

endDateIsBefore

endDate が指定した日付より前の日付かどうかの真偽値を返します。

構文

endDateIsBefore(date);

引数

date
比較対象の日付 (YYYY/MM/DD の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDate); // 初期値: 2024/12/18

  const result = scheduleTimeItem.endDateIsBefore("2024/12/20");

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

endDateIsAfter

endDate が指定した日付より後の日付かどうかの真偽値を返します。

構文

endDateIsAfter(date);

引数

date
比較対象の日付 (YYYY/MM/DD の形式)。

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDate); // 初期値: 2024/12/18

  const result = scheduleTimeItem.endDateIsAfter("2024/12/20");

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

endDateIsBetween

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

構文

endDateIsBetween(beforeDate, afterDate);

引数

beforeDate
範囲の開始日 (YYYY/MM/DD の形式)
afterDate
範囲の終了日 (YYYY/MM/DD の形式)

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endDate); // 初期値: 2024/12/18

  const result = scheduleTimeItem.endDateIsBetween("2024/12/15", "2024/12/20");

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

setEndTime

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

構文

setEndTime(time);

引数

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

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.setEndTime("12:30");

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

setEndHour

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

構文

setEndHour(hour);

引数

hour
時を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.setEndHour(12);

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

setEndMinute

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

構文

setEndMinute(minute);

引数

minute
分を示す数値です。

返値

なし

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  // 値を変更
  scheduleTimeItem.setEndMinute(40);

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

endTimeIsFulfilled

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

構文

endTimeIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endTimeIsFulfilled();

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

endTimeIsEmpty

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

構文

endTimeIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endTimeIsEmpty();

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

endTimeIsBefore

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

構文

endTimeIsBefore(time);

引数

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

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endTimeIsBefore("12:40");

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

endTimeIsAfter

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

構文

endTimeIsAfter(time);

引数

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

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );

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

  const result = scheduleTimeItem.endTimeIsAfter("12:40");

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

endTimeIsBetween

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

構文

endTimeIsBetween(beforeTime, afterTime);

引数

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

返値

真偽値

例

esmJSPlugin.sheetSave("schedule").onSheetItemsMounted((SheetSaveScreen) => {
  const scheduleTimeItem = SheetSaveScreen.getSheetItem(
    "calendar.schedule.datetime"
  );
  // 初期値を確認
  console.log("初期値:", scheduleTimeItem.endTime); // 初期値: 12:30

  const result = scheduleTimeItem.endTimeIsBetween("12:35", "12:40");

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

関連情報

• SheetItem
• SheetSaveScreen