【GAS】スプレッドシートの言語と地域を変更・取得する方法｜ロケールをアメリカ合衆国から日本にする（AppScript）

Google App Script（GAS）を使ってスプレッドシートを新規作成すると、デフォルトの言語と地域は「アメリカ合衆国」となります。

この場合、表示される時間は日本の yyyy/mm/dd ではなく、アメリカ式の m/d/yyyyになります。

ここでは、GASを使って【GAS】スプレッドシートの言語と地域を「日本」に変更する方法や現在の設定を取得する方法を実例で解説しています。

デフォルトの状態

初めにデフォルトの状態を見ておきます。

SpreadsheetApp.createを使ってスプレッドシートを新規作成します。

SpreadsheetApp.create('スプレッドシートの名前')

作成したスプレッドシートの設定を確認すると、「言語と地域」が「アメリカ合衆国」になっています。

この状態でGoogleフォームなどと連携すると、表示がアメリカ式になります。

ロケールを変更する方法｜setSpreadsheetLocale

スプレッドシートの設定の「言語と地域」（ロケール）を変更するにはsetSpreadsheetLocaleメソッドを使います。

setSpreadsheetLocale(ロケール)

引数のロケールは文字列で指定します。

例えば、日本の場合は(‘ja’)、フランスの場合は(‘fr’)のように記述します。

なお、現在の言語と地域を取得するにはgetSpreadsheetLocaleメソッドを使います。

getSpreadsheetLocale()

実例

function setSpreadsheet() {
  const ssid = "スプレッドシートのID";
  const ss = SpreadsheetApp.openById(ssid);
  
  ss.setSpreadsheetLocale('ja') //日本を指定

  const ssLocale = ss.getSpreadsheetLocale();
  console.log(ssLocale);
}

プログラムを実行すると「言語と地域」が指定したとおり「日本」になりました。

これにより既に入力してあった日付も日本のyyyy/mm/ddに切り替わりました。

タイムゾーンを設定/変更する方法｜setSpreadsheetTimeZone

デフォルトのタイムゾーン

スプレッドシートの設定画面を開くと「言語と地域」以外に「タイムゾーン」も指定できるようになっています。

デフォルトは「(GMT+09:00) Tokyo」となり日本のタイムゾーンが設定されています。

この状態で特に変更する必要はないのですが、参考としてGASを使ってタイムゾーンを変更する方法も紹介しておきます。

タイムゾーンを設定/変更する方法

スプレッドシートのタイムゾーンを変更するにはsetSpreadsheetTimeZoneメソッドを使います。

setSpreadsheetTimeZone(タイムゾーン)

日本の場合は('Asia/Tokyo')、アメリカ合衆国のニューヨークの場合は('America/New_York')を指定します。

なお、現在設定されているタイムゾーンを取得するにはgetSpreadsheetTimeZoneメソッドを使います。

getSpreadsheetTimeZone()

タイムゾーンの一覧

使えるタイムゾーンは以下になります。

実例

function setSpreadsheet() {
  const ssid = "スプレッドシートのID";
  const ss = SpreadsheetApp.openById(ssid);
  
  ss.setSpreadsheetTimeZone('Asia/Tokyo'); //日本時間を指定

  const ssTimeZone = ss.getSpreadsheetTimeZone();
  console.log(ssTimeZone);
}

参考

• AppScript > Class Spreadsheet > setSpreadsheetLocale(locale)
• AppScript > Class Spreadsheet > setSpreadsheetTimeZone( timezone )