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

JavaScriptのDate.toLocaleDateString()メソッドとは?構文と使い方を解説

Dateオブジェクトとは

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

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

Dateオブジェクトの toLocaleDateString() メソッドは、現在の日付のうち「日付部分(年月日)」を、実行環境のロケール(地域設定)に合わせた文字列として返します。

構文

toLocaleDateString()の構文は以下のとおりです。

dateObj.toLocaleDateString()

引数を省略した場合は、システムのロケールに従った形式で日付文字列が返されます。また、第1引数にロケール文字列(例:「ja-JP」)、第2引数に表示オプションを渡すことで、出力形式を細かく制御することも可能です(後述の補足を参照)。

サンプルコード1:特定の日付を指定する場合

<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.toLocaleDateString());
   </script>
</body>
</html>

出力結果

Current Date: 9/26/1989

この例では、1989年9月26日を表すDateオブジェクトを作成し、toLocaleDateString()によって「9/26/1989」という形式の日付文字列を取得しています。時刻部分は含まれず、日付のみが出力される点に注目してください。

サンプルコード2:引数なしで現在日付を取得する場合

Dateコンストラクタに引数を渡さずに呼び出した場合、toLocaleDateString()は現在のシステムのローカル時刻に基づく日付文字列を返します。

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

出力結果

Current Date: 18/10/2018

このように、引数を指定しなければ実行時点の日付が、実行環境の地域設定に応じた形式で表示されます。

補足:ロケールとオプションによる表示形式の制御

モダンなブラウザでは、toLocaleDateString()に引数を渡すことで、日付の表示形式を自由にカスタマイズできます。

const dateObj = new Date();

// ロケールを指定(日本語形式)
console.log(dateObj.toLocaleDateString('ja-JP'));
// 出力例: 2018/10/18

// オプションで詳細な形式を指定
console.log(dateObj.toLocaleDateString('ja-JP', {
   year: 'numeric',
   month: 'long',
   day: 'numeric'
}));
// 出力例: 2018年10月18日

この機能を活用すれば、ユーザーの地域や言語設定に合わせた柔軟な日付表示が実現でき、国際化対応のWebアプリケーション開発で特に役立ちます。


  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」と同様に、日付を表す文字列が返されます。 サンプルコード 以