DateItem

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

継承

SheetItem

インスタンスプロパティ

value

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

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.value = "2024/12/31";

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

year

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

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.year = 2025;

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

month

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

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.month = 12;

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

day

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

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.day = 31;

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

インスタンスメソッド

setValue

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

構文

setValue(date);

引数

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

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.setValue("2024/12/31");

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

setYear

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

構文

setYear(year);

引数

year
年を示す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.setYear(2025);

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

setMonth

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

構文

setMonth(month);

引数

month
月を示す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.setMonth(11);

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

setDay

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

構文

setDay(day);

引数

day
日を表す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  // 値を変更
  dateItem.setDay(20);

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

isFulfilled

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

構文

isFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  const result = dateItem.isFulfilled();

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

isEmpty

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

構文

isEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  const result = dateItem.isEmpty();

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

isBefore

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

構文

isBefore(date);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  const result = dateItem.isBefore("2024/12/20");

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

isAfter

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

構文

isAfter(date);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );

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

  const result = dateItem.isAfter("2024/12/20");

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

isBetween

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

構文

isBetween(beforeDate, afterDate);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onMounted((SheetSaveScreen) => {
  const dateItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_date1"
  );
  // 初期値を確認
  console.log("初期値:", dateItem.value); // 初期値: 2024/12/18

  const result = dateItem.isBetween("2024/12/15", "2024/12/20");

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

関連情報

• SheetItem