O "Z" no final de 2019-10-18T11:23:27.756Z
indica que esta data e hora está em UTC.
Já ao imprimir o Date
, repare que ele possui GMT-0300
, que indica 3 horas atrás de UTC.
Ou seja, ambos representam o mesmo instante. Esse é um ponto meio confuso, mas o Date
do JavaScript, apesar do nome, não representa um único valor de data e hora (um único dia, mês, ano, hora, minuto e segundo específico).
Ela na verdade representa um timestamp: a quantidade de milissegundos desde o Unix Epoch. Este valor representa um único instante, um ponto específico na linha do tempo. Só que um mesmo timestamp pode representar uma data e hora diferentes, dependendo do fuso horário (basta pensar que agora, neste exato momento, em cada parte do mundo o "dia de hoje" e o "horário atual" podem ser diferentes, dependendo do fuso horário em que você está).
Sendo assim, ao imprimir um Date
com console.log
, ele te mostra o valor considerando o timezone do browser. Mas ao enviar o Date
em uma requisição, ele está convertendo-a para UTC. Mas o valor do Date
(o seu timestamp, o instante ao qual ela corresponde) não foi alterado.
No caso, bastaria o backend pegar esta data e converter para o timezone correto (e cada linguagem possui suas formas de fazer isso).
O locale controla as configurações de idioma e localização, mas não interfere no fuso horário utilizado, são coisas diferentes. Eu posso usar o locale correspondente ao idioma português, mas mostrar a data em um fuso horário de qualquer outro país, uma coisa não está relacionada a outra.
Ao mudar o valor do timestamp, como sugeria outra resposta (que foi apagada), você estará mudando o instante ao qual a data corresponde. Pode até "funcionar", mas não é o ideal, dependendo do que você quer fazer.
Para entender melhor, uma analogia. Agora no Brasil são 10:20 e em Londres são 14:20 (os ingleses estão em horário de verão, daí a diferença de 4 horas). Imagine que meu computador está erroneamente configurado com o fuso de Londres, então ele mostra 14:20.
Para que ele mostre o horário correto, eu posso fazer duas coisas:
- mudar a configuração do computador para o Horário de Brasília
- atrasar o relógio em 4 horas
Em ambos os casos, o horário passará a ser mostrado como 10:20, mas a segunda opção é pior, porque agora meu relógio está indicando um instante no passado. É isso que acontece quando você manipula o valor do timestamp, e esse é o erro da outra resposta. Apesar do valor mostrado estar "correto", você criou um Date
correspondente a um instante diferente, e dependendo do que você vai fazer com a data, pode dar resultados incorretos.
Além disso, a diferença nem sempre será de 4 horas. Quando Londres não está em horário de verão, a diferença é de 3 horas, exceto que quando o Horário de Brasília está em horário de verão, a diferença é de duas horas (mas já houve períodos em que ambos estão em horário de verão, e a diferença volta a ser de 3 horas, já que em muitos anos, o horário de verão no Brasil começou no início de outubro, e na Inglaterra terminou no final de outubro, então durante alguns dias ambos estavam em horário de verão).
No caso específico do Brasil, este ano não teremos horário de verão, mas como isso é algo definido pelo governo, nada garante que isso não mudará no futuro. Por isso manipular o valor do timestamp ainda tem essa outra desvantagem: não estará sincronizado com as mudanças do mundo real. Você teria que consultar as informações do timezone para saber se usa 2 ou 3 horas para o seu cálculo.
Ou seja, usar valores fixos para fazer esse cálculo é extremamente propenso a erros, e o ideal é sempre usar o timezone correto.
Infelizmente o JavaScript não possui uma maneira decente de converter entre fuso horários. O máximo que você pode fazer é obter os valores de data e hora no timezone do browser ou em UTC. Se quiser no mesmo formato acima, mas usando o timezone do browser, terá que fazer manualmente:
function pad(value) {
return value.toString().padStart(2, 0);
}
let d = new Date();
console.log(`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`);
A diferença é que não terá o Z
no final, pois não está mais em UTC. Nesse caso, você terá que assumir que o backend sabe qual o timezone em que se encontra. Você ainda pode usar d.getTimezoneOffset()
, que retorna a diferença em minutos com relação a UTC. No caso do Horário de Brasília, o retorno é 180 (ou 120 quando está em horário de verão). Se quiser, pode mandar esta informação separadamente, para que o backend possa fazer a conversão corretamente.
Repare também que tive que somar 1 no mês, pois no JavaScript os meses são indexados em zero (janeiro é zero, fevereiro é 1, etc).
Moment.js
Se quiser, pode usar o Moment.js, juntamente com o Moment Timezone, para manipular as datas no timezone correto:
let d = moment.tz('America/Sao_Paulo');
console.log(d.format()); //2019-10-18T10:32:31-03:00
<script src="https://momentjs.com/downloads/moment.min.js"></script>
<script src="https://momentjs.com/downloads/moment-timezone-with-data.min.js"></script>
Assim, ela manda a data no timezone correto (ex: 2019-10-18T10:32:31-03:00
), sem depender do timezone do browser, e você pode manipular da maneira que achar melhor no backend.
Os nomes dos timezones (como America/Sao_Paulo
) são definidos pela IANA e estão sempre sofrendo constantes atualizações (ela acompanha as mudanças de horário de verão do mundo todo, para que você não precise se preocupar com isso: basta usar o timezone correto e a API faz o resto). Com o Moment.js você pode ter uma lista dos timezones disponíveis usando moment.tz.names()
:
console.log(moment.tz.names());
<script src="https://momentjs.com/downloads/moment.min.js"></script>
<script src="https://momentjs.com/downloads/moment-timezone-with-data.min.js"></script>
Angular
Sobre o Angular, ele parece usar JSON.stringify
para converter o Date
, ao enviá-lo em um HTTP request carece de fontes, mas estou procurando.
De qualquer forma, fiz um teste rápido, seguindo a ideia desta resposta:
// aproveitando a função pad() já vista anteriormente
Date.prototype.toJSON = function() {
return `${this.getFullYear()}-${pad(this.getMonth() + 1)}-${pad(this.getDate())}T${pad(this.getHours())}:${pad(this.getMinutes())}:${pad(this.getSeconds())}`;
}
Ao fazer isso, todas as datas enviadas via HttpClient
são convertidas usando a função acima (que você pode adaptar para o que precisar).
Evidentemente que isso mudará para todas as instâncias de Date
do seu projeto (que pelos comentários abaixo, parece ser o caso).
LocalDateTime.now()
do java 8.