<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.datetime.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'datetime.formats.php',
    1 => 'Formatos de Data e Hor&aacute;rio Suportados',
    2 => 'Formatos de Data e Hor&aacute;rio Suportados',
  ),
  'up' => 
  array (
    0 => 'book.datetime.php',
    1 => 'Data/Hor&aacute;rio',
  ),
  'prev' => 
  array (
    0 => 'datetime.error.tree.php',
    1 => 'Erros e Exce&ccedil;&otilde;es de Data/Hor&aacute;rio',
  ),
  'next' => 
  array (
    0 => 'timezones.php',
    1 => 'Lista de Fusos Hor&aacute;rios Suportados',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/datetime/formats.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="datetime.formats" class="chapter">
 <h1 class="title">Formatos de Data e Horário Suportados</h1>


 <p class="para">
  Esta seção descreve todos os diferentes formatos em uma sintaxe BNF, que os
  analisadores de <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span>, <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>,
  <span class="function"><a href="function.date-create-immutable.php" class="function">date_create_immutable()</a></span>,
  <span class="function"><a href="function.date-create.php" class="function">date_create()</a></span>, <span class="function"><a href="function.date-parse.php" class="function">date_parse()</a></span> e
  <span class="function"><a href="function.strtotime.php" class="function">strtotime()</a></span> entendem. Os formatos estão agrupados
  por seção. Na maioria dos casos, formatos de diferentes seções, separados por
  espaços, vírgula ou ponto, podem ser utilizados com a mesma string data/horário. Para cada um
  dos formatos suportados, um ou mais exemplos estão disponíveis, assim
  como a descrição do formato. Nos formatos, caracteres entre aspas simples
  são insensíveis a maiúsculas/minúsculas (<code class="literal">&#039;t&#039;</code> pode
  ser <code class="literal">t</code> ou <code class="literal">T</code>), caracteres entre
  aspas duplas são sensíveis a maiúsculas/minúsculas (<code class="literal">&quot;T&quot;</code> só pode ser
  <code class="literal">T</code>).
 </p>
 <p class="para">
  Para formatar objetos <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> e
  <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, favor se referir à documentação
  do método <span class="function"><a href="datetime.format.php" class="function">DateTimeInterface::format()</a></span>.
 </p>

 <p class="para">
  Um conjunto geral de regras deve ser considerado.
 </p>
 <ol type="1">
  <li class="listitem">
   <span class="simpara">
    O analisador permite para cada unidade (ano, mês, dia, hora, minuto, segundo)
    o intervalo completo de valores. Para um ano são apenas 4 dígitos, para um mês
    o intervalo é 0-12, dia é 0-31, hora é 0-24, e minuto é 0-59.
   </span>
  </li>
  <li class="listitem">
   <span class="simpara">
    60 é permitido para segundos, e algumas vezes strings com este
    segundo adicional aparecem. Porém, o PHP implementa o horário Unix onde &quot;60&quot; não é
    um segundo válido e por isso ocorre sobrecarga.
   </span>
  </li>
  <li class="listitem">
   <span class="simpara">
    <span class="function"><a href="function.strtotime.php" class="function">strtotime()</a></span> retorna <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> se quaisquer números estiverem fora dos
    intervalos, e <span class="function"><a href="datetimeimmutable.construct.php" class="function">DateTimeImmutable::__construct()</a></span> dispara
    uma exceção.
   </span>
  </li>
  <li class="listitem">
   <span class="simpara">
    Se um string contém somente uma data, todos os elementos de horário são inicializados em 0.
   </span>
  </li>
  <li class="listitem">
   <span class="simpara">
    Todos os elementos menos significativos são inicializados em 0 se alguma parte do horário estiver
    presente no string.
   </span>
  </li>
  <li class="listitem">
   <span class="simpara">
    O analisador é muito simples, e não faz verificações adicionais, o que o torna mais rápido (e
    mais genérico).
   </span>
  </li>
  <li class="listitem">
   <span class="simpara">
    Além das regras para os elementos de horário individuais, o analisador também entende
    <a href="datetime.formats.php#datetime.formats.compound" class="link">formatos compostos</a> mais específicos,
    como análise de timestamps Unix
    (<code class="literal">@1690388256</code>) e números de semana ISO
    (<code class="literal">2008-W28-3</code>).
   </span>
  </li>
  <li class="listitem">
   <p class="para">
    Há uma verificação adicional se uma data inválida é fornecida:
    <div class="informalexample">
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$res </span><span style="color: #007700">= </span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"2015-09-31"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$res</span><span style="color: #007700">[</span><span style="color: #DD0000">"warnings"</span><span style="color: #007700">]);</span></span></code></div>
     </div>

     <p class="para">O exemplo acima produzirá:</p>
     <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
array(1) {
  [11] =&gt;
  string(27) &quot;The parsed date was invalid&quot;
}
</pre></div>
     </div>
    </div>
   </p>
  </li>
  <li class="listitem">
   <p class="para">
    Já é possível lidar com casos extremos, mas neste caso
    a função <span class="function"><a href="datetimeimmutable.createfromformat.php" class="function">DateTimeImmutable::createFromFormat()</a></span> deve ser usada
    e o formato correto fornecido.
    <div class="informalexample">
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$res </span><span style="color: #007700">= </span><span style="color: #0000BB">DateTimeImmutable</span><span style="color: #007700">::</span><span style="color: #0000BB">createFromFormat</span><span style="color: #007700">(</span><span style="color: #DD0000">"Y-m-d"</span><span style="color: #007700">, </span><span style="color: #DD0000">"2015-09-34"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$res</span><span style="color: #007700">);</span></span></code></div>
     </div>

     <p class="para">O exemplo acima produzirá:</p>
     <div class="example-contents screen">
<div class="annotation-interactive cdata"><pre>
object(DateTimeImmutable)#1 (3) {
  [&quot;date&quot;]=&gt;
  string(26) &quot;2015-10-04 17:24:43.000000&quot;
  [&quot;timezone_type&quot;]=&gt;
  int(3)
  [&quot;timezone&quot;]=&gt;
  string(13) &quot;Europe/London&quot;
}
</pre></div>
     </div>
    </div>
   </p>
  </li>
 </ol>

 
 <div id="datetime.formats.time" class="sect1">
  <h2 class="title">Formatos de Horário</h2>

  <p class="para">
   Esta página descreve os diferentes formatos de data/horário em uma sintaxe BNF,
   que os analisadores de <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span>,
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, <span class="function"><a href="function.date-create.php" class="function">date_create()</a></span>,
   <span class="function"><a href="function.date-create-immutable.php" class="function">date_create_immutable()</a></span> e
   <span class="function"><a href="function.strtotime.php" class="function">strtotime()</a></span> entendem.
  </p>
  <p class="para">
   Para formatar objetos <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> e
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, favor se referir à documentação
   do método <span class="function"><a href="datetime.format.php" class="function">DateTimeInterface::format()</a></span>.
  </p>

  <table class="doctable table">
   <caption><strong>Símbolos utilizados</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formatos</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><code class="literal">frac</code></td>
      <td>. [0-9]+</td>
      <td>&quot;.21342&quot;, &quot;.85&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">hh</code></td>
      <td>&quot;0&quot;?[1-9] | &quot;1&quot;[0-2]</td>
      <td>&quot;04&quot;, &quot;7&quot;, &quot;12&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">HH</code></td>
      <td>[01][0-9] | &quot;2&quot;[0-4]</td>
      <td>&quot;04&quot;, &quot;07&quot;, &quot;19&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">meridian</code></td>
      <td>[AaPp] .? [Mm] .? [\0\t ]</td>
      <td>&quot;A.m.&quot;, &quot;pM&quot;, &quot;am.&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">MM</code></td>
      <td>[0-5][0-9]</td>
      <td>&quot;00&quot;, &quot;12&quot;, &quot;59&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">II</code></td>
      <td>[0-5][0-9]</td>
      <td>&quot;00&quot;, &quot;12&quot;, &quot;59&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">space</code></td>
      <td>[ \t]</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><code class="literal">tz</code></td>
      <td>&quot;(&quot;? [A-Za-z]{1,6} &quot;)&quot;? | [A-Z][a-z]+([_/][A-Z][a-z]+)+</td>
      <td>&quot;CEST&quot;, &quot;Europe/Amsterdam&quot;, &quot;America/Indiana/Knox&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">tzcorrection</code></td>
      <td>&quot;GMT&quot;? [+-] <code class="literal">hh</code> &quot;:&quot;? <code class="literal">MM</code>?</td>
      <td>&quot;+0400&quot;, &quot;GMT-07:00&quot;, &quot;-07:00&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Notação de 12 Horas</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formatos</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>Somente as horas, com o meridiano</td>
      <td><code class="literal">hh</code> <code class="literal">space</code>? <code class="literal">meridian</code></td>
      <td>&quot;4 am&quot;, &quot;5PM&quot;</td>
     </tr>

     <tr>
      <td>Horas e minutos, com o meridiano</td>
      <td><code class="literal">hh</code> [.:] <code class="literal">MM</code> <code class="literal">space</code>? <code class="literal">meridian</code></td>
      <td>&quot;4:08 am&quot;, &quot;7:19P.M.&quot;</td>
     </tr>

     <tr>
      <td>Horas, minutos e segundos, com o meridiano</td>
      <td><code class="literal">hh</code> [.:] <code class="literal">MM</code> [.:] <code class="literal">II</code> <code class="literal">space</code>? <code class="literal">meridian</code></td>
      <td>&quot;4:08:37 am&quot;, &quot;7:19:19P.M.&quot;</td>
     </tr>

     <tr>
      <td>MS SQL (Horas, minutos, segundos e a fração com o meridiano)</td>
      <td><code class="literal">hh</code> &quot;:&quot; <code class="literal">MM</code> &quot;:&quot; <code class="literal">II</code> [.:] [0-9]+ <code class="literal">meridian</code></td>
      <td>&quot;4:08:39:12313am&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Notação de 24 Horas</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>Horas e minutos</td>
      <td>&#039;t&#039;? <code class="literal">HH</code> [.:] <code class="literal">MM</code></td>
      <td>&quot;04:08&quot;, &quot;19.19&quot;, &quot;T23:43&quot;</td>
     </tr>

     <tr>
      <td>Horas e minutos, sem dois-pontos</td>
      <td>&#039;t&#039;? <code class="literal">HH</code> <code class="literal">MM</code></td>
      <td>&quot;0408&quot;, &quot;t1919&quot;, &quot;T2343&quot;</td>
     </tr>

     <tr>
      <td>Horas, minutos e segundos</td>
      <td>&#039;t&#039;? <code class="literal">HH</code> [.:] <code class="literal">MM</code> [.:] <code class="literal">II</code></td>
      <td>&quot;04.08.37&quot;, &quot;t19:19:19&quot;</td>
     </tr>

     <tr>
      <td>Horas, minutos e segundos, sem dois-pontos</td>
      <td>&#039;t&#039;? <code class="literal">HH</code> <code class="literal">MM</code> <code class="literal">II</code></td>
      <td>&quot;040837&quot;, &quot;T191919&quot;</td>
     </tr>

     <tr>
      <td>Horas, minutos, segundos e fuso horário</td>
      <td>&#039;t&#039;? <code class="literal">HH</code> [.:] <code class="literal">MM</code> [.:] <code class="literal">II</code> <code class="literal">space</code>? ( <code class="literal">tzcorrection</code> | <code class="literal">tz</code> )</td>
      <td>&quot;040837CEST&quot;, &quot;T191919-0700&quot;</td>
     </tr>

     <tr>
      <td>Horas, minutos, segundos e fração</td>
      <td>&#039;t&#039;? <code class="literal">HH</code> [.:] <code class="literal">MM</code> [.:] <code class="literal">II</code> <code class="literal">frac</code></td>
      <td>&quot;04.08.37.81412&quot;, &quot;19:19:19.532453&quot;</td>
     </tr>

     <tr>
      <td>Informações do fuso horário</td>
      <td><code class="literal">tz</code> | <code class="literal">tzcorrection</code></td>
      <td>&quot;CEST&quot;, &quot;Europe/Amsterdam&quot;, &quot;+0430&quot;, &quot;GMT-06:00&quot;</td>
     </tr>

    </tbody>
   
  </table>

 </div>
 

 
 <div id="datetime.formats.date" class="sect1">
  <h2 class="title">Formatos de Data</h2>

  <p class="para">
   Esta página descreve os diferentes formatos de data em uma sintaxe BNF, que
   os analisadores de <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span>,
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, <span class="function"><a href="function.date-create.php" class="function">date_create()</a></span>,
   <span class="function"><a href="function.date-create-immutable.php" class="function">date_create_immutable()</a></span> e
   <span class="function"><a href="function.strtotime.php" class="function">strtotime()</a></span> entendem.
  </p>
  <p class="para">
   Para formatar objetos <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> e
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, favor se referir à documentação
   do método <span class="function"><a href="datetime.format.php" class="function">DateTimeInterface::format()</a></span>.
  </p>

  <table class="doctable table">
   <caption><strong>Simbolos Utilizados</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><code class="literal">daysuf</code></td>
      <td>&quot;st&quot; | &quot;nd&quot; | &quot;rd&quot; | &quot;th&quot;</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><code class="literal">dd</code></td>
      <td>([0-2]?[0-9] | &quot;3&quot;[01]) <code class="literal">daysuf</code>?</td>
      <td>&quot;7th&quot;, &quot;22nd&quot;, &quot;31&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">DD</code></td>
      <td>&quot;0&quot; [0-9] | [1-2][0-9] | &quot;3&quot; [01]</td>
      <td>&quot;07&quot;, &quot;31&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">m</code></td>
      <td>&#039;january&#039; | &#039;february&#039; | &#039;march&#039; | &#039;april&#039; | &#039;may&#039; | &#039;june&#039; |
       &#039;july&#039; | &#039;august&#039; | &#039;september&#039; | &#039;october&#039; | &#039;november&#039; | &#039;december&#039; |
       &#039;jan&#039; | &#039;feb&#039; | &#039;mar&#039; | &#039;apr&#039; | &#039;may&#039; | &#039;jun&#039; | &#039;jul&#039; | &#039;aug&#039; | &#039;sep&#039; |
       &#039;sept&#039; | &#039;oct&#039; | &#039;nov&#039; | &#039;dec&#039; | &quot;I&quot; | &quot;II&quot; | &quot;III&quot; | &quot;IV&quot; | &quot;V&quot; | &quot;VI&quot;
       | &quot;VII&quot; | &quot;VIII&quot; | &quot;IX&quot; | &quot;X&quot; | &quot;XI&quot; | &quot;XII&quot;</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><code class="literal">M</code></td>
      <td>&#039;jan&#039; | &#039;feb&#039; | &#039;mar&#039; | &#039;apr&#039; | &#039;may&#039; | &#039;jun&#039; | &#039;jul&#039; | &#039;aug&#039; |
       &#039;sep&#039; | &#039;sept&#039; | &#039;oct&#039; | &#039;nov&#039; | &#039;dec&#039;</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><code class="literal">mm</code></td>
      <td>&quot;0&quot;? [0-9] | &quot;1&quot;[0-2]</td>
      <td>&quot;0&quot;, &quot;04&quot;, &quot;7&quot;, &quot;12&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">MM</code></td>
      <td>&quot;0&quot; [0-9] | &quot;1&quot;[0-2]</td>
      <td>&quot;00&quot;, &quot;04&quot;, &quot;07&quot;, &quot;12&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">y</code></td>
      <td>[0-9]{1,4}</td>
      <td>&quot;00&quot;, &quot;78&quot;, &quot;08&quot;, &quot;8&quot;, &quot;2008&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">yy</code></td>
      <td>[0-9]{2}</td>
      <td>&quot;00&quot;, &quot;08&quot;, &quot;78&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">YY</code></td>
      <td>[0-9]{4}</td>
      <td>&quot;2000&quot;, &quot;2008&quot;, &quot;1978&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">YYY</code></td>
      <td>[0-9]{5,19}</td>
      <td>&quot;81412&quot;, &quot;20192&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Notações Localizadas</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>Dia e mês americano</td>
      <td><code class="literal">mm</code> &quot;/&quot; <code class="literal">dd</code></td>
      <td>&quot;5/12&quot;, &quot;10/27&quot;</td>
     </tr>

     <tr>
      <td>Dia, mês e ano americano</td>
      <td><code class="literal">mm</code> &quot;/&quot; <code class="literal">dd</code> &quot;/&quot; <code class="literal">y</code></td>
      <td>&quot;12/22/78&quot;, &quot;1/17/2006&quot;, &quot;1/17/6&quot;</td>
     </tr>

     <tr>
      <td>Ano com quatro dígitos, mês e dia com barras</td>
      <td><code class="literal">YY</code> &quot;/&quot; <code class="literal">mm</code> &quot;/&quot; <code class="literal">dd</code></td>
      <td>&quot;2008/6/30&quot;, &quot;1978/12/22&quot;</td>
     </tr>

     <tr>
      <td>Ano com quatro dígitos e mês (GNU)</td>
      <td><code class="literal">YY</code> &quot;-&quot; <code class="literal">mm</code></td>
      <td>&quot;2008-6&quot;, &quot;2008-06&quot;, &quot;1978-12&quot;</td>
     </tr>

     <tr>
      <td>Ano, mês e dia com traços</td>
      <td><code class="literal">y</code> &quot;-&quot; <code class="literal">mm</code> &quot;-&quot; <code class="literal">dd</code></td>
      <td>&quot;2008-6-30&quot;, &quot;78-12-22&quot;, &quot;8-6-21&quot;</td>
     </tr>

     <tr>
      <td>Dia, mês e ano, com quatro dígitos, com pontos, tabulações ou traços</td>
      <td><code class="literal">dd</code> [.\t-] <code class="literal">mm</code> [.-] <code class="literal">YY</code></td>
      <td>&quot;30-6-2008&quot;, &quot;22.12.1978&quot;</td>
     </tr>

     <tr>
      <td>Dia, mês e ano, com dois dígitos, com pontos ou tabulações</td>
      <td><code class="literal">dd</code> [.\t] <code class="literal">mm</code> &quot;.&quot; <code class="literal">yy</code></td>
      <td>&quot;30.6.08&quot;, &quot;22\t12.78&quot;</td>
     </tr>

     <tr>
      <td>Dia, mês textual e ano</td>
      <td><code class="literal">dd</code> ([ \t.-])* <code class="literal">m</code> ([ \t.-])* <code class="literal">y</code></td>
      <td>&quot;30-June 2008&quot;, &quot;22DEC78&quot;, &quot;14 III 1879&quot;</td>
     </tr>

     <tr>
      <td>Mês textual e ano com quatro dígitos (O dia é redefinido para 1)</td>
      <td><code class="literal">m</code> ([ \t.-])* <code class="literal">YY</code></td>
      <td>&quot;June 2008&quot;, &quot;DEC1978&quot;, &quot;March 1879&quot;</td>
     </tr>

     <tr>
      <td>Ano com quatro dígitos e mês textual (O dia é redefinido para 1)</td>
      <td><code class="literal">YY</code> ([ \t.-])* <code class="literal">m</code></td>
      <td>&quot;2008 June&quot;, &quot;1978-XII&quot;, &quot;1879.MArCH&quot;</td>
     </tr>

     <tr>
      <td>Mês textual, dia e ano</td>
      <td><code class="literal">m</code> ([ .\t-])* <code class="literal">dd</code> [,.stndrh\t ]+ <code class="literal">y</code></td>
      <td>&quot;July 1st, 2008&quot;, &quot;April 17, 1790&quot;, &quot;May.9,78&quot;</td>
     </tr>

     <tr>
      <td>Mês textual e dia</td>
      <td><code class="literal">m</code> ([ .\t-])* <code class="literal">dd</code> [,.stndrh\t ]*</td>
      <td>&quot;July 1st,&quot;, &quot;Apr 17&quot;, &quot;May.9&quot;</td>
     </tr>

     <tr>
      <td>Dia e mês textual</td>
      <td><code class="literal">dd</code> ([ .\t-])* <code class="literal">m</code></td>
      <td>&quot;1 July&quot;, &quot;17 Apr&quot;, &quot;9.May&quot;</td>
     </tr>

     <tr>
      <td>Mês abreviado, dia e ano</td>
      <td><code class="literal">M</code> &quot;-&quot; <code class="literal">DD</code> &quot;-&quot; <code class="literal">y</code></td>
      <td>&quot;May-09-78&quot;, &quot;Apr-17-1790&quot;</td>
     </tr>

     <tr>
      <td>Ano, mês abreviado e dia</td>
      <td><code class="literal">y</code> &quot;-&quot; <code class="literal">M</code> &quot;-&quot; <code class="literal">DD</code></td>
      <td>&quot;78-Dec-22&quot;, &quot;1814-MAY-17&quot;</td>
     </tr>

     <tr>
      <td>Ano (somente o ano)</td>
      <td><code class="literal">YY</code></td>
      <td>&quot;1978&quot;, &quot;2008&quot;</td>
     </tr>

     <tr>
      <td>Year (expandido, 5-19 dígitos com sinal)</td>
      <td>[+-] <code class="literal">YYY</code></td>
      <td>&quot;-81120&quot;, &quot;+20192&quot;</td>
     </tr>

     <tr>
      <td>Mês textual (somente o mês)</td>
      <td><code class="literal">m</code></td>
      <td>&quot;March&quot;, &quot;jun&quot;, &quot;DEC&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Notação ISO8601</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>Ano com oito dígitos, mês e dia</td>
      <td><code class="literal">YY</code> <code class="literal">MM</code> <code class="literal">DD</code></td>
      <td>&quot;15810726&quot;, &quot;19780417&quot;, &quot;18140517&quot;</td>
     </tr>

     <tr>
      <td>Ano com quatro dígitos, mês e dia com barras</td>
      <td><code class="literal">YY</code> &quot;/&quot; <code class="literal">MM</code> &quot;/&quot; <code class="literal">DD</code></td>
      <td>&quot;2008/06/30&quot;, &quot;1978/12/22&quot;</td>
     </tr>

     <tr>
      <td>Ano com dois dígitos, mês e dia com traços</td>
      <td><code class="literal">yy</code> &quot;-&quot; <code class="literal">MM</code> &quot;-&quot; <code class="literal">DD</code></td>
      <td>&quot;08-06-30&quot;, &quot;78-12-22&quot;</td>
     </tr>

     <tr>
      <td>Ano com quatro dígitos, com sinal opcional, mês e dia</td>
      <td>[+-]? <code class="literal">YY</code> &quot;-&quot; <code class="literal">MM</code> &quot;-&quot; <code class="literal">DD</code></td>
      <td>&quot;-0002-07-26&quot;, &quot;+1978-04-17&quot;, &quot;1814-05-17&quot;</td>
     </tr>

     <tr>
      <td>Ano com 5+ dígitos com sinal, mês e dia</td>
      <td>[+-] <code class="literal">YYY</code> &quot;-&quot; <code class="literal">MM</code> &quot;-&quot; <code class="literal">DD</code></td>
      <td>&quot;-81120-02-26&quot;, &quot;+20192-04-17&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    Para os formatos <code class="literal">y</code> e <code class="literal">yy</code>,
    anos abaixo de 100 são manipulados de maneira especial quando os
    símbolos <code class="literal">y</code> ou <code class="literal">yy</code> são utilizados.
    Se o ano cair no período de 0 (incluso) a 69 (incluso),
    2000 anos são adicionados. Se o ano cair no período de 70 (incluso) a
    99 (incluso), então 1900 são adicionados. Isso significa que &quot;00-01-01&quot;
    será interpretado como &quot;2000-01-01&quot;.
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    O formato &quot;Dia, mês e ano com dois dígitos, com pontos ou tabulações&quot;
    (<code class="literal">dd</code> [.\t] <code class="literal">mm</code> &quot;.&quot;
    <code class="literal">yy</code>) somente funciona para valores de ano que variam 61 (incluso)
    até 99 (incluso) - fora destes anos, o <em>formato
    de tempo</em> &quot;<code class="literal">HH</code> [.:] <code class="literal">MM</code>
    [.:] <code class="literal">SS</code>&quot; possui precedência.
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    O formato &quot;Ano (e somente o ano)&quot;, só funcionará de maneira confiável se uma string de horário
    já tiver sido encontrada. Caso contrário, se o ano de quatro dígitos corresponder a
    <code class="literal">HH</code> <code class="literal">MM</code>, estes dois elementos serão
    definidos no lugar.
   </p>
   <p class="para">
    Para interpretear consistentemente só um valor de ano, use
    <span class="function"><a href="datetimeimmutable.createfromformat.php" class="function">DateTimeImmutable::createFromFormat()</a></span> com o especificador
    <code class="literal">Y</code>.
   </p>
  </p></blockquote>

  <div class="caution"><strong class="caution">Cuidado</strong>
   <p class="para">
    É possível exceder positivamente e negativamente os formatos <code class="literal">dd</code> e
    <code class="literal">DD</code>. Dia 0 corresponde a último dia do mês
    anterior, assim como excedências positivas contam no próximo mês. Isso faz com que
    &quot;2008-08-00&quot; seja equivalente a &quot;2008-07-31&quot; e &quot;2008-07-31&quot; seja equivalente
    a  &quot;2008-07-01&quot; (junho possui somente 30 dias).
   </p>
   <p class="para">
    Note que o intervalo de dia é restrito a 0-31 como indicado
    pela expressão regular acima. Por isso, &quot;2008-06-32&quot; não é um string de data válida,
    por exemplo.
   </p>
   <p class="para">
    É possível exceder negativamente os formatos <code class="literal">mm</code> e
    <code class="literal">MM</code> com o valor 0. O valor de mês
    0 corresponde a dezembro do mês anterior. Como exemplo, &quot;2008-00-22&quot; é
    equivalente a &quot;2007-12-22&quot;.
   </p>
   <p class="para">
    Se os dois fatos forem combinados e o dia e o mês forem excedidos
    negativamente, o que segue acontece: &quot;2008-00-00&quot; primeiro será convertido
    para &quot;2007-12-00&quot; que então será convertido para &quot;2007-11-30&quot;. Isso também
    acontece com a string &quot;0000-00-00&quot;, que é transformada em
    &quot;-0001-11-30&quot; (o ano -1 ano calendário ISO 8601, que é 2 anos DC no calendário
    que antecede o calendário gregoriano).
   </p>
  </div>
 </div>
 

 
 <div id="datetime.formats.compound" class="sect1">
  <h2 class="title">Formatos Compostos</h2>

  <p class="para">
   Esta página descreve os diferentes formatos compostos de data/horário em uma sintaxe
   BNF, que os analisadores de <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span>,
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, <span class="function"><a href="function.date-create.php" class="function">date_create()</a></span>,
   <span class="function"><a href="function.date-create-immutable.php" class="function">date_create_immutable()</a></span> e
   <span class="function"><a href="function.strtotime.php" class="function">strtotime()</a></span> entendem.
  </p>
  <p class="para">
   Para formatar objetos <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> e
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, favor se referir à documentação
   do método <span class="function"><a href="datetime.format.php" class="function">DateTimeInterface::format()</a></span>.
  </p>

  <table class="doctable table">
   <caption><strong>Símbolos Utilizados</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><code class="literal">DD</code></td>
      <td>&quot;0&quot; [0-9] | [1-2][0-9] | &quot;3&quot; [01]</td>
      <td>&quot;02&quot;, &quot;12&quot;, &quot;31&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">doy</code></td>
      <td>&quot;00&quot;[1-9] | &quot;0&quot;[1-9][0-9] | [1-2][0-9][0-9] | &quot;3&quot;[0-5][0-9] | &quot;36&quot;[0-6]</td>
      <td>&quot;001&quot;, &quot;012&quot;, &quot;180&quot;, &quot;350&quot;, &quot;366&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">frac</code></td>
      <td>. [0-9]+</td>
      <td>&quot;.21342&quot;, &quot;.85&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">hh</code></td>
      <td>&quot;0&quot;?[1-9] | &quot;1&quot;[0-2]</td>
      <td>&quot;04&quot;, &quot;7&quot;, &quot;12&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">HH</code></td>
      <td>[01][0-9] | &quot;2&quot;[0-4]</td>
      <td>&quot;04&quot;, &quot;07&quot;, &quot;19&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">meridian</code></td>
      <td>[AaPp] .? [Mm] .? [\0\t ]</td>
      <td>&quot;A.m.&quot;, &quot;pM&quot;, &quot;am.&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">ii</code></td>
      <td>[0-5]?[0-9]</td>
      <td>&quot;04&quot;, &quot;8&quot;, &quot;59&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">II</code></td>
      <td>[0-5][0-9]</td>
      <td>&quot;04&quot;, &quot;08&quot;, &quot;59&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">M</code></td>
      <td>&#039;jan&#039; | &#039;feb&#039; | &#039;mar&#039; | &#039;apr&#039; | &#039;may&#039; | &#039;jun&#039; | &#039;jul&#039; | &#039;aug&#039; | &#039;sep&#039; | &#039;sept&#039; | &#039;oct&#039; | &#039;nov&#039; | &#039;dec&#039;</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><code class="literal">MM</code></td>
      <td>[0-1][0-9]</td>
      <td>&quot;00&quot;, &quot;12&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">space</code></td>
      <td>[ \t]</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td><code class="literal">ss</code></td>
      <td>[0-5]?[0-9]|60</td>
      <td>&quot;04&quot;, &quot;8&quot;, &quot;59&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">SS</code></td>
      <td>[0-5][0-9]</td>
      <td>&quot;04&quot;, &quot;08&quot;, &quot;59&quot;, &quot;60&quot; (segundo intercalar)</td>
     </tr>

     <tr>
      <td><code class="literal">W</code></td>
      <td>&quot;0&quot;[1-9] | [1-4][0-9] | &quot;5&quot;[0-3]</td>
      <td>&quot;05&quot;, &quot;17&quot;, &quot;53&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">tzcorrection</code></td>
      <td>&quot;GMT&quot;? [+-] <code class="literal">hh</code> &quot;:&quot;? <code class="literal">II</code>?</td>
      <td>&quot;+0400&quot;, &quot;GMT-07:00&quot;, &quot;-07:00&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">YY</code></td>
      <td>[0-9]{4}</td>
      <td>&quot;2000&quot;, &quot;2008&quot;, &quot;1978&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Formatos padrões</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>ATOM</td>
      <td>&quot;2022-06-02T16:58:35+00:00&quot;</td>
     </tr>

     <tr>
      <td>COOKIE</td>
      <td>&quot;Thursday, 02-Jun-2022 16:58:35 UTC&quot;</td>
     </tr>

     <tr>
      <td>ISO8601</td>
      <td>&quot;2022-06-02T16:58:35+0000&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc822" class="link external">&raquo;&nbsp;RFC 822</a></td>
      <td>&quot;Thu, 02 Jun 22 16:58:35 +0000&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc850" class="link external">&raquo;&nbsp;RFC 850</a></td>
      <td>&quot;Thursday, 02-Jun-22 16:58:35 UTC&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc1036" class="link external">&raquo;&nbsp;RFC 1036</a></td>
      <td>&quot;Thu, 02 Jun 22 16:58:35 +0000&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc1123" class="link external">&raquo;&nbsp;RFC 1123</a></td>
      <td>&quot;Thu, 02 Jun 2022 16:58:35 +0000&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc2822" class="link external">&raquo;&nbsp;RFC 2822</a></td>
      <td>&quot;Thu, 02 Jun 2022 16:58:35 +0000&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc3339" class="link external">&raquo;&nbsp;RFC 3339</a></td>
      <td>&quot;2022-06-02T16:58:35+00:00&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc3339" class="link external">&raquo;&nbsp;RFC 3339</a> estendida</td>
      <td>&quot;2022-06-02T16:58:35.698+00:00&quot;</td>
     </tr>

     <tr>
      <td><a href="https://datatracker.ietf.org/doc/html/rfc7231" class="link external">&raquo;&nbsp;RFC 7231</a></td>
      <td>&quot;Thu, 02 Jun 2022 16:58:35 GMT&quot;</td>
     </tr>

     <tr>
      <td>RSS</td>
      <td>&quot;Thu, 02 Jun 2022 16:58:35 +0000&quot;</td>
     </tr>

     <tr>
      <td>W3C</td>
      <td>&quot;2022-06-02T16:58:35+00:00&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Notações Localizadas</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>Formato de Log Popular</td>
      <td><code class="literal">dd</code> &quot;/&quot; <code class="literal">M</code> &quot;/&quot; <code class="literal">YY</code> : <code class="literal">HH</code> &quot;:&quot; <code class="literal">II</code> &quot;:&quot; <code class="literal">SS</code> <code class="literal">space</code> <code class="literal">tzcorrection</code></td>
      <td>&quot;10/Oct/2000:13:55:36 -0700&quot;</td>
     </tr>

     <tr>
      <td>EXIF</td>
      <td><code class="literal">YY</code> &quot;:&quot; <code class="literal">MM</code> &quot;:&quot; <code class="literal">DD</code> &quot; &quot; <code class="literal">HH</code> &quot;:&quot; <code class="literal">II</code> &quot;:&quot; <code class="literal">SS</code></td>
      <td>&quot;2008:08:07 18:11:31&quot;</td>
     </tr>

     <tr>
      <td>Ano ISO com Semana ISO</td>
      <td><code class="literal">YY</code> &quot;-&quot;? &quot;W&quot; <code class="literal">W</code></td>
      <td>&quot;2008W27&quot;, &quot;2008-W28&quot;</td>
     </tr>

     <tr>
      <td>Ano ISO com Semana ISO e dia</td>
      <td><code class="literal">YY</code> &quot;-&quot;? &quot;W&quot; <code class="literal">W</code> &quot;-&quot;? [0-7]</td>
      <td>&quot;2008W273&quot;, &quot;2008-W28-3&quot;</td>
     </tr>

     <tr>
      <td>MySQL</td>
      <td><code class="literal">YY</code> &quot;-&quot; <code class="literal">MM</code> &quot;-&quot; <code class="literal">DD</code> &quot; &quot; <code class="literal">HH</code> &quot;:&quot; <code class="literal">II</code> &quot;:&quot; <code class="literal">SS</code></td>
      <td>&quot;2008-08-07 18:11:31&quot;</td>
     </tr>

     <tr>
      <td>PostgreSQL: Ano com dia do ano</td>
      <td><code class="literal">YY</code> &quot;.&quot;? <code class="literal">doy</code></td>
      <td>&quot;2008.197&quot;, &quot;2008197&quot;</td>
     </tr>

     <tr>
      <td>SOAP</td>
      <td><code class="literal">YY</code> &quot;-&quot; <code class="literal">MM</code> &quot;-&quot; <code class="literal">DD</code> &quot;T&quot; <code class="literal">HH</code> &quot;:&quot; <code class="literal">II</code> &quot;:&quot; <code class="literal">SS</code> <code class="literal">frac</code> <code class="literal">tzcorrection</code>?</td>
      <td>&quot;2008-07-01T22:35:17.02&quot;, &quot;2008-07-01T22:35:17.03+08:00&quot;</td>
     </tr>

     <tr>
      <td>Timestamp Unix</td>
      <td>&quot;@&quot; &quot;-&quot;? [0-9]+</td>
      <td>&quot;@1215282385&quot;</td>
     </tr>

     <tr>
      <td>Timestamp Unix com microssegundos</td>
      <td>&quot;@&quot; &quot;-&quot;? [0-9]+ &quot;.&quot; [0-9]{0,6}</td>
      <td>&quot;@1607974647.503686&quot;</td>
     </tr>

     <tr>
      <td>XMLRPC</td>
      <td><code class="literal">YY</code> <code class="literal">MM</code> <code class="literal">DD</code> &quot;T&quot; <code class="literal">hh</code> &quot;:&quot; <code class="literal">II</code> &quot;:&quot; <code class="literal">SS</code></td>
      <td>&quot;20080701T22:38:07&quot;, &quot;20080701T9:38:07&quot;</td>
     </tr>

     <tr>
      <td>XMLRPC (Compacto)</td>
      <td><code class="literal">YY</code> <code class="literal">MM</code> <code class="literal">DD</code> &#039;t&#039; <code class="literal">hh</code> <code class="literal">II</code> <code class="literal">SS</code></td>
      <td>&quot;20080701t223807&quot;, &quot;20080701T093807&quot;</td>
     </tr>

     <tr>
      <td>WDDX</td>
      <td><code class="literal">YY</code> &quot;-&quot; <code class="literal">mm</code> &quot;-&quot; <code class="literal">dd</code> &quot;T&quot; <code class="literal">hh</code> &quot;:&quot; <code class="literal">ii</code> &quot;:&quot; <code class="literal">ss</code></td>
      <td>&quot;2008-7-1T9:3:37&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    O &quot;W&quot; nos formatos &quot;Ano ISO com semana ISO&quot; e &quot;Ano ISO com semana ISO
    e dia&quot; são sensíveis a maiúsculas/minúsculas, só pode ser usado o &quot;W&quot;
    maiúsculo.
   </p>
   <p class="para">
    O &quot;T&quot;, nos formatos SOAP, XMLRPC e WDDX é sensível a maiúsculas/minúsculas, só
    pode ser usado o &quot;T&quot; maiúsculo.
   </p>
   <p class="para">
    O formato &quot;Timestamp Unix&quot; define o fuso horário para UTC.
   </p>
  </p></blockquote>
 </div>
 

 
 <div id="datetime.formats.relative" class="sect1">
  <h2 class="title">Formatos relativos</h2>
  <p class="para">
   Esta página descreve os diferentes formatos de data/horário relativos em uma sintaxe BNF,
   que os analisadores de <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span>,
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, <span class="function"><a href="function.date-create.php" class="function">date_create()</a></span>,
   <span class="function"><a href="function.date-create-immutable.php" class="function">date_create_immutable()</a></span> e
   <span class="function"><a href="function.strtotime.php" class="function">strtotime()</a></span> entendem.
  </p>
  <p class="para">
   Para formatar objetos <span class="classname"><a href="class.datetimeimmutable.php" class="classname">DateTimeImmutable</a></span> e
   <span class="classname"><a href="class.datetime.php" class="classname">DateTime</a></span>, favor se referir à documentação
   do método <span class="function"><a href="datetime.format.php" class="function">DateTimeInterface::format()</a></span>.
  </p>

  <table class="doctable table">
   <caption><strong>Símbolos Utilizados</strong></caption>
   
    <thead>
     <tr>
      <th>Descrição</th>
      <th>Formato</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><code class="literal">dayname</code></td>
      <td>&#039;sunday&#039; | &#039;monday&#039; | &#039;tuesday&#039; | &#039;wednesday&#039; | &#039;thursday&#039; |
       &#039;friday&#039; | &#039;saturday&#039; | &#039;sun&#039; | &#039;mon&#039; | &#039;tue&#039; | &#039;wed&#039; | &#039;thu&#039; | &#039;fri&#039; |
       &#039;sat&#039;</td>
     </tr>

     <tr>
      <td><code class="literal">daytext</code></td>
      <td>&#039;weekday&#039; | &#039;weekdays&#039;</td>
     </tr>

     <tr>
      <td><code class="literal">number</code></td>
      <td>[+-]?[0-9]+</td>
     </tr>

     <tr>
      <td><code class="literal">ordinal</code></td>
      <td>&#039;first&#039; | &#039;second&#039; | &#039;third&#039; | &#039;fourth&#039; | &#039;fifth&#039; | &#039;sixth&#039; |
       &#039;seventh&#039; | &#039;eighth&#039; | &#039;ninth&#039; | &#039;tenth&#039; | &#039;eleventh&#039; | &#039;twelfth&#039; |
       &#039;next&#039; | &#039;last&#039; | &#039;previous&#039; | &#039;this&#039;</td>
     </tr>

     <tr>
      <td><code class="literal">reltext</code></td>
      <td>&#039;next&#039; | &#039;last&#039; | &#039;previous&#039; | &#039;this&#039;</td>
     </tr>

     <tr>
      <td><code class="literal">space</code></td>
      <td>[ \t]+</td>
     </tr>

     <tr>
      <td><code class="literal">unit</code></td>
      <td>&#039;ms&#039; | &#039;µs&#039; | (( &#039;msec&#039; | &#039;millisecond&#039; | &#039;µsec&#039; | &#039;microsecond&#039;
      | &#039;usec&#039; | &#039;sec&#039; | &#039;second&#039; | &#039;min&#039; | &#039;minute&#039; | &#039;hour&#039; | &#039;day&#039; |
      &#039;fortnight&#039; | &#039;forthnight&#039; | &#039;month&#039; | &#039;year&#039;) &#039;s&#039;?) | &#039;weeks&#039; |
      <code class="literal">daytext</code></td>
     </tr>

    </tbody>
   
  </table>


  <table class="doctable table">
   <caption><strong>Notação baseada no dia</strong></caption>
   
    <thead>
     <tr>
      <th>Formato</th>
      <th>Descrição</th>
      <th>Exemplos</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>&#039;yesterday&#039;</td>
      <td>Meia-noite de ontem</td>
      <td>&quot;yesterday 14:00&quot;</td>
     </tr>

     <tr>
      <td>&#039;midnight&#039;</td>
      <td>O horário é definido para 00:00:00</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td>&#039;today&#039;</td>
      <td>O horário é definido para 00:00:00</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td>&#039;now&#039;</td>
      <td>Agora - isto é simplesmente ignorado</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td>&#039;noon&#039;</td>
      <td>O horário é definido para 12:00:00</td>
      <td>&quot;yesterday noon&quot;</td>
     </tr>

     <tr>
      <td>&#039;tomorrow&#039;</td>
      <td>Meia-noite de amanhã</td>
      <td class="empty">&nbsp;</td>
     </tr>

     <tr>
      <td>&#039;back of&#039; <code class="literal">hour</code></td>
      <td>15 minutos após o horário informado</td>
      <td>&quot;back of 7pm&quot;, &quot;back of 15&quot;</td>
     </tr>

     <tr>
      <td>&#039;front of&#039; <code class="literal">hour</code></td>
      <td>15 minutos antes do horário informado</td>
      <td>&quot;front of 5am&quot;, &quot;front of 23&quot;</td>
     </tr>

     <tr>
      <td>&#039;first day of&#039;</td>
      <td>Define o dia para o primeiro dia do mês atual. Essa frase é
       normalmente usada da melhor forma em conjunto com um nome de mês, já que ela somente
       afeta o mês atual.</td>
      <td>&quot;first day of January 2008&quot;</td>
     </tr>

     <tr>
      <td>&#039;last day of&#039;</td>
      <td>Define o dia para o último do mês corrente. Essa frase é
       normalmente usada da melhor forma em conjunto com um nome de mês, já que ela somente
       afeta o mês atual.</td>
      <td>&quot;last day of next month&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">ordinal</code> <code class="literal">space</code> <code class="literal">dayname</code> <code class="literal">space</code> &#039;of&#039;</td>
      <td>Calcula o número ordinal <code class="literal">x</code>-th da semana do mês corrente.</td>
      <td>&quot;first sat of July 2008&quot;</td>
     </tr>

     <tr>
      <td>&#039;last&#039; <code class="literal">space</code> <code class="literal">dayname</code> <code class="literal">space</code> &#039;of&#039;</td>
      <td>Calcular o <em>último</em> dia da semana do mês corrente.</td>
      <td>&quot;last sat of July 2008&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">number</code> <code class="literal">space</code>? (<code class="literal">unit</code> | &#039;week&#039;)</td>
      <td>Manipula porções de tempo relativas onde o valor seja um número.</td>
      <td>&quot;+5 weeks&quot;, &quot;12 day&quot;, &quot;-7 weekdays&quot;</td>
     </tr>

     <tr>
      <td>(<code class="literal">ordinal</code> | <code class="literal">reltext</code>) <code class="literal">space</code> <code class="literal">unit</code></td>
      <td>Manipula porções de tempo relativas onde o valor seja um texto.
      <code class="literal">last</code> e <code class="literal">previous</code> são equivalentes
      a <code class="literal">-1</code>, <code class="literal">this</code> equivalente a nada, e
      <code class="literal">next</code> equivamente a <code class="literal">+1</code>.</td>
      <td>&quot;fifth day&quot;, &quot;second month&quot;, &quot;last day&quot;, &quot;previous year&quot;</td>
     </tr>

     <tr>
      <td>&#039;ago&#039;</td>
      <td>Nega todos os valores das porções de tempo relativas anteriores.</td>
      <td>&quot;2 days ago&quot;, &quot;8 days ago 14:00&quot;, &quot;2 months 5 days ago&quot;, &quot;2 months ago 5 days&quot;, &quot;2 days ago&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">dayname</code></td>
      <td>
       Move para o próximo dia deste nome.(See <a href="datetime.formats.php#datetime.formats.relative.dayname-note" class="link">note</a>)
      </td>
      <td>&quot;Monday&quot;</td>
     </tr>

     <tr>
      <td><code class="literal">reltext</code> <code class="literal">space</code> &#039;week&#039;</td>
      <td>Manipula o formato especial &quot;weekday + last/this/next week&quot;.</td>
      <td>&quot;Monday next week&quot;</td>
     </tr>

    </tbody>
   
  </table>


  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    Declarações relativas são sempre processadas <em>depois</em>
    de declarações não relativas. Isso faz com que &quot;+1 week july 2008&quot; e &quot;july
    2008 +1 week&quot; sejam equivalentes.
   </p>
   <p class="para">
    As exceções desta regra são &quot;yesterday&quot;, &quot;midnight&quot;, &quot;today&quot;, &quot;noon&quot;
    e &quot;tomorrow&quot;. Observe que &quot;tomorrow 11:00&quot; e &quot;11:00 tomorrow&quot;
    são diferentes. Considerando que a data hoje como &quot;July 23rd, 2008&quot;, o
    primeiro produzirá &quot;2008-07-24 11:00&quot; assim como o segundo produzirá
    &quot;2008-07-24 00:00&quot;. Isso acontece por que as cinco declarações
    influenciam diretamente o tempo corrente.
   </p>
   <p class="para">
    Palavras-chave como &quot;first day of&quot; dependem do contexto no qual o
    string de formato relativo é usado. Se usado com um método ou funcão estáticos,
    a referência é o timestamp atual do sistema. Entretanto, se usado em
    <span class="function"><a href="datetime.modify.php" class="function">DateTime::modify()</a></span> ou
    <span class="function"><a href="datetimeimmutable.modify.php" class="function">DateTimeImmutable::modify()</a></span>, a referência é o objeto
    no qual o método <code class="literal">modify()</code> é chamado.
   </p>
  </p></blockquote>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para" id="datetime.formats.relative.dayname-note">
    Observe as seguintes considerações quando o dia da semana corrente é o
    mesmo que o dia da semana utilizada na string date/horário. O dia da semana
    corrente pode ser (re-)calculado para porções não relativas de strings
    de data/horário.
   </p>
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">dayname</code>&quot; <em>não</em> avança para
      outro dia. (Exemplo: &quot;Wed July 23rd, 2008&quot; referencia &quot;2008-07-23&quot;).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">number</code> <code class="literal">dayname</code>&quot;
      <em>não</em> avança para outro dia. (Exemplo: &quot;1
      wednesday july 23rd, 2008&quot; referencia &quot;2008-07-23&quot;).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">number</code> week <code class="literal">dayname</code>&quot;
      adicionará primeiro o dia da semana, mas <em>not</em>
      avançará para outro dia. Neste caso, &quot;<code class="literal">number</code>
      week&quot; e &quot;<code class="literal">dayname</code>&quot; são dois blocos distintos.
      (Exemplo: &quot;+1 week wednesday july 23rd, 2008&quot; referencia &quot;2008-07-30&quot;).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">ordinal</code> <code class="literal">dayname</code>&quot;
      <em>avançará</em>para outro dia. (Exemplo &quot;first
      wednesday july 23rd, 2008&quot; referencia &quot;2008-07-30&quot;).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">number</code> week <code class="literal">ordinal</code>
      <code class="literal">dayname</code>&quot; adicionará primeiro o número de
      semanas, e então <em>avançará</em> para outro
      dia. Neste caso &quot;<code class="literal">number</code> week&quot; e
      &quot;<code class="literal">ordinal</code> <code class="literal">dayname</code> são dois
      blocos distintos. (Exemplo: &quot;+1 week first wednesday july 23rd,
      2008&quot; referencia &quot;2008-08-06&quot;).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">ordinal</code> <code class="literal">dayname</code> &#039;of&#039; &quot;
      <em>não</em> avança para outro dia. (Exemplo:
      &quot;first wednesday of july 23rd, 2008&quot; referencia &quot;2008-07-02&quot; porque
      a frase específica com &#039;of&#039; redefine o dia do mês para &#039;1&#039; e
      o &#039;23rd&#039; é ignorado).
     </span>
    </li>
   </ol>
   <p class="para">
    Também observe que o &quot;of&quot; em &quot;<code class="literal">ordinal</code>
    <code class="literal">space</code> <code class="literal">dayname</code>
    <code class="literal">space</code> &#039;of&#039; &quot; e &quot;&#039;last&#039; <code class="literal">space</code>
    <code class="literal">dayname</code> <code class="literal">space</code> &#039;of&#039; &quot; fazem
    coisas especiais.
   </p>
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
      Ele definirá o dia do mês para 1.
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">ordinal</code> <code class="literal">dayname</code> &#039;of&#039; &quot;
      <em>não</em> avançará para outro dia. (Exemplo: &quot;first
      tuesday of july 2008&quot; referencia &quot;2008-07-01&quot;).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;<code class="literal">ordinal</code> <code class="literal">dayname</code> &quot;
      <em>avançará</em> para outro dia. (Exemplo: &quot;first
      tuesday july 2008&quot; referencia &quot;2008-07-08&quot;, veja também o item 4 na
      lista acima).
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;&#039;last&#039; <code class="literal">dayname</code> &#039;of&#039; &quot; captura o último
      <code class="literal">dayname</code> do mês corrente. (Exemplo: &quot;last
      wed of july 2008&quot; referencia &quot;2008-07-30&quot;)
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      &quot;&#039;last&#039; <code class="literal">dayname</code>&quot; captura o último
      <code class="literal">dayname</code> do mês corrente. (Exemplo: &quot;last
      wed july 2008&quot; referencia &quot;2008-06-25&quot;; &quot;july 2008&quot; primeiro definirá a
      data corrente para &quot;2008-07-01&quot; e então &quot;last wed&quot; moverá para a
      última Quarta-feira que será &quot;2008-06-25&quot;).
     </span>
    </li>
   </ol>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    Meses com valores relativos são calculados baseados no tamanho do mês
    passado. Um exemplo seria &quot;+2 month 2011-11-30&quot;,que produziria
    &quot;2012-01-30&quot;. Isso é devido a Novembro tendo 30 dias como tamanho, e
    Dezembro tendo 31, produzindo um total de 61 dias.
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    <code class="literal">number</code> é um número <em>inteiro</em>; se um
    número decimal é informado, o ponto (ou vírgula) provavelmente será interpretado como delimitador.
    Por exemplo, <code class="literal">&#039;+1.5 hours&#039;</code> é analisado como
    <code class="literal">&#039;+1 5 hours&#039;</code>, não como <code class="literal">&#039;+1 hour +30 minutes&#039;</code>.
   </p>
  </p></blockquote>

  <div class="sect2">
   <h3 class="title">Registro de Alterações</h3>
   <p class="para">
    <table class="doctable informaltable">
     
      <thead>
       <tr>
        <th>Versão</th>
        <th>Descrição</th>
       </tr>

      </thead>

      <tbody class="tbody">
       <tr>
        <td>8.4.0</td>
        <td>
         <code class="literal">number</code> agora aceita novamente um sinal positivo seguido por um
         sinal negativo, por exemplo, <code class="literal">+-2</code> e outras combinações de
         múltiplos sinais.
        </td>
       </tr>

       <tr>
        <td>8.2.0</td>
        <td>
         <code class="literal">number</code> não aceita mais um sinal positivo seguido por um
         sinal negativo, por exemplo, <code class="literal">+-2</code>.
        </td>
       </tr>

       <tr>
        <td>7.0.8</td>
        <td>
         Semanas sempre começam na segunda-feira. Antes, considerava-se que o domingo também poderia
         começar uma semana.
        </td>
       </tr>

      </tbody>
     
    </table>

   </p>
  </div>
 </div>
 

</div>
<?php manual_footer($setup); ?>