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

JavaScriptのDate.getUTCMilliseconds()関数とは？構文と実行例をわかりやすく解説

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

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

getUTCMilliseconds()メソッドは、対象となる日付の「ミリ秒」の値を、協定世界時（UTC）に基づいて返します。

構文

getUTCMilliseconds()の構文は次のとおりです。

dateObj.getUTCMilliseconds();

引数は不要で、呼び出し元のDateオブジェクトが保持している日付情報をもとに計算されます。

基本的な使い方

次の例では、日付文字列にミリ秒まで含めてDateオブジェクトを生成し、そのミリ秒の値を取得しています。

<html>
<head>
    <title>JavaScript サンプル</title>
</head>
<body>
    <script>
        var dateObj = new Date('September 26, 89 12:4:25:96');
        document.write(dateObj.getUTCMilliseconds());
    </script>
</body>
</html>

実行結果：

96

ミリ秒を指定しなかった場合

Dateオブジェクトの生成時にミリ秒を指定しなかった場合、この関数は協定世界時に基づいて0を返します。

<html>
<head>
    <title>JavaScript サンプル</title>
</head>
<body>
    <script>
        var dateObj = new Date('September 26, 89 04:50:12');
        document.write(dateObj.getUTCMilliseconds());
    </script>
</body>
</html>

実行結果：

0

引数を何も渡さなかった場合

同様に、コンストラクタに何も渡さずにDateオブジェクトを生成した場合には、現在時刻のミリ秒が協定世界時ベースで返されます。

<html>
<head>
    <title>JavaScript サンプル</title>
</head>
<body>
    <script>
        var dateObj = new Date();
        document.write('現在のミリ秒: ' + dateObj.getUTCMilliseconds());
    </script>
</body>
</html>

実行結果：

現在のミリ秒: 226

範囲外の値を指定した場合

JavaScriptで扱えるミリ秒の有効範囲は0〜999です。この範囲外の値を指定した場合、この関数は0を返します。

<html>
<head>
    <title>JavaScript サンプル</title>
</head>
<body>
    <script>
        var dateObj = new Date('September 26, 89 04:50:12:1035');
        document.write('現在のミリ秒: ' + dateObj.getUTCMilliseconds());
    </script>
</body>
</html>

実行結果：

現在のミリ秒: 0

まとめ

  • getUTCMilliseconds()は、UTC（協定世界時）に基づいたミリ秒（0〜999）を数値として返す
  • 日付文字列にミリ秒を指定しなければ「0」が返る
  • コンストラクタに引数を渡さなければ、現在時刻のミリ秒が返る
  • 有効範囲（0〜999）外の値を指定すると「0」が返る
  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」と同様に、日付を表す文字列が返されます。 サンプルコード 以