English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Objeto Date do JavaScript

Objeto Date

O objeto Date é usado para manipular datas e horários.

O objeto Date é criado usando o construtor new Date().

O objeto Date é baseado no valor de tempo, que é o tempo UTC 1970 anos1Mês1milissegundos desde o dia do mês.

Você pode usar qualquer uma das seguintes sintaxes para criar objetos Date com o construtor Date().

new Date();new Date(milliseconds);new Date(dateString);new Date(year, month, day, hours, minutes, seconds, milliseconds);

Atenção: Os meses do JavaScript variam de 0 a11ser contado. Isso significa1O mês é 0,12O mês é11.

Tutoriais de JavaScript DatePara obter mais informações sobre datas e horários, consulte o

Atributos do objeto Date

A tabela a seguir lista os atributos do objeto Date:

AtributosDescrição
constructorRetorna a função do prototype do objeto Date criado
prototypePermite adicionar novas propriedades e métodos ao objeto

Métodos do objeto Date

A tabela a seguir lista os métodos do objeto Date:

MétodoDescrição
getDate() Retorna o dia do mês do objeto de data local específico com base no tempo local (1-31)
getDay()Retorna o dia da semana do objeto de data local específico com base no tempo local (0-6)
getFullYear()Retorna o ano do objeto de data local específico com base no tempo local (ano de quatro dígitos retorna quatro dígitos).
getHours()Retorna as horas do objeto de data local específico com base no tempo local (0-23)
getMilliseconds()Retorna os milissegundos do objeto de data local específico com base no tempo local (0-999)
getMinutes()Retorna os minutos do objeto de data local específico com base no tempo local (0-59)
getMonth() Retorna o mês do objeto de data local específico com base no tempo local (0-11)
getSeconds()Retorna o número de segundos do objeto de data local específico com base no tempo local (0-59)
getTime()Retorna a diferença entre o tempo UTC e o tempo local, em minutos 1970 anos1Mês1Milissegundos desde meia-noite do dia
getTimezoneOffset()Retorna a diferença entre o tempo UTC e o tempo local, em minutos
getUTCDate()Retorna o dia do mês específico com base no tempo universal (de1-31começando)
getUTCDay()Retorna o dia da semana (de 0 a6)
getUTCFullYear()Retorna o ano com base no horário mundial
getUTCHours()Retorna as horas (de 0-23começando)
getUTCMilliseconds()Retorna os milissegundos (de 0 a999)
getUTCMinutes()Retorna os minutos (de 0 a59)
getUTCMonth()Retorna o mês (de 0 a11)
getUTCSeconds()Retorna os segundos (de 0 a59)
getYear()Não recomendado para uso.UsogetFullYear()Método substituto
setDate()Define o dia do mês do objeto data com base no horário local (o dia do mês é o dia).
setFullYear()Define o ano completo do objeto data com base no horário local (o ano completo é de quatro dígitos, são quatro números).
setHours()Define a hora do objeto data com base no horário local para a data especificada.
setMilliseconds()Define o número de milissegundos do objeto data com base no horário local
setMinutes()Define os minutos do objeto data com base no horário local
setMonth()Define o mês do objeto data com base no horário local
setSeconds()Define o número de segundos do objeto data com base no horário local
setTime()Define a data para1970 anos1Mês1antes do dia/em milissegundos a partir de
setUTCDate()Define o dia do mês do objeto data com base no horário universal
setUTCFullYear()Define o ano do objeto data com base no horário universal
setUTCHours()Define a hora do objeto data com base no horário universal
setUTCMilliseconds()Define o número de milissegundos do objeto data com base no horário universal
setUTCMinutes()Define os minutos do objeto data com base no horário universal
setUTCMonth()Define o mês do objeto data com base no horário universal
setUTCSeconds()Define o número de segundos do objeto data com base no horário universal
setYear()Não recomendado para uso.UsosetFullYear()Método substituto
toDateString()em forma legível (humana)-em forma legível (humana) retorna a string da parte da data do objeto data.
toGMTString()Não recomendado para uso.UsotoUTCString()Método substituto
toISOString()Retorna a data em formato de string, formatada conforme o padrão ISO
toJSON()Retorna a data em formato de string, no formato de data JSON
toLocaleDateString()Retorna a parte da data do objeto Date em formato de string local
toLocaleTimeString()Retornar a parte de tempo do objeto Date em uma string no formato local
toLocaleString()Converter o objeto Date para uma string no formato local
toString()Converter o objeto Date para uma string
toTimeString()Converter a parte de tempo do objeto Date para uma string
toUTCString()Converter o objeto Date para uma string com base no tempo universal
valueOf()Retornar o valor original do objeto Date

Métodos estáticos de data

O objeto Date ainda define três métodos estáticos. Esses métodos são chamados através do construtor Date() em si.

MétodoDescrição
Date.now()Retornar desde o horário universal1970 anos1Mês1Milissegundos desde meia-noite do dia
Date.parse()Analisar a string de data e retornar desde1970 anos1Mês1Milissegundos desde 00:00:00 do dia (UTC), ignorando os segundos de salto
Date.UTC()Voltar desde1970 anos1Mês1Milissegundos no objeto Date desde 00:00:00 do dia.