JavaScriptのDate.toDateString()メソッドの使い方を徹底解説
Dateオブジェクトは、JavaScript言語に標準で組み込まれているデータ型です。Dateオブジェクトは、以下のようにnew Date()を使って生成します。
一度Dateオブジェクトを作成すると、さまざまなメソッドを使ってそのオブジェクトを操作できます。ほとんどのメソッドは、ローカル時間またはUTC(協定世界時・グリニッジ標準時)のいずれかを基準として、オブジェクトが持つ年、月、日、時、分、秒、ミリ秒の各フィールドを取得・設定するためのものです。
その中でもtoDateString()メソッドは、時刻情報を除いた「日付部分のみ」を文字列として返すメソッドです。
構文
toDateString()メソッドの構文は以下のとおりです。
dateObj.toDateString();
使用例①:特定の日付を指定する場合
次の例では、Dateコンストラクタに具体的な日付を渡してオブジェクトを作成し、toDateString()メソッドで日付部分を出力しています。
<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("Current Date: " + dateObj.toDateString());
</script>
</body>
</html>出力結果
Current Date: Tue Sep 26 1989
このように、時刻(12:4:25:96)は省略され、「Tue Sep 26 1989」という日付部分だけが返されていることがわかります。
使用例②:パラメータを指定しない場合
Dateコンストラクタに何も引数を渡さなかった場合、現在の時刻をもとにDateオブジェクトが作成されます。そのため、toDateString()メソッドは現在の日付の文字列を返します。
<html>
<head>
<title>JavaScript Example</title>
</head>
<body>
<script type="text/javascript">
var dateObj = new Date();
document.write("Current Date: " + dateObj.toDateString());
</script>
</body>
</html>出力結果
Current Date: 18/10/2018
まとめ
toDateString()メソッドは、Dateオブジェクトから時刻を除いた日付部分だけを簡単に取り出したいときに便利です。引数の有無によって「指定した日付」または「現在の日付」を取得できるので、用途に応じて使い分けましょう。
-
JavaScriptのDate.getUTCDay()関数の使い方をわかりやすく解説
JavaScriptのDateオブジェクトは、言語に組み込まれているデータ型です。Dateオブジェクトは、次のようにnew Date()を使って生成します。 Dateオブジェクトを作成すると、さまざまなメソッドを使って操作できます。多くのメソッドは、ローカル時間またはUTC(協定世界時=GMT)のいずれかを基準として、年・月・日・時・分・秒・ミリ秒の各フィールドを取得・設定するためのものです。 getUTCDay()は、Dateオブジェクトが保持する日付の「曜日」を協定世界時(UTC)に基づいて返すメソッドです。戻り値は0〜6の整数で、0が日曜日を表し、月曜日は1、火曜日は2、というように土
-
JavaScriptのDate.@@toPrimitive()関数とは?日付オブジェクトをプリミティブ値に変換する方法
JavaScriptのDate.@@toPrimitive()関数は、Dateオブジェクトをプリミティブ値に変換するために使用されます。このメソッドはSymbol.toPrimitiveプロパティを通じて呼び出され、引数に指定したヒント(hint)に応じて、文字列や数値など適切なプリミティブ値を返します。 ヒントの種類と戻り値 「default」:日付を表す文字列が返されます。 「number」:1970年1月1日00:00:00 UTCからの経過ミリ秒数(タイムスタンプ)が数値で返されます。 「string」:「default」と同様に、日付を表す文字列が返されます。 サンプルコード 以