aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/javascript/reference/global_objects/date/utc/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/pt-br/web/javascript/reference/global_objects/date/utc/index.html')
-rw-r--r--files/pt-br/web/javascript/reference/global_objects/date/utc/index.html145
1 files changed, 145 insertions, 0 deletions
diff --git a/files/pt-br/web/javascript/reference/global_objects/date/utc/index.html b/files/pt-br/web/javascript/reference/global_objects/date/utc/index.html
new file mode 100644
index 0000000000..4684f83afa
--- /dev/null
+++ b/files/pt-br/web/javascript/reference/global_objects/date/utc/index.html
@@ -0,0 +1,145 @@
+---
+title: Date.UTC()
+slug: Web/JavaScript/Reference/Global_Objects/Date/UTC
+tags:
+ - JavaScript
+ - UTC
+translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC
+---
+<p>{{JSRef}}</p>
+
+<p>O método <strong><code>Date.UTC()</code></strong> aceita os mesmos parâmetros que o construtor mais longo de <strong><code>Date</code></strong> e retorna o total de milisegundos desde 1º de Janeiro de 1970 às 00:00:00 (horário universal). O valor retornado por <strong><code>Date.UTC()</code></strong> pode ser usado como parâmetro para criar uma instância de {{jsxref("Date")}}.</p>
+
+<h2 id="Syntax" name="Syntax">Sintaxe</h2>
+
+<pre><code>Date.UTC(<var>ano</var>, <var>mês</var>[, <var>dia</var>[, <var>hora</var>[, <var>minuto</var>[, <var>segundo</var>[, <var>milisegundo</var>]]]]])</code></pre>
+
+<h3 id="Parameters" name="Parameters">Parâmetros</h3>
+
+<dl>
+ <dt><code>ano</code></dt>
+ <dd>Um valor inteiro representando o ano, após 1970.</dd>
+ <dt><code><var>mês</var></code></dt>
+ <dd>Um valor inteiro que representa o mês, começando com 0 para Janeiro até 11 para Dezembro.</dd>
+ <dt><code><var>dia</var></code></dt>
+ <dd>Opcional. Um valor inteiro entre 1 e 31 representando o dia do mês.</dd>
+ <dt><code><var>hora</var></code></dt>
+ <dd>Opcional. Um valor inteiro entre 0 e 23 representando a hora do dia.</dd>
+ <dt><code>minuto</code></dt>
+ <dd>Opcional. Um valor entre 0 e 59 representando os minutos.</dd>
+ <dt><code>segundo</code></dt>
+ <dd>Opcional. Um valor entre 0 e 59 representando os segundos.</dd>
+ <dt><code>milisegundo</code></dt>
+ <dd>Opcional. Um valor entre 0 e 999 representando os milisegundos.</dd>
+</dl>
+
+<h2 id="Description" name="Description">Descrição</h2>
+
+<p><strong><code>UTC() </code></strong>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.</p>
+
+<p>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.</p>
+
+<p>O método <code>UTC()<strong> </strong></code>se diferencia do construtor de<font face="Consolas, Liberation Mono, Courier, monospace"> </font>{{jsxref("Date")}} de duas maneiras:</p>
+
+<ul>
+ <li><code>Date.UTC()</code> utiliza o horário universal em vez do horário local.</li>
+ <li><code>Date.UTC() </code>retorna um valor inteiro em vez de uma instância de {{jsxref("Date")}}.</li>
+</ul>
+
+<p>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.</p>
+
+<p><code>UTC() </code>é um método estático, por conta disto você sempre irá chamar <code>Date.UTC()</code> em vez de chamar um método de um objeto {{jsxref("Date")}} que você tenha criado.</p>
+
+<h2 id="Examples" name="Examples">Exemplos</h2>
+
+<h3 id="Example:_Using_Date.UTC" name="Example:_Using_Date.UTC">Utilizando <code>Date.UTC()</code></h3>
+
+<p>A seguinte expressão cria uma instância de {{jsxref("Date")}} utilizando UTC em vez do horário local:</p>
+
+<pre>var dataUniversal = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
+</pre>
+
+<h2 id="Especificações">Especificações</h2>
+
+<table>
+ <tbody>
+ <tr>
+ <th scope="col">Especificação</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comentário</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}}</td>
+ <td>{{Spec2('ES6')}}</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td>{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}}</td>
+ <td>{{Spec2('ES5.1')}}</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td>{{SpecName('ES1')}}</td>
+ <td>{{Spec2('ES1')}}</td>
+ <td>Definição inicial. Implementado no JavaScript 1.0.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilidade_entre_navegadores">Compatibilidade entre navegadores</h2>
+
+<div>{{CompatibilityTable}}</div>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari</th>
+ </tr>
+ <tr>
+ <td>Suporte básico</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ <td>{{CompatVersionUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Android</th>
+ <th>Chrome for Android</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>IE Mobile</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ <td>{{CompatUnknown}}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="See_also" name="See_also">Veja Também</h2>
+
+<ul>
+ <li>{{jsxref("Date.parse()")}}</li>
+</ul>