Class Utilities

Dienstprogramme

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

Attribute

PropertyTypBeschreibung
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Methoden

MethodeRückgabetypKurzbeschreibung
base64Decode(encoded)Byte[]Decodiert einen base64-codierten String in ein UTF-8-Byte-Array.
base64Decode(encoded, charset)Byte[]Decodiert einen base64-codierten String in ein Bytearray 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)StringErzeugt einen base64-codierten String aus dem gegebenen Byte-Array.
base64Encode(data)StringErzeugt einen base-64-codierten String aus dem angegebenen String.
base64Encode(data, charset)StringErzeugt einen base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz.
base64EncodeWebSafe(data)StringGeneriert einen websicheren base64-codierten String aus dem angegebenen Byte-Array.
base64EncodeWebSafe(data)StringGeneriert einen websicheren base64-codierten String aus dem angegebenen String.
base64EncodeWebSafe(data, charset)StringErzeugt einen websicheren base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz.
computeDigest(algorithm, value)Byte[]Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen Byte[]-Wert.
computeDigest(algorithm, value)Byte[]Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen String-Wert.
computeDigest(algorithm, value, charset)Byte[]Berechnet mit dem angegebenen Algorithmus einen Digest für den angegebenen String-Wert mit dem angegebenen Zeichensatz.
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[]Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel und Wert.
computeHmacSignature(algorithm, value, key)Byte[]Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel und Wert.
computeHmacSignature(algorithm, value, key, charset)Byte[]Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel 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 mit 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)StringFormatiert Datum gemäß der in der Java SE SimpleDateFormat-Klasse beschriebenen Spezifikation.
formatString(template, args)StringFührt eine sprintf-ähnliche Stringformatierung mit Formatstrings im „%“-Stil durch.
getUuid()StringRufen Sie eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID()).
gzip(blob)Blobgzip komprimiert die bereitgestellten Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.
gzip(blob, name)Blobgzip komprimiert die bereitgestellten Blob-Daten und gibt sie in einem neuen Blob-Objekt zurück.
newBlob(data)BlobErstellt ein neues Blob-Objekt aus einem Byte-Array.
newBlob(data, contentType)BlobErstellt ein neues Blob-Objekt aus einem Byte-Array und einem Inhaltstyp.
newBlob(data, contentType, name)BlobErstellt ein neues Blob-Objekt aus einem Byte-Array, einem Inhaltstyp und einem Namen.
newBlob(data)BlobErstellt ein neues Blob-Objekt aus einem String.
newBlob(data, contentType)BlobErstellt ein neues Blob-Objekt aus einem String und Inhaltstyp.
newBlob(data, contentType, name)BlobErstellt ein neues Blob-Objekt aus einem String, einem Inhaltstyp und einem Namen.
parseCsv(csv)String[][]Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings zurück.
parseCsv(csv, delimiter)String[][]Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings unter Verwendung eines benutzerdefinierten Trennzeichens zurück.
parseDate(date, timeZone, format)DateAnalysiert das angegebene Stringdatum gemäß der Spezifikation, die in der SimpleDateFormat-Klasse der Java Standard Edition beschrieben ist.
sleep(milliseconds)voidSchlaft für eine bestimmte Anzahl von Millisekunden.
ungzip(blob)BlobDekomprimiert ein Blob-Objekt und gibt ein Blob-Objekt mit den unkomprimierten Daten zurück.
unzip(blob)Blob[]Nimmt einen Blob, der eine ZIP-Datei darstellt, und gibt deren Komponentendateien zurück.
zip(blobs)BlobErstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei handelt, die die Daten aus den übergebenen Blobs enthält.
zip(blobs, name)BlobErstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei handelt, die die Daten aus den übergebenen Blobs enthält.

Detaillierte Dokumentation

base64Decode(encoded)

Decodiert einen base64-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

NameTypBeschreibung
encodedStringEin Array von Datenbyte, die decodiert werden sollen.

Return

Byte[]: Die Rohdaten, die durch das base-64-codierte Argument als Byte-Array dargestellt werden.


base64Decode(encoded, charset)

Decodiert einen base64-codierten String in ein Bytearray 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

NameTypBeschreibung
encodedStringDie zu decodierende Datenzeichenfolge.
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt.

Return

Byte[]: Die Rohdaten, die durch das base-64-codierte Argument als Byte-Array dargestellt werden.


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

NameTypBeschreibung
encodedStringEin Array von Bytes aus websicheren Daten, die decodiert werden sollen.

Return

Byte[]: Die Rohdaten, die durch das base-64-Websicher-codierte Argument 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

NameTypBeschreibung
encodedStringZeichenfolge aus websicheren Daten, die decodiert werden sollen.
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt.

Return

Byte[]: Die Rohdaten, die durch das base-64-Websicher-codierte Argument als Byte-Array dargestellt werden.


base64Encode(data)

Erzeugt einen base64-codierten String aus dem gegebenen Byte-Array. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

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

NameTypBeschreibung
dataByte[]Ein Byte[] mit zu codierenden Daten.

Return

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


base64Encode(data)

Erzeugt einen base-64-codierten String aus dem angegebenen String. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataStringEntspricht der zu codierenden Zeichenfolge.

Return

String: Die base64-codierte Darstellung des Eingabestrings.


base64Encode(data, charset)

Erzeugt einen base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. Mit einem Charset können Zeichen so codiert werden, dass sie codiert werden können. Diese werden normalerweise in einem Binärformat ausgeführt, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel sein kann. Um die Daten kompatibel zu machen, werden sie im Allgemeinen in Base 64 codiert, eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base 64 wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

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

NameTypBeschreibung
dataStringDie zu codierende Datenzeichenfolge.
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt.

Return

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


base64EncodeWebSafe(data)

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

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

NameTypBeschreibung
dataByte[]Ein Array von Datenbyte, die codiert werden sollen.

Return

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


base64EncodeWebSafe(data)

Generiert einen websicheren base64-codierten String aus dem angegebenen String. Base64 ist eine gängige Codierung, die von einer Vielzahl von Tools akzeptiert wird, die keine Binärdaten annehmen können. Base64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder in XML-Dokumenten verwendet.

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

Parameter

NameTypBeschreibung
dataStringEntspricht der zu codierenden Zeichenfolge.

Return

String: Die websicher codierte Darstellung des Eingabestrings mit Base64.


base64EncodeWebSafe(data, charset)

Erzeugt einen websicheren base64-codierten String aus dem angegebenen String in einem bestimmten Zeichensatz. Mit einem Charset können Zeichen so codiert werden, dass sie codiert werden können. Sie werden in der Regel in einem Binärformat erstellt, das im Allgemeinen mit bestimmten Datenübertragungsprotokollen nicht kompatibel sein kann. Um die Daten kompatibel zu machen, werden sie im Allgemeinen in Base 64 codiert. Diese Codierung wird häufig von einer Vielzahl von Tools akzeptiert, die keine Binärdaten annehmen können. Base 64 websicher wird häufig in Internetprotokollen wie E-Mail, HTTP oder in 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

NameTypBeschreibung
dataStringDie zu codierende Datenzeichenfolge.
charsetCharsetEin Charset, der den Zeichensatz der Eingabe angibt.

Return

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


computeDigest(algorithm, value)

Berechnet mit dem angegebenen Algorithmus einen Digest 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

NameTypBeschreibung
algorithmDigestAlgorithmEin zu verwendendes DigestAlgorithm.
valueByte[]Ein Eingabestringwert, für den ein Digest berechnet werden soll.

Return

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


computeDigest(algorithm, value)

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

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

Parameter

NameTypBeschreibung
algorithmDigestAlgorithmEin zu verwendendes DigestAlgorithm.
valueStringEin Eingabestringwert, für den ein Digest berechnet werden soll.

Return

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


computeDigest(algorithm, value, charset)

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

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

Parameter

NameTypBeschreibung
algorithmDigestAlgorithmEin zu verwendendes DigestAlgorithm.
valueStringEin Eingabestringwert, für den ein Digest berechnet werden soll.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Return

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

NameTypBeschreibung
valueByte[]Der Eingabewert, für den ein Hash generiert werden soll.
keyByte[]Ein Schlüssel, mit dem der Hash generiert wird.

Return

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

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel, mit dem der Hash generiert wird.

Return

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

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel, mit dem der Hash generiert wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Return

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


computeHmacSignature(algorithm, value, key)

Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel 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

NameTypBeschreibung
algorithmMacAlgorithmEin MacAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
valueByte[]Der Eingabewert, für den ein Hash generiert werden soll.
keyByte[]Ein Schlüssel, mit dem der Hash generiert wird.

Return

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


computeHmacSignature(algorithm, value, key)

Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel 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

NameTypBeschreibung
algorithmMacAlgorithmEin MacAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel, mit dem der Hash generiert wird.

Return

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


computeHmacSignature(algorithm, value, key, charset)

Berechnet mithilfe des angegebenen Algorithmus einen Nachrichtenauthentifizierungscode für den angegebenen Schlüssel 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

NameTypBeschreibung
algorithmMacAlgorithmEin MacAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel, mit dem der Hash generiert wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Return

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

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird.

Return

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

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Return

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

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird.

Return

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

NameTypBeschreibung
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Return

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


computeRsaSignature(algorithm, value, key)

Signiert den angegebenen Wert mit dem angegebenen RSA-Algorithmus mit 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

NameTypBeschreibung
algorithmRsaAlgorithmEin RsaAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird.

Return

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

NameTypBeschreibung
algorithmRsaAlgorithmEin RsaAlgorithm-Algorithmus, mit dem der Eingabewert gehasht wird.
valueStringDer Eingabewert, für den ein Hash generiert werden soll.
keyStringEin Schlüssel im PEM-Format, der zum Generieren der Signatur verwendet wird.
charsetCharsetEin Charset, der den Eingabezeichensatz darstellt.

Return

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


formatDate(date, timeZone, format)

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

NameTypBeschreibung
dateDateEin Date, der als String formatiert werden soll.
timeZoneStringDie Ausgabezeitzone des Ergebnisses.
formatStringEin Format gemäß der SimpleDateFormat-Spezifikation.

Return

String: Das Eingabedatum als formatierter String.


formatString(template, args)

Führt eine sprintf-ähnliche Stringformatierung mit Formatstrings im „%“-Stil durch.

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

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

Parameter

NameTypBeschreibung
templateStringDer Formatstring, der steuert, was zurückgegeben wird.
argsObject...Objekte, die zum Ausfüllen der "%"-Platzhalter in der Vorlage verwendet werden

Return

String: Der formatierte String.


getUuid()

Rufen Sie eine UUID als String ab (entspricht der Verwendung der Methode java.util.UUID.randomUUID()). Es kann nicht garantiert werden, dass diese Kennung über die gesamte Zeit und den gesamten Raum eindeutig ist. Verwenden Sie diese Methode daher nicht in Situationen, in denen 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();
};

Return

String: Eine Stringdarstellung der UUID.


gzip(blob)

gzip komprimiert die bereitgestellten 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

NameTypBeschreibung
blobBlobSourceEin Blob-Objekt, das mit gzip komprimiert werden soll.

Return

Blob: Ein neuer Blob mit den komprimierten Daten.


gzip(blob, name)

gzip komprimiert die bereitgestellten 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

NameTypBeschreibung
blobBlobSourceEin Blob-Objekt, das mit gzip komprimiert werden soll.
nameStringDer Name der gzip-Datei, die erstellt werden soll.

Return

Blob: Ein neuer Blob mit den komprimierten Daten.


newBlob(data)

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

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

NameTypBeschreibung
dataByte[]Die Byte für das Blob.

Return

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 APIs verwendet, 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';

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

NameTypBeschreibung
dataByte[]Die Byte für das Blob.
contentTypeStringDer Inhaltstyp des Blobs kann null sein.

Return

Blob: Das neu erstellte Blob.


newBlob(data, contentType, name)

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

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

NameTypBeschreibung
dataByte[]Die Byte für das Blob.
contentTypeString– Der Inhaltstyp des Blobs kann null sein.
nameStringDer Name des Blobs kann null sein.

Return

Blob: Das neu erstellte Blob.


newBlob(data)

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

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

NameTypBeschreibung
dataStringDer String für das Blob (UTF-8).

Return

Blob: Das neu erstellte Blob.


newBlob(data, contentType)

Erstellt ein neues Blob-Objekt aus einem String und Inhaltstyp. Blobs werden in vielen Apps Script APIs verwendet, die Binärdaten 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

NameTypBeschreibung
dataStringDer String für das Blob (UTF-8).
contentTypeStringDer Inhaltstyp des Blobs kann null sein.

Return

Blob: Das neu erstellte Blob.


newBlob(data, contentType, name)

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

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

NameTypBeschreibung
dataStringDer String für das Blob (UTF-8).
contentTypeStringDer Inhaltstyp des Blobs kann null sein.
nameStringDer Name des Blobs kann null sein.

Return

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

NameTypBeschreibung
csvStringEin String, der ein- oder mehrzeilige Daten im CSV-Format (kommagetrennte Werte) enthält.

Return

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


parseCsv(csv, delimiter)

Gibt eine tabellarische 2D-Arraydarstellung eines CSV-Strings 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

NameTypBeschreibung
csvStringEin String, der ein- oder mehrzeilige Daten im CSV-Format (kommagetrennte Werte) enthält.
delimiterCharZwischen Werten.

Return

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


parseDate(date, timeZone, format)

Analysiert das angegebene Stringdatum gemäß der Spezifikation, die in der SimpleDateFormat-Klasse der Java Standard Edition beschrieben ist. 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

NameTypBeschreibung
dateStringEin Stringwert, der als Datum geparst werden soll.
timeZoneStringDie Zeitzone der Ausgabe.
formatStringDas Datumsformat gemäß der SimpleDateFormat-Spezifikation.

Return

Date: Der Eingabestring als Datum.


sleep(milliseconds)

Schlaft für eine bestimmte Anzahl von Millisekunden. Versetzt das Skript sofort für die angegebene Anzahl von Millisekunden in den Ruhemodus. 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

NameTypBeschreibung
millisecondsIntegerDie Anzahl der Millisekunden, die geschlafen werden soll.

ungzip(blob)

Dekomprimiert ein Blob-Objekt und gibt ein Blob-Objekt mit den unkomprimierten Daten zurück.

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

NameTypBeschreibung
blobBlobSourceDie Blob komprimierter Daten.

Return

Blob: Ein Blob, der die dekomprimierten Daten darstellt.


unzip(blob)

Nimmt einen Blob, der eine ZIP-Datei darstellt, und gibt deren 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

NameTypBeschreibung
blobBlobSourceDas ZIP-Datei-Blob.

Return

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


zip(blobs)

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

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

NameTypBeschreibung
blobsBlobSource[]Ein Array von Blobs, die verpackt werden sollen.

Return

Blob: Ein neues Blob, das die Eingaben als Archiv enthält.


zip(blobs, name)

Erstellt ein neues Blob-Objekt, bei dem es sich um eine ZIP-Datei handelt, die die Daten aus den übergebenen Blobs enthält. Mit dieser Version der Methode kann ein Dateiname angegeben werden.

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

NameTypBeschreibung
blobsBlobSource[]Ein Array von Blobs, die verpackt werden sollen.
nameStringDer Name der zu erstellenden ZIP-Datei.

Return

Blob: Ein neues Blob, das die Eingaben als Archiv enthält.

Verworfene Methoden