Class Utilities

Dienstprogramme

Dieser Dienst bietet Dienstprogramme für die Codierung/Decodierung von Zeichenfolgen, die Datumsformatierung, JSON-Bearbeitung und andere Aufgaben.

Attribute

Attribut	Typ	Beschreibung
Charset	Charset
DigestAlgorithm	DigestAlgorithm
MacAlgorithm	MacAlgorithm
RsaAlgorithm	RsaAlgorithm

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
base64Decode(encoded)	Byte[]	Decodiert einen base-64-codierten String in ein UTF-8-Byte-Array.
base64Decode(encoded, charset)	Byte[]	Decodiert einen base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz.
base64DecodeWebSafe(encoded)	Byte[]	Decodiert einen websicheren Base-64-codierten String in ein UTF-8-Byte-Array.
base64DecodeWebSafe(encoded, charset)	Byte[]	Decodiert einen websicheren, base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz.
base64Encode(data)	String	Generiert einen base-64-codierten String aus dem angegebenen Byte-Array.
base64Encode(data)	String	Generiert einen base-64-codierten String aus dem angegebenen String.
base64Encode(data, charset)	String	Erzeugt einen base-64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz.
base64EncodeWebSafe(data)	String	Generiert einen websicheren, base-64-codierten String aus dem angegebenen Byte-Array.
base64EncodeWebSafe(data)	String	Generiert einen base-64-websicheren, codierten String aus dem angegebenen String.
base64EncodeWebSafe(data, charset)	String	Generiert einen base-64 websicheren, codierten String aus dem gegebenen String in einem bestimmten Zeichensatz.
computeDigest(algorithm, value)	Byte[]	Berechnet einen Digest mit dem angegebenen Algorithmus für den angegebenen Byte[]-Wert.
computeDigest(algorithm, value)	Byte[]	Berechnet einen Digest mit dem angegebenen Algorithmus für den angegebenen String-Wert.
computeDigest(algorithm, value, charset)	Byte[]	Berechnet einen Digest mit dem angegebenen Algorithmus für den angegebenen String-Wert mit dem Zeichensatzes verwendet.
computeHmacSha256Signature(value, key)	Byte[]	Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.
computeHmacSha256Signature(value, key)	Byte[]	Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.
computeHmacSha256Signature(value, key, charset)	Byte[]	Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel und Zeichensatz.
computeHmacSignature(algorithm, value, key)	Byte[]	Mit dem angegebenen Algorithmus für den angegebenen Schlüssel einen Nachrichtenauthentifizierungscode berechnen und Wert.
computeHmacSignature(algorithm, value, key)	Byte[]	Mit dem angegebenen Algorithmus für den angegebenen Schlüssel einen Nachrichtenauthentifizierungscode berechnen und Wert.
computeHmacSignature(algorithm, value, key, charset)	Byte[]	Mit dem angegebenen Algorithmus für den angegebenen Schlüssel einen Nachrichtenauthentifizierungscode berechnen und Wert.
computeRsaSha1Signature(value, key)	Byte[]	Signiert den angegebenen Wert mit RSA-SHA1 mit dem angegebenen Schlüssel.
computeRsaSha1Signature(value, key, charset)	Byte[]	Signiert den angegebenen Wert mit RSA-SHA1 mit dem angegebenen Schlüssel und Zeichensatz.
computeRsaSha256Signature(value, key)	Byte[]	Signiert den angegebenen Wert mit RSA-SHA256 mit dem angegebenen Schlüssel.
computeRsaSha256Signature(value, key, charset)	Byte[]	Signiert den angegebenen Wert mit RSA-SHA256 mit dem angegebenen Schlüssel.
computeRsaSignature(algorithm, value, key)	Byte[]	Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus und dem angegebenen Schlüssel.
computeRsaSignature(algorithm, value, key, charset)	Byte[]	Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel und Zeichensatz.
formatDate(date, timeZone, format)	String	Formatiert das Datum gemäß der in der Java SE SimpleDateFormat-Klasse beschriebenen Spezifikation.
formatString(template, args)	String	Führt eine sprintf-ähnliche Stringformatierung mithilfe von Stringformaten im %-Stil durch.
getUuid()	String	Rufen Sie eine UUID als String ab (entspricht der Methode java.util.UUID.randomUUID()).
gzip(blob)	Blob	gzip komprimiert die Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.
gzip(blob, name)	Blob	gzip komprimiert die Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.
newBlob(data)	Blob	Erstellt ein neues Blob-Objekt aus einem Byte-Array.
newBlob(data, contentType)	Blob	Erstellt ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp.
newBlob(data, contentType, name)	Blob	Erstellt ein neues Blob-Objekt aus einem Byte-Array, Inhaltstyp und Namen.
newBlob(data)	Blob	Erstellt ein neues Blob-Objekt aus einem String.
newBlob(data, contentType)	Blob	Erstellt ein neues Blob-Objekt aus einem String und Inhaltstyp.
newBlob(data, contentType, name)	Blob	Erstellt ein neues Blob-Objekt aus einem String, Inhaltstyp und Namen.
parseCsv(csv)	String[][]	Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings zurück.
parseCsv(csv, delimiter)	String[][]	Gibt eine tabellarische 2D-Array-Darstellung einer CSV-Zeichenfolge unter Verwendung eines benutzerdefinierten Trennzeichens zurück.
parseDate(date, timeZone, format)	Date	Analysiert das angegebene Stringdatum gemäß der im Java-Standard beschriebenen Spezifikation. Version SimpleDateFormat-Klasse.
sleep(milliseconds)	void	Ruhemodus für eine bestimmte Anzahl von Millisekunden
ungzip(blob)	Blob	Dekomprimiert ein Blob-Objekt und gibt ein Blob zurück, das das unkomprimierte Daten.
unzip(blob)	Blob[]	Nimmt ein Blob an, das eine ZIP-Datei darstellt, und gibt die zugehörigen Komponentendateien zurück.
zip(blobs)	Blob	Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei mit den Daten aus den übergebenen Blobs handelt.
zip(blobs, name)	Blob	Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei mit den Daten aus den übergebenen Blobs handelt.

Verworfene Methoden

Methode	Rückgabetyp	Kurzbeschreibung
jsonParse(jsonString)	Object	Gibt ein Objekt zurück, das dem übergebenen JSON-String entspricht.
jsonStringify(obj)	String	Gibt einen JSON-String des übergebenen Objekts zurück.

Detaillierte Dokumentation

base64Decode(encoded)

Decodiert einen base-64-codierten String in ein UTF-8-Byte-Array.

// 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());

Parameter

Name	Typ	Beschreibung
encoded	String	Ein Array von Datenbyte, das decodiert werden soll.

Rückflug

Byte[]: Die durch das base-64-codierten Argument dargestellten Rohdaten als Byte-Array.

---

base64Decode(encoded, charset)

Decodiert einen base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz.

// 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());

Parameter

Name	Typ	Beschreibung
encoded	String	Der zu decodierende Datenstring.
charset	Charset	Ein Charset, der den Zeichensatz der Eingabe angibt.

Rückflug

Byte[]: Die durch das base-64-codierten Argument dargestellten Rohdaten als Byte-Array.

---

base64DecodeWebSafe(encoded)

Decodiert einen websicheren Base-64-codierten String in ein UTF-8-Byte-Array.

// 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());

Parameter

Name	Typ	Beschreibung
encoded	String	Ein Array von Bytes mit websicheren Daten, die decodiert werden sollen.

Rückflug

Byte[]: Die Rohdaten, die durch das websicher codierte Argument mit Base64 als Byte-Array dargestellt werden.

---

base64DecodeWebSafe(encoded, charset)

Decodiert einen websicheren Base-64-codierten String in ein Byte-Array in einem bestimmten Zeichensatz.

// 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());

Parameter

Name	Typ	Beschreibung
encoded	String	Der zu decodierende String aus websicheren Daten.
charset	Charset	Ein Charset, der den Zeichensatz der Eingabe angibt.

Rückflug

Byte[]: Die Rohdaten, die durch das websicher codierte Argument mit Base64 als Byte-Array dargestellt werden.

---

base64Encode(data)

Generiert einen base-64-codierten String aus dem angegebenen Byte-Array. Base64 ist eine gängige Codierung, von verschiedenen Tools akzeptiert werden, die keine Binärdaten akzeptieren. Base64 wird häufig in wie E-Mail, HTTP oder XML-Dokumente.

// 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);

Parameter

Name	Typ	Beschreibung
data	Byte[]	Ein Byte[] mit zu codierenden Daten.

Rückflug

String: Die base-64-codierte Darstellung der übergebenen Daten.

---

base64Encode(data)

Generiert einen base-64-codierten String aus dem angegebenen String. Base64 ist eine gängige Codierung, die akzeptiert wird. die keine Binärdaten akzeptieren können. Base64 wird im Internet häufig verwendet wie E-Mail, HTTP oder XML-Dokumente.

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

Parameter

Name	Typ	Beschreibung
data	String	Die zu codierende Zeichenfolge.

Rückflug

String: Die base-64-codierte Darstellung des Eingabestrings.

---

base64Encode(data, charset)

Generiert einen base-64-codierten String aus dem gegebenen String in einem bestimmten Zeichensatz. Ein Schnurrbart ist eine Möglichkeit, Zeichen so zu codieren, dass sie codiert werden können. Diese werden in der Regel Binärformat, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel sein kann. Bis machen die Daten kompatibel. Sie werden in der Regel in Base64 codiert. Dies ist eine von verschiedenen Tools akzeptiert werden, die keine Binärdaten akzeptieren. Base64 wird häufig in wie E-Mail, HTTP oder XML-Dokumente.

// "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);

Parameter

Name	Typ	Beschreibung
data	String	Der zu codierende Datenstring.
charset	Charset	Ein Charset, der den Zeichensatz der Eingabe angibt.

Rückflug

String: Die base-64-codierte Darstellung des Eingabestrings mit dem angegebenen Charset.

---

base64EncodeWebSafe(data)

Generiert einen websicheren, base-64-codierten String aus dem angegebenen Byte-Array. Base64 ist eine gängige Codierung wird von einer Vielzahl von Tools akzeptiert, die keine Binärdaten akzeptieren. Base64 websicher ist die häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet werden.

// 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);

Parameter

Name	Typ	Beschreibung
data	Byte[]	Ein Array von zu codierenden Datenbyte.

Rückflug

String: Die websichere, base64-codierte Darstellung der übergebenen Daten.

---

base64EncodeWebSafe(data)

Generiert aus dem angegebenen String einen websicheren, base-64-codierten String. Base64 ist eine gängige Codierung, von verschiedenen Tools akzeptiert werden, die keine Binärdaten akzeptieren. Die Base64-Websicherheit ist meist die in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet werden.

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

Parameter

Name	Typ	Beschreibung
data	String	Die zu codierende Zeichenfolge.

Rückflug

String: Die websichere codierte Darstellung des Eingabestrings in Base64.

---

base64EncodeWebSafe(data, charset)

Generiert einen base-64 websicheren, codierten String aus dem gegebenen String in einem bestimmten Zeichensatz. Ein Charset ist eine Möglichkeit, Zeichen so zu codieren, dass sie codiert werden können. Das sind in der Regel in einem Binärformat erfolgen, das mit bestimmten Datenübertragungen Protokolle. Um die Daten kompatibel zu machen, werden sie in der Regel in Base64 codiert. Dies ist ein gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten akzeptieren. Base64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder XML-Dokumenten verwendet.

// "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);

Parameter

Name	Typ	Beschreibung
data	String	Der zu codierende Datenstring.
charset	Charset	Ein Charset, der den Zeichensatz der Eingabe angibt.

Rückflug

String: Die websichere codierte Darstellung des Eingabestrings mit Base64 und dem angegebenen Charset.

---

computeDigest(algorithm, value)

Berechnet einen Digest mit dem angegebenen Algorithmus für den angegebenen Byte[]-Wert.

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

Parameter

Name	Typ	Beschreibung
algorithm	DigestAlgorithm	Ein zu verwendendes DigestAlgorithm.
value	Byte[]	Ein Eingabestringwert, für den ein Digest berechnet werden soll.

Rückflug

Byte[]: Ein Byte[], das den Ausgabe-Digest darstellt.

---

computeDigest(algorithm, value)

Berechnet einen Digest mit dem angegebenen Algorithmus für den angegebenen String-Wert.

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

Parameter

Name	Typ	Beschreibung
algorithm	DigestAlgorithm	Ein zu verwendendes DigestAlgorithm.
value	String	Ein Eingabestringwert, für den ein Digest berechnet werden soll.

Rückflug

Byte[]: Ein Byte[], das den Ausgabe-Digest darstellt.

---

computeDigest(algorithm, value, charset)

Berechnet einen Digest mit dem angegebenen Algorithmus für den angegebenen String-Wert mit dem Zeichensatzes verwendet.

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

Parameter

Name	Typ	Beschreibung
algorithm	DigestAlgorithm	Ein zu verwendendes DigestAlgorithm.
value	String	Ein Eingabestringwert, für den ein Digest berechnet werden soll.
charset	Charset	Ein Charset, das den eingegebenen Zeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[], das den Ausgabe-Digest darstellt.

---

computeHmacSha256Signature(value, key)

Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.

// 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);

Parameter

Name	Typ	Beschreibung
value	Byte[]	Der Eingabewert, für den ein Hash generiert werden soll.
key	Byte[]	Ein Schlüssel zum Generieren des Hashs.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeHmacSha256Signature(value, key)

Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel.

// 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);

Parameter

Name	Typ	Beschreibung
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel zum Generieren des Hashs.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeHmacSha256Signature(value, key, charset)

Signiert den angegebenen Wert mithilfe von HMAC-SHA256 mit dem angegebenen Schlüssel und Zeichensatz.

// 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);

Parameter

Name	Typ	Beschreibung
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel zum Generieren des Hashs.
charset	Charset	Ein Charset, das den eingegebenen Zeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeHmacSignature(algorithm, value, key)

Mit dem angegebenen Algorithmus für den angegebenen Schlüssel einen Nachrichtenauthentifizierungscode berechnen und Wert.

// 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);

Parameter

Name	Typ	Beschreibung
algorithm	MacAlgorithm	Ein MacAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
value	Byte[]	Der Eingabewert, für den ein Hash generiert werden soll.
key	Byte[]	Ein Schlüssel zum Generieren des Hashs.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeHmacSignature(algorithm, value, key)

Mit dem angegebenen Algorithmus für den angegebenen Schlüssel einen Nachrichtenauthentifizierungscode berechnen und Wert.

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

Parameter

Name	Typ	Beschreibung
algorithm	MacAlgorithm	Ein MacAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel zum Generieren des Hashs.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeHmacSignature(algorithm, value, key, charset)

Mit dem angegebenen Algorithmus für den angegebenen Schlüssel einen Nachrichtenauthentifizierungscode berechnen und Wert.

// 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);

Parameter

Name	Typ	Beschreibung
algorithm	MacAlgorithm	Ein MacAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel zum Generieren des Hashs.
charset	Charset	Ein Charset, das den eingegebenen Zeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeRsaSha1Signature(value, key)

Signiert den angegebenen Wert mit RSA-SHA1 mit dem angegebenen Schlüssel.

// 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);

Parameter

Name	Typ	Beschreibung
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel im PEM-Format, mit dem die Signatur generiert wird.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeRsaSha1Signature(value, key, charset)

Signiert den angegebenen Wert mit RSA-SHA1 mit dem angegebenen Schlüssel und Zeichensatz.

// 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);

Parameter

Name	Typ	Beschreibung
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel im PEM-Format, mit dem die Signatur generiert wird.
charset	Charset	Ein Charset, das den eingegebenen Zeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeRsaSha256Signature(value, key)

Signiert den angegebenen Wert mit RSA-SHA256 mit dem angegebenen Schlüssel.

// 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);

Parameter

Name	Typ	Beschreibung
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel im PEM-Format, mit dem die Signatur generiert wird.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeRsaSha256Signature(value, key, charset)

Signiert den angegebenen Wert mit RSA-SHA256 mit dem angegebenen Schlüssel.

// 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);

Parameter

Name	Typ	Beschreibung
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel im PEM-Format, mit dem die Signatur generiert wird.
charset	Charset	Ein Charset, das den eingegebenen Zeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeRsaSignature(algorithm, value, key)

Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus und dem angegebenen Schlüssel.

// 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);

Parameter

Name	Typ	Beschreibung
algorithm	RsaAlgorithm	Ein RsaAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel im PEM-Format, mit dem die Signatur generiert wird.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

computeRsaSignature(algorithm, value, key, charset)

Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus mit dem angegebenen Schlüssel und Zeichensatz.

// 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);

Parameter

Name	Typ	Beschreibung
algorithm	RsaAlgorithm	Ein RsaAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
value	String	Der Eingabewert, für den ein Hash generiert werden soll.
key	String	Ein Schlüssel im PEM-Format, mit dem die Signatur generiert wird.
charset	Charset	Ein Charset, das den eingegebenen Zeichensatz darstellt.

Rückflug

Byte[]: Ein Byte[], das die Ausgabesignatur darstellt.

---

formatDate(date, timeZone, format)

Formatiert das Datum gemäß der in der Java SE SimpleDateFormat-Klasse beschriebenen Spezifikation. Bitte finden Sie in der Spezifikation unter 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);

Parameter

Name	Typ	Beschreibung
date	Date	Ein Date zum Formatieren als String.
timeZone	String	Die Ausgabezeitzone des Ergebnisses.
format	String	Ein Format gemäß der SimpleDateFormat-Spezifikation.

Rückflug

String: Das Eingabedatum als formatierter String.

---

formatString(template, args)

Führt eine sprintf-ähnliche Stringformatierung mithilfe von Stringformaten im %-Stil durch.

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

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

Parameter

Name	Typ	Beschreibung
template	String	Der Formatstring, der steuert, was zurückgegeben wird.
args	Object...	Objekte zum Ausfüllen von '%' Platzhalter in der Vorlage.

Rückflug

String: Der formatierte String.

---

getUuid()

Rufen Sie eine UUID als String ab (entspricht der Methode java.util.UUID.randomUUID()). Es kann nicht garantiert werden, dass diese Kennung immer und überall. Verwenden Sie es daher nicht in Situationen, in denen eine garantierte Eindeutigkeit erforderlich ist.

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

Rückflug

String: Ein Stringdarstellung der UUID.

---

gzip(blob)

gzip komprimiert die Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.

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

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

Parameter

Name	Typ	Beschreibung
blob	BlobSource	Ein Blob-Objekt, das mit gzip komprimiert werden soll.

Rückflug

Blob: Eine neue Blob, die die komprimierten Daten enthält.

---

gzip(blob, name)

gzip komprimiert die Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück. Diese Version der Methode ermöglicht die Angabe eines Dateinamens.

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

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

Parameter

Name	Typ	Beschreibung
blob	BlobSource	Ein Blob-Objekt, das mit gzip komprimiert werden soll.
name	String	Der Name der Datei gzip, die erstellt werden soll.

Rückflug

Blob: Eine neue Blob, die die komprimierten Daten enthält.

---

newBlob(data)

Erstellt ein neues Blob-Objekt aus einem Byte-Array. Blobs werden in vielen Apps Script APIs verwendet, Binärdaten als Eingabe.

// 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());

Parameter

Name	Typ	Beschreibung
data	Byte[]	Die Byte für das Blob.

Rückflug

Blob: Das neu erstellte Blob.

---

newBlob(data, contentType)

Erstellt ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp. Blobs werden in vielen Apps Script verwendet APIs, die binäre Daten als Eingabe verwenden

// 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());

Parameter

Name	Typ	Beschreibung
data	Byte[]	Die Byte für das Blob.
contentType	String	Der Inhaltstyp des Blobs – kann null sein.

Rückflug

Blob: Das neu erstellte Blob.

---

newBlob(data, contentType, name)

Erstellt ein neues Blob-Objekt aus einem Byte-Array, Inhaltstyp und Namen. Blobs werden in vielen Anwendungen verwendet Script-APIs, die Binärdaten als Eingabe verwenden

// 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());

Parameter

Name	Typ	Beschreibung
data	Byte[]	Die Byte für das Blob.
contentType	String	– Der Inhaltstyp des Blobs – kann null sein.
name	String	Der Name des Blobs – kann null sein.

Rückflug

Blob: Das neu erstellte Blob.

---

newBlob(data)

Erstellt ein neues Blob-Objekt aus einem String. Blobs werden in vielen Apps Script APIs verwendet, Binärdaten als Eingabe.

// 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());

Parameter

Name	Typ	Beschreibung
data	String	Der String für das Blob, angenommen UTF-8.

Rückflug

Blob: Das neu erstellte Blob.

---

newBlob(data, contentType)

Erstellt ein neues Blob-Objekt aus einem String und Inhaltstyp. Blobs werden in vielen Apps Script verwendet APIs, die binäre Daten als Eingabe verwenden

// 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());

Parameter

Name	Typ	Beschreibung
data	String	Der String für das Blob, angenommen UTF-8.
contentType	String	Der Inhaltstyp des Blobs – kann null sein.

Rückflug

Blob: Das neu erstellte Blob.

---

newBlob(data, contentType, name)

Erstellt ein neues Blob-Objekt aus einem String, Inhaltstyp und Namen. Blobs werden in vielen Anwendungen verwendet Script-APIs, die Binärdaten als Eingabe verwenden

// 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());

Parameter

Name	Typ	Beschreibung
data	String	Der String für das Blob, angenommen UTF-8.
contentType	String	Der Inhaltstyp des Blobs – kann null sein.
name	String	Der Name des Blobs – kann null sein.

Rückflug

Blob: Das neu erstellte Blob.

---

parseCsv(csv)

Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings zurück.

// 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);

Parameter

Name	Typ	Beschreibung
csv	String	Ein String mit ein- oder mehrzeiligen Daten als kommagetrennten Wert (CSV) Format.

Rückflug

String[][]: Ein zweidimensionales Array, das die Werte im CSV-String enthält.

---

parseCsv(csv, delimiter)

Gibt eine tabellarische 2D-Array-Darstellung einer CSV-Zeichenfolge unter Verwendung eines benutzerdefinierten Trennzeichens zurück.

// 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');

Parameter

Name	Typ	Beschreibung
csv	String	Ein String mit ein- oder mehrzeiligen Daten als kommagetrennten Wert (CSV) Format.
delimiter	Char	Zwischen Werten.

Rückflug

String[][]: Ein zweidimensionales Array, das die Werte im CSV-String enthält.

---

parseDate(date, timeZone, format)

Analysiert das angegebene Stringdatum gemäß der im Java-Standard beschriebenen Spezifikation. Klasse der Version SimpleDateFormat. Weitere Informationen finden Sie in der Java-Klasse 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);

Parameter

Name	Typ	Beschreibung
date	String	Ein Stringwert, der als Datum geparst werden soll.
timeZone	String	Die Zeitzone der Ausgabe.
format	String	Das Datumsformat gemäß der SimpleDateFormat-Spezifikation.

Rückflug

Date: Der Eingabestring als Datum.

---

sleep(milliseconds)

Ruhemodus für eine bestimmte Anzahl von Millisekunden Versetzt das Skript sofort in den Ruhemodus angegebene Anzahl von Millisekunden Der maximal zulässige Wert ist 300.000 (oder 5 Minuten).

// 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());

Parameter

Name	Typ	Beschreibung
milliseconds	Integer	Anzahl der Millisekunden, die in den Ruhemodus versetzt werden sollen.

---

ungzip(blob)

Dekomprimiert ein Blob-Objekt und gibt ein Blob zurück, das das unkomprimierte Daten.

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);

Parameter

Name	Typ	Beschreibung
blob	BlobSource	Die Blob für komprimierte Daten.

Rückflug

Blob: Ein Blob-Wert für die dekomprimierten Daten.

---

unzip(blob)

Nimmt ein Blob an, das eine ZIP-Datei darstellt, und gibt die zugehörigen Komponentendateien zurück.

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);

Parameter

Name	Typ	Beschreibung
blob	BlobSource	Das ZIP-Datei-Blob.

Rückflug

Blob[]: Ein Blob[], das die Komponenten-Blobs darstellt, die jeweils mit dem vollständigen Pfad innerhalb der ZIP-Datei.

---

zip(blobs)

Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei mit den Daten aus den übergebenen Blobs handelt.

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]);

Parameter

Name	Typ	Beschreibung
blobs	BlobSource[]	Ein Array von Blobs, die gezippt werden sollen.

Rückflug

Blob: Ein neues Blob mit den Eingaben als Archiv.

---

zip(blobs, name)

Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei mit den Daten aus den übergebenen Blobs handelt. Dieses -Version der Methode ermöglicht die Angabe eines Dateinamens.

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");

Parameter

Name	Typ	Beschreibung
blobs	BlobSource[]	Ein Array von Blobs, die gezippt werden sollen.
name	String	Der Name der zu erstellenden ZIP-Datei.

Rückflug

Blob: Ein neues Blob mit den Eingaben als Archiv.

Verworfene Methoden

jsonParse(jsonString)

Veraltet. Ab November 2013, ersetzt durch JSON.parse()

Gibt ein Objekt zurück, das dem übergebenen JSON-String entspricht.

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

Parameter

Name	Typ	Beschreibung
jsonString	String	Stringdarstellung eines zu deserialisierenden JavaScript-Objekts.

Rückflug

Object: Eine JavaScript-Objektdarstellung der Eingabe.

---

jsonStringify(obj)

Veraltet. Ab November 2013, ersetzt durch JSON.stringify()

Gibt einen JSON-String des übergebenen Objekts zurück.

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

Parameter

Name	Typ	Beschreibung
obj	Object	das JavaScript-Objekt, das in JSON serialisiert werden soll

Rückflug

String – Ein JSON-serialisiertes JavaScript-Objekt