recursal/MDN huggingface dataset:
Date.prototype.setTime()
========================

O método **`setTime()`** atribui ao objecto `Date` a hora representada pelo número de milisegundos desde 1 de janeiro de 1970 as 00:00:00 UTC.Experimente
-----------

Sintáxe
-------
```

dateObj.setTime(timeValue)
```

### Parâmetros

`timeValue`

Um inteiro representando o número de milisegundos desde 1 de janeiro 1970, 00:00:00 UTC.

### Valor retornado

O número de milisegundos entre 1 de janeiro de 1970 00:00:00 UTC e a data atualizada (efetivamente, o valor do argumento).

Descrição
---------

Use o método `setTime()` para ajudar a atribuir data e hora para outro objeto `Date`.

Exemplos
--------

### Usando `setTime()`


```js
var theBigDay = new Date("July 1, 1999");
var sameAsBigDay = new Date();
sameAsBigDay.setTime(theBigDay.getTime());
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.settime |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getTime()`
* `Date.prototype.setUTCHours()`
Date.prototype.setHours()
=========================

O método **`setHours()`** atribui as horas para uma data especificada de acordo com a hora local e retorna o número de milissegundos desde do dia 1 de Janeiro de 1970 00:00:00 UTC até o tempo representado pela instância `Date` atualizada.

Experimente
-----------

Sintaxe
-------
```

dateObj.setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
```

### Versões anteriores ao JavaScript 1.3
```

dateObj.setHours(hoursValue)
```

### Parâmetros

`hoursValue`

Idealmente, um número inteiro entre 0 e 23, representando a hora. Se um valor maior que 23 for fornecido, a data e hora será incrementada pelas horas extras.

`minutesValue`

Opcional. Idealmente, um número inteiro entre 0 e 59, representando os minutos. Se um valor maior que 59 for fornecido, a data e hora será incrementada em minutos extras.

`secondsValue`

Opcional. Idealmente, um número inteiro entre 0 e 59, representando os segundos. Se um valor maior que 59 for fornecido, a data e hora será incrementada em segundos extras. Se você especificar o parâmetro `secondsValue`, também deverá especificar parâmetro `minutesValue`.

`msValue`

Opcional. Idealmente, um número entre 0 e 999, representando os milissegundos. Se um valor maior que 999 for fornecido, a data e hora será incrementada em milissegundos extras. Se você especificar o parâmetro `msValue`, você também deve especificar `minutesValue` e `secondsValue`.

### 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 os parâmetros `minutesValue`, `secondsValue`, e `msValue`, os valores retornados dos métodos `getMinutes()`, `getSeconds()`, e `getMilliseconds()` são usados.

Se um parâmetro que você especificar estiver fora do intervalo esperado, `setHours()` tenta atualizar as informações de data no objeto `Date`. Por exemplo, se você usa 100 para `secondsValue`, os minutos serão incrementados em 1 (`minutesValue + 1`), e 40 serão usados para os segundos.

Exemplos
--------

### Usando `setHours()`


```js
var theBigDay = new Date();
theBigDay.setHours(7);
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.sethours |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getHours()`
* `Date.prototype.setUTCHours()`
Date.prototype.setUTCMinutes()
==============================

O método **`setUTCMinutes()`** atribui os minutos para uma data específica de acordo com o horário universal.

Experimente
-----------

Sintaxe
-------
```

dateObj.setUTCMinutes(minutesValue[, secondsValue[, msValue]])
```

### Parâmetros

`minutesValue`

Um inteiro entre 0 e 59, representando os minutos.

`secondsValue`

Opcional. Um inteiro entre 0 e 59, reprensentando os segundos. Se vocẽ especificar o parâmetro `secondsValue`, você também deve especificar `minutesValue`.

`msValue`

Opcional. Um número entre 0 e 999, representando os milissegundos. Se você especificar o parâmetro `msValue`, você também deve especificar `minutesValue` e `secondsValue`.

### Valor de retorno

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

Descrição
---------

Se vocẽ não especificar os parâmetros `secondsValue` e `msValue`, os valores retornados dos métodos `getUTCSeconds()` e `getUTCMilliseconds()` são utilizados.

Se o parâmetro que você especificou estiver fora do alcance esperado, `setUTCMinutes()` tentará atualizar a informação da data no objeto `Date`. Por exemplo, se você usar 100 para `secondsValue`, os minutos serão incrementados em 1 (`minutesValue + 1`), e 40 será usado para os segundos.

Exemplos
--------

### Usando `setUTCMinutes()`


```js
var theBigDay = new Date();
theBigDay.setUTCMinutes(43);
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setutcminutes |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getUTCMinutes()`
* `Date.prototype.setMinutes()`
Date.prototype.setYear()
========================

**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.

O método **`setYear()`** atribui o ano para a data especificada de acordo com o horário local. Devido `setYear()` não colocar o anos cheios ("problema do ano 2000"), ele não é mais utilizado e foi substituído pelo método `setFullYear()`.

Sintaxe
-------
```

dateObj.setYear(yearValue)
```

### Parâmetros

`yearValue`

Um inteiro.

### Valor de retorno

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

Descrição
---------

Se `yearValue` é um número entre 0 e 99 (inclusivo), então o ano para `dateObj` é atribuido para `1900 + yearValue`. Caso contrário, o ano para `dateObj` é atribuido para `yearValue`.

Exemplos
--------

### Usando `setYear()`

As duas primeiras linhas atribuem o ano para 1996. O terceiro atribui o ano para 2000.


```js
var theBigDay = new Date();

theBigDay.setYear(96);
theBigDay.setYear(1996);
theBigDay.setYear(2000);
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setyear |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getFullYear()`
* `Date.prototype.getUTCFullYear()`
* `Date.prototype.setFullYear()`
* `Date.prototype.setUTCFullYear()`
Date.UTC()
==========

O método **`Date.UTC()`** aceita os mesmos parâmetros que o construtor mais longo de **`Date`** e retorna o total de milisegundos desde 1º de Janeiro de 1970 às 00:00:00 (horário universal). O valor retornado por **`Date.UTC()`** pode ser usado como parâmetro para criar uma instância de `Date`.

Sintaxe
-------
```

Date.UTC(ano, mês[, dia[, hora[, minuto[, segundo[, milisegundo]]]]])
```

### Parâmetros

`ano`

Um valor inteiro representando o ano, após 1970.

`mês`

Um valor inteiro que representa o mês, começando com 0 para Janeiro até 11 para Dezembro.

`dia`

Opcional. Um valor inteiro entre 1 e 31 representando o dia do mês.

`hora`

Opcional. Um valor inteiro entre 0 e 23 representando a hora do dia.

`minuto`

Opcional. Um valor entre 0 e 59 representando os minutos.

`segundo`

Opcional. Um valor entre 0 e 59 representando os segundos.

`milisegundo`

Opcional. Um valor entre 0 e 999 representando os milisegundos.

Descrição
---------

**`UTC()`** recebe argumentos de uma data separados por vírgula e retorna um número representando o total de milisegundos entre o dia 1º de Janeiro de 1970 às 00:00:00 (horário universal) e a data e hora que você especificou.

Você deve especificar o ano completo para o argumento ano. Por exemplo, 1998. Se o ano fornecido for um valor entre 0 e 99 o método irá converter este valor para o século 20 (1900 + ano); Por exemplo, se você utilizar 95, então o ano 1995 será utilizado.

O método `UTC()` se diferencia do construtor de `Date` de duas maneiras:

* `Date.UTC()` utiliza o horário universal em vez do horário local.
* `Date.UTC()` retorna um valor inteiro em vez de uma instância de `Date`.

Se você fornecer um argumento fora do intervalo esperado, o método UTC() atualiza os demais argumentos para permitir este valor. Por exemplo, se você utilizar 15 para mês, será adicionado 1 ao argumento ano (ano + 1) e será utilizado 3 para o argumento mês.

`UTC()` é um método estático, por conta disto você sempre irá chamar `Date.UTC()` em vez de chamar um método de um objeto `Date` que você tenha criado.

Exemplos
--------

### Utilizando `Date.UTC()`

A seguinte expressão cria uma instância de `Date` utilizando UTC em vez do horário local:
```

var dataUniversal = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.utc |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja Também
-----------

* `Date.parse()`
Date.prototype.setSeconds()
===========================

O método **`setSeconds()`** atribui os segundos na data especificada de acordo com o tempo local.

Experimente
-----------

Sintaxe
-------
```

dateObj.setSeconds(secondsValue[, msValue])
```

### Versões anteriores ao JavaScript 1.3
```

dateObj.setSeconds(secondsValue)
```

### Parâmetros

`secondsValue`

Um inteiro entre 0 e 59, representando os segundos.

`msValue`

Opcional. Um número entre 0 e 999, representando os milissegundos.

### Valor de retorno

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

Descrição
---------

Se você não especifica o parâmetro `msValue`, o valor retornado do método `getMilliseconds()` é utilizado.

Se um parâmetro que você especificou está fora do alcance esperado, `setSeconds()` tentará atualizar a informação da data no objeto `Date`. Por exemplo, se você usar 100 para `secondsValue`, os minutos guardados no objeto `Date` serão incrementados em 1, e 40 serão usados para os segundos.

Exemplos
--------

### Usando `setSeconds()`


```js
var theBigDay = new Date();
theBigDay.setSeconds(30);
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setseconds |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getSeconds()`
* `Date.prototype.setUTCSeconds()`
Date.prototype.getUTCMonth()
============================

A função **`getUTCMonth()`** retorna o mês da data especificada de acordo com o horário universal, como um valor iniciado em zero (aonde zero indica o primeiro mês do ano).

Sintaxe
-------
```

dateObj.getUTCMonth()
```

### Valor retornado

Um número inteiro, entre 0 e 11, correspondente ao mês da data informada de acordo com o horário universal. 0 para Janeiro, 1 para Fevereiro, 2 para Março, e assim em diante.

Exemplos
--------

### Usando `getUTCMonth()`

O exemplo a seguir atribui a parte do mês da data atual a variável `month`.


```js
var today = new Date();
var month = today.getUTCMonth();
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getutcmonth |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getMonth()`
* `Date.prototype.setUTCMonth()`
Date.prototype.setFullYear()
============================

O método **`setFullYear()`** atribui o ano completo para a data especificada de acordo com o horário universal (UTC). Retorna uma nova data e hora.

Experimente
-----------

Sintaxe
-------
```

dateObj.setFullYear(yearValue[, monthValue[, dateValue]])
```

### Parâmetros

`yearValue`

Um inteiro especificando o valor número de um ano, por exemplo, 1995.

`monthValue`

Opcional. Um inteiro entre 0 e 11 representando os meses Janeiro até Dezembro.

`dateValue`

Opcional. Um inteiro entre 1 e 31 representando o dia do mês. Se você especificar o parâmetro `dateValue`, você deve também especificar `monthValue`.

### Valor retornado

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

Descrição
---------

Se você não especificar os parâmetros `monthValue` e `dateValue`, os valores retornados dos métodos `getMonth()` e `getDate()` são usados.

Se um parâmetro que você especificou está fora do alcance esperado, `setFullYear()` tenta atualizar os outros parâmetros e a informação de data no objeto `Date` adequadamente. Por exemplo, se você especificar 15 para o `monthValue`, o ano será incrementado em 1 (`yearValue + 1`), e 3 é usado para o mês.

Exemplos
--------

### Usando `setFullYear()`


```js
var theBigDay = new Date();
theBigDay.setFullYear(1997);
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setfullyear |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getUTCFullYear()`
* `Date.prototype.setUTCFullYear()`
* `Date.prototype.setYear()`
Date.prototype.getUTCSeconds()
==============================

O método **`getUTCSeconds()`** retorna os segundos na data informada de acordo com a hora universal.

Experimente
-----------

Sintaxe
-------
```

dateObj.getUTCSeconds()
```

### Valor de retorno

Um número inteiro, entre 0 e 59, representando os segundos da data informada de acordo com a hora universal.

Exemplos
--------

### Usando `getUTCSeconds()`

The following example assigns the seconds portion of the current time to the variabl

O exemplo a seguir atribui a parte dos segundos da hora atual à variável `seconds`.


```js
var today = new Date();
var seconds = today.getUTCSeconds();
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getutcseconds |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getSeconds()`
* `Date.prototype.setUTCSeconds()`
Date.prototype.getTime()
========================

O método **`getTime()`** retorna o valor numérico correspondente ao horário da data especificada de acordo com o horário universal.

Você pode usar este método para atribuir uma data e horário a outro objeto `Date`. Este método é funcionalmente equivalente ao método `valueOf()`.

Sintaxe
-------
```

dateObj.getTime()
```

### Retorna

Um número representando os milissegundos passados entre 1 de Janeiro de 1970 00:00:00 UTC e a data atual.

Exemplos
--------

### Usando `getTime()` para duplicar datas

Construindo um objeto de data com um horário idêntico.


```js
// Sendo o mês iniciado em zero, birthday será 10 de Janeiro de 1995
var birthday = new Date(1994, 12, 10);
var copy = new Date();
copy.setTime(birthday.getTime());
```

### Medindo tempo de execução

Subtrair duas chamadas subsequentes a `getTime()` em objetos `Date` recém criados resultará no intervalo de tempo entre essas duas chamadas. Isso pode ser usado para calcular o tempo de execução de algumas operações. Veja também `Date.now()` para evitar instanciar objetos `Date` desnecessariamente.


```js
var end, start;

start = new Date();
for (var i = 0; i < 1000; i++) {
  Math.sqrt(i);
}
end = new Date();

console.log("Operation took " + (end.getTime() - start.getTime()) + " msec");
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.gettime |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `Date.prototype.setTime()`
* `Date.prototype.valueOf()`
* `Date.now()`
Date.now()
==========

Resumo
------

O método **`Date.now()`** retorna o número de milisegundos decorridos desde 1 de janeiro de 1970 00:00:00 UTC.

Sintaxe
-------
```

var timeInMs = Date.now();
```

### Parâmetros

Nenhum.

Descrição
---------

O método **`now()`** retorna os milisegundos decorridos desde 1 de janeiro de 1970 00:00:00 UTC até agora como um `Number`.

Por que **`now`** é um método estático de **`Date`**, você sempre o usará como **`Date.now()`**.

Polyfill
--------

Este método foi padronizado no ECMA-262 5th edition. Em ambientes que não estão atualizados para suportar este método você pode suprir esta carência utilizando o seguinte:


```js
if (!Date.now) {
  Date.now = function now() {
    return new Date().getTime();
  };
}
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.now |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `window.performance.now` - fornece timestamps com sub-millisegundo precisão para uso em medir o desempenho da página
* `console.time` / `console.timeEnd`
Date.prototype.getDay()
=======================

Resumo
------

O método **`getDay()`** retorna o dia da semana para a data especificada de acordo com a hora local, onde 0 representa o Domingo.

Sintaxe
-------
```

dateObj.getDay()
```

### Parâmetros

Nenhum.

### Retorna

O valor retornado por `getDay()` é um inteiro que corresponde com o dia da semana: 0 para Domingo, 1 para Segunda-Feira, 2 para Terça-Feira, e assim por diante.

Exemplos
--------

### Exemplo: Usando `getDay()`

O segundo statement abaixo atribui o valor 1 à variável weekday (dia da semana), baseado no valor do objeto `Date` `Xmas95`. A data 25 de Dezembro de 1995 é uma Segunda-Feira.


```js
var Xmas95 = new Date("December 25, 1995 23:15:30");
var weekday = Xmas95.getDay();

console.log(weekday); // 1
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getday |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getUTCDate()`
* `Date.prototype.getUTCDay()`
* `Date.prototype.setDate()`
Date.prototype.setMonth()
=========================

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

Experimente
-----------

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 `getDate()` é utilizado.

Se um parâmetro que você especificou estiver fora do alcance esperado, `setMonth()` tenta atualizar a informação da data no objeto `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()`


```js
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
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setmonth |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Date.prototype.getMonth()`
* `Date.prototype.setUTCMonth()`
String.prototype.concat()
=========================

O método **`concat()`** combina o texto de duas ou mais strings e retorna uma nova string.

Sintaxe
-------
```

str.concat(string2 [, ...stringN])
```

### Parâmetros

`string2...stringN`

Strings para concatenar à **`string2`**.

### Valor retornado

Uma nova string contendo a string original concatenada à string passada como parâmetro.

Descrição
---------

A função **`concat()`** combina o texto de duas ou mais strings e retorna uma nova string. As alterações de texto de uma string não afetam a outra string.

Se o argumento passado não for do tipo string, o mesmo será convertido em uma string antes de ser concatenado.

Performance
-----------

É extremamente recomendado o uso dos operadores de atribuição (`+`, `+=`) em detrimento do método `concat()`.

Exemplos
--------

### Usando `concat()`

O exemplo a seguir concatena uma string à outra string originando uma terceira string.


```js
var hello = "Olá, ";
console.log(hello.concat("Kevin", " tenha um bom dia."));

// retorna 'Olá, Kevin tenha um bom dia.'
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-string.prototype.concat |

Navegadores compatíveis
-----------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* `Array.prototype.concat()`
* Assignment operators (en-US)