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

JavaScriptのDate.getTime()メソッドとは？使い方とコード例を解説

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

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

JavaScriptのgetTime()メソッドは、指定された日時に対応する数値を、協定世界時（UTC）に基づいて返します。戻り値は「1970年1月1日00:00:00（UTC）」から対象の日時までの経過時間をミリ秒単位で表したものです。

構文

getTime()メソッドの構文は以下のとおりです。

dateObj.getTime();

使用例

次の例では、特定の日時を指定してDateオブジェクトを生成し、getTime()メソッドでそのタイムスタンプ（ミリ秒）を取得しています。

<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("Time value: "+dateObj.getTime());
  </script>
</body>
</html>

実行結果

Time value: 622794865096

引数を指定しない場合の使用例

同様に、Dateオブジェクトの生成時に引数を何も渡さなかった場合は、現在の日時をもとにオブジェクトが作成されるため、このメソッドは現在の時刻に対応するタイムスタンプを返します。

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

実行結果

Time value: 1539764866888

まとめ

getTime()メソッドは、日時を「1970年1月1日からの経過ミリ秒」という数値として扱えるため、日付同士の比較や経過時間の計算などに非常に便利です。JavaScriptで日付処理を行う際には、ぜひ活用してみてください。

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

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

  2. JavaScriptでDateオブジェクト（文字列データ）に時間を追加する方法

    JavaScriptで日付・時刻のデータを扱う際、「現在の時刻から2時間後」のように指定した時間を加算したいケースはよくあります。本記事では、文字列から作成したDateオブジェクトに対して、setHours()とgetHours()を組み合わせて時間を追加する方法を解説します。 1. 新しいDateオブジェクトを作成する まずは、日時を表す文字列をもとに、新しいDateオブジェクトを作成しましょう。 var dateValue = new Date(2021-01-12 10:10:20); 2. setHours()とgetHours()で時間を追加する getHours()メソッドで現在の