[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Date/getYear [Back]  [Original]
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. Referncia JavaScript
  4. Objetos Globais
  5. Date
  6. Date.prototype.getYear()
Theme
  • OS default
  • Light
  • Dark
Portugus (doBrasil)
Remember language Learn more

Esta pgina foi traduzida do ingls pela comunidade. Saiba mais e junte-se comunidade MDN Web Docs.

View in English Always switch to English

Date.prototype.getYear()

Deprecated

Avoid using this feature in new projects. The getYear() and setYear() methods use a truncated number instead of the actual year number, known as a year 2000 problem. This feature may be a candidate for removal from web standards or browsers.

In this article

Resumo

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

Sintaxe

dateObj.getYear()

Parmetros

Nenhum.

Retorna

O mtodo getYear() retorna o ano menos 1900; ento:

  • 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 considerao anos antes e depois de 2000, voc deve utilizar getFullYear() ao invs de getYear() para que o ano seja especificado por completo.

Retrocombatibilidade

Comportamento em JavaScript 1.2 e anteriores

O mtodo getYear() retorna um ano de 2 ou 4 dgitos:

  • 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 dgitos. 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 varivel 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 varivel 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 varivel 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 varivel year, representanto o ano 1995.

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

Especificaes

Specification
ECMAScript 2027 LanguageSpecification
# sec-date.prototype.getyear

Compatibilidade com navegadores

Veja tambm

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
Clear filter input
  1. Objetos Globais
  2. Date
  3. Construtor
    1. Date()
  4. Mtodos estticos
    1. Date.now()
    2. Date.parse()
    3. Date.UTC()
  5. Mtodos de instncia
    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. Herana
  7. Object/Function
  8. Mtodos estticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  9. Propriedades estticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  10. Mtodos de instncia
    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 instncia
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
MDN

Your blueprint for a better internet.

MDN
Contribute
Developers
Mozilla

Portions of this content are 19982026 by individual mozilla.org contributors. Content available under a Creative Commons license.

Web Proxy Viewer  |  New URL  |  Original Page