【JavaScript ECMAScript】Temporal::Temporal.PlainMonthDayコンストラクタの使い方
Temporal.PlainMonthDay()コンストラクタの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainMonthDay()クラスは、年情報を持たない月と日を表すTemporal.PlainMonthDayオブジェクトを生成するためのクラスです。このクラスは、特定の年やタイムゾーン、カレンダーシステムに依存せず、純粋に月と日だけを表現したい場合に利用されます。例えば、誕生日や記念日など、毎年同じ月日に発生するイベントの管理に適しています。
このクラスのコンストラクタを呼び出す際は、引数として月の数値と日の数値を指定します。オプションで、使用するカレンダーシステムを指定することも可能です。これにより、例えば「3月15日」といった情報を、どの年も関係なく独立して扱うことができます。生成されたPlainMonthDayオブジェクトは、日付の年やタイムゾーンに関する情報を一切含まないため、時間の計算においてこれらの要素が不要な場面で非常に役立ちます。
Temporal APIは、JavaScriptにおける日付と時刻の操作をより堅牢かつ柔軟に行うための新しいAPIであり、その一部であるTemporal.PlainMonthDayクラスは、特定のユースケースにおける日付表現の課題を解決します。システム開発において、年を含まない固定の日付を扱う必要がある場合に、正確で一貫性のある方法を提供します。
公式リファレンス: Temporal.PlainMonthDay()
構文(syntax)
1new Temporal.PlainMonthDay(month, day, calendar, referenceISODay);
引数(parameters)
month, day, options
- month: number: 月を表す数値 (1 から 12 までの整数)
- day: number: 日を表す数値 (1 から 31 までの整数)
- options: object: オプションを指定するオブジェクト (省略可能)
戻り値(return)
戻り値なし
戻り値はありません