JavaScript
 Computer >> コンピューター >  >> プログラミング >> JavaScript

JavaScriptのDate.getSeconds()関数とは？使い方をサンプルコード付きで解説

Dateオブジェクトとは

Dateオブジェクトは、JavaScriptに組み込まれているデータ型のひとつです。次のように new Date() を使って作成します。

var dateObj = new Date();

Dateオブジェクトを生成すると、多数のメソッドを使ってさまざまな操作が行えます。ほとんどのメソッドは、ローカル時間またはUTC（協定世界時／GMT）のいずれかを基準として、オブジェクトが持つ年・月・日・時・分・秒・ミリ秒の各フィールドを取得・設定できます。

DateオブジェクトのgetSeconds()関数は、その日付オブジェクトが持つ「秒」の値を0〜59の整数で返します。

構文

getSeconds()の構文は以下のとおりです。引数は不要で、Dateオブジェクトのメソッドとして呼び出します。

dateObj.getSeconds();

サンプル1：基本的な使い方

日付文字列に時刻を指定してDateオブジェクトを作成し、秒を取得する基本的な例です。

<html>
<head>
   <title>JavaScript Example</title>
</head>
<body>
   <script type="text/javascript">
      var dateObj = new Date('september 26, 89 12:4:25:96');
      document.write("Seconds: "+dateObj.getSeconds());
   </script>
</body>
</html>

実行結果

Seconds: 25

時刻「12:4:25:96」の秒の部分である「25」が正しく取得できています。

サンプル2：秒を指定しなかった場合

Dateオブジェクトの作成時に秒の値を指定しなかった場合、getSeconds()は0を返します。

<html>
<head>
   <title>JavaScript Example</title>
</head>
<body>
   <script type="text/javascript">
      var dateObj = new Date('september 26, 89 12:4');
      document.write("Seconds: "+dateObj.getSeconds());
   </script>
</body>
</html>

実行結果

Seconds: 0

サンプル3：引数を指定しなかった場合

new Date()に何も引数を渡さずにDateオブジェクトを作成した場合は、現在の日時が自動的に設定されるため、getSeconds()は実行時点の「現在の秒」を返します。

<html>
<head>
   <title>JavaScript Example</title>
</head>
<body>
   <script type="text/javascript">
      var dateObj = new Date();
      document.write("Seconds: "+dateObj.getSeconds());
   </script>
</body>
</html>

実行結果

Seconds: 40

※実行したタイミングによって表示される値は変わります。

サンプル4：範囲外の秒を指定した場合

JavaScriptにおける秒の有効な範囲は0〜59です。この範囲外の値を指定した場合、getSeconds()は0を返します。

<html>
<head>
   <title>JavaScript Example</title>
</head>
<body>
   <script type="text/javascript">
      var dateObj = new Date('september 26, 89 04:50:100');
      document.write("Seconds: "+dateObj.getSeconds());
   </script>
</body>
</html>

実行結果

Seconds: 0

なお、最新のJavaScript環境では、範囲外の値は自動的に繰り上がって処理される（例：100秒は「1分40秒」として解釈される）ため、実行環境によって挙動が異なる場合があります。意図しない結果を避けるためにも、0〜59の範囲内で値を指定するようにしましょう。

まとめ

getSeconds()は、Dateオブジェクトから秒（0〜59）を取得するためのシンプルな基本メソッドです。秒が指定されていない場合は0を返し、引数なしでDateオブジェクトを生成した場合は現在時刻の秒を返します。日時を扱う処理では頻繁に登場するメソッドなので、この挙動をしっかり押さえておきましょう。

  1. JavaScriptのDate.toDateString()メソッドの使い方を徹底解説

    Dateオブジェクトは、JavaScript言語に標準で組み込まれているデータ型です。Dateオブジェクトは、以下のようにnew Date()を使って生成します。一度Dateオブジェクトを作成すると、さまざまなメソッドを使ってそのオブジェクトを操作できます。ほとんどのメソッドは、ローカル時間またはUTC（協定世界時・グリニッジ標準時）のいずれかを基準として、オブジェクトが持つ年、月、日、時、分、秒、ミリ秒の各フィールドを取得・設定するためのものです。その中でもtoDateString()メソッドは、時刻情報を除いた「日付部分のみ」を文字列として返すメソッドです。構文toDateString()

  2. JavaScriptのDate.@@toPrimitive()関数とは？日付オブジェクトをプリミティブ値に変換する方法

    JavaScriptのDate.@@toPrimitive()関数は、Dateオブジェクトをプリミティブ値に変換するために使用されます。このメソッドはSymbol.toPrimitiveプロパティを通じて呼び出され、引数に指定したヒント（hint）に応じて、文字列や数値など適切なプリミティブ値を返します。 ヒントの種類と戻り値 「default」：日付を表す文字列が返されます。 「number」：1970年1月1日00:00:00 UTCからの経過ミリ秒数（タイムスタンプ）が数値で返されます。 「string」：「default」と同様に、日付を表す文字列が返されます。 サンプルコード 以