Class Utilities

公益事業

このサービスは、文字列のエンコード/デコード、日付形式、JSON 操作、 その他のタスクを自動化します。

プロパティ

プロパティ	タイプ	説明
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

メソッド

メソッド	戻り値の型	概要
base64Decode(encoded)	Byte[]	Base64 でエンコードされた文字列を UTF-8 バイト配列にデコードします。
base64Decode(encoded, charset)	Byte[]	Base64 でエンコードされた文字列を特定の文字セットのバイト配列にデコードします。
base64DecodeWebSafe(encoded)	Byte[]	Base64 でウェブセーフにエンコードされた文字列を UTF-8 バイト配列にデコードします。
base64DecodeWebSafe(encoded, charset)	Byte[]	Base64 のウェブセーフにエンコードされた文字列を特定の文字セットのバイト配列にデコードします。
base64Encode(data)	String	指定されたバイト配列から Base64 でエンコードされた文字列を生成します。
base64Encode(data)	String	指定された文字列から Base-64 でエンコードされた文字列を生成します。
base64Encode(data, charset)	String	特定の文字セットで指定された文字列から、Base64 でエンコードされた文字列を生成します。
base64EncodeWebSafe(data)	String	指定されたバイト配列から Base-64 のウェブセーフ エンコード文字列を生成します。
base64EncodeWebSafe(data)	String	指定された文字列から Base-64 のウェブセーフ エンコード文字列を生成します。
base64EncodeWebSafe(data, charset)	String	特定の文字セットで指定された文字列から、Base-64 ウェブセーフ エンコード文字列を生成します。
computeDigest(algorithm, value)	Byte[]	指定された Byte[] 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。
computeDigest(algorithm, value)	Byte[]	指定された String 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。
computeDigest(algorithm, value, charset)	Byte[]	指定された String 値に対して、指定されたアルゴリズムを使用して、 あります。
computeHmacSha256Signature(value, key)	Byte[]	指定されたキーの HMAC-SHA256 を使用して、指定された値に署名します。
computeHmacSha256Signature(value, key)	Byte[]	指定されたキーの HMAC-SHA256 を使用して、指定された値に署名します。
computeHmacSha256Signature(value, key, charset)	Byte[]	HMAC-SHA256 を使用し、指定されたキーと文字セットを使用して、指定された値に署名します。
computeHmacSignature(algorithm, value, key)	Byte[]	指定された鍵で、指定されたアルゴリズムを使用してメッセージ認証コードを計算します。 あります。
computeHmacSignature(algorithm, value, key)	Byte[]	指定された鍵で、指定されたアルゴリズムを使用してメッセージ認証コードを計算します。 あります。
computeHmacSignature(algorithm, value, key, charset)	Byte[]	指定された鍵で、指定されたアルゴリズムを使用してメッセージ認証コードを計算します。 あります。
computeRsaSha1Signature(value, key)	Byte[]	指定された鍵の RSA-SHA1 を使用して、指定された値に署名します。
computeRsaSha1Signature(value, key, charset)	Byte[]	指定された鍵と文字セットの RSA-SHA1 を使用して、指定された値に署名します。
computeRsaSha256Signature(value, key)	Byte[]	指定された鍵の RSA-SHA256 を使用して、指定された値に署名します。
computeRsaSha256Signature(value, key, charset)	Byte[]	指定された鍵の RSA-SHA256 を使用して、指定された値に署名します。
computeRsaSignature(algorithm, value, key)	Byte[]	指定された鍵で、指定された RSA アルゴリズムを使用して、指定された値に署名します。
computeRsaSignature(algorithm, value, key, charset)	Byte[]	指定された鍵と文字セットで、指定された RSA アルゴリズムを使用して、指定された値に署名します。
formatDate(date, timeZone, format)	String	Java SE SimpleDateFormat クラスで説明されている仕様に従って日付をフォーマットします。
formatString(template, args)	String	「%」形式の文字列を使用して、sprintf のような文字列書式設定を実行します。
getUuid()	String	UUID を文字列として取得します（java.util.UUID.randomUUID() メソッドを使用する場合と同等）。
gzip(blob)	Blob	gzip は、指定された Blob データを圧縮し、新しい Blob オブジェクトに返します。
gzip(blob, name)	Blob	gzip は、指定された Blob データを圧縮し、新しい Blob オブジェクトに返します。
newBlob(data)	Blob	バイト配列から新しい Blob オブジェクトを作成します。
newBlob(data, contentType)	Blob	バイト配列とコンテンツ型から新しい Blob オブジェクトを作成します。
newBlob(data, contentType, name)	Blob	バイト配列、コンテンツ タイプ、名前から新しい Blob オブジェクトを作成します。
newBlob(data)	Blob	文字列から新しい Blob オブジェクトを作成します。
newBlob(data, contentType)	Blob	文字列とコンテンツ タイプから新しい Blob オブジェクトを作成します。
newBlob(data, contentType, name)	Blob	文字列、コンテンツ タイプ、名前から新しい Blob オブジェクトを作成します。
parseCsv(csv)	String[][]	CSV 文字列の表形式の 2D 配列表現を返します。
parseCsv(csv, delimiter)	String[][]	カスタムの区切り文字を使用して、CSV 文字列の表形式の 2D 配列表現を返します。
parseDate(date, timeZone, format)	Date	Java 標準 エディション SimpleDateFormat クラス。
sleep(milliseconds)	void	指定したミリ秒数の間スリープします。
ungzip(blob)	Blob	Blob オブジェクトを解凍し、圧縮されていないファイルを含む Blob を返します。 分析できます
unzip(blob)	Blob[]	zip ファイルを表す blob を受け取り、そのコンポーネント ファイルを返します。
zip(blobs)	Blob	渡された blob のデータを含む ZIP ファイルである新しい Blob オブジェクトを作成します。
zip(blobs, name)	Blob	渡された blob のデータを含む ZIP ファイルである新しい Blob オブジェクトを作成します。

サポート終了のメソッド

メソッド	戻り値の型	概要
jsonParse(jsonString)	Object	渡された JSON 文字列に対応するオブジェクトを返します。
jsonStringify(obj)	String	渡されたオブジェクトの JSON 文字列を返します。

詳細なドキュメント

base64Decode(encoded)

Base64 でエンコードされた文字列を UTF-8 バイト配列にデコードします。

// This is the base64 encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
var decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
encoded	String	デコードするデータのバイト配列。

戻る

Byte[] - Base64 でエンコードされた引数によってバイト配列として表される元データ。

---

base64Decode(encoded, charset)

Base64 でエンコードされた文字列を特定の文字セットのバイト配列にデコードします。

// This is the base64 encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

var decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
encoded	String	デコードするデータの文字列。
charset	Charset	入力の文字セットを指定する Charset。

戻る

Byte[] - Base64 でエンコードされた引数によってバイト配列として表される元データ。

---

base64DecodeWebSafe(encoded)

Base64 でウェブセーフにエンコードされた文字列を UTF-8 バイト配列にデコードします。

// This is the base64 web-safe encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var decoded = Utilities.base64DecodeWebSafe(base64data);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
encoded	String	デコードするウェブセーフ データのバイト配列。

戻る

Byte[] - Base64 のウェブセーフ エンコード引数でバイト配列として表される元データ。

---

base64DecodeWebSafe(encoded, charset)

Base64 のウェブセーフにエンコードされた文字列を特定の文字セットのバイト配列にデコードします。

// This is the base64 web-safe encoded form of "Google グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var decoded = Utilities.base64DecodeWebSafe(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
encoded	String	デコードするウェブセーフ データの文字列。
charset	Charset	入力の文字セットを指定する Charset。

戻る

Byte[] - Base64 のウェブセーフ エンコード引数でバイト配列として表される元データ。

---

base64Encode(data)

指定されたバイト配列から Base64 でエンコードされた文字列を生成します。Base64 は一般的なエンコード方式で、 バイナリデータを受け入れることができないさまざまなツールで許容されます。Base64 は一般に インターネット プロトコル（E メール、HTTP、XML ドキュメントなど）

// Instantiates a blob here for clarity
var blob = Utilities.newBlob("A string here");

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

パラメータ

名前	型	説明
data	Byte[]	エンコードするデータの byte[]。

戻る

String - 渡されたデータの Base-64 エンコード表現。

---

base64Encode(data)

指定された文字列から Base-64 でエンコードされた文字列を生成します。Base64 は広く使用されているエンコードで バイナリデータを受け入れることができないさまざまなツールによって 処理されていますBase64 はインターネットで一般的に使用されている HTTP、XML ドキュメントなどのプロトコルです

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64Encode("A string here");
Logger.log(encoded);

パラメータ

名前	型	説明
data	String	エンコードする文字列。

戻る

String - 入力文字列の Base-64 エンコード表現。

---

base64Encode(data, charset)

特定の文字セットで指定された文字列から、Base64 でエンコードされた文字列を生成します。文字セット は、文字をエンコードできるようにエンコードする方法です。通常、これらは バイナリ形式では、通常は特定のデータ転送プロトコルと互換性がない場合があります。宛先 データの互換性を確保するために、通常は Base64 にエンコードされます。 バイナリデータを受け入れることができないさまざまなツールで許容されます。Base64 は一般に インターネット プロトコル（E メール、HTTP、XML ドキュメントなど）

// "Google Groups" in Katakana (Japanese)
var input = "Google グループ";

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
var encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

パラメータ

名前	型	説明
data	String	エンコードするデータの文字列。
charset	Charset	入力の文字セットを指定する Charset。

戻る

String - 指定された Charset を持つ入力文字列の Base-64 エンコード表現。

---

base64EncodeWebSafe(data)

指定されたバイト配列から Base-64 のウェブセーフ エンコード文字列を生成します。Base64 は バイナリデータを受け入れることができないさまざまなツールで許容されるエンコーディングを使用します。Base64 ウェブセーフは 電子メール、HTTP、XML 文書などのインターネットプロトコルで一般的に使用されます。

// Instantiates a blob here for clarity
var blob = Utilities.newBlob("A string here");

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

パラメータ

名前	型	説明
data	Byte[]	エンコードするデータのバイト配列。

戻る

String - 渡されたデータの Base-64 ウェブセーフ エンコード表現。

---

base64EncodeWebSafe(data)

指定された文字列から Base-64 のウェブセーフ エンコード文字列を生成します。Base64 は一般的なエンコード方式で、 バイナリデータを受け入れることができないさまざまなツールで許容されます。Base64 ウェブセーフは一般的に インターネット プロトコル（電子メール、HTTP、XML ドキュメントなど）で使用されます。

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var encoded = Utilities.base64EncodeWebSafe("A string here");
Logger.log(encoded);

パラメータ

名前	型	説明
data	String	エンコードする文字列。

戻る

String - 入力文字列の Base-64 ウェブセーフ表現。

---

base64EncodeWebSafe(data, charset)

特定の文字セットで指定された文字列から、Base-64 ウェブセーフ エンコード文字列を生成します。 Charset は、エンコードできるように文字をエンコードする方法です。これらは通常 バイナリ形式で行われ、通常は特定のデータ転送とは互換性がない 通信できます。データの互換性を持たせるために、通常は Base64 にエンコードされます。 バイナリデータを受け入れることができないさまざまなツールで受け入れられる一般的なエンコーディング。Base64 ウェブセーフ 電子メール、HTTP、XML 文書などのインターネットプロトコルで一般的に使用されます。

// "Google Groups" in Katakana (Japanese)
var input = "Google グループ";

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
var encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

パラメータ

名前	型	説明
data	String	エンコードするデータの文字列。
charset	Charset	入力の文字セットを指定する Charset。

戻る

String - 指定された Charset を持つ入力文字列の Base-64 ウェブセーフ エンコード表現。

---

computeDigest(algorithm, value)

指定された Byte[] 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。

var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input);
Logger.log(digest);

パラメータ

名前	型	説明
algorithm	DigestAlgorithm	使用する DigestAlgorithm。
value	Byte[]	ダイジェストを計算する入力文字列値。

戻る

Byte[] - 出力ダイジェストを表す byte[]。

---

computeDigest(algorithm, value)

指定された String 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。

var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, "input to hash");
Logger.log(digest);

パラメータ

名前	型	説明
algorithm	DigestAlgorithm	使用する DigestAlgorithm。
value	String	ダイジェストを計算する入力文字列値。

戻る

Byte[] - 出力ダイジェストを表す byte[]。

---

computeDigest(algorithm, value, charset)

指定された String 値に対して、指定されたアルゴリズムを使用して、 あります。

var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5,
                                     "input to hash",
                                     Utilities.Charset.US_ASCII);
Logger.log(digest);

パラメータ

名前	型	説明
algorithm	DigestAlgorithm	使用する DigestAlgorithm。
value	String	ダイジェストを計算する入力文字列値。
charset	Charset	入力文字セットを表す Charset。

戻る

Byte[] - 出力ダイジェストを表す byte[]。

---

computeHmacSha256Signature(value, key)

指定されたキーの HMAC-SHA256 を使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var key = Utilities.base64Decode("a2V5"); // == base64encode("key")
var signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

パラメータ

名前	型	説明
value	Byte[]	ハッシュを生成する入力値。
key	Byte[]	ハッシュの生成に使用する鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeHmacSha256Signature(value, key)

指定されたキーの HMAC-SHA256 を使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                      "my key - use a stronger one");
Logger.log(signature);

パラメータ

名前	型	説明
value	String	ハッシュを生成する入力値。
key	String	ハッシュの生成に使用する鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeHmacSha256Signature(value, key, charset)

HMAC-SHA256 を使用し、指定されたキーと文字セットを使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                     "my key - use a stronger one",
                                                     Utilities.Charset.US_ASCII);
Logger.log(signature);

パラメータ

名前	型	説明
value	String	ハッシュを生成する入力値。
key	String	ハッシュの生成に使用する鍵。
charset	Charset	入力文字セットを表す Charset。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeHmacSignature(algorithm, value, key)

指定された鍵で、指定されたアルゴリズムを使用してメッセージ認証コードを計算します。 あります。

// This writes an array of bytes to the log.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var key = Utilities.base64Decode("a2V5"); // == base64encode("key")
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, input, key);
Logger.log(signature);

パラメータ

名前	型	説明
algorithm	MacAlgorithm	入力値のハッシュに使用する MacAlgorithm アルゴリズム。
value	Byte[]	ハッシュを生成する入力値。
key	Byte[]	ハッシュの生成に使用する鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeHmacSignature(algorithm, value, key)

指定された鍵で、指定されたアルゴリズムを使用してメッセージ認証コードを計算します。 あります。

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key");
Logger.log(signature);

パラメータ

名前	型	説明
algorithm	MacAlgorithm	入力値のハッシュに使用する MacAlgorithm アルゴリズム。
value	String	ハッシュを生成する入力値。
key	String	ハッシュの生成に使用する鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeHmacSignature(algorithm, value, key, charset)

指定された鍵で、指定されたアルゴリズムを使用してメッセージ認証コードを計算します。 あります。

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key",
                                               Utilities.Charset.US_ASCII);
Logger.log(signature);

パラメータ

名前	型	説明
algorithm	MacAlgorithm	入力値のハッシュに使用する MacAlgorithm アルゴリズム。
value	String	ハッシュを生成する入力値。
key	String	ハッシュの生成に使用する鍵。
charset	Charset	入力文字セットを表す Charset。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeRsaSha1Signature(value, key)

指定された鍵の RSA-SHA1 を使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

パラメータ

名前	型	説明
value	String	ハッシュを生成する入力値。
key	String	署名の生成に使用する PEM 形式の鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeRsaSha1Signature(value, key, charset)

指定された鍵と文字セットの RSA-SHA1 を使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"
    Utilities.Charset.US_ASCII);
Logger.log(signature);

パラメータ

名前	型	説明
value	String	ハッシュを生成する入力値。
key	String	署名の生成に使用する PEM 形式の鍵。
charset	Charset	入力文字セットを表す Charset。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeRsaSha256Signature(value, key)

指定された鍵の RSA-SHA256 を使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

パラメータ

名前	型	説明
value	String	ハッシュを生成する入力値。
key	String	署名の生成に使用する PEM 形式の鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeRsaSha256Signature(value, key, charset)

指定された鍵の RSA-SHA256 を使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

パラメータ

名前	型	説明
value	String	ハッシュを生成する入力値。
key	String	署名の生成に使用する PEM 形式の鍵。
charset	Charset	入力文字セットを表す Charset。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeRsaSignature(algorithm, value, key)

指定された鍵で、指定された RSA アルゴリズムを使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

パラメータ

名前	型	説明
algorithm	RsaAlgorithm	入力値のハッシュに使用する RsaAlgorithm アルゴリズム。
value	String	ハッシュを生成する入力値。
key	String	署名の生成に使用する PEM 形式の鍵。

戻る

Byte[] - 出力署名を表す byte[]。

---

computeRsaSignature(algorithm, value, key, charset)

指定された鍵と文字セットで、指定された RSA アルゴリズムを使用して、指定された値に署名します。

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

パラメータ

名前	型	説明
algorithm	RsaAlgorithm	入力値のハッシュに使用する RsaAlgorithm アルゴリズム。
value	String	ハッシュを生成する入力値。
key	String	署名の生成に使用する PEM 形式の鍵。
charset	Charset	入力文字セットを表す Charset。

戻る

Byte[] - 出力署名を表す byte[]。

---

formatDate(date, timeZone, format)

Java SE SimpleDateFormat クラスで説明されている仕様に従って日付をフォーマットします。恐れ入りますが、 で仕様をご覧ください。 http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

// This formats the date as Greenwich Mean Time in the format
// year-month-dateThour-minute-second.
var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'");
Logger.log(formattedDate);

パラメータ

名前	型	説明
date	Date	文字列としてフォーマットする Date。
timeZone	String	結果の出力タイムゾーン。
format	String	SimpleDateFormat 仕様の形式。

戻る

String - フォーマットされた文字列としての入力日付。

---

formatString(template, args)

「%」形式の文字列を使用して、sprintf のような文字列書式設定を実行します。

// " 123.456000"
Utilities.formatString('%11.6f', 123.456);

// "   abc"
Utilities.formatString('%6s', 'abc');

パラメータ

名前	型	説明
template	String	何が返されるかを制御する書式文字列。
args	Object...	「%」を入力するために使用するオブジェクトプレースホルダを使用できます。

戻る

String - フォーマットされた文字列。

---

getUuid()

UUID を文字列として取得する（java.util.UUID.randomUUID() メソッドを使用する場合と同等）。この識別子は、ネットワーク間で一意であるとは限りません。 あります。そのため、一意性を保証する必要がある状況では使用しないでください。

//This assigns a UUID as a temporary ID for a data object you are creating in your script.
var myDataObject = {
   tempId: Utilities.getUuid();
};

戻る

String - UUID の文字列表現。

---

gzip(blob)

gzip は、指定された Blob データを圧縮し、新しい Blob オブジェクトに返します。

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob);

パラメータ

名前	型	説明
blob	BlobSource	gzip を使用して圧縮する Blob オブジェクト。

戻る

Blob - 圧縮データを含む新しい Blob。

---

gzip(blob, name)

gzip は、指定された Blob データを圧縮し、新しい Blob オブジェクトに返します。このバージョンのメソッドでは、ファイル名を指定できます。

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob, "text.gz");

パラメータ

名前	型	説明
blob	BlobSource	gzip を使用して圧縮する Blob オブジェクト。
name	String	作成する gzip ファイルの名前。

戻る

Blob - 圧縮データを含む新しい Blob。

---

newBlob(data)

バイト配列から新しい Blob オブジェクトを作成します。blob は、多くの Apps Script API で使用され、 バイナリデータを入力として使用します。

// Creates a blob object from a byte array.
const data = [71, 79, 79, 71, 76, 69];
const blob = Utilities.newBlob(data);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

パラメータ

名前	型	説明
data	Byte[]	blob のバイト。

戻る

Blob - 新しく作成された blob。

---

newBlob(data, contentType)

バイト配列とコンテンツ型から新しい Blob オブジェクトを作成します。blob は多くの Apps Script で使用される バイナリデータを入力として受け取る API。

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Creates a blob object from the byte array and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

パラメータ

名前	型	説明
data	Byte[]	blob のバイト。
contentType	String	blob のコンテンツ タイプ。null にできます。

戻る

Blob - 新しく作成された blob。

---

newBlob(data, contentType, name)

バイト配列、コンテンツ タイプ、名前から新しい Blob オブジェクトを作成します。blob は多くのアプリで使用されています。 バイナリデータを入力として受け取るスクリプト API。

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Creates a blob object from the byte array, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data as a string to the console.
console.log('Blob data:', blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

パラメータ

名前	型	説明
data	Byte[]	blob のバイト。
contentType	String	- blob のコンテンツ タイプ（null など）。
name	String	blob の名前（null など）。

戻る

Blob - 新しく作成された blob。

---

newBlob(data)

文字列から新しい Blob オブジェクトを作成します。blob は、多くの Apps Script API で使用され、 バイナリデータを入力として使用します。

// Declares a string for the blob.
const data = 'GOOGLE';

// Creates a blob object from a string.
const blob = Utilities.newBlob(data);

// Logs the blob data in byte array to the console.
console.log('Blob Data:', blob.getBytes());

パラメータ

名前	型	説明
data	String	blob の文字列（UTF-8 を想定）。

戻る

Blob - 新しく作成された blob。

---

newBlob(data, contentType)

文字列とコンテンツ タイプから新しい Blob オブジェクトを作成します。blob は多くの Apps Script で使用される バイナリデータを入力として受け取る API。

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of blob.
const contentType = 'application/json';

// Creates a blob object from the string and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

パラメータ

名前	型	説明
data	String	blob の文字列（UTF-8 を想定）。
contentType	String	blob のコンテンツ タイプ。null にできます。

戻る

Blob - 新しく作成された blob。

---

newBlob(data, contentType, name)

文字列、コンテンツ タイプ、名前から新しい Blob オブジェクトを作成します。blob は多くのアプリで使用されています。 バイナリデータを入力として受け取るスクリプト API。

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Create a blob object from the string, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

パラメータ

名前	型	説明
data	String	blob の文字列（UTF-8 を想定）。
contentType	String	blob のコンテンツ タイプ。null にできます。
name	String	blob の名前（null など）。

戻る

Blob - 新しく作成された blob。

---

parseCsv(csv)

CSV 文字列の表形式の 2D 配列表現を返します。

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
var csvString = "a,b,c\nd,e,f";
var data = Utilities.parseCsv(csvString);

パラメータ

名前	型	説明
csv	String	単一または複数行のデータを含むカンマ区切り値（CSV）の文字列 使用できます。

戻る

String[][] - CSV 文字列内の値を含む 2 次元配列。

---

parseCsv(csv, delimiter)

カスタムの区切り文字を使用して、CSV 文字列の表形式の 2D 配列表現を返します。

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
var csvString = "a\tb\tc\nd\te\tf";
var data = Utilities.parseCsv(csvString, '\t');

パラメータ

名前	型	説明
csv	String	単一または複数行のデータを含むカンマ区切り値（CSV）の文字列 使用できます。
delimiter	Char	値の間。

戻る

String[][] - CSV 文字列内の値を含む 2 次元配列。

---

parseDate(date, timeZone, format)

Java 標準 エディション SimpleDateFormat クラス。詳細については、Java SimpleDateFormat クラスをご覧ください。

// This set of parameters parses the given string as a date in Greenwich Mean Time, formatted
// as year-month-dateThour-minute-second.
var date = Utilities.parseDate("1970-01-01 00:00:00", "GMT", "yyyy-MM-dd' 'HH:mm:ss");
Logger.log(date);

パラメータ

名前	型	説明
date	String	日付として解析する文字列値。
timeZone	String	出力のタイムゾーン。
format	String	SimpleDateFormat 仕様の日付形式。

戻る

Date - 日付としての入力文字列。

---

sleep(milliseconds)

指定したミリ秒数の間スリープします。すぐにスクリプトがスリープ状態になり、 ミリ秒単位で表示されます。指定できる最大値は 300,000（5 分）です。

// Creates a blob object from a string.
const data = 'GOOGLE';
const blob = Utilities.newBlob(data);

// Puts the script to sleep for 10,000 milliseconds (10 seconds).
Utilities.sleep(10000);

// Logs the blob data in byte array to the console.
console.log(blob.getBytes());

パラメータ

名前	型	説明
milliseconds	Integer	スリープする時間（ミリ秒）。

---

ungzip(blob)

Blob オブジェクトを解凍し、圧縮されていないファイルを含む Blob を返します。 分析できます

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob, "text.gz");

// Uncompress the data.
var uncompressedBlob = Utilities.ungzip(gzipBlob);

パラメータ

名前	型	説明
blob	BlobSource	圧縮データの Blob。

戻る

Blob - 解凍データを表す Blob。

---

unzip(blob)

zip ファイルを表す blob を受け取り、そのコンポーネント ファイルを返します。

var googleFavIconUrl = "https://www.google.com/favicon.ico";
var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png";

// Fetch the Google favicon.ico file and get the Blob data
var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and logoBlob
var zip = Utilities.zip([faviconBlob, logoBlob], "google_images.zip");

// This now unzips the blobs
var files = Utilities.unzip(zip);

パラメータ

名前	型	説明
blob	BlobSource	zip ファイル blob。

戻る

Blob[] - コンポーネント blob を表す Blob[]。名前には ZIP

---

zip(blobs)

渡された blob のデータを含む ZIP ファイルである新しい Blob オブジェクトを作成します。

var googleFavIconUrl = "https://www.google.com/favicon.ico";
var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png";

// Fetch the Google favicon.ico file and get the Blob data
var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and logoBlob
var zip = Utilities.zip([faviconBlob, logoBlob]);

パラメータ

名前	型	説明
blobs	BlobSource[]	圧縮する blob の配列。

戻る

Blob - 入力をアーカイブとして含む新しい blob。

---

zip(blobs, name)

渡された blob のデータを含む ZIP ファイルである新しい Blob オブジェクトを作成します。この バージョンのメソッドではファイル名を指定できます。

var googleFavIconUrl = "https://www.google.com/favicon.ico";
var googleLogoUrl = "https://www.google.com/images/srpr/logo3w.png";

// Fetch the Google favicon.ico file and get the Blob data
var faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
var logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and logoBlob
var zip = Utilities.zip([faviconBlob, logoBlob], "google_images.zip");

パラメータ

名前	型	説明
blobs	BlobSource[]	圧縮する blob の配列。
name	String	作成する ZIP ファイルの名前。

戻る

Blob - 入力をアーカイブとして含む新しい blob。

サポート終了のメソッド

jsonParse(jsonString)

非推奨。2013 年 11 月現在、JSON.parse() に変更

渡された JSON 文字列に対応するオブジェクトを返します。

// Returns the object { name: "John Smith", company: "Virginia Company"}
var obj = Utilities.jsonParse('{"name":"John Smith","company":"Virginia Company"}');

パラメータ

名前	型	説明
jsonString	String	シリアル化解除する JavaScript オブジェクトの String 表現。

戻る

Object - 入力の JavaScript オブジェクト表現。

---

jsonStringify(obj)

非推奨。2013 年 11 月現在、JSON.stringify() に変更

渡されたオブジェクトの JSON 文字列を返します。

// Logs: {"name":"John Smith","company":"Virginia Company"}
var person = { name: "John Smith", company: "Virginia Company" };
var json = Utilities.jsonStringify(person);
Logger.log(json);

パラメータ

名前	型	説明
obj	Object	JSON にシリアル化する JavaScript オブジェクト

戻る

String - JSON シリアル化された JavaScript オブジェクト