DateTimeItem

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

継承

SheetItem

インスタンスプロパティ

value

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  // 値を変更
  dateTimeItem.value = "2024/12/31 11:40";

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

date

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  // 値を変更
  dateTimeItem.date = "2024/12/31";

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

year

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

month

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

day

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

time

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  // 値を変更
  dateTimeItem.time = "12:30";

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

hour

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

minute

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

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

インスタンスメソッド

setValue

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

構文

setValue(dateTime);

引数

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

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

isFulfilled

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

構文

isFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.isFulfilled();

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

isEmpty

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

構文

isEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.isEmpty();

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

isBefore

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

構文

isBefore(dateTime);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.isBefore("2024/12/20 12:40");

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

isAfter

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

構文

isAfter(dateTime);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.isAfter("2024/12/20  12:40");

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

isBetween

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

構文

isBetween(beforeDatedTime, afterDateTime);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );
  // 初期値を確認
  console.log("初期値:", dateTimeItem.value); // 初期値: 2024/12/18  12:40

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

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

setDate

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

構文

setDate(date);

引数

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

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  // 値を変更
  dateTimeItem.setDate("2024/12/31");

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

setYear

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

構文

setYear(year);

引数

year
年を示す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

setMonth

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

構文

setMonth(month);

引数

month
月を示す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

setDay

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

構文

setDay(day);

引数

day
日を表す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

dateIsFulfilled

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

構文

dateIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.dateIsFulfilled();

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

dateIsEmpty

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

構文

dateIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.dateIsEmpty();

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

dateIsBefore

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

構文

dateIsBefore(date);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.dateIsBefore("2024/12/20");

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

dateIsAfter

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

構文

dateIsAfter(date);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.dateIsAfter("2024/12/20");

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

dateIsBetween

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

構文

dateIsBetween(beforeDate, afterDate);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );
  // 初期値を確認
  console.log("初期値:", dateTimeItem.date); // 初期値: 2024/12/18

  const result = dateTimeItem.dateIsBetween("2024/12/15", "2024/12/20");

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

setTime

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

構文

setTime(time);

引数

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

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  // 値を変更
  dateTimeItem.setTime("12:30");

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

setHour

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

構文

setHour(hour);

引数

hour
時を示す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

setMinute

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

構文

setMinute(minute);

引数

minute
分を示す数値です。

返値

なし

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

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

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

timeIsFulfilled

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

構文

timeIsFulfilled();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.timeIsFulfilled();

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

timeIsEmpty

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

構文

timeIsEmpty();

引数

なし

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.timeIsEmpty();

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

timeIsBefore

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

構文

timeIsBefore(time);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.timeIsBefore("12:40");

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

timeIsAfter

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

構文

timeIsAfter(time);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );

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

  const result = dateTimeItem.timeIsAfter("12:40");

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

timeIsBetween

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

構文

timeIsBetween(beforeTime, afterTime);

引数

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

返値

真偽値

例

esmJSPlugin.screen.sheetSave("customer").onSheetItemsMounted(function (SheetSaveScreen) {
  const dateTimeItem = SheetSaveScreen.getSheetItem(
    "customers.customer.type_datetime1"
  );
  // 初期値を確認
  console.log("初期値:", dateTimeItem.time); // 初期値: 12:30

  const result = dateTimeItem.timeIsBetween("12:35", "12:40");

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

関連情報