Class Utilities

Utilitários

Esse serviço fornece utilitários para codificação/decodificação de strings, formatação de datas, manipulação de JSON e outras tarefas diversas.

Propriedades

PropriedadeTipoDescrição
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

Métodos

MétodoTipo de retornoBreve descrição
base64Decode(encoded)Byte[]Decodifica uma string codificada em base64 em uma matriz de bytes UTF-8.
base64Decode(encoded, charset)Byte[]Decodifica uma string codificada em base64 em uma matriz de bytes em um conjunto de caracteres específico.
base64DecodeWebSafe(encoded)Byte[]Decodifica uma string codificada e segura para a Web em base64 em uma matriz de bytes UTF-8.
base64DecodeWebSafe(encoded, charset)Byte[]Decodifica uma string codificada e segura para a Web em base64 em uma matriz de bytes em um conjunto de caracteres específico.
base64Encode(data)StringGera uma string codificada em base64 a partir da matriz de bytes fornecida.
base64Encode(data)StringGera uma string codificada em base64 a partir da string fornecida.
base64Encode(data, charset)StringGera uma string codificada em base64 a partir da string fornecida em um conjunto de caracteres específico.
base64EncodeWebSafe(data)StringGera uma string codificada e segura para a Web em base64 com base na matriz de bytes fornecida.
base64EncodeWebSafe(data)StringGera uma string codificada e segura para a Web em base64 a partir da string fornecida.
base64EncodeWebSafe(data, charset)StringGera uma string codificada e segura para a Web em base64 a partir da string fornecida em um conjunto de caracteres específico.
computeDigest(algorithm, value)Byte[]Calcule um resumo usando o algoritmo especificado no valor Byte[] especificado.
computeDigest(algorithm, value)Byte[]Calcule um resumo usando o algoritmo especificado no valor String especificado.
computeDigest(algorithm, value, charset)Byte[]Calcule um resumo usando o algoritmo especificado no valor String especificado com o conjunto de caracteres determinado.
computeHmacSha256Signature(value, key)Byte[]Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.
computeHmacSha256Signature(value, key)Byte[]Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.
computeHmacSha256Signature(value, key, charset)Byte[]Assina o valor fornecido usando HMAC-SHA256 com a chave e o conjunto de caracteres fornecidos.
computeHmacSignature(algorithm, value, key)Byte[]Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.
computeHmacSignature(algorithm, value, key)Byte[]Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.
computeHmacSignature(algorithm, value, key, charset)Byte[]Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.
computeRsaSha1Signature(value, key)Byte[]Assina o valor fornecido usando RSA-SHA1 com a chave fornecida.
computeRsaSha1Signature(value, key, charset)Byte[]Assina o valor fornecido usando RSA-SHA1 com a chave e o conjunto de caracteres fornecidos.
computeRsaSha256Signature(value, key)Byte[]Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.
computeRsaSha256Signature(value, key, charset)Byte[]Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.
computeRsaSignature(algorithm, value, key)Byte[]Assina o valor fornecido usando o algoritmo RSA especificado com a chave fornecida.
computeRsaSignature(algorithm, value, key, charset)Byte[]Assina o valor fornecido usando o algoritmo RSA especificado com a chave e o conjunto de caracteres fornecidos.
formatDate(date, timeZone, format)StringFormata a data de acordo com a especificação descrita na classe SimpleDateFormat do Java SE.
formatString(template, args)StringExecuta formatação de string semelhante a sprintf usando strings de formato no estilo "%".
getUuid()StringReceba um UUID como uma string (equivalente ao uso do método java.util.UUID.randomUUID()).
gzip(blob)Blobgzip compacta os dados de Blob fornecidos e os retorna em um novo objeto Blob.
gzip(blob, name)Blobgzip compacta os dados de Blob fornecidos e os retorna em um novo objeto Blob.
newBlob(data)BlobCria um novo objeto Blob a partir de uma matriz de bytes.
newBlob(data, contentType)BlobCrie um novo objeto Blob usando uma matriz de bytes e um tipo de conteúdo.
newBlob(data, contentType, name)BlobCrie um novo objeto Blob a partir de uma matriz de bytes, tipo de conteúdo e nome.
newBlob(data)BlobCria um novo objeto Blob a partir de uma string.
newBlob(data, contentType)BlobCria um novo objeto Blob a partir de uma string e um tipo de conteúdo.
newBlob(data, contentType, name)BlobCria um novo objeto Blob a partir de uma string, tipo de conteúdo e nome.
parseCsv(csv)String[][]Retorna uma representação da matriz 2D tabular de uma string CSV.
parseCsv(csv, delimiter)String[][]Retorna uma representação tabular de matriz 2D de uma string CSV usando um delimitador personalizado.
parseDate(date, timeZone, format)DateAnalisa a data da string fornecida de acordo com a especificação descrita na classe SimpleDateFormat da edição padrão Java.
sleep(milliseconds)voidFica suspenso por um número especificado de milissegundos.
ungzip(blob)BlobDescompacta um objeto Blob e retorna um Blob contendo os dados descompactados.
unzip(blob)Blob[]Toma um Blob que representa um arquivo zip e retorna seus arquivos componentes.
zip(blobs)BlobCria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados.
zip(blobs, name)BlobCria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados.

Documentação detalhada

base64Decode(encoded)

Decodifica uma string codificada em base64 em uma matriz de bytes 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());

Parâmetros

NomeTipoDescrição
encodedStringUma matriz de bytes de dados a serem decodificados.

Retorno

Byte[]: os dados brutos representados pelo argumento codificado em base64 como uma matriz de bytes.


base64Decode(encoded, charset)

Decodifica uma string codificada em base64 em uma matriz de bytes em um conjunto de caracteres específico.

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

Parâmetros

NomeTipoDescrição
encodedStringA string de dados a ser decodificada.
charsetCharsetUma Charset especificando o conjunto de caracteres da entrada.

Retorno

Byte[]: os dados brutos representados pelo argumento codificado em base64 como uma matriz de bytes.


base64DecodeWebSafe(encoded)

Decodifica uma string codificada e segura para a Web em base64 em uma matriz de bytes 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());

Parâmetros

NomeTipoDescrição
encodedStringUma matriz de bytes de dados seguros da Web para decodificar.

Retorno

Byte[]: os dados brutos representados pelo argumento codificado seguro para Web em base64 como uma matriz de bytes.


base64DecodeWebSafe(encoded, charset)

Decodifica uma string codificada e segura para a Web em base64 em uma matriz de bytes em um conjunto de caracteres específico.

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

Parâmetros

NomeTipoDescrição
encodedStringA string de dados seguros da Web a serem decodificados.
charsetCharsetUma Charset especificando o conjunto de caracteres da entrada.

Retorno

Byte[]: os dados brutos representados pelo argumento codificado seguro para Web em base64 como uma matriz de bytes.


base64Encode(data)

Gera uma string codificada em base64 a partir da matriz de bytes fornecida. A base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. O Base 64 é normalmente usado em protocolos da Internet, como e-mail, HTTP ou em documentos 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);

Parâmetros

NomeTipoDescrição
dataByte[]Um byte[] de dados a codificar.

Retorno

String: a representação codificada em base64 dos dados transmitidos.


base64Encode(data)

Gera uma string codificada em base64 a partir da string fornecida. Base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A base 64 é normalmente usada em protocolos de Internet, como e-mail, HTTP ou em documentos XML.

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

Parâmetros

NomeTipoDescrição
dataStringA string a ser codificada.

Retorno

String: a representação codificada em base64 da string de entrada.


base64Encode(data, charset)

Gera uma string codificada em base64 a partir da string fornecida em um conjunto de caracteres específico. Um charset é uma maneira de codificar caracteres de modo que eles possam ser codificados. Isso geralmente é feito em um formato binário, que geralmente pode ser incompatível com determinados protocolos de transmissão de dados. Para tornar os dados compatíveis, eles geralmente são codificados em base 64, que é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. O Base 64 é normalmente usado em protocolos da Internet, como e-mail, HTTP ou em documentos 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);

Parâmetros

NomeTipoDescrição
dataStringA string de dados a ser codificada.
charsetCharsetUma Charset especificando o conjunto de caracteres da entrada.

Retorno

String: a representação codificada em base64 da string de entrada com o Charset especificado.


base64EncodeWebSafe(data)

Gera uma string codificada e segura para a Web em base64 com base na matriz de bytes fornecida. A codificação Base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A segurança para a Web Base 64 é frequentemente usada em protocolos da Internet, como e-mail, HTTP ou em documentos 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);

Parâmetros

NomeTipoDescrição
dataByte[]Uma matriz de bytes de dados a serem codificados.

Retorno

String: a representação codificada e segura para a Web de base64 dos dados transmitidos.


base64EncodeWebSafe(data)

Gera uma string codificada e segura para a Web em base64 a partir da string fornecida. A base 64 é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A base 64 segura para a Web é usada com frequência em protocolos de Internet, como e-mail, HTTP ou em documentos XML.

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

Parâmetros

NomeTipoDescrição
dataStringA string a ser codificada.

Retorno

String: a representação codificada e segura para a Web de base64 da string de entrada.


base64EncodeWebSafe(data, charset)

Gera uma string codificada e segura para a Web em base64 a partir da string fornecida em um conjunto de caracteres específico. Um charset é uma maneira de codificar caracteres de modo que eles possam ser codificados. Eles geralmente são feitos em um formato binário, que geralmente pode ser incompatível com determinados protocolos de transmissão de dados. Para tornar os dados compatíveis, eles geralmente são codificados em base 64, que é uma codificação comum aceita por várias ferramentas que não aceitam dados binários. A base 64 segura para a Web é comumente usada em protocolos da Internet, como e-mail, HTTP ou em documentos 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);

Parâmetros

NomeTipoDescrição
dataStringA string de dados a ser codificada.
charsetCharsetUma Charset especificando o conjunto de caracteres da entrada.

Retorno

String: a representação codificada e segura para a Web de base64 da string de entrada com o Charset fornecido.


computeDigest(algorithm, value)

Calcule um resumo usando o algoritmo especificado no valor Byte[] especificado.

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

Parâmetros

NomeTipoDescrição
algorithmDigestAlgorithmUm DigestAlgorithm para usar.
valueByte[]Um valor de string de entrada para calcular um resumo.

Retorno

Byte[]: um byte[] que representa o resumo de saída.


computeDigest(algorithm, value)

Calcule um resumo usando o algoritmo especificado no valor String especificado.

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

Parâmetros

NomeTipoDescrição
algorithmDigestAlgorithmUm DigestAlgorithm para usar.
valueStringUm valor de string de entrada para calcular um resumo.

Retorno

Byte[]: um byte[] que representa o resumo de saída.


computeDigest(algorithm, value, charset)

Calcule um resumo usando o algoritmo especificado no valor String especificado com o conjunto de caracteres determinado.

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

Parâmetros

NomeTipoDescrição
algorithmDigestAlgorithmUm DigestAlgorithm para usar.
valueStringUm valor de string de entrada para calcular um resumo.
charsetCharsetUma Charset que representa o conjunto de caracteres de entrada.

Retorno

Byte[]: um byte[] que representa o resumo de saída.


computeHmacSha256Signature(value, key)

Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.

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

Parâmetros

NomeTipoDescrição
valueByte[]O valor de entrada para o qual gerar um hash.
keyByte[]Uma chave para gerar o hash.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeHmacSha256Signature(value, key)

Assina o valor fornecido usando HMAC-SHA256 com a chave fornecida.

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

Parâmetros

NomeTipoDescrição
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave para gerar o hash.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeHmacSha256Signature(value, key, charset)

Assina o valor fornecido usando HMAC-SHA256 com a chave e o conjunto de caracteres fornecidos.

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

Parâmetros

NomeTipoDescrição
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave para gerar o hash.
charsetCharsetUma Charset que representa o conjunto de caracteres de entrada.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeHmacSignature(algorithm, value, key)

Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.

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

Parâmetros

NomeTipoDescrição
algorithmMacAlgorithmUm algoritmo MacAlgorithm a ser usado para gerar hash do valor de entrada.
valueByte[]O valor de entrada para o qual gerar um hash.
keyByte[]Uma chave para gerar o hash.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeHmacSignature(algorithm, value, key)

Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.

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

Parâmetros

NomeTipoDescrição
algorithmMacAlgorithmUm algoritmo MacAlgorithm a ser usado para gerar hash do valor de entrada.
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave para gerar o hash.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeHmacSignature(algorithm, value, key, charset)

Calcule um código de autenticação de mensagem usando o algoritmo especificado na chave e no valor especificados.

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

Parâmetros

NomeTipoDescrição
algorithmMacAlgorithmUm algoritmo MacAlgorithm a ser usado para gerar hash do valor de entrada.
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave para gerar o hash.
charsetCharsetUma Charset que representa o conjunto de caracteres de entrada.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeRsaSha1Signature(value, key)

Assina o valor fornecido usando RSA-SHA1 com a chave fornecida.

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

Parâmetros

NomeTipoDescrição
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave formatada em PEM a ser usada para gerar a assinatura.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeRsaSha1Signature(value, key, charset)

Assina o valor fornecido usando RSA-SHA1 com a chave e o conjunto de caracteres fornecidos.

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

Parâmetros

NomeTipoDescrição
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave formatada em PEM a ser usada para gerar a assinatura.
charsetCharsetUma Charset que representa o conjunto de caracteres de entrada.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeRsaSha256Signature(value, key)

Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.

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

Parâmetros

NomeTipoDescrição
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave formatada em PEM a ser usada para gerar a assinatura.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeRsaSha256Signature(value, key, charset)

Assina o valor fornecido usando RSA-SHA256 com a chave fornecida.

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

Parâmetros

NomeTipoDescrição
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave formatada em PEM a ser usada para gerar a assinatura.
charsetCharsetUma Charset que representa o conjunto de caracteres de entrada.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeRsaSignature(algorithm, value, key)

Assina o valor fornecido usando o algoritmo RSA especificado com a chave fornecida.

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

Parâmetros

NomeTipoDescrição
algorithmRsaAlgorithmUm algoritmo RsaAlgorithm a ser usado para gerar hash do valor de entrada.
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave formatada em PEM a ser usada para gerar a assinatura.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


computeRsaSignature(algorithm, value, key, charset)

Assina o valor fornecido usando o algoritmo RSA especificado com a chave e o conjunto de caracteres fornecidos.

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

Parâmetros

NomeTipoDescrição
algorithmRsaAlgorithmUm algoritmo RsaAlgorithm a ser usado para gerar hash do valor de entrada.
valueStringO valor de entrada para o qual gerar um hash.
keyStringUma chave formatada em PEM a ser usada para gerar a assinatura.
charsetCharsetUma Charset que representa o conjunto de caracteres de entrada.

Retorno

Byte[]: um byte[] que representa a assinatura de saída.


formatDate(date, timeZone, format)

Formata a data de acordo com a especificação descrita na classe SimpleDateFormat do Java SE. Acesse a especificação em 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);

Parâmetros

NomeTipoDescrição
dateDateUm Date para formatar como uma string.
timeZoneStringO fuso horário de saída do resultado.
formatStringUm formato de acordo com a especificação SimpleDateFormat.

Retorno

String: a data de entrada como uma string formatada.


formatString(template, args)

Executa formatação de string semelhante a sprintf usando strings de formato no estilo "%".

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

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

Parâmetros

NomeTipoDescrição
templateStringA string de formato que controla o que é retornado.
argsObject...Objetos a serem usados para preencher os espaços reservados "%" no modelo.

Retorno

String: a string formatada.


getUuid()

Receba um UUID como uma string (equivalente ao uso do método java.util.UUID.randomUUID()). Não há garantia de que esse identificador será exclusivo em todo o tempo e espaço. Sendo assim, não use em situações em que a exclusividade garantida é necessária.

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

Retorno

String: uma representação de string do UUID.


gzip(blob)

gzip compacta os dados de Blob fornecidos e os retorna em um novo objeto Blob.

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

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

Parâmetros

NomeTipoDescrição
blobBlobSourceUm objeto Blob para compactar usando gzip.

Retorno

Blob: um novo Blob contendo os dados compactados.


gzip(blob, name)

gzip compacta os dados de Blob fornecidos e os retorna em um novo objeto Blob. Essa versão do método permite especificar um nome de arquivo.

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

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

Parâmetros

NomeTipoDescrição
blobBlobSourceUm objeto Blob para compactar usando gzip.
nameStringO nome do arquivo gzip que será criado.

Retorno

Blob: um novo Blob contendo os dados compactados.


newBlob(data)

Cria um novo objeto Blob a partir de uma matriz de bytes. Blobs são usados em muitas APIs do Apps Script que recebem dados binários como entrada.

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

Parâmetros

NomeTipoDescrição
dataByte[]Os bytes do blob.

Retorno

Blob: o blob recém-criado.


newBlob(data, contentType)

Crie um novo objeto Blob usando uma matriz de bytes e um tipo de conteúdo. Blobs são usados em muitas APIs do Apps Script que usam dados binários como entrada.

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

Parâmetros

NomeTipoDescrição
dataByte[]Os bytes do blob.
contentTypeStringO tipo de conteúdo do blob pode ser null.

Retorno

Blob: o blob recém-criado.


newBlob(data, contentType, name)

Crie um novo objeto Blob a partir de uma matriz de bytes, tipo de conteúdo e nome. Blobs são usados em muitas APIs do Apps Script que usam dados binários como entrada.

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

Parâmetros

NomeTipoDescrição
dataByte[]Os bytes do blob.
contentTypeString– O tipo de conteúdo do blob é null.
nameStringO nome do blob pode ser null.

Retorno

Blob: o blob recém-criado.


newBlob(data)

Cria um novo objeto Blob a partir de uma string. Blobs são usados em muitas APIs do Apps Script que recebem dados binários como entrada.

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

Parâmetros

NomeTipoDescrição
dataStringA string do blob, presumida UTF-8.

Retorno

Blob: o blob recém-criado.


newBlob(data, contentType)

Cria um novo objeto Blob a partir de uma string e um tipo de conteúdo. Blobs são usados em muitas APIs do Apps Script que usam dados binários como entrada.

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

Parâmetros

NomeTipoDescrição
dataStringA string do blob, presumida UTF-8.
contentTypeStringO tipo de conteúdo do blob pode ser null.

Retorno

Blob: o blob recém-criado.


newBlob(data, contentType, name)

Cria um novo objeto Blob a partir de uma string, tipo de conteúdo e nome. Blobs são usados em muitas APIs do Apps Script que usam dados binários como entrada.

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

Parâmetros

NomeTipoDescrição
dataStringA string do blob, presumida UTF-8.
contentTypeStringO tipo de conteúdo do blob pode ser null.
nameStringO nome do blob pode ser null.

Retorno

Blob: o blob recém-criado.


parseCsv(csv)

Retorna uma representação da matriz 2D tabular de uma string CSV.

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

Parâmetros

NomeTipoDescrição
csvStringUma string que contém dados de uma ou várias linhas em formato de valores separados por vírgulas (CSV).

Retorno

String[][]: uma matriz bidimensional contendo os valores na string CSV.


parseCsv(csv, delimiter)

Retorna uma representação tabular de matriz 2D de uma string CSV usando um delimitador personalizado.

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

Parâmetros

NomeTipoDescrição
csvStringUma string que contém dados de uma ou várias linhas em formato de valores separados por vírgulas (CSV).
delimiterCharEntre valores.

Retorno

String[][]: uma matriz bidimensional contendo os valores na string CSV.


parseDate(date, timeZone, format)

Analisa a data da string fornecida de acordo com a especificação descrita na classe SimpleDateFormat da edição padrão Java. Para mais informações, consulte a classe SimpleDateFormat do Java.

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

Parâmetros

NomeTipoDescrição
dateStringUm valor de string para analisar como uma data.
timeZoneStringO fuso horário de saída.
formatStringO formato de data de acordo com a especificação SimpleDateFormat.

Retorno

Date: a string de entrada como uma data.


sleep(milliseconds)

Fica suspenso por um número especificado de milissegundos. Coloca o script em suspensão imediatamente pelo número especificado de milissegundos. O valor máximo permitido é 300.000 (ou 5 minutos).

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

Parâmetros

NomeTipoDescrição
millisecondsIntegerNúmero de milissegundos de suspensão.

ungzip(blob)

Descompacta um objeto Blob e retorna um Blob contendo os dados descompactados.

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

Parâmetros

NomeTipoDescrição
blobBlobSourceO Blob de dados compactados.

Retorno

Blob: uma Blob que representa os dados descompactados.


unzip(blob)

Toma um Blob que representa um arquivo zip e retorna seus arquivos componentes.

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

Parâmetros

NomeTipoDescrição
blobBlobSourceO blob do arquivo ZIP.

Retorno

Blob[]: um Blob[] que representa os blobs do componente, cada um nomeado com o caminho completo dentro do ZIP.


zip(blobs)

Cria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados.

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

Parâmetros

NomeTipoDescrição
blobsBlobSource[]Uma matriz de blobs para compactar.

Retorno

Blob: um novo blob contendo as entradas como um arquivo.


zip(blobs, name)

Cria um novo objeto Blob que é um arquivo zip contendo os dados dos Blobs passados. Essa versão do método permite especificar um nome de arquivo.

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

Parâmetros

NomeTipoDescrição
blobsBlobSource[]Uma matriz de blobs para compactar.
nameStringO nome do arquivo ZIP a ser criado.

Retorno

Blob: um novo blob contendo as entradas como um arquivo.

Métodos obsoletos