From 7a92febb81e5d025d27859a427f72be5ab0f14c4 Mon Sep 17 00:00:00 2001 From: azu Date: Sat, 5 Nov 2022 10:17:47 +0900 Subject: [PATCH 1/3] =?UTF-8?q?new=20Date=E3=81=AE=E5=BC=95=E6=95=B0?= =?UTF-8?q?=E8=A7=A3=E8=AA=AC=E3=81=AE=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/basic/date/README.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/source/basic/date/README.md b/source/basic/date/README.md index 582325f9e9..e120e0fda8 100644 --- a/source/basic/date/README.md +++ b/source/basic/date/README.md @@ -28,7 +28,7 @@ description: "日付や時刻を扱うビルトインオブジェクトのDate `Date`オブジェクトのインスタンスではなく現在の時刻の時刻値だけが欲しい場合には、`Date.now`メソッドの返り値を使います。 作成したインスタンスが持つ時刻値は、`getTime`メソッドで取得できます。 また、`toISOString`メソッドを使うと、その時刻をUTCにおける[ISO 8601][]形式の文字列に変換できます。 -ISO 8601とは国際規格となっている文字列の形式で、`2006-01-02T15:04:05.999+09:00`のように時刻を表現します。 +ISO 8601とは国際規格となっている文字列の形式で、`2006-01-02T15:04:05.999+09:00`のように時刻とタイムゾーン情報を表現します。 人間が見てもわかりやすい文字列であるため、広く利用されています。 {{book.console}} @@ -56,8 +56,8 @@ console.log(now.toISOString()); 1つめは、コンストラクタ関数にミリ秒を表す数値型の引数を渡したときに適用されます。 渡した数値をUTCの1970年1月1日0時0分0秒を基準とした時刻値として扱います。 -この方法は実行環境による挙動の違いが起きないので安全です。 -また、時刻値を直接指定するので、他の2つの方法と違ってタイムゾーンを考慮する必要がありません。 +この方法は基準となる時刻とタイムゾーンが固定されているため、実行環境のタイムゾーンによる違いが起きないので安全です。 +そのため、他の2つの方法と違ってタイムゾーンを考慮する必要がありません。 {{book.console}} ```js @@ -68,7 +68,7 @@ const date = new Date(1136214245999); console.log(date.toISOString()); // => "2006-01-02T15:04:05.999Z" ``` -2つめは文字列型の引数を渡したときに適用されます。 +2つめは、文字列型の引数を渡したときに適用されます。 [RFC2822][]や[ISO 8601][]の形式に従った文字列を渡すと、 その文字列をパースして得られる時刻値を使って、`Date`のインスタンスを作成します。 @@ -96,15 +96,18 @@ console.log(inLocal.toISOString()); // "2006-01-02T06:04:05.999Z" (Asia/Tokyoの new Date(year, month, day, hour, minutes, seconds, milliseconds); ``` -コンストラクタ関数に2つ以上の引数を渡すと、このオーバーロードが適用されます。 -日を表す第三引数から後ろの引数は省略可能ですが、日付だけはデフォルトで1が設定され、そのほかには0が設定されます。 -また、月を表す第二引数は0から11までの数値で指定することにも注意しましょう。 +コンストラクタ関数に2つ以上の引数を渡すと、この方法で`Date`インスタンスが作成されます。 +月内の日を表す第三引数（`day`）から後ろの引数は省略可能です。 +省略した場合のそれぞれの引数の初期値は`0`ですが、日（`day`）を表す第三引数だけは`1`がデフォルト値となります。 +また、月（`month`）を表す第二引数は`0`が1月に対応し、`0`から`11`までの数値で月を指定することにも注意しましょう。 先述した2つの方法と違い、この方法はタイムゾーンを指定できません。 渡した数値は常にローカルのタイムゾーンにおける時刻とみなされます。 + 結果が実行環境に依存してしまうため、基本的にこの方法は使うべきではありません。 + 時刻を部分ごとに指定したい場合は、[Date.UTC][]メソッドを使うとよいでしょう。 渡す引数の形式は同じですが、`Date.UTC`メソッドは渡された数値をUTCにおける時刻として扱い、その時刻値を返します。 From 9d9b4dc5b40d9b411a1ca2a348c7b69b7609d93c Mon Sep 17 00:00:00 2001 From: azu Date: Sat, 5 Nov 2022 10:23:29 +0900 Subject: [PATCH 2/3] =?UTF-8?q?=E5=88=A4=E5=AE=9A=E6=96=B9=E6=B3=95?= =?UTF-8?q?=E3=82=92=E3=81=A4=E3=81=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/basic/date/README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/basic/date/README.md b/source/basic/date/README.md index e120e0fda8..d0817f0ac5 100644 --- a/source/basic/date/README.md +++ b/source/basic/date/README.md @@ -134,6 +134,8 @@ console.log(date2.toISOString()); // => "2006-01-02T15:04:05.999Z" const invalid = new Date(""); console.log(invalid.getTime()); // => NaN console.log(invalid.toString()); // => "Invalid Date" +// 不正なDateインスタンスかを判定 +console.log(Number.isNaN(invalid.getTime())); // => true ``` ### Dateのインスタンスメソッド {#instance-method} @@ -141,7 +143,7 @@ console.log(invalid.toString()); // => "Invalid Date" `Date`オブジェクトのインスタンスは多くのメソッドを持っていますが、 ほとんどは`getHours`と`setHours`のような、時刻の各部分を取得・更新するためのメソッドです。 -次の例は、日付を決まった形式の文字列に変換しています。 +次のコードは、日付を決まった形式の文字列に変換しています。 `getMonth`メソッドや`setMonth`メソッドのように月を数値で扱うメソッドは、0から11の数値で指定することに注意しましょう。ある`Date`のインスタンスの時刻が何月かを表示するには、`getMonth`メソッドの返り値に1を足す必要があります。 {{book.console}} From effd95c580be330473128ecd3e55eb13bc6f35ca Mon Sep 17 00:00:00 2001 From: azu Date: Sat, 5 Nov 2022 10:33:35 +0900 Subject: [PATCH 3/3] =?UTF-8?q?moment.js=E3=82=92=E8=90=BD=E3=81=A8?= =?UTF-8?q?=E3=81=97=E3=80=81Day.js=E3=82=92=E4=BD=BF=E3=81=86=E3=82=88?= =?UTF-8?q?=E3=81=86=E3=81=AB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/basic/date/README.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/source/basic/date/README.md b/source/basic/date/README.md index d0817f0ac5..9b208c4e60 100644 --- a/source/basic/date/README.md +++ b/source/basic/date/README.md @@ -184,22 +184,24 @@ console.log(`Hours in UTC: ${now.getHours() + timezoneOffsetInHours}`); - 任意の書式の文字列から時刻に変換するメソッドがない - 「時刻を1時間進める」のように時刻を前後にずらす操作を提供するメソッドがない - 任意のタイムゾーンにおける時刻を計算するメソッドがない -- `YYYY/MM/DD`のようなフォーマットに基づいた文字列への変換を提供するメソッドがない +- `YYYY/MM/DD HH:mm`のようなフォーマットに基づいた文字列への変換を提供するメソッドがない そのため、JavaScriptにおける日付・時刻の処理は、標準のDateではなくライブラリを使うことが一般的になっています。 -代表的なライブラリとしては、[moment.js][]や[js-joda][]、[date-fns][]などがあります。 +代表的なライブラリとしては、[Day.js][]、[date-fns][]、[js-joda][]、[moment.js][]の後継である[Luxon][]などがあります。 - + ```js -// moment.jsで現在時刻のmomentオブジェクトを作る -const now = moment(); +// Day.jsで現在時刻のDay.jsオブジェクトを作る +const now = dayjs(); // addメソッドで10分進める -const future = now.add(10, "minutes"); +const future = now.add(10, "minute"); // formatメソッドで任意の書式の文字列に変換する -console.log(future.format("YYYY/MM/DD")); +console.log(future.format("YYYY/MM/DD HH:mm")); ``` + + ## まとめ {#conclusion} この章では、Dateオブジェクトについて学びました。 @@ -217,5 +219,8 @@ console.log(future.format("YYYY/MM/DD")); [RFC2822]: https://www.rfc-editor.org/rfc/rfc2822#section-3.3 [ISO 8601]: https://ja.wikipedia.org/wiki/ISO_8601 [moment.js]: https://momentjs.com/ +[Luxon]: https://github.com/moment/luxon/ [js-joda]: https://github.com/js-joda/js-joda +[Day.js]: https://day.js.org/ [date-fns]: https://date-fns.org/ +[ECMA-402]: https://www.ecma-international.org/publications-and-standards/standards/ecma-402/ \ No newline at end of file