JavaScript - Método setUTCFullYear () de data

Descrição

Data Javascript setUTCFullYear() método define o ano inteiro para uma data especificada de acordo com a hora universal.

Sintaxe

Sua sintaxe é a seguinte -

Date.setUTCFullYear(yearValue[, monthValue[, dayValue]])

Note - Os parâmetros entre colchetes são sempre opcionais.

Detalhe de Parâmetro

  • yearValue - Um número inteiro que especifica o valor numérico do ano, por exemplo, 2008.

  • monthValue - Um número inteiro entre 0 e 11 representando os meses de janeiro a dezembro.

  • dayValue- Um número inteiro entre 1 e 31 representando o dia do mês. Se você especificar o parâmetro dayValue, também deverá especificar o monthValue.

Se você não especificar os parâmetros monthValue e dayValue, os valores retornados dos métodos getMonth e getDate serão usados. Se um parâmetro especificado estiver fora do intervalo esperado, setUTCFullYear tentará atualizar os outros parâmetros e as informações de data no objeto Date de acordo. Por exemplo, se você especificar 15 para monthValue, o ano será incrementado em 1 (ano + 1) e 3 será usado para o mês.

Exemplo

Experimente o seguinte exemplo.

<html>   
   <head>
      <title>JavaScript setUTCFullYear Method</title>
   </head>
   
   <body>      
      <script type = "text/javascript">
         var dt = new Date( "Aug 28, 2008 23:30:00" );
         dt.setUTCFullYear( 2006 );
         document.write( dt );
      </script>      
   </body>
</html>

Resultado

Mon Aug 28 2006 23:30:00 GMT+0530 (India Standard Time)