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

O método **`toTimeString()`** retorna uma porção de tempo de um objeto `Date` de forma legível para um ser humano em Inglês Americano.

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

Sintaxe
-------
```

dateObj.toTimeString()
```

### Valor de retorno

Uma *string* representando a porção de tempo da data de forma legível para um ser humano em Inglês Americano.

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

Instâncias de `Date` referem-se a um ponto específico no tempo. Chamando `toString()` irá retornar uma data formatada de forma legível para um ser humano em Inglês Americano. No SpiderMonkey, isso consiste na porção da data (dia, mês e ano) seguido pela porção de tempo (horas, minutos, segundos e fuso horário). Algumas vezes é desejável obter a *string* da porção do tempo; tal coisa pode ser atingida utilizando o método `toTimeString()`.

O `toTimeString()` método é especialmente útil por que motores parecidos que implementam a ECMA-262 (en-US) podem ter *strings* diferentes obtidas de `toString()` para objetos `Date`, como o formato é dependente de implementação; abordagens de corte simples de *strings* pode não produzir resultados consistentes entre múltiplos motores.

Exemplos
--------

### Uso básico de `toTimeString()`


```js
var d = new Date(1993, 6, 28, 14, 39, 7);

console.log(d.toString()); // Wed Jul 28 1993 14:39:07 GMT-0600 (PDT)
console.log(d.toTimeString()); // 14:39:07 GMT-0600 (PDT)
```

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

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

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

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

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

* `Date.prototype.toLocaleTimeString()`
* `Date.prototype.toDateString()`
* `Date.prototype.toString()`
Date.prototype.getUTCDate()
===========================

O método **`getUTCDate()`** retorna o dia (data) do mês na data especificada de acordo com o horário universal.

Sintaxe
-------
```

dateObj.getUTCDate()
```

### Retorna

Um número inteiro, entre 1 e 31, representando o dia do mês na data especificada de acordo com o horário universal.

Exemplos
--------

### Usando `getUTCDate()`

O exemplo a seguir atribui o dia da data atual à variável `day`:


```js
var today = new Date();
var day = today.getUTCDate();
```

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

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

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

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

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

* `Date.prototype.getDate()`
* `Date.prototype.getUTCDay()`
* `Date.prototype.setUTCDate()`
Date.prototype.toISOString()
============================

O método **`toISOString()`** retorna uma cadeia de caracteres (*string*) simplificada no formato ISO extendido (ISO 8601), que é sempre 24 ou 27 caracteres de tamanho (`YYYY-MM-DDTHH:mm:ss.sssZ` ou `±YYYYYY-MM-DDTHH:mm:ss.sssZ`, respectivamente). O fuso horário é sempre o deslocamento zero UTC, como denotado pelo sufixo "`Z`".

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

Sintaxe
-------
```

dateObj.toISOString()
```

### Valor de retorno

Uma *string* representando a data no formato ISO 8601 de acordo com o horário universal.

Polyfill
--------

Este método foi padronizado na quinta edição da ECMA-262. Motores que não foram atualizados para suportar este método podem funcionar com uma gambiarra na ausência deste método da seguinte forma:


```js
if (!Date.prototype.toISOString) {
  (function () {
    function pad(number) {
      if (number < 10) {
        return "0" + number;
      }
      return number;
    }

    Date.prototype.toISOString = function () {
      return (
        this.getUTCFullYear() +
        "-" +
        pad(this.getUTCMonth() + 1) +
        "-" +
        pad(this.getUTCDate()) +
        "T" +
        pad(this.getUTCHours()) +
        ":" +
        pad(this.getUTCMinutes()) +
        ":" +
        pad(this.getUTCSeconds()) +
        "." +
        (this.getUTCMilliseconds() / 1000).toFixed(3).slice(2, 5) +
        "Z"
      );
    };
  })();
}
```

Exemplos
--------

### Usando `toISOString()`


```js
let today = new Date("05 October 2011 14:48 UTC");

console.log(today.toISOString()); // Retorna 2011-10-05T14:48:00.000Z
```


O exemplo acima usa uma conversão de uma *string* não-padrão que pode não ser convertida corretamente em navegadores que não sejam da Mozilla..

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

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

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

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

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

* `Date.prototype.toLocaleDateString()`
* `Date.prototype.toTimeString()`
* `Date.prototype.toUTCString()`
Date.prototype.valueOf()
========================

O método **`valueOf()`** retorna o valor primitivo do objeto `Date`.

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

Sintaxe
-------
```

dateObj.valueOf()
```

### Valor de retorno

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

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

O método `valueOf()` retorna o valor primitivo do objeto `Date` como um tipo de dado numérico, o número de milissegundos desde a meia noite do dia 1 de Janeiro de 1970 UTC.

Este método é funcionalmente equivalente ao método `Date.prototype.getTime()`.

Este método é geralmente chamado internamente pelo JavaScript e não explícito em código.

Exemplos
--------

### Usando `valueOf()`


```js
var x = new Date(56, 6, 17);
var myVar = x.valueOf(); // atribui -424713600000 to myVar
```

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

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

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

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

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

* `Object.prototype.valueOf()`
* `Date.prototype.getTime()`
Date.prototype.setMilliseconds()
================================

O método **`setMilliseconds()`** atribui os milissegundos para a data específica de acordo com a hora local.

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

Sintaxe
-------
```

dateObj.setMilliseconds(millisecondsValue)
```

### Parâmetros

`millisecondsValue`

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

### 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ê especifica um número fora do alcance esperado, a informação de data no objeto `Date` é atualizado de acordo. Por exemplo, se você especifica 1005, o número de segundos é incrementado em 1, e 5 é utilizado para os milissegundos.

Exemplos
--------

### Usando `setMilliseconds()`


```js
var theBigDay = new Date();
theBigDay.setMilliseconds(100);
```

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

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

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

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

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

* `Date.prototype.getMilliseconds()`
* `Date.prototype.setUTCMilliseconds()`
Date.prototype.setUTCMonth()
============================

O método **`setUTCMonth()`** atribui o mês para a data especificada de acordo com o horário universal.

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

Sintaxe
-------
```

dateObj.setUTCMonth(monthValue[, dayValue])
```

### Parâmetros

`monthValue`

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

`dayValue`

Opcional. Um inteiro de 1 a 31, representando o dia do mês.

### 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 o parâmetro `dayValue`, o valor retornado do método `getUTCDate()` é utilizado.

Se um parâmetro que você especificou está fora do alcance especificado, `setUTCMonth()` tentará atualizar a informação da data no objeto `Date`. Por exemplo, se você usar 15 para `monthValue`, o ano irá incrementar em 1, e 3 será usado para o mês.

Exemplos
--------

### Usando `setUTCMonth()`


```js
var theBigDay = new Date();
theBigDay.setUTCMonth(11);
```

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

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

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

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

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

* `Date.prototype.getUTCMonth()`
* `Date.prototype.setMonth()`
Date.prototype.getUTCMinutes()
==============================

O método **`getUTCMinutes()`** retorna os minutos na data especificada de acordo com o tempo universal.

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

Sintaxe
-------
```

dateObj.getUTCMinutes()
```

### Valor retornado

Um número inteiro, entre 0 e 59, representando os minutos na data especificada de acordo com o horário universal (UTC).

Exemplos
--------

### Usando `getUTCMinutes()`

O seguinte exemplo atribui a parte dos minutos do tempo atual para a variável `minutes`.


```js
var today = new Date();
var minutes = today.getUTCMinutes();
```

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

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

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

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

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

* `Date.prototype.getMinutes()`
* `Date.prototype.setUTCMinutes()`
Date.prototype.getFullYear()
============================

Resumo
------

O método **`getFullYear()`** retorna o ano da data especificada de acordo com a hora local.

Use este método ao invés do `getYear()`.

Sintaxe
-------
```

dateObj.getFullYear()
```

### Parâmetros

Nenhum.

### Retorna

O valor retornado por `getFullYear()` é um número absoluto. Para datas entre os anos 1000 e 9999, `getFullYear()` retorna um número de quatro dígitos, por exemplo, 1995. Use esta função para ter certeza de que o ano é compatível com os anos depois de 2000.

Exemplos
--------

### Exemplo: Usando `getFullYear()`

O exemplo seguinte atribui o valor de quatro dígitos do ano corrente à variável year.


```js
var today = new Date();
var year = today.getFullYear();
```

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

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

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.setFullYear()`
* `Date.prototype.getYear()`
Date.prototype.setMinutes()
===========================

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

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

Sintaxe
-------
```

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

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

dateObj.setMinutes(minutesValue)
```

### Parâmetros

`minutesValue`

Um inteiro entre 0 e 59, representando os mintuos.

`secondsValue`

Opcional. Um inteiro entre 0 e 59, representando 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ê deve também 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 `secondsValue` e `msValue`, os valores retornados dos métodos `getSeconds()` e `getMilliseconds()` são usados.

Se um parâmetro que você especificou estiver fora do alcance esperado, `setMinutes()` tentará atualizar a informação da 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 segundos.

Exemplos
--------

### Usando `setMinutes()`


```js
var theBigDay = new Date();
theBigDay.setMinutes(45);
```

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

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

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

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

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

* `Date.prototype.getMinutes()`
* `Date.prototype.setUTCMinutes()`
Date.prototype.getUTCMilliseconds()
===================================

o método **`getUTCMilliseconds()`** retorna os milisegundos na data especificada, de acordo com o horário universal (UTC).

Sintaxe
-------
```

dateObj.getUTCMilliseconds()
```

### Valor de retorno

Um número inteiro, entre 0 e 999, representando os milisegundos na data especificada de acordo com o horário universal (UTC).

Exemplos
--------

### Usando `getUTCMilliseconds()`

O exemplo a seguir associa a parte dos milissegundos do tempo atual à variável `milissegundos`.


```js
var hoje = new Date();
var milissegundos = today.getUTCMilliseconds();
```

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

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

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

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

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

* `Date.prototype.getMilliseconds()`
* `Date.prototype.setUTCMilliseconds()`
Date.prototype.getMilliseconds()
================================

O método **`getMilliseconds()`** retorna os milissegundos em uma data específica de acordo com o horário local.

Sintaxe
-------
```

dateObj.getMilliseconds()
```

### Retorna

Um número, entre 0 e 999, representando os milissegundos de uma data de acordo com o horário local.

Exemplos
--------

### Usando o `getMilliseconds()`

O exemplo a seguir atribui a porção de milissegundos do horário atual à variável `milliseconds`:


```js
var today = new Date();
var milliseconds = today.getMilliseconds();
```

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

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

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

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

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

* `Date.prototype.getUTCMilliseconds()`
* `Date.prototype.setMilliseconds()`
Date.prototype[@@toPrimitive]
=============================

O método **`[@@toPrimitive]()`** converte o objeto `Date` para um valor primitivo.

Sintaxe
-------
```

Date()[Symbol.toPrimitive](hint);
```

### Valor de retorno

O valor primitivo do objeto `Date`. Dependendo do argumento, o método pode retornar uma cadeia de caracteres (*string*) ou um número.

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

O método `[@@toPrimitive]()` do objeto `Date` retorna um valor primitivo, que pode ser tanto um tipo numérico quanto uma string.

Se `hint` é `"string"` ou `"default"`, `[@@toPrimitive]()` tenta chamar o método `toString`. Se a propriedade `toString` não existe, ele tenta chamar o método `valueOf` e se o `valueOf` não existir, `[@@toPrimitive]()` joga um `TypeError`.

Se `hint` é `"number"`, `[@@toPrimitive]()` tenta primeiro chamar `valueOf`, e se ele falha, chama `toString`.

O JavaScript chama o método `[@@toPrimitive]()` para converter um objeto para um valor primitivo. Você raramente precisa invocar o método `[@@toPrimitive]()` em si; JavaScript automaticamente o invoca quando encontra um objeto onde um valor primitivo é esperado.

Exemplos
--------

### Retornando primitivos de data


```js
const testDate = new Date(1590757517834);
// "Date Fri May 29 2020 14:05:17 GMT+0100 (British Summer Time)"

testDate[Symbol.toPrimitive]("string");
// Returns "Date Fri May 29 2020 14:05:17 GMT+0100 (British Summer Time)"

testDate[Symbol.toPrimitive]("number");
// Returns "1590757517834"

testDate[Symbol.toPrimitive]("default");
// Returns "Date Fri May 29 2020 14:05:17 GMT+0100 (British Summer Time)"
```

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

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype-@@toprimitive |

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

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

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

* `Symbol.toPrimitive`
Date.prototype.getMonth()
=========================

O método **`getMonth()`** retorna o mês na data especificada de acordo com o horário local, como um valor zero-based (onde o zero indica o primeiro mês do ano).

Sintaxe
-------
```

dateObj.getMonth()
```

### Parâmetros

Nenhum.

### Retorno

O valor retornado pelo método `getMonth()` é um inteiro entre 0 e 11. 0 corresponde a Janeiro, 1 a Fevereiro, e assim sucessivamente.

Exemplos
--------

### Usando o `getMonth()`

A segunda declaração abaixo atribui o valor 11 à variavel `month`, baseado no valor do objeto `Date` `Xmas95`.


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

console.log(month); // 11
```

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

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

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

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

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

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

O método **`setUTCSeconds()`** atribui os segundos para a data especificada de acordo com o horário universal.

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

Sintaxe
-------
```

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

### 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 pelo método `getUTCMilliseconds()` é utilizado.

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

Exemplos
--------

### Usando `setUTCSeconds()`


```js
var theBigDay = new Date();
theBigDay.setUTCSeconds(20);
```

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

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

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

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

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

* `Date.prototype.getUTCSeconds()`
* `Date.prototype.setSeconds()`
Date.prototype.getUTCHours()
============================

O método **`getUTCHours()`** retorna o número de horas na data especificada de acordo com o horário universal (UTC).Experimente
-----------

Sintaxe
-------
```

dateObj.getUTCHours()
```

### Valor retornado

Um número inteiro, entre 0 e 23, representando as horas em uma data de acordo com o horário universal (UTC).

Exemplos
--------

### Usando `getUTCHours()`

O exemplo a seguir atribui a porção de horas do horário corrente à variável `hours`.


```js
var today = new Date();
var hours = today.getUTCHours();
```

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

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

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.getSeconds()
===========================

O método **`getSeconds()`** retorna os segundos de uma data específica de acordo com o horário local.

Sintaxe
-------
```

dateObj.getSeconds()
```

### Retorna

Um número inteiro, entre 0 e 59, representando os segundos de uma data específica de acordo com o horário local.

Exemples
--------

### Usando o `getSeconds()`

The second statement below assigns the value 30 to the variable `seconds`, based on the value of the `Date` object `Xmas95`.

No exemplo a seguir, a segunda linha atribui o valor 30 à variável `seconds`, baseado no valor do objeto `Date` `Xmas95`.


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

console.log(seconds); // 30
```

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

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

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

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

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

* `Date.prototype.getUTCSeconds()`
* `Date.prototype.setSeconds()`
Date.prototype.toJSON()
=======================

O método **`toJSON()`** retorna uma representação representation do objeto `Date` como string.

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

Sintaxe
-------
```

dateObj.toJSON()
```

### Retorno

Uma representação da data como string.

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

Instâncias de `Date` referem-se a um específico ponto no tempo. Invocar `toJSON()` retorna uma string (usando `toISOString()`) representando o valor do objeto `Date`. Por padrão este método é destinado a serializar objetos `Date` em serializações JSON.

Exemplos
--------

### Usando `toJSON()`


```js
var jsonDate = new Date().toJSON();
var backToDate = new Date(jsonDate);

console.log(jsonDate); //2015-10-26T07:46:36.611Z
```

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

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

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

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

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

* `Date.prototype.toLocaleDateString()`
* `Date.prototype.toTimeString()`
* `Date.prototype.toUTCString()`
Date.prototype.setUTCFullYear()
===============================

O método **`setUTCFullYear()`** atribui o ano completo na data especificada de acordo com o horário universal.

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

Sintaxe
-------
```

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])
```

### Parâmetros

`yearValue`

Um inteiro especificando o valor numérico do ano, por exemplo, 1995.

`monthValue`

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

`dayValue`

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

### 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 `monthValue` e `dayValue`, os valores retornados dos métodos `getUTCMonth()` e `getUTCDate()` serão utilizados.

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

Exemplos
--------

### Usando `setUTCFullYear()`


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

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

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

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.setFullYear()`