Métodos de data JavaScript

Índice

O construtor `new Date()`

Em JavaScript, objetos de data são criados com new Date().

new Date() retorna um objeto de data com a data e hora atuais.

Obtenha a hora atual

const date = new Date();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>

<h1>JavaScript Dates</h1>
<h2>Using new Date()</h2>
<p>Create a new date object with the current date and time:</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d;
</script>

</body>
</html>

Métodos de obtenção de data

getFullYear(): Obtenha ano como um número de quatro dígitos (aaaa)
getMonth(): Obtenha mês como um número (0-11)
getDate(): Obtenha dia como um número (1-31)
getDay(): Obtenha dia da semana como um número (0-6)
getHours(): Obtenha hora (0-23)
getMinutes(): Obtenha minuto (0-59)
getSeconds(): Obtenha segundo (0-59)
getMilliseconds(): Obtenha milissegundos (0-999)
getTime(): Obtenha tempo (milissegundos desde 1º de janeiro de 1970)

Nota 1

Os métodos get acima retornam Hora local.

O Horário universal (UTC) está documentado na parte inferior desta página.

Nota 2

Os métodos get retornam informações de objetos de data existentes.

Em um objeto de data, a hora é estática. O “relógio” não está “funcionando”.

A hora em um objeto de data NÃO é igual à hora atual.

O método `getFullYear()`

O método getFullYear() retorna o ano de uma data como um número de quatro dígitos:

Exemplos

const d = new Date("2021-03-25");
d.getFullYear();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getFullYear() Method</h2>
<p>Return the full year of a date object:</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25")
document.getElementById("demo").innerHTML = d.getFullYear();
</script>

</body>
</html>

const d = new Date();
d.getFullYear();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>

<h1>JavaScript Dates</h1>
<h2>The getFullYear() Method</h2>
<p>Return the full year of a date object:</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getFullYear();
</script>

</body>
</html>

Aviso !

O código JavaScript antigo pode usar o método não padrão getYear().

getYear() deve retornar um ano de 2 dígitos.

getYear() está obsoleto. Não use isso!

O método `getMonth()`

O método getMonth() retorna o mês de uma data como um número (0-11).

Observação

Em JavaScript, janeiro é o mês número 0, fevereiro é o número 1, ...

Finalmente, dezembro é o mês número 11.

Exemplos

const d = new Date("2021-03-25");
d.getMonth();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getMonth() Method</h2>
<p>Return the month of a date as a number from 0 to 11.</p>
<p>To get the correct month number, you must add 1:</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getMonth() + 1;
</script>

</body>
</html>

const d = new Date();
d.getMonth();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getMonth() Method</h2>
<p>Return the month of a date as a number from 0 to 11.</p>
<p>To get the correct month number, you must add 1:</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getMonth() + 1;
</script>

</body>
</html>

Observação

Você pode usar uma matriz de nomes para retornar o mês como nome:

Exemplos

const months = ["January", "February", "March", "April", "May",
"June", "July", "August", "September", "October",
"November", "December"];

const d = new Date("2021-03-25");
let month = months[d.getMonth()];

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>JavaScript getMonth()</h2>
<p>Return the month as a number.</p>
<p>You can use an array of names to return the month as a name:</p>

<p id="demo"></p>

<script>
const months = ["January","February","March","April","May","June","July","August","September","October","November","December"];

const d = new Date("2021-03-25");
let month = months[d.getMonth()];
document.getElementById("demo").innerHTML = month;
</script>

</body>
</html>

const months = ["January", "February", "March", "April", "May",
"June", "July", "August", "September", "October",
"November", "December"];

const d = new Date();
let month = months[d.getMonth()];

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>JavaScript getMonth()</h2>
<p>Return the month as a number.</p>
<p>You can use an array of names to return the month as a name:</p>

<p id="demo"></p>

<script>
const months = ["January","February","March","April","May","June","July","August","September","October","November","December"];

const d = new Date();
let month = months[d.getMonth()];
document.getElementById("demo").innerHTML = month;
</script>

</body>
</html>

O método `getDate()`

O método getDate() retorna o dia de uma data como um número (1-31):

Exemplos

const d = new Date("2021-03-25");
d.getDate();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getDate() Method</h2>
<p>Return the day of a date as a number (1-31):</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getDate();
</script>

</body>
</html>

const d = new Date();
d.getDate();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getDate() Method</h2>
<p>Return the day of a date as a number (1-31):</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getDate();
</script>

</body>
</html>

O método `getHours()`

O método getHours() retorna as horas de uma data como um número (0-23):

Exemplos

const d = new Date("2021-03-25");
d.getHours();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getHours() Method</h2>
<p>Return the hours of a date as a number (0-23):</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");document.getElementById("demo").innerHTML = d.getHours();
</script>

</body>
</html>

const d = new Date();
d.getHours();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getHours() Method</h2>
<p>Return the hours of a date as a number (0-23):</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getHours();
</script>

</body>
</html>

O método `getMinutes()`

O método getMinutes() retorna os minutos de uma data como um número (0-59):

Exemplos

const d = new Date("2021-03-25");
d.getMinutes();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getMinutes() Method</h2>
<p>Returns the minutes of a date as a number (0-59):</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getMinutes();
</script>

</body>
</html>

const d = new Date();
d.getMinutes();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getMinutes() Method</h2>
<p>Returns the minutes of a date as a number (0-59):</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getMinutes();
</script>

</body>
</html>

O método `getSeconds()`

O método getSeconds() retorna os segundos de uma data como um número (0-59):

Exemplos

const d = new Date("2021-03-25");
d.getSeconds();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getSeconds() Method</h2>
<p>Return the seconds of a date as a number (0-59):</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getSeconds();
</script>

</body>
</html>

const d = new Date();
d.getSeconds();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getSeconds() Method</h2>
<p>Return the seconds of a date as a number (0-59):</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getSeconds();
</script>

</body>
</html>

O método `getMilliseconds()`

O método getMilliseconds() retorna os milissegundos de uma data como um número (0-999):

Exemplos

const d = new Date("2021-03-25");
d.getMilliseconds();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getMilliseconds() Method</h2>
<p>Return the milliseconds of a date as a number (0-999):</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getMilliseconds();
</script>

</body>
</html>

const d = new Date();
d.getMilliseconds();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getMilliseconds() Method</h2>
<p>Return the milliseconds of a date as a number (0-999):</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getMilliseconds();
</script>

</body>
</html>

O método `getDay()`

O método getDay() retorna o dia da semana de uma data como um número (0-6).

Observação

Em JavaScript, o primeiro dia da semana (dia 0) é domingo.

Alguns países do mundo consideram o primeiro dia da semana como segunda-feira.

Exemplos

const d = new Date("2021-03-25");
d.getDay();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getDay() Method</h2>
<p>Return the weekday as a number:</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getDay();
</script>

</body>
</html>

const d = new Date();
d.getDay();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getDay() Method</h2>
<p>Return the weekday as a number:</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getDay();
</script>

</body>
</html>

Observação

Você pode usar uma matriz de nomes e getDay() para retornar o dia da semana como um nome:

Exemplos

const days = ["Sunday", "Monday", "Tuesday", "Wednesday",
"Thursday", "Friday", "Saturday"];

const d = new Date("2021-03-25");
let day = days[d.getDay()];

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getDay() Method</h2>
<p>Return the weekday as a number.</p>
<p>You can use an array of names to return the weekday as a name:</p>

<p id="demo"></p>

<script>
const days = ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"];

const d = new Date("2021-03-25");
let day = days[d.getDay()];
document.getElementById("demo").innerHTML = day;
</script>

</body>
</html>

const days = ["Sunday", "Monday", "Tuesday", "Wednesday",
"Thursday", "Friday", "Saturday"];

const d = new Date();
let day = days[d.getDay()];

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getDay() Method</h2>
<p>Return the weekday as a number.</p>
<p>You can use an array of names to return the weekday as a name:</p>

<p id="demo"></p>

<script>
const days = ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"];

const d = new Date();
let day = days[d.getDay()];
document.getElementById("demo").innerHTML = day;
</script>

</body>
</html>

O método `getTime()`

O método getTime() retorna o número de milissegundos desde 1º de janeiro de 1970:

Exemplos

const d = new Date("1970-01-01");
d.getTime();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getTime() Method</h2>
<p></p>
<p>Return the number of milliseconds since midnight January 1, 1970:</p>

<p id="demo"></p>

<script>
const d = new Date("1970-01-01");
document.getElementById("demo").innerHTML = d.getTime();
</script>

</body>
</html>

const d = new Date("2021-03-25");
d.getTime();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getTime() Method</h2>
<p></p>
<p>Return the number of milliseconds since midnight January 1, 1970:</p>

<p id="demo"></p>

<script>
const d = new Date("2021-03-25");
document.getElementById("demo").innerHTML = d.getTime();
</script>

</body>
</html>

const d = new Date();
d.getTime();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>
<h1>JavaScript Dates</h1>
<h2>The getTime() Method</h2>
<p></p>
<p>Return the number of milliseconds since midnight January 1, 1970:</p>

<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getTime();
</script>

</body>
</html>

O método `Date.now()`

Date.now() retorna o número de milissegundos desde 1º de janeiro de 1970.

Exemplos

let ms = Date.now();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>

<h1>JavaScript Dates</h1>
<h2>The Date.now() Method</h2>
<p>Return the current date/time in milliseconds since January 1, 1970:</p>

<p id="demo"></p>

<script>
const date = Date.now();
document.getElementById("demo").innerHTML = date;
</script>

</body>
</html>

Calcule o número de anos desde 1970/01/01:

const minute = 1000 * 60;
const hour = minute * 60;
const day = hour * 24;
const year = day * 365;

let years = Math.round(Date.now() / year);

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>

<h1>JavaScript Dates</h1>
<h2>Using Date.now()</h2>
<p>Calculate the number of years since January 1, 1970:</p>

<p id="demo"></p>

<script>
// Calculate milliseconds in a year
const minute = 1000 * 60;
const hour = minute * 60;
const day = hour * 24;
const year = day * 365;

// Divide Date.now() with a year
let years = Math.round(Date.now() / year);
document.getElementById("demo").innerHTML = years;
</script>

</body>
</html>

Date.now() é um método estático do objeto Date.

Você não pode usá-lo em um objeto de data como myDate.now().

A sintaxe é sempre Date.now().

Métodos de obtenção de data UTC

getUTCDate() / getDate(): Retorna a data UTC
getUTCFullYear() / getFullYear(): Retorna o ano UTC
getUTCMonth() / getMonth(): Retorna o mês UTC
getUTCDay() / getDay(): Retorna o dia UTC
getUTCHours() / getHours(): Retorna a hora UTC
getUTCMinutes() / getMinutes(): Retorna os minutos UTC
getUTCSeconds() / getSeconds(): Retorna os segundos UTC
getUTCMilliseconds() / getMilliseconds(): Retorna os milissegundos UTC

UTC methods use UTC time (Coordinated Universal Time).

UTC time is the same as GMT (Greenwich Mean Time).

The difference between Local time and UTC time can be up to 24 hours.

O método `getTimezoneOffset()`

O método getTimezoneOffset() retorna a diferença (em minutos) entre a hora local e a hora UTC:

Exemplo

let diff = d.getTimezoneOffset();

Experimente você mesmo →

<!DOCTYPE html>
<html>
<body>

<h1>JavaScript Dates</h1>
<h2>The getTimezoneOffset() Method</h2>

<p>The time zone difference in minutes is:</p>
<p id="demo"></p>

<script>
const d = new Date();
document.getElementById("demo").innerHTML = d.getTimezoneOffset();
</script>

</body>
</html>

Referência completa de data JavaScript

Para uma referência completa da data, acesse:

Referência completa de data JavaScript.

A referência contém descrições e exemplos de todas as propriedades Date e métodos.

Métodos de data JavaScript

Índice

O construtor new Date()

Obtenha a hora atual

Métodos de obtenção de data

Nota 1

Nota 2

O método getFullYear()

Exemplos

Aviso !

O método getMonth()

Observação

Exemplos

Observação

Exemplos

O método getDate()

Exemplos

O método getHours()

Exemplos

O método getMinutes()

Exemplos

O método getSeconds()

Exemplos

O método getMilliseconds()

Exemplos

O método getDay()

Observação

Exemplos

Observação

Exemplos

O método getTime()

Exemplos

O método Date.now()

Exemplos

Métodos de obtenção de data UTC

O método getTimezoneOffset()

Exemplo

Referência completa de data JavaScript

O construtor `new Date()`

O método `getFullYear()`

O método `getMonth()`

O método `getDate()`

O método `getHours()`

O método `getMinutes()`

O método `getSeconds()`

O método `getMilliseconds()`

O método `getDay()`

O método `getTime()`

O método `Date.now()`

O método `getTimezoneOffset()`