【Node.js24.x】Date::parse()メソッドの使い方
parseメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
parseメソッドは、Dateクラスに属し、日付を表す文字列を解析（パース）し、その文字列が示す日付時刻を、Unixエポック（1970年1月1日 00:00:00 UTC）からの経過時間をミリ秒単位で数値として返すメソッドです。
このメソッドは、引数として与えられた日付文字列を解釈しようと試み、有効な日付として認識できた場合にミリ秒数を返します。例えば、「2023-10-27T10:00:00Z」のようなISO 8601形式や、その他の一般的な日付時刻形式に対応しています。
parseメソッドの主な用途は、ユーザーからの入力や外部システムから得られたテキスト形式の日付情報を、コンピュータ内部で比較や計算がしやすい数値形式に変換することです。もし、引数として渡された文字列が有効な日付として認識できない場合、このメソッドは特別な値であるNaN（Not-a-Number）を返します。これにより、プログラムは日付解析の成功・失敗を判断し、適切なエラー処理を行うことができます。異なる実行環境やNode.jsのバージョン間で予測可能な結果を得るため、日付文字列はISO 8601形式のような国際標準に準拠した形式を使用することが強く推奨されます。
構文(syntax)
Date.parse("2024-07-20T15:30:00Z");
引数(parameters)
dateString
- dateString: string: 解析する日付を表す文字列
戻り値(return)
Number
引数として与えられた日付文字列を解析し、その日付が表現するミリ秒単位の時間を返します。解析できない場合は NaN (Not a Number) を返します。