【JavaScript ECMAScript】Date::Date.prototype.toDateStringインスタンスメソッドの使い方
Date.prototype.toDateString()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Date.prototype.toDateString()メソッドは、指定されたDateオブジェクトが保持する日付情報のうち、日付部分のみを抽出して人間が読みやすい形式の文字列として返却するメソッドです。このメソッドは、年、月、日、および曜日といった日付要素を、JavaScript実行環境のローカルタイムゾーンに基づいてフォーマットします。具体的には、「曜日 月 日 年」という形式の文字列を生成します。
このメソッドは引数を受け付けず、Dateオブジェクトのインスタンスに対して呼び出されると、そのオブジェクトが表す日付の情報を基に処理を行います。ウェブアプリケーションのユーザーインターフェースに日付を表示する際や、ログ記録において時刻情報が不要な場合に特に役立ちます。戻り値は常に文字列型であり、ローカルタイムゾーンにおける日付の視覚的な表現を提供します。
日付だけでなく時刻情報も含む完全な日付と時刻の文字列が必要な場合は、Date.prototype.toString()やDate.prototype.toLocaleString()といった他のメソッドを利用することを検討してください。toDateString()は、日付の表示を一貫させ、時刻やタイムゾーンの複雑さを意識せずにシンプルに日付部分を取り扱いたい場合に適しています。これは、Dateオブジェクトのプロトタイプに定義されているため、全てのDateインスタンスから直接利用することが可能です。
構文(syntax)
1const dateInstance = new Date(); 2const dateString = dateInstance.toDateString();
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
toDateString() メソッドは、Dateオブジェクトの年月日部分を、ローカライズされた形式の文字列として返します。