【入門】GASで当日の日付を「年月日」で取得

お仕事おつにゃッス🐈

文系未経験から社内SEになった、あっきょ（@daily_code_JP）です！

Google Apps Scriptで当日の日付を取得したいけど、Dateオブジェクトって難しそうと思っていませんか？

この記事ではそのお悩みを、コピペOKのGoogle Apps Scriptのコードでとても簡単に解決します。

あっきょ

この記事は以下で悩んでいる人におすすめ！

Dateオブジェクトで当日の日付を一瞬で取得したい
GASでカレンダーの操作やトリガーを作成して業務効率化したい
プログラミングでJavaScriptを学んだけど、何を作っていいかわからない

誰でも無料で簡単にできますので、お気軽に学んでいきましょう！

タップできる目次

日付を取得する完成イメージ
日付を取得する準備
- サンプルコードを貼り付ける方法
Dateオブジェクトとは？
日付を取得する4つのメソッド
日付を取得するサンプルコード
- サンプルコード
当日の日付を取得するテスト
【入門】GASで時間に関わるコード一覧
おわりに | GASのスキルをさらに高めるには

日付を取得する完成イメージ

この記事ではGASのログ出力で日付を出力できるようにします。

コードを実行した日付を自動取得し、日程を手動でわざわざ入力する手間を省きます。

結果として人的ミスと作業時間の短縮となり、業務効率化を実現します。

日付を取得する準備

Google Apps Script で日付を取得する準備します。ファイルは1つ必要です。

必要なファイル

Google Apps Script　・・・　コードの貼り付け

サンプルコードを貼り付ける方法

ソースコードはGoogle Apps Scriptのファイルにコピペします。

メニュー画面で右クリックし、オプションを開きます。メニュー一覧の一番下の「その他」を選択し、その中の「Google Apps Script」を選択します。

以下のような画面が現れます。ここにコードをコピペして実行します。

Dateオブジェクトとは？

Dateオブジェクトとは、JavaScriptというプログラミング言語の組み込みオブジェクトで時間や日付を処理できます。

この言語をベースに開発されたGASでも使用でき、カレンダーの操作やトリガーを使った自作アプリで使用します。

Dateオブジェクトの詳細が気になる場合は以下のサイトをご参考ください。

【Dateオブジェクトの詳細】

Date - JavaScript | MDN

日付を取得する4つのメソッド

Google Apps Scriptでよく使う日付を取得するメソッドを4つ紹介します。

日付を取得するメソッドの一覧

getFullYear() ・・・現在の年を数字で取得
getMonth() ・・・現在の月を数字で取得
getDate() ・・・現在の日を数字で取得
getDay() ・・・現在の曜日を数字で取得

getFullYear() | 現在の年を数字で取得

getFullYearメソッドは現在の西暦を数字で取得します。

引数は不要です。

getMonth() | 現在の月を数字で取得

getMonthメソッドは現在の月を数字で取得します。

引数は不要です。

このメソッドは0から11までの数字を返すので、当月を出力するには1を足す必要があります。

例えば1月の場合は0を返すので、正確に月を取得するには「getMonth() + 1」と記入します。

getDate() | 現在の日を数字で取得

getDateメソッドは現在の日を数字で取得します。

引数は不要です。

getDay() | 現在の曜日を数字で取得

getDayメソッドは、現在の曜日を数字で取得します。

引数は不要ですが、このメソッドは0から6までの数字を返します。

つまり、日曜日の0を基準にし、土曜日の6まで出力します。

したがって、文字列の曜日を取得するには、配列を別に定義する必要があります。

曜日を取得する方法の詳細は以下の記事から。

: 【3分で解決】GASで当日の曜日を取得
続きを見る

日付を取得するサンプルコード

Google Apps Scriptで日付を取得するサンプルコードを公開します。

サンプルコード

サンプルコード全般です。右上のマークをクリックすると、簡単にコピペできます。

function getTodayDate() {
  //Dateオブジェクトからインスタンスを生成
  const today = new Date();

  //メソッドを使って、本日の日付を取得
  const year = today.getFullYear(); //年
  const month = today.getMonth()+1; //月
  const date = today.getDate(); //日
  const day = today.getDay(); //曜日
  const dayArray = ["日","月","火","水","木","金","土"]; //曜日の配列

  Logger.log("本日は" + year + "年" + month + "月" + date + "日の" + dayArray[day] + "曜日");
}