日付したい（Date）

const now = new Date();
Logger.log(now);
// Mon Nov 11 2024 10:37:03 GMT+0900 (Japan Standard Time)

Logger.log(now.toISOString());
// 2024-11-11T01:37:03.620Z

Logger.log(now.toLocaleString());
// 11/11/2024, 10:37:03 AM

Logger.log(now.toLocaleString("ja-JP", {timeZone: "JST"}));
// 2024/11/11 10:37:03

JavaScriptのDateクラスで日付オブジェクトを操作できます。

注釈

タイムゾーンはGASのプロジェクト設定（全般設定）で変更できます。

現在時刻したい（new Date）

const now = new Date();
console.log(now);
// Mon Nov 11 2024 10:23:23 GMT+0900 (Japan Standard Time)
console.log(now.toISOString());
// 2024-11-11T01:23:23.137Z

引数なしで生成すると現在時刻を取得できます。

const year = new Date("2024");
// 2024-01-01T00:00:00.000Z

const date = new Date("2024-11-11");
// 2024-11-11T00:00:00.000Z

const datetime = new Date("2024-11-11 12:34:56");
// 2024-11-11T03:34:56.000Z

引数に日時形式の文字列を与えて、Dateオブジェクトに変換できます。

// TZ=+08:00に設定
const now = new Date("2024-11-11 12:34:56.789+08:00");


console.log(now);
// Mon Nov 11 2024 13:34:56 GMT+0900 (Japan Standard Time)
// ↑GASプロジェクトのTZ設定（Asia/Tokyo）に変換されている

console.log(now.toISOString());
// 2024-11-11T04:34:56.789Z
// ↑UTC+00:00に変換されている

タイムゾーンを明示した形式の場合、 GASプロジェクトの日時設定や、 UTC時刻に自動で変換されます。

表示形式したい（toLocaleString）

const now = new Date();
const options = {
    year: "numeric",    // [2-digit, numeric]
    month: "2-digit",   // [2-digit, numeric, long, short]
    day: "2-digit",     // [2-digit, numeric]
    hour: "2-digit",    // [2-digit, numeric]
    minute: "2-digit",  // [2-digit, numeric]
    second: "2-digit",  // [2-digit, numeric]
    fractionalSecondDigits: 3,  // [0, 1, 2, 3]
    hour12: false,  // [false, true]
    timeZone: "Asia/Tokyo",  // [UTC, Asia/Tokyo, ...]
    timeZoneName: "shortOffset",  // [short, long, longOffset, shortOffset, longGeneric, shortGeneric]
    weekday: "long",  // [short, long]
}
console.log(now.toLocaleString("ja-JP", options));
// 2024/11/11月曜日 10時56分32.590秒 GMT+9

DateオブジェクトのtoLocaleStringで、ロケールに合わせた表示形式に変更できます。 ロケールはja-Jp-u-ca-japanese-hc-h12のような形式で、 言語のユニコード拡張（ja-Jp-u）や 和暦（ca-japanese）、 12時間制（hc-h12）などのオプションを追加できます。

ISO8601したい（Utilities.formatDate）

const now = new Date();

// Utilities.formatDate(日付, "タイムゾーン", "表示形式");
const date = Utilities.formatDate(now, "Asia/Tokyo", "yyyy-MM-dd'T'HH:mm:ss.SSSZ");
Logger.info(date);

GASのUtilities.formatDateメソッドで、任意の表示形式に変更できます。 上記サンプルでは、現在時刻を日本の時刻にローカライズして、ISO8601形式で出力しています。

指定子	表示内容	型	例
G	Era designator	Text	AD
yyyy	年（4桁）	Year	2024 / 24
MM	月（2桁）	Month	01 - 12
dd	日（2桁）	Number	01 - 31
hh	時（2桁）	Number	1 - 24
mm	分（2桁）	Number	00 - 59
ss	秒（2桁）	Number	00 - 59
SSS	ミリ秒（3桁）	Number	000 - 999
E	曜日	Text	Tuesday; Tue
z	タイムゾーン	General time zone	JST
Z	タイムゾーン	RFC 822 time zone	+0900
XX	タイムゾーン	ISO 8601 time zone	+0900

週末したい

// 週末かどうか判定する
//
// @param {Date} date - 日付オブジェクト
function isHoliday(date) {
    // 曜日を取得
    const day = date.getDay();

    // 0: 日曜日 ... 6:土曜日
    if (day === 0 || day === 6) {
        return true;
    } else {
        return false;
    };
};

getDayで曜日を取得できます。

月初／月末したい

const d1 = new Date();
d1.setDate(1);
d1.setHours(0);
d1.setMinutes(0);
d1.setSeconds(0);
//     2024-11-13 12:34:56
// ==> 2024-11-01 00:00:00

const d2 = new Date();
d2.setMonth(d2.getMonth() + 1);
d2.setDate(1);
d2.setHours(0);
d2.setMinutes(0);
d2.setSeconds(0);
//     2024-11-13 12:34:56
// ==> 2024-12-01 00:00:00

現在日時を基準に、月初と月末を取得できます。 カレンダーから毎月のイベントを取得したい場合に使えます。

リファレンス

• formatDate

• Class SimpleDateFormat

• Date - mdn