DateTime

Representa o horário civil (ou, às vezes, o horário físico).

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

  • Quando utcOffset é definido e timeZone não é definido: um horário civil em um dia do calendário com um deslocamento específico do UTC.
  • Quando timeZone é definido e utcOffset não é definido: uma hora civil em um dia do calendário em um fuso horário específico.
  • Quando nem timeZone nem utcOffset estão definidos: uma hora civil em um dia do calendário no horário local.

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

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

Esse tipo também pode ser usado para representar um horário físico se todos os campos de data e hora estiverem definidos e se um dos casos de time_offset estiver definido. Considere usar a mensagem Timestamp para o tempo físico. Se o caso de uso também quiser armazenar o fuso horário do usuário, isso poderá 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 
{
  "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/hora sem um ano.
month

integer

Opcional. Mês do ano. Precisa ser de 1 a 12 ou 0 se especificar uma data/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 o tipo de dados for "data/hora" sem dia.
hours

integer

Opcional. Horas do dia no formato de 24 horas. Precisa ser de 0 a 23, 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 ser de 0 a 59, o padrão é 0.
seconds

integer

Opcional. Segundos do minutos do horário. Normalmente precisa ser de 0 a 59, padrão 0. Uma API pode permitir o valor 60 se permitir segundos bissextos.
nanos

integer

Opcional. Frações de segundos em nanossegundos. Precisa ser de 0 a 999.999.999. O padrão é 0.
Campo de união time_offset. Opcional. Especifica o deslocamento UTC ou o fuso horário do DateTime. Escolha com cuidado 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 as datas e horários no período afetado já foram armazenadas). Se omitido, o DateTime será considerado no horário local. time_offset pode ser apenas de um dos tipos a seguir:
utcOffset

string (Duration format)

Deslocamento de UTC. Precisa ser um segundo inteiro, entre -18 horas e +18 horas. Por exemplo, um deslocamento UTC de -4:00 seria representado como { seconds: -14400 }.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
timeZone

object (TimeZone)

Fuso horário.