Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】Temporal::Temporal.Now.plainDateTimeISO静的メソッドの使い方

Temporal.Now.plainDateTimeISO()静的メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Temporal.Now.plainDateTimeISO()メソッドは、現在の日付と時刻を、特定の形式で取得するために使用されるメソッドです。このメソッドは、実行された時点でのシステムローカルの日付と時刻を、タイムゾーン情報を含まずに取得します。具体的には、年、月、日、時、分、秒、ミリ秒などの要素を持つTemporal.PlainDateTimeオブジェクトを返します。

「ISO」という名称は、国際標準化機構が定めたISO 8601形式に基づいて日付と時刻の要素が表現されることを意味し、多くのシステムで互換性のある標準的な形式です。一方、「plainDateTime」は、タイムゾーンや夏時間(DST)の複雑さを考慮せず、カレンダー上の特定の日時を明確に扱うための概念です。これにより、世界中のどの場所でも同じ日時として扱いたい場合に適しています。

このメソッドは、例えばアプリケーション内でユーザーのローカルなカレンダー日付や時刻を表示したい場合、またはタイムゾーンの影響を受けずに、イベントの開始時刻やログの記録時刻といった単純な日時を記録・比較したい場合に特に役立ちます。Temporal APIは、JavaScriptにおける日付と時刻の操作をより堅牢かつ直感的に行うための新しい標準APIの一部であり、このメソッドはその中で現在のローカル日時を簡単に取得する手段を提供します。これにより、開発者はタイムゾーンに依存しない現時点の日時情報を正確に扱うことができます。

公式リファレンス: Temporal.Now.plainDateTimeISO()

構文(syntax)

1Temporal.Now.plainDateTimeISO();

引数(parameters)

options = {}

  • options: PlainDateTimeOptions オブジェクト。オプションで、時差やカレンダーなどの表示形式を指定できます。省略可能で、デフォルトは空オブジェクト {} です。

戻り値(return)

Temporal.PlainDateTime

現在のシステム時刻を、ISO 8601形式の年、月、日、時、分、秒、ナノ秒で表した Temporal.PlainDateTime オブジェクトとして返します。

関連コンテンツ

関連プログラミング言語