JavaScriptのDate.setHours()関数とは?使い方と実例をわかりやすく解説
Dateオブジェクトは、JavaScript言語に組み込まれているデータ型の一つです。Dateオブジェクトは以下のようにnew Date()を使って生成します。
Dateオブジェクトを一度作成すると、さまざまなメソッドを使って操作できるようになります。ほとんどのメソッドは、オブジェクトが持つ年・月・日・時・分・秒・ミリ秒の各フィールドに対して、ローカル時間またはUTC(協定世界時/GMT)のいずれかで値の取得や設定を行うものです。
DateオブジェクトのsetHours()関数は、時間を表す整数を引数として受け取り、現在の日付の時刻(「時」の部分)をその値で置き換えます。
構文
setHours()メソッドの構文は次のとおりです。
dateObj.setHours();
使用例
以下の例では、既存のDateオブジェクトに対してsetHours()を使って時刻を変更しています。
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('september 26, 89 5:4:25:96');
document.write("Current date: "+dateObj.toUTCString());
document.write("<br>");
dateObj.setHours(12);
document.write("Date after setting the hours: "+dateObj.toUTCString());
</script>
</body>
</html>実行結果
Current date: Mon, 25 Sep 1989 23:34:25 GMT Date after setting the hours: Tue, 26 Sep 1989 06:34:25 GMT
日時を指定せずに時刻だけを設定する例
Dateオブジェクトの作成時に時刻を指定していなくても、後からsetHours()関数を使えば時刻を設定できます。
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date('26, September, 1989 4:25:96');
dateObj.setHours(5);
document.write(dateObj.toString());
</script>
</body>
</html>実行結果
Tue Sep 26 1989 05:25:00 GMT+0530 (India Standard Time)
コンストラクタに値を渡さない場合の例
同様に、Dateオブジェクトを作成する際にコンストラクタへ何も値を渡さなかった場合でも、この関数を使って時刻を設定できます。その際、月・日・年などの他の値は現在の日付(および時刻)のまま維持されます。
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date();
dateObj.setHours(5);
document.write(dateObj.toString());
</script>
</body>
</html>実行結果
Thu Oct 18 2018
まとめ
setHours()は、Dateオブジェクトの「時」の値を簡単に変更できる便利なメソッドです。日時を指定してオブジェクトを作成した場合でも、空の状態で作成した場合でも柔軟に対応でき、時刻操作を伴うWebアプリケーション開発で幅広く活用できます。
-
JavaScriptのDate.setUTCMonth()メソッドとは?構文と使い方を実例付きで解説
Dateオブジェクトは、JavaScriptに組み込まれているデータ型の一つです。Dateオブジェクトは、次のように new Date() を使って生成します。 Dateオブジェクトを生成すると、多数のメソッドを使ってそのオブジェクトを操作できます。ほとんどのメソッドは、ローカル時間またはUTC(協定世界時/GMT)のいずれかの時刻基準で、年・月・日・時・分・秒・ミリ秒の各フィールドを取得・設定するためのものです。 setUTCMonth()メソッドは、年の月を表す整数を受け取り、UTC(協定世界時)に基づいて現在の日付の「月」の値を置き換えます。月の値は0が1月を表し、以降は11が12月に
-
JavaScriptのDate.@@toPrimitive()関数とは?日付オブジェクトをプリミティブ値に変換する方法
JavaScriptのDate.@@toPrimitive()関数は、Dateオブジェクトをプリミティブ値に変換するために使用されます。このメソッドはSymbol.toPrimitiveプロパティを通じて呼び出され、引数に指定したヒント(hint)に応じて、文字列や数値など適切なプリミティブ値を返します。 ヒントの種類と戻り値 「default」:日付を表す文字列が返されます。 「number」:1970年1月1日00:00:00 UTCからの経過ミリ秒数(タイムスタンプ)が数値で返されます。 「string」:「default」と同様に、日付を表す文字列が返されます。 サンプルコード 以