From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../global_objects/date/setmonth/index.html | 87 ++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 files/pt-br/web/javascript/reference/global_objects/date/setmonth/index.html (limited to 'files/pt-br/web/javascript/reference/global_objects/date/setmonth/index.html') diff --git a/files/pt-br/web/javascript/reference/global_objects/date/setmonth/index.html b/files/pt-br/web/javascript/reference/global_objects/date/setmonth/index.html new file mode 100644 index 0000000000..e9ac42302a --- /dev/null +++ b/files/pt-br/web/javascript/reference/global_objects/date/setmonth/index.html @@ -0,0 +1,87 @@ +--- +title: Date.prototype.setMonth() +slug: Web/JavaScript/Reference/Global_Objects/Date/setMonth +tags: + - Date + - JavaScript + - Method + - Prototipo + - Prototype + - Referencia + - data + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMonth +--- +
{{JSRef}}
+ +

O método setMonth() atribui o mês para uma data específica de acordo com o ano corrente.

+ +
{{EmbedInteractiveExample("pages/js/date-setmonth.html")}}
+ +

Sintaxe

+ +
dateObj.setMonth(monthValue[, dayValue])
+ +

Versões anteriores ao JavaScript 1.3

+ +
dateObj.setMonth(monthValue)
+ +

Parâmetros

+ +
+
monthValue
+
Um inteiro baseado em zero representando o mês do ano a partir do começo do ano. Então, 0 representa Janeiro, 11 representa Dezembro, -1 representa Dezembro do ano passado, e 12 representa Janeiro do ano seguinte.
+
dayValue
+
Opcional. Um inteiro de 1 a 31, representando o dia do mês.
+
+ +

Valor de retorno

+ +

O número de milissegundos entre dia 1 de Janeiro de 1970 00:00:00 UTC e a data atualizada.

+ +

Descrição

+ +

Se você não especifica o parâmetro dayValue, o valor retornado do método {{jsxref("Date.prototype.getDate()", "getDate()")}} é utilizado.

+ +

Se um parâmetro que você especificou estiver fora do alcance esperado, setMonth() tenta atualizar a informação da data no objeto {{jsxref("Date")}}. Por exemplo, se você usa 15 para monthValue, o ano será incrementado em 1, e 3 será usado para o mês.

+ +

O dia corrente do mês terá um impacto no comportamento deste método. Conceitualmente ele irá adicionar o número de dias dado pelo dia corrente do mês ao primeiro dia do novo mês especificado como parâmetro, retornando uma nova data. Por exemplo, se o valor corrente é 31 de agosto de 2016, chamando setMonth() com um valor de 1 irá retornar 2 de Março de 2016. Isso acontece porque Fevereiro de 2016 tem 29 dias.

+ +

Exemplos

+ +

Usando setMonth()

+ +
var theBigDay = new Date();
+theBigDay.setMonth(6);
+
+//Cuidado com transições de final de mês
+var endOfMonth = new Date(2016, 7, 31);
+endOfMonth.setMonth(1);
+console.log(endOfMonth); //Wed Mar 02 2016 00:00:00
+
+ +

Especificações

+ + + + + + + + + + +
Especificação
{{SpecName('ESDraft', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}}
+ +

Compatibilidade de navegador

+ + + +

{{Compat("javascript.builtins.Date.setMonth")}}

+ +

Veja também

+ + -- cgit v1.2.3-54-g00ecf