Momentjs-quick-guide
MomentJS-概要
MomentJSは、JavaScriptで日付/時刻を非常に簡単な方法で解析、検証、操作、表示するのに役立つJavaScriptライブラリです。 この章では、MomentJSの概要を説明し、その機能について詳しく説明します。
Moment JSでは、ローカライズごとに、人間が読める形式で日付を表示できます。 スクリプトメソッドを使用して、ブラウザ内でMomentJSを使用できます。 Node.jsでも利用可能で、npmを使用してインストールできます。
MomentJSでは、日付の追加、減算、検証、最大日付、最小日付の取得など、使いやすいメソッドを多数見つけることができます。 これはオープンソースプロジェクトであり、ライブラリに簡単に貢献し、プラグインの形で機能を追加し、GitHubおよびNode.jsで利用可能にすることができます。
特徴
MomentJSで利用可能なすべての重要な機能を詳細に理解しましょう-
構文解析
解析により、日付を必要な形式で解析できます。 日付の解析は、文字列、オブジェクト、配列で利用できます。 moment.cloneを使用して、瞬間のクローンを作成できます。 UTC形式で日付を出力する方法があります。
日付検証
日付検証は、MomentJSを使用すると非常に簡単です。 メソッド* isValid()*を使用して、日付が有効かどうかを確認できます。 MomentJSは、日付検証の確認に使用できる多くの解析フラグも提供します。
操作
momentオブジェクトの日付と時刻を操作するさまざまなメソッドがあります。 add、subtract、startoftime、endoftime、local、utc、utcoffsetなどは、MomentJSで日付/時刻に必要な詳細を提供する利用可能なメソッドです。
取得/設定
Get/Setを使用すると、日付の単位を読み取って設定できます。 それは、時間、分、秒、ミリ秒、月の日付、曜日、年の日、年の週、月、年、四半期、週の年、年の週、取得/設定、最大値の変更と読み取りを可能にします、最小など Get/Setは、MomentJSで利用できる非常に便利な機能です。
表示
Displayは、さまざまな方法で日付を表示するための形式を提供します。 特定の瞬間からの時間、現在の瞬間からの時間、2つの瞬間の差などを伝える方法があります。 JSON形式、配列、オブジェクト、文字列などで日付を表示できます。
日付クエリ
日付クエリには、日付が入力よりも大きいか小さいか、指定された日付の間、うるう年、瞬間、日付などを示す使いやすいメソッドがあります。 日付の検証に非常に役立ちます。
期間
期間は、MomentJSの重要な機能の1つです。 基本的に、指定されたユニットの時間の長さを処理します。 利用可能な humanize メソッドは、人間が読める形式で日付を表示します。
国際化
国際化は、MomentJSのもう1つの重要な機能です。 ロケールに基づいて日付と時刻を表示できます。 ロケールは、必要に応じて特定の瞬間に適用できます。 すべてのロケールを含むMomentJSホームサイトから縮小ファイルを取得します。 特定のロケールを扱う場合は、そのロケールファイルだけを追加して作業することもできます。 月、週、日の名前は、指定されたロケールで表示されます。
カスタマイズ
MomentJSでは、作成されたロケールをカスタマイズできます。 要件に応じて、定義されたロケールの月名、月の省略形、曜日名、曜日の省略形、長い日付形式、およびカレンダー形式をカスタマイズできます。
公益事業
ユーティリティには、 normalize units および invalid の2つの方法があります。 それらは瞬間的に使用され、必要に応じて出力を変更またはカスタマイズするのに役立ちます。 また、momentオブジェクトに独自のカスタム検証を設定することもできます。
プラグイン
プラグインは、MomentJSの追加機能です。 カレンダー、日付形式、解析、日付範囲、正確な範囲などに追加された多くのプラグインがあります。 独自のプラグインを追加して、Node.jsおよびGitHubで使用可能にすることができます。
MomentJS-環境設定
この章では、ローカルコンピューターでMomentJSの作業環境を設定する方法について詳しく学習します。 MomentJSでの作業を開始する前に、ライブラリにアクセスできる必要があります。 次の方法のいずれかでそのファイルにアクセスできます-
方法1:ブラウザーでMomentJSファイルを使用する
この方法では、公式WebサイトのMomentJSファイルが必要になり、ブラウザーで直接使用します。
ステップ1
最初のステップとして、MomentJSの公式Webサイトhttps://momentjs.com/[https://momentjs.com]にアクセスします。ここに示すようなホームページがあります-
利用可能な最新のMomentJSファイルを提供するダウンロードオプションがあることを確認してください。 ファイルは縮小化の有無にかかわらず使用できることに注意してください。
ステップ2
次に、 script タグ内に moment.js を含めて、MomentJSの操作を開始します。 このためには、以下に示すコードを使用することができます-
ここに与えられているのは、より良い理解のための実際の例とその出力です-
例
出力
上記のスクリーンショットに示すように、異なるロケールで動作する moment-locale ファイルも利用できます。 次に、以下に示すようにスクリプトタグにファイルを追加し、選択したさまざまなロケールで作業します。 このためには、以下に示すコードを使用することができます-
ここで与えられているのは、モーメントロケールの実用例と、より良い理解のための出力です-
出力
方法2:Node.jsを使用する
この方法を選択する場合は、システムに Node.js および npm がインストールされていることを確認してください。 次のコマンドを使用して、MomentJSをインストールできます-
MomentJSが正常にインストールされたら、次の出力を確認できます-
今、MomentJSがNode.jsで正常に動作するかどうかをテストするには、ファイルtest.jsを作成し、次のコードを追加します-
さて、コマンドプロンプトで、以下のスクリーンショットに示すようにコマンドノードtest.jsを実行します-
このコマンドは、* moment()。toString()*の出力を表示することに注意してください。
方法3:Bowerを使用する
Bowerは、MomentJSに必要なファイルを取得するもう1つの方法です。 次のコマンドを使用して、Bowerを使用してMomentJSをインストールできます-
以下のスクリーンショットは、Bowerを使用したMomentJSのインストールを示しています-
これらは、MomentJSがインストールするためにBowerからロードされたファイルです。 インストールされた瞬間とロケールファイルは、以下の画像に示されています-
MomentJS-はじめに
この章では、RequireJS と *MomentJSとTypeScript を使用して* MomentJSを操作する方法について説明します。
MomentJSおよびRequireJS
RequireJSを使用したMomentJSの動作を理解するために、MomentJSとRequireJSを使用した動作例を分析してみましょう。 対応するアプリのフォルダ構造は、次の画像に示されています-
RequireJS公式サイトから取得したrequire.jsファイルを取得できます-https://requirejs.org/docs/downloadl[[[1]]]理解を深めるために次のコードを確認してください-
プロジェクトの例
main.js
以下は、ブラウザで確認できる projectl の出力です-
MomentJSおよびTypeScript
MomentJSとTypescriptプロジェクトの構築に使用されるコードは以下のとおりです-
package.json
main.ts
ファイルをtypescriptからJavaScript、つまり main.ts から main.js にビルドするには、* Gulpを使用する必要があります。 次のコードは、ファイルのビルドに使用される gulpfile .jsを示しています。 ローカルサーバーを開いて出力を表示する gulp-connect パッケージを使用していることに注意してください。
gulpfile.js
これは、上記のコードを実行したときに観察される出力です-
次の形式で示すように、フォルダ構造を見ることができます-
indexlのコードを以下に示します-
さて、 http://localhost:8080/ を開くと、次のように出力が表示されます-
MomentJS-日付と時刻の解析
MomentJSには、日付と時刻の解析に役立つ多くの使いやすいメソッドがあります。 オブジェクト、文字列、配列、JavaScriptネイティブ日付オブジェクトなどの形式で日付を解析できます。 この章では、それらについて詳しく説明します。
解析日
MomentJSは、* moment()*が呼び出されたときに出力としてラッパーオブジェクトを提供します。 ブラウザで出力をコンソールするときに、次のことを確認できます。
MomentJSは、以下にリストするように日付を解析するためのさまざまなメソッドを提供します-
Sr.No. | Method & Syntax |
---|---|
1 |
moment() |
2 |
モーメント(文字列) |
3 |
モーメント(オブジェクト) |
4 |
モーメント(日付) |
5 |
moment(Array []) |
6 |
モーメント(数値) |
7 |
モーメント(モーメント) |
8 |
moment.utc() |
9 |
moment.parseZone() |
10 |
moment()。creationData(); |
11 |
var m = moment(\ {時間:3、分:40、秒:10}); |
MomentJS-日付検証
解析フラグ
MomentJSは、指定された日付が無効とみなされる場合に、以下の解析フラグを提供します-
オーバーフロー-これは、指定された月が13日、日が1年で367日、月で32日、うるう年でない2月で29日などの場合に発生します。 オーバーフローには、 invalidAt に一致する無効なユニットのインデックスが含まれます。 -1 はオーバーフローがないことを意味することに注意してください。
空-日付ではない入力が与えられたとき。 ブール値を返します。
日付の検証を理解するために、次の例を考慮してください-
出力
invalidAtは出力を1として提供します。これは、月の値が12を超えてオーバーフローするため、月を指します。 オーバーフローがある場合、invalidAtは、ここに示されている表に示すように出力を提供します-
0 | years |
1 | months |
2 | days |
3 | hours |
4 | minutes |
5 | seconds |
6 | milliseconds |
指定された日付に複数のオーバーフローがある場合、最初のオーバーフローしたインデックスの出力になります。
MomentJS-ゲッター/セッター
MomentJSには、日付入力を取得/設定するための多くのメソッドがあります。 Getを使用すると、必要な入力ユニットを読み取ることができ、setを使用すると入力ユニットを変更できます。 この章では、現時点で使用されるget/setメソッドについて詳しく説明します。
次の表は、使用可能なget/setメソッドを示しています-
Method | Syntax |
---|---|
Millisecond |
moment().millisecond(Number) moment()。millisecond(); moment()。milliseconds(Number); moment()。milliseconds(); |
Second |
moment().second(Number); moment()。second(); moment()。seconds(Number); moment()。seconds(); |
Minute |
moment().minute(Number); moment()。minute(); moment()。minutes(Number); moment()。minutes(); |
Hour |
moment().date(Number); moment()。date(); moment()。dates(Number); moment()。dates(); |
Day of week | moment().day(Number |
String); moment()。day(); moment()。days(Number |
String); moment()。days(); |
Date of Month |
moment().date(Number); moment()。date(); moment()。dates(Number); moment()。dates(); |
Day of year |
moment().dayOfYear(Number); moment()。dayOfYear(); |
Week of year |
moment().week(Number); moment()。week(); moment()。weeks(Number); moment()。weeks(); |
Week of year (ISO) |
moment().isoWeek(Number); moment()。isoWeek(); moment()。isoWeeks(Number); moment()。isoWeeks(); |
Month | moment().month(Number |
String); moment()。month(); |
Quarter |
moment().quarter(); moment()。quarter(Number); moment()。quarters(); moment()。quarters(Number); |
Year |
moment().year(Number); moment()。year(); |
Week year |
moment().weekYear(Number); moment()。weekYear(); |
Weeks in year |
moment().weeksInYear(); | Get |
moment().get('year'); moment()。get( 'month'); moment()。get( 'date'); moment()。get( 'hour'); moment()。get( 'minute'); moment()。get( 'second'); moment()。get( 'millisecond'); |
Set |
moment().set(String, Int); moment()。set(Object(String、Int)); |
Maximum |
moment.max(Moment[,Moment…]); moment.max(Moment []); |
Minimum |
MomentJS-日付と時刻の操作
- MomentJS *は、モーメントオブジェクトの日付と時刻を操作するためのさまざまなメソッドを提供します。 この章では、このようなすべての方法について詳しく説明します。
日付と時刻を操作する方法
次の表は、必要に応じて日付と時刻を操作するのに役立つMomentJSで利用可能なメソッドを示しています-
Sr.No. | Method & Syntax |
---|---|
1 |
moment.add() |
2 |
moment.subtract() |
3 |
moment.startof() |
4 |
moment.endof() |
5 |
moment.local() |
6 |
moment.utc() |
7 |
moment.utcOffset() |
MomentJS-日付と時刻のフォーマット
MomentJSは、さまざまな方法で日付を表示する形式を提供します。 特定の瞬間からの時間、現在の瞬間からの時間、2つの瞬間の差などを伝える方法があります。 JSON形式、配列、オブジェクト、文字列などで日付を表示できます。
日付と時刻をフォーマットする方法
次の表は、必要に応じて日付の表示/書式設定に役立つ利用可能なメソッドのリストを示しています。
Method | Syntax |
---|---|
Format |
moment().format(); moment()。format(String); |
Time from now |
moment().fromNow(); moment()。fromNow(Boolean); |
Time from X | moment().from (Moment |
String | Number |
Date | Array); |
Time to now |
moment().toNow(); moment()。toNow(Boolean); |
Time to X | moment().to(Moment |
String | Number |
Date |
Array); moment()。to(Moment |
String | Number |
Date | Array、Boolean); |
Calendar Time |
moment().calendar(); moment()。calendar(referenceTime); moment()。calendar(referenceTime、formats); |
Difference | moment().diff(Moment |
String | Number |
Date |
Array); moment()。diff(Moment |
String | Number |
Date |
Array、String); moment()。diff(Moment |
String | Number |
Date | Array、String、Boolean); |
Unix Timestamp(milliseconds) |
moment().valueOf(); + moment(); |
Unix Timestamp(seconds) | moment().unix(); |
Days in Month | moment().daysInMonth(); |
As JavaScript Date | moment().toDate(); |
As Array | moment().toArray(); |
As JSON | moment().toJSON(); |
As ISO 8601 String |
moment().toISOString(); moment()。toISOString(keepOffset); |
As Object | moment().toObject(); |
As String | moment().toString(); |
Inspect | moment().inspect(); |
MomentJS-日付クエリ
MomentJSで日付をクエリするためのメソッド
次の表は、MomentJSで使用可能なメソッドと、日付を照会するための構文を示しています-
Method | Syntax |
---|---|
Is Before | moment().isBefore(Moment |
String | Number |
Date |
Array); moment()。isBefore(Moment |
String | Number |
Date | Array、String); |
Is Same | moment().isSame(Moment |
String | Number |
Date |
Array); moment()。isSame(Moment |
String | Number |
Date | Array、String); |
Is After | moment().isAfter(Moment |
String | Number |
Date |
Array); moment()。isAfter(Moment |
String | Number |
Date | Array、String); |
Is Same or Before | moment().isSameOrBefore(Moment |
String | Number |
Date |
Array); moment()。isSameOrBefore(Moment |
String | Number |
Date | Array、String); |
Is Same or After | moment().isSameOrAfter(Moment |
String | Number |
Date |
Array); moment()。isSameOrAfter(Moment |
String | Number |
Date | Array、String); |
Is Between |
moment().isBetween(moment-like, moment-like); moment()。isBetween(moment-like、moment-like、String); |
Is Daylight Saving Time | moment().isDST(); |
Is Leap Year | moment().isLeapYear(); |
Is a Moment | moment.isMoment(obj); |
Is a Date | moment.isDate(obj); |
MomentJS-国際化
国際化は、MomentJSの重要な機能の1つです。 ローカライズ、つまり国/地域に基づいて日付と時刻を表示できます。 ロケールは、必要に応じて特定の瞬間に適用できます。
この章では、ロケールをグローバルに、ローカルに適用し、Node.jsを使用してロケールを操作し、ブラウザーで、必要なロケールなどで単位(月、平日など)を取得する方法について詳しく説明します。
Sr.No. | Locale & Description |
---|---|
1 |
ロケールをグローバルに割り当てることができ、割り当てられたロケールですべての日付/時刻の詳細が利用可能になります。 |
2 |
アプリケーションで多くのロケールを処理する必要がある場合に備えて、ローカルに適用するロケールが必要です。 |
3 |
スクリプトタグにロケールファイルを含めることで、ロケールの操作を開始できます。 |
4 |
Node.jsを使用する場合は、npmインストールの瞬間にロケールファイルがすぐに存在します。 |
5 |
momentjs_Listing date/time details of current locale ロケールを設定し、月、平日などの詳細を確認できます。 |
6 |
moment.locale()を使用して現在のロケールを確認できます。 |
7 |
Accessing Locale Specific Functionality 現在ロードされているロケールで利用可能なメソッドとプロパティが表示されます。 |
MomentJS-カスタマイズ
次のリストは、ローカライズで可能なカスタマイズを示しています-
シニア
ローカリゼーションと説明
1
リンク:/momentjs/momentjs_customization_month_names [月の名前]
ロケールのカスタマイズに月名を追加できます。
2
リンク:/momentjs/momentjs_month_abbreviation [月の省略形]
このメソッドは、月の省略形をカスタマイズするのに役立ちます。
3
リンク:/momentjs/momentjs_weekday_names [平日の名前]
このメソッドは、ロケールごとに曜日名をカスタマイズするのに役立ちます。
4
リンク:/momentjs/momentjs_weekday_abbreviation [平日省略形]
このメソッドは、ロケールセットに基づいて曜日の省略形をカスタマイズするのに役立ちます。
5
リンク:/momentjs/momentjs_minimal_weekday_abbreviation [最小の曜日の省略形]
この方法は、ロケールセットに基づいて最小曜日の省略形をカスタマイズするのに役立ちます。
6
リンク:/momentjs/momentjs_long_date_formats [長い日付形式]
このメソッドは、ロケールのlongdateformatのカスタマイズに役立ちます。
7
リンク:/momentjs/momentjs_relative_time [相対時間]
この方法は、相対時間を取得するのに役立ちます。
8
リンク:/momentjs/momentjs_ampm [AM/PM]
このメソッドは、ロケールごとにメリディエムをカスタマイズするのに役立ちます。
9
リンク:/momentjs/momentjs_ampm_parsing [AM/PM解析]
この方法を使用してAM/PMを解析できます。
10
リンク:/momentjs/momentjs_calendar [カレンダー]
これは、ロケールセットのカレンダーオブジェクトのカスタマイズに役立ちます。
11
リンク:/momentjs/momentjs_ordinal [序数]
日付の序数表示は、ロケールに基づいて変更できます。
12
リンク:/momentjs/momentjs_relative_time_thresholds [相対時間しきい値]
これはduration.humanizeで使用され、持続時間の長さが*数秒前、1分、1時間前*などとして表示されます。
MomentJS-期間
MomentJSは、指定されたユニットの時間の長さを処理する期間と呼ばれる重要な機能を提供します。 この章では、これについて詳しく学習します。
期間で利用可能なメソッド
次の表は、モーメントデュレーションで使用されるさまざまなユニットのデュレーションで使用可能なメソッドを示しています-
方法
構文
リンク:/momentjs/momentjs_creating [作成]
moment.duration(Number、String);
moment.duration(数値);
moment.duration(Object);
moment.duration(String);
リンク:/momentjs/momentjs_clone [クローン]
moment.duration()。clone();
リンク:/momentjs/momentjs_humanize [Humanize]
moment.duration()。humanize();
リンク:/momentjs/momentjs_milliseconds [ミリ秒]
moment.duration()。milliseconds();
moment.duration()。asMilliseconds();
リンク:/momentjs/momentjs_seconds [秒]
moment.duration()。seconds();
moment.duration()。asSeconds();
リンク:/momentjs/momentjs_minutes [分]
moment.duration()。minutes();
moment.duration()。asMinutes();
リンク:/momentjs/momentjs_hours [時間]
moment.duration()。hours();
moment.duration()。asHours();
リンク:/momentjs/momentjs_days [日]
moment.duration()。days();
moment.duration()。asDays();
リンク:/momentjs/momentjs_weeks [週]
moment.duration()。weeks();
moment.duration()。asWeeks();
リンク:/momentjs/momentjs_months [月]
moment.duration()。months();
moment.duration()。asMonths();
年
moment.duration()。years();
moment.duration()。asYears();
リンク:/momentjs/momentjs_add_time [時間を追加]
moment.duration()。add(Number、String);
moment.duration()。add(Number);
moment.duration()。add(Duration);
moment.duration()。add(Object);
リンク:/momentjs/momentjs_subtract_time [減算時間]
moment.duration()。subtract(Number、String);
moment.duration()。subtract(Number);
moment.duration()。subtract(Duration);
moment.duration()。subtract(Object);
リンク:/momentjs/momentjs_using_duration_with_diff [Diffでの期間の使用]
var duration = moment.duration(x.diff(y))
リンク:/momentjs/momentjs_as_unit_of_time [時間の単位として]
moment.duration()。as(String);
リンク:/momentjs/momentjs_get_unit_of_time [時間の単位を取得]
duration.get( 'hours');
duration.get( 'minutes');
duration.get( 'seconds');
duration.get( 'milliseconds');
リンク:/momentjs/momentjs_duration_as_json [JSONとして]
moment.duration()。toJSON();
リンク:/momentjs/momentjs_is_duration [Is a Duration]
moment.isDuration(obj);
リンク:/momentjs/momentjs_duration_as_iso_8601_string [ISO 8601文字列として]
moment.duration()。toISOString();
リンク:/momentjs/momentjs_locale [ロケール]
moment.duration()。locale();
moment.duration()。locale(String);
MomentJS-ユーティリティ
MomentJSでは、正規化ユニットと無効なメソッドを使用して、要件に従って出力を変更またはカスタマイズできます。 momentオブジェクトに独自のカスタム検証を設定することもできます。
詳細については、次の表をご覧ください-
Sr.No. | Method & Syntax |
---|---|
1 |
moment.normalizeUnits(String); |
2 |
moment.invalid(Object); |
MomentJS-プラグイン
プラグインは、MomentJSに追加された拡張機能です。 MomentJSはオープンソースプロジェクトであり、多くのプラグインがMomentJSに含まれています。これらのプラグインは、ユーザーによって提供され、Node.jsおよびGitHubを使用して利用できます。
この章では、MomentJSで使用できるカレンダープラグインと日付形式プラグインのいくつかについて説明します。
カレンダープラグイン
このセクションでは、* ISOカレンダーと台湾カレンダー*の2種類のカレンダープラグインについて説明します。
ISOカレンダー
次のコマンドを使用して、Node.jsでインストールできます-
GitHubからmoment-isocalendar.jsを取得できます。
例
出力
例
出力
台湾カレンダー
次のコマンドを使用して、Node.jsでインストールできます-
GitHubからmoment-taiwan.jsを取得できます。
例
出力
日付形式プラグイン
このセクションでは、日付形式プラグインの次のタイプについて説明します-
- Java dateformatパーサー
- 短い日付フォーマッター
- 日付形式の解析
- 期間の形式
- 期間
- 正確な範囲
Java DateFormatパーサー
次のコマンドを使用して、Node.jsでインストールできます-
GitHubからmoment-jdateformatparser.jsを取得できます。
例
出力
短い日付フォーマッター
shortdateformatのJavaScriptファイルはGitHubから取得できます-
https://github.com/researchgate/moment-shortformat
構文
表示はここの表に示すように見えます-
From moment | From moment().short() |
---|---|
0 to 59 seconds | 0 to 59 s |
1 to 59 minutes | 1 to 59 m |
1 to 23 hours | 1h to 23h |
1 to 6 days | 1d to 6d |
>= 7 days and same year | Display will be like such as feb 3, mar 6 |
>= 7 days and diff year | Display will be like such as feb 3, 2018, mar 6, 2018 |
上記のGitHubリンクから瞬間的にスクリプトを取得できます。
例
出力
サフィックス ago または in を削除する場合は、trueをshort(truに渡すことができます。
日付形式の解析
次のコマンドを使用して、Node.jsでインストールできます-
例
出力
出力が、parseFormatに与えられたパラメーター(日付/時刻)が何であれ、上記のように日付の形式を与えることを示していることに注意してください。
期間の形式
次のコマンドを使用して、Node.jsに期間形式をインストールできます-
期間形式のリポジトリはこちらから入手できます-https://github.com/jsmreese/moment-duration-format期間形式を使用した実例を見てみましょう-
例
出力
これにより、作成された瞬間の継続時間に詳細が追加されます。
期間
次のコマンドを使用して、Node.jsに日付範囲をインストールできます-
例
出力
正確な範囲
正確な範囲は、日付、時刻、および人間が読める形式で正確な日付の差を表示します。 次のコマンドを使用して、Node.jsに正確な範囲をインストールできます-
例
出力
MomentJS-例
これまで、MomentJSで多くの概念を学びました。 この章では、理解を深めるためにさらに例を示します。
2つの日付間の日付範囲を表示する
これは、指定された2つの日付の間の日付を表示する例です。
出力
2014-05-01〜2014-08-16の日曜日を表示
出力
ロケールごとに日付の詳細を表示する
ここでは、すべてのロケールを含むmoment.localeスクリプトを使用しています。