Date.prototype.setUTCFullYear() - UTCで年をセットする
Date.prototype.setUTCFullYear()は、インスタンスに、UTCで「年」をセットするメソッドです。任意で「月」「日」もまとめて設定できます。
概要
- 名前
- setUTCFullYear
- 所属
- Date.prototype
- 仕様書
- https://tc39.github.io/ecma262/#sec-date.prototype.setutcfullyear
説明
Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
引数は、UTCで解釈される。
第1引数(year)には年数を指定する。
第2引数(month)には月を指定する。月は0から数える。省略した場合はgetMonth()と同じ値がセットされる。
第3引数(date)には日を指定する。省略した場合はgetDate()と同じ値がセットされる。
デモ
Date.prototype.setUTCFullYear()のデモです。1月1日8時のインスタンスに年をセットします。日本のLocal timeの1日をセットした時と、UTCの1日をセットした時では9時間の時差があるため結果が変わります。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<html>
<head>
<style>
body {
white-space: pre-wrap ;
}
</style>
</head>
<body>
<script>
/** try it! **/
var date = new Date( 2017, 0, 1, 8 ) ;
date.setUTCFullYear( 2000 ) ;
var a = date.toString() ;
date.setFullYear( 2000 ) ;
var b = date.toString() ;
/** try it! **/
var results = { a:a, b:b, } ;
for( var name in results ) {
console.log( name, results[name] ) ;
document.body.appendChild( new Text( name + " = " + JSON.stringify( results[name] ) + "\n" ) ) ;
}
</script>
</body>
</html>
サポート状況
Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|
● | ● | ● | ● | ● | ● | ● | ● |
関連記事
- Date.prototype.setUTCHours()
- Date.prototype.setUTCHours()は、インスタンスに、UTCで「時」をセットするメソッドです。任意で「分」「秒」「ミリ秒」もまとめて設定できます。
- Date.prototype.setUTCMonth()
- Date.prototype.setUTCMonth()は、インスタンスに、UTCで「月」をセットするメソッドです。任意で「日」もまとめて設定できます。
- Date.prototype.setFullYear()
- Date.prototype.setFullYear()は、インスタンスに、Local time(端末の時間設定)で「年」をセットするメソッドです。任意で「月」「日」もまとめて設定できます。
- Date.prototype.setUTCMinutes()
- Date.prototype.setUTCMinutes()は、インスタンスに、UTCで「分」をセットするメソッドです。任意で「秒」「ミリ秒」もまとめて設定できます。