O tipo de dado Date armazena informações sobre um momento do tempo: dia, mês, ano, horas, minutos , segundo e outros. Esse tipo de dado possui métodos para criação, recuperação de parte de uma data, conversão, formatação e outros.

Um objeto Date pode ser instanciado utilizando um dos construtores abaixo.

Sintaxe

let variavel = new Date()
let variavel = new Date( value )
let variavel = new Date(dateString)
let variavel = new Date(dateObject)
let variavel = new Date(year, monthIndex)
let variavel = new Date(year, monthIndex, day)
new Date(year, monthIndex, day, hours)
new Date(year, monthIndex, day, hours, minutes)
new Date(year, monthIndex, day, hours, minutes, seconds)
new Date(year, monthIndex, day, hours, minutes, seconds, milliseconds)

Onde

value:           Valor inteiro representando o número em milissegundos a partir 01/01/1970.
dateString:      data em formato string
year:            ano
monthIndex:      mês. Valor entre 0(janeiro) e 11
day:             dia
hours:           horas
minutes:         minutos
seconds:         segundos
milliseconds:    milisegundos

Exemplo 1

let dt = new Date();
console.log(dt);
dt = new Date(2029,0,01);
console.log(dt);

Saída

2023-06-05T22:39:56.162Z
2029-01-01T00:00:00.000Z

A classe Date não possui propriedades próprias, além das herdadas pela classe Object. A manipulação das informações da classe Date é feita utilizando seus métodos.

O tipo Date possui vários métodos para recuperação de partes de uma data, conversão, atribuição e outros. Abaixo a lista completa dos métodos:

Como o métodos retornam parte de informações sobre data/hora locais e momentâneas, as saídas foram destacadas em vermelho para que fique definido que os valores são diferentes dos valores de saída ao ser executado na máquina do usuário ou compilador online.

O método getDate retorna o dia do mês de uma data. Valor pertence ao interval 1-31.

Sintaxe

variavel_date.getDate();

Onde

-

Retorno

Number contendo valor entre 1~31.

Exemplo 2

console.log(new Date().getDate());

Saída

5

O método getDay retorna o dia da semana. Valor entre 0-6.

Sintaxe

variavel_date.getDay();

Onde

-

Retorno

Number contendo valor entre 0~6 que representa o dia da semana.

Exemplo 3

console.log(new Date().getDay());

Saída

2

O método getFullYear retorna o ano.

Sintaxe

variavel_date.getFullYear();

Onde

-

Retorno

Number contendo valor do ano de uma data.

Exemplo 4

console.log(new Date().getFullYear());

Saída

2023

O método getHours retorna a parte hora de uma data. Valor entre 0~23.

Sintaxe

variavel_date.getHours();

Onde

-

Retorno

Number contendo valor da hora de uma data.

Exemplo 5

console.log(new Date().getHours());

Saída

21

O método getMilliseconds retorna a parte hora de uma data.

Sintaxe

variavel_date.getMilliseconds();

Onde

-

Retorno

Number contendo millisegundos de uma data. Valor entre 0~999.

Exemplo 6

console.log(new Date().getMilliseconds());

Saída

675

O método getSeconds retorna a parte minutos da hora de uma data.

Sintaxe

variavel_date.getSeconds();

Onde

-

Retorno

Number contendo os segundos de uma data. Valor entre 0~59.

Exemplo 7

console.log(new Date().getSeconds());

Saída

31

O método getMonth retorna a parte mês de uma data.

Sintaxe

variavel_date.getMonth();

Onde

-

Retorno

Number contendo mês de uma data. Valor entre 0~11.

Exemplo 8

console.log(new Date().getMonth());

Saída

7

O método getSeconds retorna a parte segundos da uma data/hora.

Sintaxe

variavel_date.getSeconds();

Onde

-

Retorno

Number contendo os segundos de uma data/hora. Valor entre 0~59.

Exemplo 9

console.log(new Date().getSeconds());

Saída

12

O método getTime retorna os milissegundos desde 01/01/1970.

Sintaxe

variavel_date.getTime();

Onde

-

Retorno

Number contendo os milissegundos desde 01/01/1970.

Exemplo 10

console.log(new Date().getTime());

Saída

1755638339358

O método estático now retorna os milisegundos desde 01/01/1970.

Sintaxe

Date.now();

Onde

-

Retorno

Um objeto Date

Exemplo 11

console.log(Date.now());

Saída

1755638369260

O método parse converter uma data em formato string e retorna um número contendo os milissegundos.

Sintaxe

variavel_date.parse(datestring);

Onde

dateString: string contendo uma data para conversão

Retorno

Number contendo os millisegundos desde janeiro de 1970 até a data contida em dateString.

Exemplo 12

console.log(Date.parse("01/02/1970, 00:00:00"));

Saída

86400000

Atribui um dia do mês, que é passado como argumento, a um objeto Date.

Sintaxe

variavel_date.setDate(dayValue);

Onde

dayValue: dia do mês para alteração da data.

Retorno

Novo objeto Date alterado com dayValue ou NaN caso não dayValue seja inválido.

Exemplo 13

let dt = new Date("01/01/2023 00:00:00");
console.log(dt);
dt.setDate(8);
console.log(dt);

Saída

2023-01-01T00:00:00.000Z
2023-01-08T00:00:00.000Z

Atribui um valor de ano, que é passado como argumento, a um objeto Date.

Sintaxe

variavel_date.setFullYear(yearValue)
variavel_date.setFullYear(yearValue, monthValue)
variavel_date.setFullYear(yearValue, monthValue, dateValue)

Onde

yearValue: Número do ano
monthValue: Número do mês
dateValue: Número do dia do mês

Retorno

Novo objeto Date alterado com dayValue ou NaN caso ocorra argumentos sejam inválidos.

Exemplo 14

let dt = new Date();
console.log(dt.getFullYear());
dt.setFullYear(dt.getFullYear() + 1);
console.log(dt);

Saída

2023
2024-06-06T11:54:46.646Z

Atribui uma nova hora, que é passada como argumento, a um objeto Date.

Sintaxe

variavel_date.setHours(hoursValue)
variavel_date.setHours(hoursValue, minutesValue)
variavel_date.setHours(hoursValue, minutesValue, secondsValue)
variavel_date.setHours(hoursValue, minutesValue, secondsValue, msValue)

Onde

hoursValue: Número da hora
minutesValue: Número dos minutos
secondsValue: Número dos segundos
msValue: Número dos milisegundos

Retorno

Novo objeto Date alterado com secondsValue e msValue. NaN em caso de erro.

Exemplo 15

let dt = new Date("01-01-2023 00:00:00");
console.log(dt.getHours());
dt.setHours(dt.getHours() + 1);
console.log(dt.getHours());

Saída

0
1

Atribui um valor de minutos, que é passado como argumento, a um objeto Date.

Sintaxe

variavel_date.setMinutes(minutesValue)
variavel_date.setMinutes(minutesValue, secondsValue)
variavel_date.setMinutes(minutesValue, secondsValue, msValue)

Onde

minutesValue: Número de minutos
secondsValue: Número de segundos
msValue: Número do milisegundos

Retorno

Novo objeto Date alterado com minutesValue, secondsValue e msValue. NaN em caso de erro.

Exemplo 16

let dt = new Date("01-01-2023 00:00:00");
console.log(dt.getMinutes());
dt.setMinutes(dt.setMinutes() + 1);
console.log(dt.getMinutes());

Saída

0
1

Atribui um número de mês, que é passado como argumento, à uma data.

Sintaxe

variavel_date.setSeconds(monthValue)
variavel_date.setSeconds(monthValue, dateValue)

Onde

monthValue: Número de mês
dateValue: Número do dia do mês

Retorno

Novo objeto Date alterado com secondsValue e msValue. NaN em caso de erro.

Exemplo 17

let dt = new Date("01-01-2023 00:00:00");
console.log(dt);
dt.setSeconds(10);
console.log(dt);

Saída

2023-01-01T00:00:00.000Z
2023-01-01T00:00:10.000Z

Atribui um número de segundos, que é passado como argumento, à uma data.

Sintaxe

variavel_date.setSeconds(secondsValue)
variavel_date.setSeconds(secondsValue, msValue)

Onde

secondsValue: Número de segundos
msValue: Número de milisegundos

Retorno

Novo objeto Date alterado com dayValue ou NaN caso ocorra argumentos sejam inválidos.

Exemplo 18

let dt = new Date("01-01-2023 00:00:00");
console.log(dt.getSeconds());
dt.setSeconds(dt.getSeconds() + 1);
console.log(dt.getSeconds());

Saída

0
1

Converte a parte data de um objeto Date para o formato string.

Sintaxe

variavel_date.toDateString();

Onde

-

Retorno

String contendo uma data no formato: dia-semana mês ano

Exemplo 19

console.log(new Date().toLocaleString());

Saída

6/6/2023, 12:05:32 PM

Converte uma data como uma string para o formato JSON.

Sintaxe

variavel_data.toJSON()

Onde

-

Retorno

Novo objeto Date em formato JSON.

Exemplo 20

console.log(new Date().toJSON());

Saída

2023-06-06T12:13:31.115Z

Converte um objeto Date para string utilizando as convenções locais de data/hora.

Sintaxe

variavel_date.toLocaleString();
variavel_date.toLocaleString()
variavel_date.toLocaleString(locales)
variavel_date.toLocaleString(locales, options)

Onde

-

Retorno

String contendo uma data no formato: dd/mm/aaaa, HH24:mm:ss AM/PM

Exemplo 22

console.log(new Date().toLocaleString());
console.log(new Date().toLocaleString("ko-KR", { timeZone: "UTC" }));

Saída

8/19/2025, 9:01:31 PM
2025. 8. 19. 오후 9:01:32

Converte um objeto data para sua representação em string.

Sintaxe

variavel_date.toString();

Onde

-

Retorno

String contendo uma data no formato: dia-semana dia-mes ano hh:mm:ss GMT-XXXX (fuso horario)

Exemplo 23

console.log(new Date().toString());

Saída

Tue Jun 06 2023 12:02:13 GMT+0000 (Coordinated Universal Time)

Converte a hora de um objeto Date para string.

Sintaxe

variavel_date.toTimeString();

Onde

-

Retorno

String contendo uma data no formato hh:mmss GMT-XXXX (fuso horario)

Exemplo 24

console.log(new Date().toTimeString()); 

Saída

12:00:05 GMT+0000 (Coordinated Universal Time)

1. 19/08/2025 - revisão 4 - Ajustes: pontuais, sintaxes e exemplos; Correção: método 'getMonth', 'getTime' e outros
2. 24/09/2024 - revisão 3 - Correção em descrição de métodos em tab. de métodos; ajustes pontuais
3. 02/09/2024 - revisão 2 - Correção em links de objetivos
4. 06/10/2023 - revisão 1 - Correção navegação, layout, estilo e erros gramaticais
5. 31/05/2023 - versão inicial