Esta página foi traduzida pela API Cloud Translation.

DateTime

Representa a hora civil (ou, às vezes, a hora física).

Esse tipo pode representar um horário civil de uma das seguintes maneiras possíveis:

Quando utcoffset está definido e timeZone não está definido: um horário civil em um dia do calendário com uma diferença específica do UTC.
Quando o fuso horário é definido e o valor de utcoffset não é definido: um horário civil em um dia do calendário em um fuso horário específico.
Quando o timeZone e o utcoffset não estão definidos: um horário civil em um dia do calendário no horário local.

A data é referente ao calendário gregoriano proléptico.

Se ano, mês ou dia forem 0, o DateTime será considerado como não tendo um ano, mês ou dia específico, respectivamente.

Esse tipo também pode ser usado para representar uma hora física se todos os campos de data e hora estiverem definidos e qualquer caso de oneof do time_offset estiver definido. Considere usar a mensagem Timestamp para o horário físico. Caso seu caso de uso também queira armazenar o fuso horário do usuário, isso pode ser feito em outro campo.

Esse tipo é mais flexível do que alguns aplicativos podem querer. Documente e valide as limitações do seu aplicativo.

Representação JSON

Representação JSON
{ "year": integer, "month": integer, "day": integer, "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer, // Union field `time_offset` can be only one of the following: "utcOffset": string, "timeZone": { object (`TimeZone`) } // End of list of possible types for union field `time_offset`. }

{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}

Campos
`year`	`integer` Opcional. Ano da data. Precisa ser de 1 a 9999, ou 0 se especificar uma data e hora sem um ano.
`month`	`integer` Opcional. Mês do ano. Precisa ser de 1 a 12, ou 0 se você especificar uma data e hora sem um mês.
`day`	`integer` Opcional. Dia do mês. Precisa ser um valor entre 1 e 31 válido para o ano e o mês, ou 0 se você especificar uma data e hora sem dia.
`hours`	`integer` Opcional. Horas do dia no formato de 24 horas. Deve ser de 0 a 23, e o padrão é 0 (meia-noite). Uma API pode permitir o valor "24:00:00" para o horário de fechamento da empresa, por exemplo.
`minutes`	`integer` Opcional. Minutos da hora do dia. Precisa estar entre 0 e 59, e o padrão é 0.
`seconds`	`integer` Opcional. Segundos do minutos do horário. Normalmente precisa estar entre 0 e 59, e o padrão é 0. Uma API pode permitir o valor 60 se permitir segundos bissextos.
`nanos`	`integer` Opcional. Frações de segundos em nanossegundos. Precisa estar entre 0 e 999.999.999. O padrão é 0.
Campo de união `time_offset`. Opcional. Especifica a diferença de UTC ou o fuso horário do DateTime. Escolha cuidadosamente entre eles, considerando que os dados de fuso horário podem mudar no futuro (por exemplo, um país modifica as datas de início/término do horário de verão, e DateTimes futuras no intervalo afetado já foram armazenadas). Se omitido, o DateTime é considerado o horário local. `time_offset` pode ser apenas de um dos tipos a seguir:
`utcOffset`	`string (Duration format)` Compensação de UTC. Precisa ser em segundos inteiros, entre -18 e +18 horas. Por exemplo, uma compensação de UTC de -4:00 seria representada como { segundos: -14400 }. Duração em segundos com até nove dígitos fracionários, terminando em "`s`". Exemplo: `"3.5s"`.
`timeZone`	`object (TimeZone)` Fuso horário.

TimeZone

Representa um fuso horário do banco de dados IANA.

Representação JSON
{ "id": string, "version": string }

Campos

Campos
`id`	`string` Fuso horário do banco de dados IANA. Por exemplo: "America/New_York".
`version`	`string` Opcional. Número da versão do banco de dados IANA de fuso horário. Por exemplo: "2019a".

id

string

Fuso horário do banco de dados IANA. Por exemplo: "America/New_York".

version

string

Opcional. Número da versão do banco de dados IANA de fuso horário. Por exemplo: "2019a".