← 返回首页
Date.prototype.getYear() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Tecnologia Web para desenvolvedores
  2. JavaScript
  3. Referência JavaScript
  4. Objetos Globais
  5. Date
  6. Date.prototype.getYear()
Theme
  • OS default
  • Light
  • Dark
Português (do Brasil)
Remember language Learn more

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Date.prototype.getYear()

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

In this article

Resumo

O método getYear() retorna o ano especificado pela data de acordo com a hora local. Por conta do fato de que getYear() não retorna anos completos ("problema do ano 2000"), este método não é mais utilizado e foi substituido pelo método getFullYear().

Sintaxe

dateObj.getYear()

Parâmetros

Nenhum.

Retorna

O método getYear() retorna o ano menos 1900; então:

  • Para ano maior ou igual a 2000, o valor retornado por getYear() é 100 ou mais. Por exemplo, se o ano for 2026, getYear() retorna 126.
  • Para ano entre e incluindo 1900 e 1999, o valor retornado por getYear() é entre 0 e 99. Por exemplo, se o anor for 1976, getYear() retorna 76.
  • Para ano menor que 1900, o valor retornado por getYear() é menor que 0. Por exemplo, se o ano for 1800, getYear() retorna -100.

Para levar em consideração anos antes e depois de 2000, você deve utilizar getFullYear() ao invés de getYear() para que o ano seja especificado por completo.

Retrocombatibilidade

Comportamento em JavaScript 1.2 e anteriores

O método getYear() retorna um ano de 2 ou 4 dígitos:

  • Para anos entre e incluindo 1900 e 1999, o valor retornado por getYear() é o ano menos 1900. Por exemplo, se o ano é 1976, o valor retornado é 76.
  • Para anos menores que 1900 ou maiores que 1999, o valor retornado por getYear() é um ano de 4 dígitos. Por exemplo, se o ano é 1856, o valor retornado é 1856. Se o ano é 2026, o valor retornado é 2026.

Exemplos

Exemplo: Anos entre 1900 e 1999

O segundo statement atribui o valor 95 à variável year.

js
var Xmas = new Date("December 25, 1995 23:15:00"); var year = Xmas.getYear(); // returns 95

Exemplo: Anos depois de 1999

O segundo statement atribui o valor 100 à variável year.

js
var Xmas = new Date("December 25, 2000 23:15:00"); var year = Xmas.getYear(); // returns 100

Exemplo: Anos antes de 1900

O segundo statement atribui o valor -100 à variável year.

js
var Xmas = new Date("December 25, 1800 23:15:00"); var year = Xmas.getYear(); // returns -100

Exemplo: Setando e recuperando um ano entre 1900 e 1999

O segundo statement atribui o valor 95 à variável year, representanto o ano 1995.

js
var Xmas.setYear(95); var year = Xmas.getYear(); // returns 95

Especificações

Specification
ECMAScript® 2027 Language Specification
# sec-date.prototype.getyear

Compatibilidade com navegadores

Enable JavaScript to view this browser compatibility table.

Veja também

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 3 de fev. de 2024 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos Globais
  2. Date
  3. Construtor
    1. Date()
  4. Métodos estáticos
    1. Date.now()
    2. Date.parse()
    3. Date.UTC()
  5. Métodos de instância
    1. Date.prototype.getDate()
    2. Date.prototype.getDay()
    3. Date.prototype.getFullYear()
    4. Date.prototype.getHours()
    5. Date.prototype.getMilliseconds()
    6. Date.prototype.getMinutes()
    7. Date.prototype.getMonth()
    8. Date.prototype.getSeconds()
    9. Date.prototype.getTime()
    10. Date.prototype.getTimezoneOffset()
    11. Date.prototype.getUTCDate()
    12. Date.prototype.getUTCDay()
    13. Date.prototype.getUTCFullYear()
    14. Date.prototype.getUTCHours()
    15. Date.prototype.getUTCMilliseconds()
    16. Date.prototype.getUTCMinutes()
    17. Date.prototype.getUTCMonth()
    18. Date.prototype.getUTCSeconds()
    19. Date.prototype.getYear()
    20. Date.prototype.setDate()
    21. Date.prototype.setFullYear()
    22. Date.prototype.setHours()
    23. Date.prototype.setMilliseconds()
    24. Date.prototype.setMinutes()
    25. Date.prototype.setMonth()
    26. Date.prototype.setSeconds()
    27. Date.prototype.setTime()
    28. Date.prototype.setUTCDate()
    29. Date.prototype.setUTCFullYear()
    30. Date.prototype.setUTCHours()
    31. Date.prototype.setUTCMilliseconds()
    32. Date.prototype.setUTCMinutes()
    33. Date.prototype.setUTCMonth()
    34. Date.prototype.setUTCSeconds()
    35. Date.prototype.setYear()
    36. Date.prototype.toDateString()
    37. Date.prototype.toISOString()
    38. Date.prototype.toJSON()
    39. Date.prototype.toLocaleDateString()
    40. toLocaleString()
    41. Date.prototype.toLocaleTimeString()
    42. Date.prototype.toString()
    43. toTemporalInstant()
    44. Date.prototype.toTimeString()
    45. Date.prototype.toUTCString()
    46. Date.prototype.valueOf()
    47. Date.prototype[@@toPrimitive]
  6. Herança
  7. Object/Function
  8. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  9. Propriedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  10. Métodos de instância
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  11. Propriedades de instância
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.