Officeスクリプトでの変数の使い方 | let・varの違いと型指定のポイント

「Office スクリプトで変数を使いたいけれど、VBAとはどう違うのか分からない…」
そんな悩みを抱えていませんか？

・Office スクリプトで変数を使いたいけれど、どうしたらいいの？

・VBAで使っていた変数の型とOfficeスクリプトの違いが知りたい。

・データの種類ごとにどんな変数を使えばいいのか分からない。

今回は、Officeスクリプトの「変数」について
解説します！

この記事では、Officeスクリプトでの変数の使い方や、VBAとの違いを詳しく解説します。

Officeスクリプトの変数は、データを操作する上で欠かせない重要な役割を果たします。
VBAとの違いや、変数の型の使い分け方を学ぶことで、スクリプト作成がもっと簡単に！この記事を読めば、基本から応用まで理解できるようになります。

基本的な使い方から、実際の業務に役立つ応用例まで、初心者でもすぐに実践できる内容です。
ぜひ最後までお読みください。

【　この記事の概要　】

この記事を読むと「できるようになる」こと

この記事を読むことで、以下のことができるようになります。

Officeスクリプトの「変数」とは？

Officeスクリプトにおける変数は、プログラム内でデータを一時的に記憶し、操作するための「箱」です。

変数を使うことで、数値や文字列などのデータを効率的に処理できます。

なぜ変数を使うのか？

変数を使用することで、以下の利点があります。

VBAの変数との違いについて

「Officeスクリプト」と「VBA」の変数にはいくつか違いがあります。

Officeスクリプトでは、letやconstを使って変数を宣言し、型を指定することでプログラムの信頼性が向上します。

VBAではDimを使用し、型を明示する必要はありませんが、Officeスクリプトでは型指定が推奨されます。
これによりエラーを未然に防ぎやすく、信頼性の高いスクリプトを作成できます。

VBAの変数について気になる方は、別途詳しく解説した記事をご覧ください。

あわせて読みたい

エクセルVBAで変数を使いこなす方法 | 変数の基本から実践まで エクセルVBAを使用するにあたって、変数を使用する意味は何だろう？と悩んだことはありませんか？ お悩みポイント VBAをするにあたって、変数という言葉を初めて聞いた...

Officeスクリプトで「変数」の宣言方法 | 「let」「const」「var」で宣言

Officeスクリプトでは、変数の宣言に「let」「const」「var」といったキーワードを使用します。

それぞれのキーワードには異なる特性があり、適切に使い分けることで、効率的なスクリプトを作成できます。

Officeスクリプトでの変数の宣言方法｜基本のキーワード解説

「let」「const」「var」の使い分けについて解説します

Officeスクリプトで変数を宣言する際、let、const、varにはそれぞれ異なる特性があります。

適切に使い分けることで、スクリプトの柔軟性と信頼性が向上します。

変数の宣言例をご紹介

実際にOfficeスクリプトで変数を宣言する例を以下に示します。

let number: number;

const isCompleted: boolean = true;

Officeスクリプトにおける「変数の型」について

変数の型は、変数に格納するデータの種類を指定するもので、適切な型を使用することでプログラムの安定性が向上し、エラーを未然に防ぎます。

Officeスクリプトでは、変数の型を指定しないとエラーとなるため、必ず型を指定しましょう。

「Officeスクリプト」と「VBA」の型の比較

型注釈について

Officeスクリプトでは、workbook: ExcelScript.Workbook のように、変数や引数に型注釈を追加することで、データ型を明示します。

型注釈を使用することで、スクリプトがどのデータ型を扱うかが一目でわかり、エラー防止に役立ちます。

型注釈の使用例

function main(workbook: ExcelScript.Workbook) {
    let total: number = 10;            // 数値型の変数
    let isCompleted: boolean = true;   // 真偽値型の変数
    let items: string[] = ["A", "B"];  // 文字列型の配列
}

注意ポイント：Officeスクリプトの変数で気をつけたいポイント

Officeスクリプトで変数を使う際に、特に初心者が気をつけるべきポイントを解説します。

適切な変数の使い方を理解し、エラーの回避に役立ててください。

1. 型のミスマッチエラーに注意

Officeスクリプトで変数の型を使う際、変数の型（データの種類）は宣言することが推奨されています。

エラーは出ないかもしれませんが、確実に宣言するようにしましょう。

対策

変数を宣言する際には、使用するデータに合った型を指定しましょう。

例えば、「let total: number = 10;」とすることで、数値型の変数が作成されます。

⇒ 「 「Officeスクリプト」と「VBA」の型の比較 」をもう一度見る

2. 「var」は非推奨、代わりに「let」や「const」を使用

Officeスクリプトでは、「let」「const」「var」の3つのキーワードで変数を宣言できますが、「var」は非推奨です。

「var」は古いJavaScriptの仕様に基づいており、変数の範囲（スコープ）が広がりやすく、意図しないエラーが起きやすいからです。

⇒ 「 「let」「const」「var」の使い分けについて解説します 」をもう一度見る

対策

「var」ではなく、再代入可能な変数には「let」、固定値には「const」を使用しましょう。

例えば、「let total = 10;」と宣言することで、スコープも制御されやすく、予期せぬ動作を避けられます。

3. 配列やオブジェクトでのデータ構造に注意

Officeスクリプトの変数の型では、配列やオブジェクトなどの複雑なデータ構造を扱う際に、意図したデータが取得できないことがあります。

特に2次元配列やネストされたオブジェクトは、インデックスやプロパティ指定にミスがあるとエラーが出やすくなります。

対策

配列のインデックスやオブジェクトのプロパティ名を正確に確認しながら、アクセスしたいデータを指定しましょう。

たとえば、「配列名[行][列]」や「オブジェクト名.プロパティ名」でデータを取得します。

Officeスクリプトで変数の使用例をご紹介

以下に、Officeスクリプトで変数の具体的な使用例を紹介します。

以下に紹介する使用例は、すべてコピペしてすぐに実行できるコードです。
気になる例は、ぜひご覧いただき、実際に実行してみてください。

Officeスクリプトの基礎から応用までを効率よくしっかり学習したい方には、UdemyのOfficeスクリプト講座もおすすめです。

特に自己学習で進める場合、ビデオや実践例があると理解が進みやすくなります。

【 Udemy 】Officeスクリプトのオススメ講座

使用例1: 数値 (number) と、文字列 (string) の変数を定義する

この例では、letキーワードを使って数値（number型）と文字列（string型）の変数を宣言する方法を紹介します。

これらの型の基本的な使い方を理解することで、数値計算や文字列操作のスクリプトを簡単に作成できるようになります。

コード例 | 数値と文字列の変数を宣言・定義する

function main(workbook: ExcelScript.Workbook) {
  
  // 数値型の変数を定義
  let num: number = 10;
  console.log("数値型の変数 num の値: " + num);

  // 文字列型の変数を定義
  let text: string = "こんにちは";
  console.log("文字列型の変数 text の値: " + text);
}

処理結果

コードの動作概要

このコードで使用している機能

• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、Officeスクリプトでの基本的な数値型と文字列型の変数の使い方を示しています。

数値や文字列のデータをスクリプト内で効率的に管理・利用する基礎が学べます。

特に、console.logで変数の内容を出力し、実行結果を確認することで、スクリプトの動作を理解しやすくなります。

使用例2: 複数のデータ型を持つ変数を定義する

この例では、1つの変数に複数のデータ型（数値と文字列）を代入する方法を紹介します。

1つの変数で異なるデータ型を扱えるようにすることで、コードの柔軟性が高まり、より汎用的な変数操作が可能となります。

コード例 | 複数のデータ型を持つ変数の定義と使用

function main(workbook: ExcelScript.Workbook) {
  
  // 数値型と文字列型を持つ変数を定義
  let value: number | string;

  // 数値を代入
  value = 100;
  console.log("数値としての value: " + value);

  // 文字列を代入
  value = "こんにちは";
  console.log("文字列としての value: " + value);
}

処理結果

コードの動作概要

このコードで使用している機能

• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、Union型（number | string）を使用することで、1つの変数に異なるデータ型を代入する方法を示しています。

数値や文字列など、複数のデータ型を柔軟に扱うことで、コードの汎用性が向上します。

特に、Union型を利用することで異なるデータ型を1つの変数で扱える点は、複雑な処理や多用途なスクリプトに役立ちます。

使用例3: 日付型の変数を定義し、特定の日付を設定する

この例では、Date型を使って現在の日付と特定の日付を表示する方法を紹介します。

Date型を使用することで、プログラム内で日付を管理したり、さまざまな時間処理を行えるようになります。

コード例 | 日付型の変数を定義し、特定の日付を設定する

function main(workbook: ExcelScript.Workbook) {
    
    // 現在の日付と時間(UTC)
    let currentDate: Date = new Date();
    console.log(currentDate)

    // 現在の日付と時間(JST) 
    console.log(currentDate.toLocaleString('ja-JP', { timeZone: 'Asia/Tokyo' }));

    // 指定した日付と時間(UTC)
    let specificDate: Date = new Date(2024, 0, 1)
    console.log(specificDate)

    // 指定した日付と時間(JST)
    console.log(specificDate.toLocaleString('ja-JP', { timeZone: 'Asia/Tokyo' }));
}

処理結果

コードの動作概要

このコードで使用している機能

• toLocaleString (ローカルな形式での日時表示)
  • UTCの日時を日本標準時などの任意のタイムゾーンに変換し、表示します。
• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、OfficeスクリプトのDate型を用いて、現在の日付と特定の日付を「UTC形式:協定世界時」および「JST：日本標準時」で表示する方法を示しています。

officeスクリプトでは、標準で「UTC形式:協定世界時」で表示されます。
toLocaleStringを使って任意のタイムゾーンに変換することで、海外の時間設定や異なるタイムゾーンでの日付管理が可能になります。

このような日付管理は、グローバル対応のアプリケーションや複雑な日付処理に非常に有用です。

使用例4: 複数の数値を配列で管理する

この例では、number型の配列を使用して複数の数値を管理する方法を紹介します。

配列を使うことで、複数の値を一度に扱えるようになり、データの操作やアクセスが簡単に行えるようになります。

コード例 | 数値の配列を定義し、各要素にアクセスする

function main(workbook: ExcelScript.Workbook) {

  // 数値の配列を定義
  let numbers: number[] = [10, 20, 30, 40, 50];
  console.log("数値の配列: " + numbers);

  // 配列内の要素にアクセス
  console.log("配列の最初の要素: " + numbers[0]);
  console.log("配列の最後の要素: " + numbers[numbers.length - 1]);

}

処理結果

コードの動作概要

このコードで使用している機能

• number[] (数値型の配列)
  • 複数の数値を格納するための配列型で、データの管理に便利です。
• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、Officeスクリプトでnumber型の配列を定義し、配列の要素にアクセスする方法を示しています。

配列を使用することで、複数の数値を一括して管理・操作でき、データの取り扱いがより効率的になります。

また、配列の最初および最後の要素を取得する手順を学ぶことで、柔軟なデータ操作が可能になります。

使用例5: 配列に複数の要素を格納する方法

この例では、数値と文字列の要素を混在させた配列を作成し、各要素にアクセスする方法を紹介します。

異なるデータ型を1つの配列で扱えるようにすることで、データ管理の幅が広がり、柔軟なスクリプト作成が可能になります。

コード例 | 数値と文字列の要素を混在させた配列の定義と使用

function main(workbook: ExcelScript.Workbook) {

  // 数値と文字列を混在させた配列を定義
  let mixedArray: (number | string)[] = 
      [1, "アップル", 2, "バナナ", 3, "チェリー"];
  
  console.log("混在する要素の配列: " + mixedArray);

  // 配列内の各要素にアクセス
  console.log("最初の要素: " + mixedArray[0]); // 1
  console.log("2番目の要素: " + mixedArray[1]); // "アップル"
  console.log("最後の要素: " + mixedArray[mixedArray.length - 1]); // "チェリー"

}

処理結果

コードの動作概要

このコードで使用している機能

• (number | string)[] (Union型の配列)
  • 数値と文字列のデータ型を持つ配列を定義し、異なるデータ型を一括管理します。
• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、OfficeスクリプトでUnion型を使って、数値と文字列が混在する配列を定義する方法を解説しました。

異なるデータ型を同じ配列に格納することで、さまざまなデータを効率よく管理でき、汎用的なスクリプト作成が可能になります。

配列のlengthプロパティを使用して最後の要素にアクセスする手法も学べ、柔軟なデータ操作に役立ちます。

使用例6: 数値を2次元配列で操作する

この例では、number型の2次元配列を定義し、各要素にアクセスする方法を紹介します。

2次元配列を使うことで、行と列を持つデータを一括して管理でき、複雑なデータ処理やテーブル状の情報を扱うのに便利です。

コード例 | number型の2次元配列を定義し、特定の要素にアクセスする

function main(workbook: ExcelScript.Workbook) {

  // 2次元配列を定義
  let matrix: number[][] = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9]
  ];

  console.log("2次元配列: " + matrix);

  // 特定の要素にアクセス
  console.log("matrix[1][1]の値: " + matrix[1][1]); // 5

}

処理結果

コードの動作概要

このコードで使用している機能

• number[][] (2次元配列)
  • 数値型の2次元配列を定義し、行と列の形でデータを管理します。
• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、Officeスクリプトでのnumber型2次元配列の定義と、特定の要素へのアクセス方法を解説しました。

2次元配列を使うことで、行と列を持つデータ構造を簡単に管理でき、テーブル形式のデータや複雑な数値データの操作が容易になります。

特に行と列を指定して要素にアクセスすることで、ピンポイントでデータを取得・操作することが可能になります。

使用例7: 2次元配列を使ってデータを管理する

この例では、2次元配列を使用して数値と文字列が混在したデータを管理し、各要素にアクセスする方法を紹介します。

異なるデータ型を含む2次元配列を使うことで、複数の属性を持つデータを柔軟に扱えるようになります。

コード例 | 数値と文字列の要素を混在させた2次元配列の定義と使用

function main(workbook: ExcelScript.Workbook) {

  // 数値と文字列を混在させた2次元配列を定義
  let mixedArray2D: (number | string)[][] = [
    [1, "アップル", 10],
    [2, "バナナ", 20],
    [3, "チェリー", 30]
  ];

  console.log("2次元配列の内容: " + mixedArray2D);

  // 2次元配列内の各要素にアクセス
  console.log("最初の行、2番目の要素: " + mixedArray2D[0][1]); // "アップル"
  console.log("2番目の行、3番目の要素: " + mixedArray2D[1][2]); // 20
  console.log("最後の行、1番目の要素: " + mixedArray2D[2][0]); // 3

}

処理結果

コードの動作概要

このコードで使用している機能

• (number | string)[][] (Union型の2次元配列)
  • 数値と文字列を含む2次元配列を定義し、異なるデータ型を持つ複数の要素を同時に管理します。
• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、OfficeスクリプトでUnion型を用いた2次元配列を定義し、数値と文字列の異なるデータ型を同じ配列で管理する方法を解説しました。

行と列のインデックスを指定して個々の要素にアクセスすることで、複数の属性を持つデータ構造を効率よく操作できます。

特に、Union型の使用により、柔軟なデータ管理が可能になり、表形式の複雑なデータを扱う際に非常に便利です。

使用例8: 複数の要素を持つオブジェクトを定義する

この例では、複数のプロパティを持つオブジェクトを定義し、各プロパティにアクセスする方法を紹介します。

オブジェクトを使用することで、関連するデータを一つの変数にまとめ、管理しやすくなります。

コード例 | 複数のプロパティを持つオブジェクトの定義と使用

function main(workbook: ExcelScript.Workbook) {

  // オブジェクトを定義
  let person: { name: string, age: number, isStudent: boolean } = {
    name: "John Doe",
    age: 25,
    isStudent: true
  };

  console.log("オブジェクト: " + JSON.stringify(person));

  // 各プロパティにアクセス
  console.log("名前: " + person.name); // "John Doe"
  console.log("年齢: " + person.age); // 25
  console.log("学生かどうか: " + person.isStudent); // true

}

処理結果

コードの動作概要

このコードで使用している機能

• オブジェクト定義
  • { name: string, age: number, isStudent: boolean }のようにプロパティと型を定義することで、複数の要素を含むオブジェクトを作成します。
• JSON.stringify (JSON形式でのオブジェクト出力)
  • オブジェクトをJSON形式に変換して出力し、オブジェクト全体をわかりやすく表示します。
• console.log (値の出力)
  • 指定した内容をコンソールに表示します。

1行ずつコードを解説

総括・ポイント

この使用例では、複数のプロパティを持つオブジェクトを定義し、各プロパティにアクセスする方法を解説しました。

オブジェクトを使うことで、関連するデータを一つの変数にまとめて管理でき、複雑なデータ構造にも対応できます。

また、JSON.stringifyを使うことでオブジェクト全体の内容を一度に出力し、確認しやすくすることが可能です。

この記事のまとめ

この記事では、Officeスクリプトにおける変数の使い方や、VBAとの違い、データ型の活用方法について詳しく解説しました。

Officeスクリプトを使う際に知っておくべき「変数」や「型指定」の基本を学ぶことで、スクリプト作成の効率と信頼性が大幅に向上します。

ポイントのおさらい

さらに学ぶために

Officeスクリプトでの変数の使い方をマスターしたら、次に進むと良い学習テーマをいくつかご紹介します。

これらのステップを踏むことで、より強力で効率的なスクリプトが書けるようになります。初心者からさらにスキルアップするために、ぜひ以下の内容に挑戦してみてください。

あわせて読みたい

サイトマップ VBAOfficeスクリプトワークシート関数 VBA 基本設定 VBAとは？ VBAの始め方 VBAのおすすめ設定 セル操作 RangeとCells CurrentRegion Offset Resize 最終行・最終列の取...