diff options
Diffstat (limited to 'files/ja/web/javascript/reference/global_objects/date')
53 files changed, 4759 insertions, 0 deletions
diff --git a/files/ja/web/javascript/reference/global_objects/date/@@toprimitive/index.html b/files/ja/web/javascript/reference/global_objects/date/@@toprimitive/index.html new file mode 100644 index 0000000000..ba7475e583 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/@@toprimitive/index.html @@ -0,0 +1,75 @@ +--- +title: 'Date.prototype[@@toPrimitive]' +slug: Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive +--- +<div>{{JSRef}}</div> + +<p><code><strong>[@@toPrimitive]()</strong></code> メソッドは、<code>Date</code> オブジェクトをプリミティブ値に変換します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">Date()[Symbol.toPrimitive](<var>hint</var>);</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた {{jsxref("Date")}} オブジェクトのプリミティブ値です。引数に応じて、このメソッドは文字列と数値のどちらかを返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Date")}} オブジェクトの <code>[@@toPrimitive]()</code> メソッドは、プリミティブ値を返します。これは、数値型か文字列型です。</p> + +<p><code><var>hint</var></code> が <code>string</code> または <code>default</code> の場合、<code>[@@toPrimitive]()</code> は {{jsxref("Object.prototype.toString()", "toString")}} メソッドを呼び出そうとします。<code>toString</code> メソッドが存在しなければ、{{jsxref("Object.prototype.valueOf()", "valueOf")}} メソッドを呼び出そうとします。<code>valueOf</code> メソッドも存在しなければ、<code>[@@toPrimitive]()</code> は {{jsxref("TypeError")}} を発生させます。</p> + +<p><code>hint</code> が <code>number</code> の場合、<code>[@@toPrimitive]()</code> は初めに <code>valueOf</code> メソッドを呼び出そうとします。これが失敗した場合は、<code>toString</code> メソッドを呼び出します。</p> + +<p>JavaScript は、<code>[@@toPrimitive]()</code> メソッドを呼び出してオブジェクトをプリミティブ値に変換します。<code>[@@toPrimitive]()</code> メソッドを自分で呼び出す必要はほとんどありません。JavaScript は、プリミティブ値が期待されるオブジェクトに遭遇した時、自動的にこれを呼び出します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Returning_date_primitives" name="Returning_date_primitives">日付プリミティブの返却</h3> + +<pre class="brush: js notranslate">const testDate = new Date(1590757517834); +// "Date Fri May 29 2020 14:05:17 GMT+0100 (British Summer Time)" + +testDate[Symbol.toPrimitive]('string'); +// Returns "Date Fri May 29 2020 14:05:17 GMT+0100 (British Summer Time)" + +testDate[Symbol.toPrimitive]('number'); +// Returns "1590757517834" + +testDate[Symbol.toPrimitive]('default'); +// Returns "Date Fri May 29 2020 14:05:17 GMT+0100 (British Summer Time)"</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype-@@toprimitive', 'Date.prototype.@@toPrimitive')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.@@toPrimitive")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Symbol.toPrimitive")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/date/index.html b/files/ja/web/javascript/reference/global_objects/date/date/index.html new file mode 100644 index 0000000000..9aa45f5b17 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/date/index.html @@ -0,0 +1,135 @@ +--- +title: Date() コンストラクター +slug: Web/JavaScript/Reference/Global_Objects/Date/Date +tags: + - Constructor + - Date + - JavaScript + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/Date +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary">JavaScript の <strong><code>Date</code></strong> インスタンスを生成し、これはプラットフォームに依存しない形式で単一の瞬間の時刻を表現します。</span> <code>Date</code> オブジェクトは 1970 年 1 月 1 日 (UTC) からの経過ミリ秒数を <code>Number</code> で保持します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-constructor.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">new Date() +new Date(<var>value</var>) +new Date(<var>dateString</var>) +new Date(<var>year</var>, <var>monthIndex</var> [, <var>day</var> [, <var>hours</var> [, <var>minutes</var> [, <var>seconds</var> [, <var>milliseconds</var>]]]]]) +</pre> + +<div class="blockIndicator note"> +<p><strong>注:</strong> 新しい <code>Date</code> オブジェクトをインスタンス化する唯一の正しい方法は、 {{jsxref("new")}} 演算子を使用することです。単純に直接 <code>Date</code> オブジェクトを <code>now = Date()</code> のように呼び出すと、返値は <code>Date</code> オブジェクトではなく文字列になります。</p> +</div> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p><code>Date()</code> コンストラクターには4つの基本形があります。</p> + +<ol> + <li> + <h4 id="No_parameters" name="No_parameters">引数なし</h4> + + <p>引数が与えられなかった場合は、新しく生成された <code>Date</code> オブジェクトはインスタンス化された時点で現在の日付と時刻を表します。</p> + </li> + <li> + <h4 id="Time_value_or_timestamp_number" name="Time_value_or_timestamp_number">時刻値またはタイムスタンプ値</h4> + + <dl> + <dt><code><var>value</var></code></dt> + <dd>世界協定時 (UTC) 1970年1月1日午前0時0分0秒 (ECMAScript 元期、 UNIX 元期と等価) からのミリ秒数を整数値で表し、うるう秒は無視します。大部分の <a href="http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_16">UNIX Timestamp</a> 関数は秒単位の精度しかないことに注意してください。</dd> + </dl> + </li> + <li> + <h4 id="Timestamp_string" name="Timestamp_string">タイムスタンプ文字列</h4> + + <dl> + <dt><code><var>dateString</var></code></dt> + <dd>日付を表す文字列値で、 {{jsxref("Date.parse()")}} メソッドによって認識される形式で指定されます。 (これらの形式は <a href="http://tools.ietf.org/html/rfc2822#page-14">IETF 準拠の RFC 2822 タイムスタンプ</a>であり、 <a href="https://www.ecma-international.org/ecma-262/11.0/#sec-date.parse">ISO8601 のバージョン</a>の文字列でもあります。) + <div class="note"> + <p><strong>注:</strong> <code>Date</code> コンストラクター (および同じように動作する <code>Date.parse()</code>) を使用した日付文字列の解析は、ブラウザーによって違いや矛盾があるため、<em>使用を避けることを強くお勧めします。</em>。</p> + + <ul> + <li><a href="https://tools.ietf.org/html/rfc2822">RFC 2822</a> 書式の文字列の対応は慣習的に行われているだけです。</li> + <li>ISO 8601 形式の対応は、日付のみの文字列 (例えば <code>1970-01-01</code>) が地方時ではなく UTC として扱われる点が異なります。</li> + </ul> + </div> + </dd> + </dl> + </li> + <li> + <h4 id="Individual_date_and_time_component_values" name="Individual_date_and_time_component_values">独立した日付と時刻の成分の値</h4> + + <p>少なくとも年と月が指定された場合、この形の <code>Date()</code> は成分の値 (年、月、日、時、分、秒、ミリ秒) のすべてを以下の引数から取得した <code>Date</code> オブジェクトを返します。欠けている値は、有効な最も小さな値 (<code><var>day</var></code> では <code>1</code>、他の成分では <code>0</code>) になります。</p> + + <dl> + <dt><code><var>year</var></code></dt> + <dd> + <p>年を表す整数値です。</p> + + <p><code>0</code> から <code>99</code> までの値は、 <code>1900</code> から <code>1999</code> までの値にマッピングされます。他の値は実際の年になります。<a href="#Two_digit_years_map_to_1900_-_1999">後述の例</a>をご覧ください。</p> + </dd> + <dt><code><var>monthIndex</var></code></dt> + <dd>月を表す整数値です。 <code>0</code> (1月) から <code>11</code> (12月) までの値です。</dd> + <dt><code><var>day</var></code> {{optional_inline}}</dt> + <dd>月内の日を表す整数値です。既定値は <code>1</code> です。</dd> + <dt><code><var>hours</var></code> {{optional_inline}}</dt> + <dd>1日の中の時を表します。既定値は <code>0</code> です。</dd> + <dt><code><var>minutes</var></code> {{optional_inline}}</dt> + <dd>任意。分 (0-59) を表す整数値です。</dd> + <dt><code><var>seconds</var></code> {{optional_inline}}</dt> + <dd>任意。秒 (0-59) を表す整数値です。</dd> + <dt><code><var>milliseconds</var></code> {{optional_inline}}</dt> + <dd>任意。ミリ秒 (0-999) を表す整数値です。</dd> + </dl> + </li> +</ol> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Several_ways_to_create_a_Date_object" name="Several_ways_to_create_a_Date_object">Date オブジェクトを生成するいくつかの方法</h3> + +<p>以下の例で、JavaScript の Date を生成するいくつかの方法を示します。</p> + +<div class="note"> +<p><strong>注:</strong> 日付文字列を <code>Date</code> コンストラクター (または同等の <code>Date.parse</code>) で解釈する方法は、ブラウザーごとに動作が異なり一貫性がないため、避けることを強くおすすめします。</p> +</div> + +<pre class="brush: js notranslate">let today = new Date() +let birthday = new Date('December 17, 1995 03:24:00') +let birthday = new Date('1995-12-17T03:24:00') +let birthday = new Date(1995, 11, 17) // the month is 0-indexed +let birthday = new Date(1995, 11, 17, 3, 24, 0)</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date-constructor', 'Date')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.Date")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getdate/index.html b/files/ja/web/javascript/reference/global_objects/date/getdate/index.html new file mode 100644 index 0000000000..3f790c14df --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getdate/index.html @@ -0,0 +1,67 @@ +--- +title: Date.prototype.getDate() +slug: Web/JavaScript/Reference/Global_Objects/Date/getDate +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getDate +--- +<div>{{JSRef}}</div> + +<p><strong><code>getDate()</code></strong> メソッドは、地方時に基づき、指定された日付の「日」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getdate.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getDate()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>1 から 31 までの間の整数値。地方時に基づき、指定された日付の「日」を表します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getDate" name="Using_getDate">getDate() の使用</h3> + +<p>以下の 2 行目の文は、{{jsxref("Date")}} オブジェクト <code>Xmas95</code> の値に基づき、変数 <code>day</code> に 25 という値を代入します。</p> + +<pre class="brush: js notranslate">var Xmas95 = new Date('December 25, 1995 23:15:30'); +var day = Xmas95.getDate(); + +console.log(day); // 25 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getdate', 'Date.prototype.getDate')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getDate")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> + <li>{{jsxref("Date.prototype.getUTCDay()")}}</li> + <li>{{jsxref("Date.prototype.setDate()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getday/index.html b/files/ja/web/javascript/reference/global_objects/date/getday/index.html new file mode 100644 index 0000000000..2a9e3192ae --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getday/index.html @@ -0,0 +1,80 @@ +--- +title: Date.prototype.getDay() +slug: Web/JavaScript/Reference/Global_Objects/Date/getDay +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference + - getDay + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getDay +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>getDay()</code></strong> メソッドは、地方時に基づき、指定された日付の「曜日」を返します。 0 は日曜日を表します。</span>「日」を取得する方法は {{jsxref("Date.prototype.getDate()")}} をご覧ください。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getday.html", "shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getDay()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>整数値で、 0 から 6 までの値を取り、地方時に基づいて指定された日付の曜日に対応し、 0 は日曜日、 1 は月曜日、 2 は火曜日のようになります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getDay" name="Using_getDay">getDay の使用</h3> + +<p>以下の 2 行目の文は、{{jsxref("Date")}} オブジェクト <code>Xmas95</code> の値に基づき、<code>weekday</code> に 1 という値を代入します。1995 年 12 月 25 日は月曜日です。</p> + +<pre class="brush: js notranslate">var Xmas95 = new Date('December 25, 1995 23:15:30'); +var weekday = Xmas95.getDay(); + +console.log(weekday); // 1 +</pre> + +<div class="blockIndicator note"> +<p><strong>注:</strong> 必要であれば、曜日の完全な名前 (例えば "<code>Monday</code>") は {{jsxref("DateTimeFormat", "Intl.DateTimeFormat")}} に <code>options</code> 引数を設定することで取得することができます。このメソッドを使用すれば、国際化がより簡単になります。</p> + +<pre class="brush: js notranslate">var options = { weekday: 'long'}; +console.log(new Intl.DateTimeFormat('en-US', options).format(Xmas95)); +// Monday +console.log(new Intl.DateTimeFormat('de-DE', options).format(Xmas95)); +// Montag +</pre> +</div> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getday', 'Date.prototype.getDay')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getDay")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> + <li>{{jsxref("Date.prototype.getUTCDay()")}}</li> + <li>{{jsxref("Date.prototype.setDate()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getfullyear/index.html b/files/ja/web/javascript/reference/global_objects/date/getfullyear/index.html new file mode 100644 index 0000000000..a1cad58ea3 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getfullyear/index.html @@ -0,0 +1,71 @@ +--- +title: Date.prototype.getFullYear() +slug: Web/JavaScript/Reference/Global_Objects/Date/getFullYear +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getFullYear +--- +<div>{{JSRef}}</div> + +<p><strong><code>getFullYear()</code></strong> メソッドは、地方時に基づき、指定された日時の「年」を返します。</p> + +<p>{{jsxref("Date.prototype.getYear()", "getYear()")}} メソッドの代わりに、このメソッドを使用してください。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getfullyear.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getFullYear()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>地方時に基づき、与えた日付の年に相当する数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>getFullYear()</code> が返す値は絶対的な値です。1000 年から 9999 年までの日付に対して、<code>getFullYear()</code> は 1995 のような 4 桁の数字を返します。2000 年以降の年について正しい値を得るには、この関数を使用してください。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getFullYear" name="Using_getFullYear">getFullYear() の使用</h3> + +<p>以下の例は、変数 <code>year</code> に今年を表す 4 桁の数字を代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var year = today.getFullYear(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getfullyear', 'Date.prototype.getFullYear')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getFullYear")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setFullYear()")}}</li> + <li>{{jsxref("Date.prototype.getYear()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/gethours/index.html b/files/ja/web/javascript/reference/global_objects/date/gethours/index.html new file mode 100644 index 0000000000..3d23d4599a --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/gethours/index.html @@ -0,0 +1,67 @@ +--- +title: Date.prototype.getHours() +slug: Web/JavaScript/Reference/Global_Objects/Date/getHours +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getHours +--- +<div>{{JSRef}}</div> + +<p><strong><code>getHours()</code></strong> メソッドは、地方時に基づき、指定された日時の「時」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-gethours.html","shorter")}}</div> + +<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getHours()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>地方時に基づき、与えた日時の「時」を表す 0 から 23 の間の整数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getHours" name="Using_getHours">getHours() の使用</h3> + +<p>以下の 2 行目の文は、 {{jsxref("Global_Objects/Date", "Date")}} オブジェクト <code>Xmas95</code> の値に基づき、23 という値を変数 <code>hours</code> に代入します。</p> + +<pre class="brush: js notranslate">let Xmas95 = new Date('December 25, 1995 23:15:30'); +let hours = Xmas95.getHours(); + +console.log(hours); // 23 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.gethours', 'Date.prototype.getHours')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getHours")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCHours()")}}</li> + <li>{{jsxref("Date.prototype.setHours()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getmilliseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/getmilliseconds/index.html new file mode 100644 index 0000000000..91b632f753 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getmilliseconds/index.html @@ -0,0 +1,64 @@ +--- +title: Date.prototype.getMilliseconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/getMilliseconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getMilliseconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>getMilliseconds()</code></strong> メソッドは、ローカル時間に基づき、指定された日時の「ミリ秒」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getmilliseconds.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getMilliseconds()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>ローカル時間に基づき、指定された日時の「ミリ秒」を表す 0 から 999 までの間の数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getMilliseconds" name="Using_getMilliseconds">getMilliseconds() の使用</h3> + +<p>次の例は、現在時刻のミリ秒部を変数 <code>milliseconds</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var milliseconds = today.getMilliseconds(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getmilliseconds', 'Date.prototype.getMilliseconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getMilliseconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</li> + <li>{{jsxref("Date.prototype.setMilliseconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getminutes/index.html b/files/ja/web/javascript/reference/global_objects/date/getminutes/index.html new file mode 100644 index 0000000000..45646458a7 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getminutes/index.html @@ -0,0 +1,66 @@ +--- +title: Date.prototype.getMinutes() +slug: Web/JavaScript/Reference/Global_Objects/Date/getMinutes +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getMinutes +--- +<div>{{JSRef}}</div> + +<p><strong><code>getMinutes()</code></strong> メソッドは、地方時に基づき、指定された日時の「分」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getminutes.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getMinutes()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>地方時に基づき、与えた日時の「分」を表す 0 から 59 までの間の整数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getMinutes" name="Using_getMinutes">getMinutes() の使用</h3> + +<p>以下の 2 行目の文は、{{jsxref("Global_Objects/Date", "Date")}} オブジェクト <code>Xmas95</code> の値に基づき、変数 <code>minutes</code> に 15 という値を代入します。</p> + +<pre class="brush: js notranslate">var Xmas95 = new Date('December 25, 1995 23:15:30'); +var minutes = Xmas95.getMinutes(); + +console.log(minutes); // 15 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getminutes', 'Date.prototype.getMinutes')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getMinutes")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCMinutes()")}}</li> + <li>{{jsxref("Date.prototype.setMinutes()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getmonth/index.html b/files/ja/web/javascript/reference/global_objects/date/getmonth/index.html new file mode 100644 index 0000000000..3ffe832ff7 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getmonth/index.html @@ -0,0 +1,77 @@ +--- +title: Date.prototype.getMonth() +slug: Web/JavaScript/Reference/Global_Objects/Date/getMonth +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getMonth +--- +<div>{{JSRef}}</div> + +<p><strong><code>getMonth()</code></strong> メソッドは、地方時に基づき、指定された日付の「月」を表す 0 を基点とした値 (すなわち 0 が年の最初の月を示す) を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getmonth.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getMonth()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>地方時に基づき、与えた日付の「月」を表す 0 から 11 までの間の整数値。0 は 1 月、1 は 2 月、11 は 12 月に対応します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getMonth" name="Using_getMonth">getMonth() の使用</h3> + +<p>以下の 2 行目の文は、{{jsxref("Global_Objects/Date", "Date")}} オブジェクト <code>Xmas95</code> の値に基づき、変数 <code>month</code> に 11 という値を代入します。</p> + +<pre class="brush: js notranslate">var Xmas95 = new Date('December 25, 1995 23:15:30'); +var month = Xmas95.getMonth(); + +console.log(month); // 11 +</pre> + +<div class="blockIndicator note"> +<p><strong>注:</strong> 必要であれば、月の完全な名前 (例えば <code>January</code> ) は <code><a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#Using_options">Intl.DateTimeFormat()</a></code> に <code>options</code> 引数を付けることで取得することができます。このメソッドを使用すれば、国際化がより簡単になります。</p> + +<pre class="brush: js notranslate">var options = { month: 'long'}; +console.log(new Intl.DateTimeFormat('en-US', options).format(Xmas95)); +// December +console.log(new Intl.DateTimeFormat('de-DE', options).format(Xmas95)); +// Dezember +</pre> +</div> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getmonth', 'Date.prototype.getMonth')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getMonth")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCMonth()")}}</li> + <li>{{jsxref("Date.prototype.setMonth()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/getseconds/index.html new file mode 100644 index 0000000000..44ace675f4 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getseconds/index.html @@ -0,0 +1,66 @@ +--- +title: Date.prototype.getSeconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/getSeconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getSeconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>getSeconds()</code></strong> メソッドは、地方時に基づき、指定した日時の「秒」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getseconds.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getSeconds()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>地方時に基づき、与えた日付の「秒」を表す 0 から 59 までの間の整数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getSeconds" name="Using_getSeconds">getSeconds() の使用</h3> + +<p>以下の 2 行目の文は、{{jsxref("Global_Objects/Date", "Date")}} オブジェクト <code>Xmas95</code> の値に基づき、変数 <code>seconds</code> に 30 という値を代入します。</p> + +<pre class="brush: js notranslate">var Xmas95 = new Date('December 25, 1995 23:15:30'); +var seconds = Xmas95.getSeconds(); + +console.log(seconds); // 30 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getseconds', 'Date.prototype.getSeconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getSeconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCSeconds()")}}</li> + <li>{{jsxref("Date.prototype.setSeconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/gettime/index.html b/files/ja/web/javascript/reference/global_objects/date/gettime/index.html new file mode 100644 index 0000000000..c0ff3ff0e1 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/gettime/index.html @@ -0,0 +1,110 @@ +--- +title: Date.prototype.getTime() +slug: Web/JavaScript/Reference/Global_Objects/Date/getTime +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getTime +--- +<div>{{JSRef}}</div> + +<p><strong><code>getTime()</code></strong> メソッドは、 <a href="https://ja.wikipedia.org/wiki/UNIX%E6%99%82%E9%96%93">UNIX 元期</a>からの経過ミリ秒数*を返します。</p> + +<p>* JavaScriptは測定単位として<em>ミリ秒</em>を使用しますが、 Unix 時間は<em>秒</em>単位です。</p> + +<p><em>getTime() は時間表現に常に UTC を使用します。例えば、あるタイムゾーンに設定されているブラウザーの getTime() も、他のタイムゾーンに設定されたブラウザーの getTime() も、同じ値を返します。</em></p> + +<p>このメソッドは、日付と時刻を別の {{jsxref("Date")}} オブジェクトへ代入する助けとして使用できます。このメソッドは、{{jsxref("Date.valueof", "valueOf()")}} メソッドと機能的に同等です。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-gettime.html","shorter")}}</div> + +<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><code><var>dateObj</var>.getTime()</code></pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>1970 年 1 月 1 日 00:00:00 UTC から指定した日時までの経過時間をミリ秒で表した数値。</p> + +<h2 id="Reduced_time_precision" name="Reduced_time_precision">時刻の低精度化</h2> + +<p>ブラウザーの設定によっては、タイミング攻撃と Fingerprinting に対する保護を提供するために <code>new Date().getTime()</code> の精度が落とされていることがあります。 Firefox では、<code>privacy.reduceTimerPrecision</code> が既定で有効になっています。既定値は Firefox 59 では 20 マイクロ秒で、 Firefox 60 では 2 ミリ秒です。</p> + +<pre class="brush: js notranslate">// Firefox 60 での時刻の精度の低下（2 ミリ秒） +new Date().getTime(); +// 1519211809934 +// 1519211810362 +// 1519211811670 +// ... + + +// `privacy.resistFingerprinting` が有効な場合の時刻の精度の低下 +new Date().getTime(); +// 1519129853500 +// 1519129858900 +// 1519129864400 +// ... +</pre> + +<p>Firefox では、 <code>privacy.resistFingerprinting</code> も有効にできます。この場合、精度は 100 ミリ秒と <code>privacy.resistFingerprinting.reduceTimerPrecision.microseconds</code> 値のうち大きい方になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getTime_for_copying_dates" name="Using_getTime_for_copying_dates">getTime() を使って日付をコピーする</h3> + +<p>同一の time 値を持つ date オブジェクトを構築します。</p> + +<pre class="brush: js notranslate">// month は 0 を基点とするため、birthday は 1995 年 1 月 10 日になります +var birthday = new Date(1994, 12, 10); +var copy = new Date(); +copy.setTime(birthday.getTime()); +</pre> + +<h3 id="Measuring_execution_time" name="Measuring_execution_time">実行時間を計測する</h3> + +<p>新たに生成された {{jsxref("Date")}} オブジェクトでの、続く 2 個の <code>getTime()</code> の結果を減算して、これらの呼び出しと呼び出しの間の時間を得ます。これは、何らかの命令の実行時間を計測するために使用できます。不要な {{jsxref("Date")}} オブジェクトのインスタンス化を避けるため、{{jsxref("Date.now()")}} も参照してください。</p> + +<pre class="brush: js notranslate">var end, start; + +start = new Date(); +for (var i = 0; i < 1000; i++) { + Math.sqrt(i); +} +end = new Date(); + +console.log('Operation took ' + (end.getTime() - start.getTime()) + ' msec'); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.gettime', 'Date.prototype.getTime')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p> + +<p>{{Compat("javascript.builtins.Date.getTime")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.setTime()")}}</li> + <li>{{jsxref("Date.prototype.valueOf()")}}</li> + <li>{{jsxref("Date.now()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/gettimezoneoffset/index.html b/files/ja/web/javascript/reference/global_objects/date/gettimezoneoffset/index.html new file mode 100644 index 0000000000..3f7f8c968b --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/gettimezoneoffset/index.html @@ -0,0 +1,98 @@ +--- +title: Date.prototype.getTimezoneOffset() +slug: Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getTimezoneOffset +--- +<div>{{JSRef}}</div> + +<p><strong><code>getTimezoneOffset()</code></strong> メソッドは、 (ホストシステム上における) 現在のロケールから協定世界時 (UTC) までのタイムゾーンの差を分単位で返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-gettimezoneoffset.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getTimezoneOffset()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>ホストシステム上の現在の日付から協定世界時 (UTC) までの分単位のタイムゾーンオフセットを表す数値です。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>タイムゾーンオフセットは、地方時から協定世界時 (UTC) までの間の分単位の差です。</p> + +<p>このオフセットは、地方時が UTC より遅れている時刻の場合は正の数になり、進んでいる時刻の場合は負の数になることを意味します。例えば、タイムゾーンが UTC+10:00（オーストラリア東部標準時、ロシアのウラジオストク時、チャモロ標準時）の場合、-600 が返されます。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="row">現在のロケール</th> + <th scope="col">UTC-8</th> + <th scope="col">UTC</th> + <th scope="col">UTC+3</th> + </tr> + </thead> + <tbody> + <tr> + <th scope="row">返値</th> + <td>480</td> + <td>0</td> + <td>-180</td> + </tr> + </tbody> +</table> + +<p>返されるタイムゾーンオフセットは呼ばれた Date で適用されているものです。</p> + +<p>ホストシステムで夏時間が設定されている場合、Date が表す日時と夏時間が適用される日時によって、オフセットが変わります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getTimezoneOffset" name="Using_getTimezoneOffset">getTimezoneOffset() の使用</h3> + +<pre class="brush: js notranslate">// Get current timezone offset for host device +let x = new Date(); +let currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60; +// 1 + +// Get timezone offset for International Labour Day (May 1) in 2016 +// Be careful, the Date() constructor uses 0-indexed months, so May is +// represented with 4 (and not 5) +let labourDay = new Date(2016, 4, 1) +let labourDayOffset = labourDay.getTimezoneOffset() / 60; +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.gettimezoneoffset', 'Date.prototype.getTimezoneOffset')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getTimezoneOffset")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcdate/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcdate/index.html new file mode 100644 index 0000000000..f61db6e71c --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcdate/index.html @@ -0,0 +1,65 @@ +--- +title: Date.prototype.getUTCDate() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCDate +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCDate +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCDay()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「曜日」を返します。0 は日曜日を表します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcday.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCDay()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日付の「曜日」に相当する整数値。0 は日曜日、1 は月曜日、2 は火曜日を表します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCDay" name="Using_getUTCDay">getUTCDay() の使用</h3> + +<p>次の例は、現在日時の「曜日」部を変数 <code>weekday</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var weekday = today.getUTCDay(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcday', 'Date.prototype.getUTCDay')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCDay")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> + <li>{{jsxref("Date.prototype.getDay()")}}</li> + <li>{{jsxref("Date.prototype.setUTCDate()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcday/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcday/index.html new file mode 100644 index 0000000000..4078dfc807 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcday/index.html @@ -0,0 +1,65 @@ +--- +title: Date.prototype.getUTCDay() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCDay +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCDay +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCDay()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「曜日」を返します。0 は日曜日を表します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcday.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCDay()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日付の「曜日」に相当する整数値。0 は日曜日、1 は月曜日、2 は火曜日を表します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCDay" name="Using_getUTCDay">getUTCDay() の使用</h3> + +<p>次の例は、現在日時の「曜日」部を変数 <code>weekday</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var weekday = today.getUTCDay(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcday', 'Date.prototype.getUTCDay')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCDay")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> + <li>{{jsxref("Date.prototype.getDay()")}}</li> + <li>{{jsxref("Date.prototype.setUTCDate()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcfullyear/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcfullyear/index.html new file mode 100644 index 0000000000..efa5d1d7b8 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcfullyear/index.html @@ -0,0 +1,68 @@ +--- +title: Date.prototype.getUTCFullYear() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCFullYear +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCFullYear +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCFullYear()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「年」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcfullyear.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCFullYear()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日付の「年」を表す数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>getUTCFullYear()</code> が返す値は、 2000 年問題に対応した表記に従う絶対的な値、例えば 1995 などです。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCFullYear" name="Using_getUTCFullYear">getUTCFullYear() の使用</h3> + +<p>次の例は、現在の年を表す 4 桁の値を変数 <code>year</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var year = today.getUTCFullYear(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcfullyear', 'Date.prototype.getUTCFullYear')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCFullYear")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setFullYear()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutchours/index.html b/files/ja/web/javascript/reference/global_objects/date/getutchours/index.html new file mode 100644 index 0000000000..e1a3272494 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutchours/index.html @@ -0,0 +1,64 @@ +--- +title: Date.prototype.getUTCHours() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCHours +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCHours +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCHours()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「時」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutchours.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCHours()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日時の「時」を表す 0 から 23 までの間の整数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCHours" name="Using_getUTCHours">getUTCHours() の使用</h3> + +<p>次の例は、現在時刻の「時」部を変数 <code>hours</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var hours = today.getUTCHours(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutchours', 'Date.prototype.getUTCHours')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCHours")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getHours()")}}</li> + <li>{{jsxref("Date.prototype.setUTCHours()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcmilliseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcmilliseconds/index.html new file mode 100644 index 0000000000..e61d81ae33 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcmilliseconds/index.html @@ -0,0 +1,66 @@ +--- +title: Date.prototype.getUTCMilliseconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCMilliseconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCMilliseconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCMilliseconds()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「ミリ秒」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcmilliseconds.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCMilliseconds()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日時の「ミリ秒」を表す 0 から 999 までの間の整数値。このメソッドは、時間部分、分部分などを提供する他のUTCベースのメソッドのコンパニオンです。このメソッドはミリ秒の部分を与えます。</p> + +<p>Unix 元期の時刻と混同しないでください。1970/01/01からの経過ミリ秒を取得するには、".getTime()" メソッドを使用してください。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCMilliseconds" name="Using_getUTCMilliseconds">getUTCMilliseconds() の使用</h3> + +<p>次の例は、現在時刻の「ミリ秒」部を変数 <code>milliseconds</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var milliseconds = today.getUTCMilliseconds(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcmilliseconds', 'Date.prototype.getUTCMilliseconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCMilliseconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMilliseconds()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcminutes/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcminutes/index.html new file mode 100644 index 0000000000..4c5796b4c8 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcminutes/index.html @@ -0,0 +1,64 @@ +--- +title: Date.prototype.getUTCMinutes() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCMinutes +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCMinutes +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCMinutes()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「分」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcminutes.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCMinutes()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日時の「分」を表す 0 から 59 までの間の整数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCMinutes" name="Using_getUTCMinutes">getUTCMinutes() の使用</h3> + +<p>次の例は、現在時刻の「分」部を変数 <code>minutes</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var minutes = today.getUTCMinutes(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcminutes', 'Date.prototype.getUTCMinutes')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCMinutes")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMinutes()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMinutes()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcmonth/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcmonth/index.html new file mode 100644 index 0000000000..a760e61b01 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcmonth/index.html @@ -0,0 +1,64 @@ +--- +title: Date.prototype.getUTCMonth() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCMonth +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCMonth +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCMonth()</code></strong> メソッドは、協定世界時に基づき、指定された日付の「月」を表す 0 を基点とした値 (すなわち 0 が年の最初の月を示す) を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcmonth.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCMonth()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日付の「月」に相当する 0 から 11 までの間の整数値。0 は 1 月、1 は 2 月、2 は 3 月を表します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_getUTCMonth" name="Using_getUTCMonth">getUTCMonth() の使用</h3> + +<p>次の例は、現在日時の「月」部を変数 <code>month</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var month = today.getUTCMonth(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcmonth', 'Date.prototype.getUTCMonth')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCMonth")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMonth()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMonth()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getutcseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/getutcseconds/index.html new file mode 100644 index 0000000000..2b74bbf53d --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getutcseconds/index.html @@ -0,0 +1,64 @@ +--- +title: Date.prototype.getUTCSeconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/getUTCSeconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getUTCSeconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>getUTCSeconds()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「秒」を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-getutcseconds.html", "shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.getUTCSeconds()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日時の「秒」を表す 0 から 59 までの間の整数値。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="getUTCSeconds_の使用">getUTCSeconds() の使用</h3> + +<p>次の例は、現在日時の「秒」部を変数 <code>seconds</code> に代入します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var seconds = today.getUTCSeconds(); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getutcseconds', 'Date.prototype.getUTCSeconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getUTCSeconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getSeconds()")}}</li> + <li>{{jsxref("Date.prototype.setUTCSeconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/getyear/index.html b/files/ja/web/javascript/reference/global_objects/date/getyear/index.html new file mode 100644 index 0000000000..05637f5e1f --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/getyear/index.html @@ -0,0 +1,108 @@ +--- +title: Date.prototype.getYear() +slug: Web/JavaScript/Reference/Global_Objects/Date/getYear +tags: + - Date + - Deprecated + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/getYear +--- +<div>{{JSRef}} {{deprecated_header}}</div> + +<p><strong><code>getYear()</code></strong> メソッドは、地方時に基づき、指定された日付の「年」を返します。<code>getYear()</code> は完全な桁数の値を返さないため (いわゆる 2000 年問題)、使用されなくなり、{{jsxref("Date.prototype.getFullYear", "getFullYear()")}} メソッドに置き換えられました。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><code><var>dateObj</var>.getYear()</code></pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>地方時に基づき、与えられた日付の「年」を表す数値から1900を引いたものを返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<ul> + <li>2000 年以降の年について、<code>getYear()</code> が返す値は 100 以上です。例えば、2026 年の場合、<code>getYear()</code> は 126 を返します。</li> + <li>1900 年から 1999 年について、<code>getYear()</code> が返す値は 0 から 99 の間です。例えば、1976 年の場合、<code>getYear()</code> は 76 を返します。</li> + <li>1900 年以前の年について、<code>getYear()</code> が返す値は 0 未満です。例えば、1800 年の場合、<code>getYear()</code> は -100 を返します。</li> +</ul> + +<p>2000 年以前と以降に対処するため、<code>getYear()</code> の代わりに、完全な桁数の値を返す {{jsxref("Date.prototype.getFullYear", "getFullYear()")}} を使用するべきです。</p> + +<h2 id="Backward_compatibility" name="Backward_compatibility">後方互換性</h2> + +<h3 id="Behavior_in_JavaScript_1.2_and_earlier" name="Behavior_in_JavaScript_1.2_and_earlier">JavaScript 1.2 以前の動作</h3> + +<p><code>getYear()</code> メソッドは、2 桁または 4 桁の年を返します:</p> + +<ul> + <li>1900 年から 1999 年の間の場合、<code>getYear()</code> が返す値は、year - 1900 です。例えば 1976 年の場合、戻り値は 76 です。</li> + <li>1900 年より前または 1999 年より後の場合、<code>getYear()</code> が返す値は 4 桁の年です。例えば、1856 年の場合、戻り値は 1856 です。2026 年の場合、戻り値は 2026 です。</li> +</ul> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Years_between_1900_and_1999" name="Years_between_1900_and_1999">1900 年から 1999 年の間の年</h3> + +<p>2 行目の文は、変数 <code>year</code> に 95 を代入します。</p> + +<pre class="brush: js notranslate">var Xmas = new Date('December 25, 1995 23:15:00'); +var year = Xmas.getYear(); // 95 を返す +</pre> + +<h3 id="Years_above_1999" name="Years_above_1999">1999 年より後の年</h3> + +<p>2 行目の文は、変数 <code>year</code> に 100 を代入します。</p> + +<pre class="brush: js notranslate">var Xmas = new Date('December 25, 2000 23:15:00'); +var year = Xmas.getYear(); // 100 を返す +</pre> + +<h3 id="Years_below_1900" name="Years_below_1900">1900 年より前の年</h3> + +<p>2 行目の文は、変数 <code>year</code> に -100 を代入します。</p> + +<pre class="brush: js notranslate">var Xmas = new Date('December 25, 1800 23:15:00'); +var year = Xmas.getYear(); // -100 を返す +</pre> + +<h3 id="Setting_and_getting_a_year_between_1900_and_1999" name="Setting_and_getting_a_year_between_1900_and_1999">1900 年から 1999 年の間の年の設定または取得</h3> + +<p>3 行目の文は、変数 <code>year</code> に 1995 年を表す 95 を代入します。</p> + +<pre class="brush: js notranslate">var Xmas = new Date('December 25, 2015 23:15:00'); +Xmas.setYear(95); +var year = Xmas.getYear(); // 95 を返す +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.getYear")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getFullYear()")}}</li> + <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setYear()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/index.html b/files/ja/web/javascript/reference/global_objects/date/index.html new file mode 100644 index 0000000000..a681a241ce --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/index.html @@ -0,0 +1,263 @@ +--- +title: Date +slug: Web/JavaScript/Reference/Global_Objects/Date +tags: + - Class + - Date + - Epoch + - JavaScript + - Time + - Unix Epoch + - timeStamp + - クラス + - 日付 + - 日時 + - 時刻 +translation_of: Web/JavaScript/Reference/Global_Objects/Date +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary">JavaScript の <strong><code>Date</code></strong> オブジェクトは、単一の瞬間の時刻をプラットフォームに依存しない形式で表します。</span> <code>Date</code> オブジェクトは協定世界時 (UTC) の1970年1月1日からの経過ミリ秒数を表現する <code>Number</code> 含んでいます。</p> + +<h2 id="Description" name="Description">解説</h2> + +<h3 id="The_ECMAScript_epoch_and_timestamps" name="The_ECMAScript_epoch_and_timestamps">ECMAScript Epoch とタイムスタンプ</h3> + +<p>JavaScript の日時は、基本的に協定世界時 (UTC) の1970年1月1日深夜0時からの経過ミリ秒数で指定されます。この日付と時刻は、コンピューターに記録される日付と時刻の値の主な基準値である <strong>UNIX Epoch </strong>と同じです。</p> + +<div class="blockIndicator note"> +<p><strong>注:</strong> Date オブジェクトの中心となる時間値は UTC ですが、日付と時刻、またはその一部を取得する基本的なメソッドは、すべて地方時 (ホストシステムなど) のタイムゾーンとオフセットで動作することを覚えておくことが重要です。</p> +</div> + +<p><code>Date</code> の最大値は、確実な整数の最大値 (<code>Number.MAX_SAFE_INTEGER</code>、9,007,199,254,740,991) と同じ値ではないことに注意が必要です。代わりに ECMA-262 では、 UTC の 1970年1月1日から前後 ±100,000,000 (1億) 日 (つまり、紀元前271821年4月20日 - 紀元275760年9月13日) を標準の <code>Date</code> オブジェクトで表すことができると定義しています。</p> + +<h3 id="Date_format_and_time_zone_conversions" name="Date_format_and_time_zone_conversions">日時形式とタイムゾーンの変換</h3> + +<p>様々な形式で日時を取得したり、タイムゾーンの変換を行ったりすることができる方法はたくさんあります。特に便利なのは、<ruby>世界時標準<rp> (</rp><rt>World Time Standard</rt><rp>) </rp></ruby>で定義されている世界標準時である協定世界時 (UTC) で日付と時刻を出力する関数です。 (この時間は歴史的に<em>グリニッジ標準時</em>として知られており、 UTC はイギリスのロンドンとその近くのグリニッジを含む子午線に沿って位置しています。) ユーザーの端末は現地時間を提供します。</p> + +<p>地方時の日付と時刻の個々の部分を読み書きするメソッド ({{jsxref("Date.getDay", "getDay()")}} や {{jsxref("Date.setHours", "setHours()")}} など) に加えて、 UTC を使用して日付と時刻を読み書きする同等のメソッド ({{jsxref("Date.getUTCDay()", "getUTCDay()")}} や {{jsxref("Date.setUTCHours", "setUTCHours()")}} など) もあります。</p> + +<h2 id="Constructor" name="Constructor">コンストラクター</h2> + +<dl> + <dt>{{jsxref("Date/Date", "Date()")}}</dt> + <dd>新たな <code>Date</code> オブジェクトを生成します。</dd> +</dl> + +<h2 id="Static_methods" name="Static_methods">静的メソッド</h2> + +<dl> + <dt>{{jsxref("Date.now()")}}</dt> + <dd>現在の時刻に対応する数値、すなわち UTC の 1970 年 1 月 1 日 00:00:00 から経過したミリ秒 (閏秒は無視) を表す数値を返します。</dd> + <dt>{{jsxref("Date.parse()")}}</dt> + <dd>JavaScript で日付を表す文字列を解釈して、地方時で 1970 年 1 月 1 日 00:00:00 から経過したミリ秒 (閏秒は無視) を表す数値を返します。 + <div class="note"> + <p><strong>注:</strong> ブラウザーごとに動作が異なり一貫性がないため、 <code>Date.parse</code> で文字列を解釈しないように強くすすめます。</p> + </div> + </dd> + <dt>{{jsxref("Date.UTC()")}}</dt> + <dd>コンストラクターですべての引数を与えて呼び出したのと同じように、 UTC の 1970 年 1 月 1 日 00:00:00 から経過したミリ秒数 (閏秒は無視) を返します。</dd> +</dl> + +<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> + +<dl> + <dt>{{jsxref("Date.prototype.getDate()")}}</dt> + <dd>地方時に基づき、指定された日時の「日」 (<code>1</code>–<code>31</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getDay()")}}</dt> + <dd>地方時に基づき、指定された日時の「曜日」 (<code>0</code>–<code>6</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getFullYear()")}}</dt> + <dd>地方時に基づき、指定された日時の「年」 (4桁の年であれば4桁) を返します。</dd> + <dt>{{jsxref("Date.prototype.getHours()")}}</dt> + <dd>地方時に基づき、指定された日時の「時」 (<code>0</code>–<code>23</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getMilliseconds()")}}</dt> + <dd>地方時に基づき、指定された日時の「ミリ秒」 (<code>0</code>–<code>999</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getMinutes()")}}</dt> + <dd>地方時に基づき、指定された日時の「分」 (<code>0</code>–<code>59</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getMonth()")}}</dt> + <dd>地方時に基づき、指定された日時の「月」 (<code>0</code>–<code>11</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getSeconds()")}}</dt> + <dd>地方時に基づき、指定された日時の「秒」 (<code>0</code>–<code>59</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getTime()")}}</dt> + <dd>指定された日時を協定世界時 (UTC) の 1970 年 1 月 1 日 00:00:00 からの経過ミリ秒単位の数値で返します。 (それ以前の時刻では負の数を返します。)</dd> + <dt>{{jsxref("Date.prototype.getTimezoneOffset()")}}</dt> + <dd>現地の時間帯のオフセットを分で返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCDate()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「日」 (<code>1</code>–<code>31</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCDay()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「曜日」 (<code>0</code>–<code>6</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCFullYear()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「年」 (4桁の年であれば4桁) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCHours()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「時」 (<code>0</code>–<code>23</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「ミリ秒」 (<code>0</code>–<code>999</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCMinutes()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「分」 (<code>0</code>–<code>59</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCMonth()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「月」 (<code>0</code>–<code>11</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getUTCSeconds()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「秒」 (<code>0</code>–<code>59</code>) を返します。</dd> + <dt>{{jsxref("Date.prototype.getYear()")}}</dt> + <dd>地方時に基づき、指定された日時の「年」 (ふつうは2–3桁) を返します。代わりに {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}} を使用してください。</dd> + <dt>{{jsxref("Date.prototype.setDate()")}}</dt> + <dd>地方時に基づき、指定された日時の「日」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setFullYear()")}}</dt> + <dd>地方時に基づき、指定された日時の「年」を完全な形 (例えば、4桁の年であれば4桁) で設定します。</dd> + <dt>{{jsxref("Date.prototype.setHours()")}}</dt> + <dd>地方時に基づき、指定された日時の「時」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setMilliseconds()")}}</dt> + <dd>地方時に基づき、指定された日時の「ミリ秒」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setMinutes()")}}</dt> + <dd>地方時に基づき、指定された日時の「分」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setMonth()")}}</dt> + <dd>地方時に基づき、指定された日時の「月」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setSeconds()")}}</dt> + <dd>地方時に基づき、指定された日時の「秒」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setTime()")}}</dt> + <dd>{{jsxref("Date")}} オブジェクトを協定世界時(UTC) の 1970 年 1 月 1 日 00:00:00 からのミリ秒単位の数で表された時刻に設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCDate()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「日」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCFullYear()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「年」を完全な形で設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCHours()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「時」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「ミリ秒」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCMinutes()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「分」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCMonth()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「月」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setUTCSeconds()")}}</dt> + <dd>協定世界時に基づき、指定された日時の「秒」を設定します。</dd> + <dt>{{jsxref("Date.prototype.setYear()")}}</dt> + <dd>協定地方時に基づき、指定された日時の「年」 (ふつうは2–3桁) を設定します。代わりに {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}} を使用してください。</dd> + <dt>{{jsxref("Date.prototype.toDateString()")}}</dt> + <dd>{{jsxref("Date")}} の「日付」部を、 'Thu Apr 12 2018' のように人間が読みやすい形式の文字列にして返します。</dd> + <dt>{{jsxref("Date.prototype.toISOString()")}}</dt> + <dd>日付を ISO 8601 Extended Format に準じた文字列に変換します。</dd> + <dt>{{jsxref("Date.prototype.toJSON()")}}</dt> + <dd>{{jsxref("Date.prototype.toISOString()", "toISOString()")}} を使用して {{jsxref("Date")}} を表す文字列を返します。{{jsxref("JSON.stringify()")}} の代わりに使用してください。</dd> + <dt>{{jsxref("Date.prototype.toGMTString()")}}</dt> + <dd>GMT (UTC) タイムゾーンを基準にした {{jsxref("Date")}} を表す文字列を返します。代わりに {{jsxref("Date.prototype.toUTCString()", "toUTCString()")}} を使用してください。</dd> + <dt>{{jsxref("Date.prototype.toLocaleDateString()")}}</dt> + <dd>システム設定の日時の「日付」部を、地域の日付書式に従った文字列に変換して返します。</dd> + <dt>{{jsxref("Date.prototype.toLocaleFormat()")}}</dt> + <dd>書式化された文字列を使って、日時を文字列に変換します。</dd> + <dt>{{jsxref("Date.prototype.toLocaleString()")}}</dt> + <dd>日付を地域の日付書式に従った文字列に変換して返します。{{jsxref("Object.prototype.toLocaleString()")}} メソッドを上書きします。</dd> + <dt>{{jsxref("Date.prototype.toLocaleTimeString()")}}</dt> + <dd>システム設定の日時の「時刻」部を、地域の日付書式に従った文字列に変換して返します。</dd> + <dt>{{jsxref("Date.prototype.toString()")}}</dt> + <dd>指定された {{jsxref("Date")}} オブジェクトを表す文字列を返します。 {{jsxref("Object.prototype.toString()")}} メソッドを上書きします。</dd> + <dt>{{jsxref("Date.prototype.toTimeString()")}}</dt> + <dd>{{jsxref("Date")}} の「時刻」部を人間が読みやすい形式の文字列にして返します。</dd> + <dt>{{jsxref("Date.prototype.toUTCString()")}}</dt> + <dd>日時を UTC タイムゾーンを使用する文字列に変換します。</dd> + <dt>{{jsxref("Date.prototype.valueOf()")}}</dt> + <dd>{{jsxref("Date")}} オブジェクトのプリミティブ値を返します。{{jsxref("Object.prototype.valueOf()")}} メソッドを上書きします。</dd> +</dl> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Several_ways_to_create_a_Date_object" name="Several_ways_to_create_a_Date_object">Date オブジェクトを生成するいくつかの方法</h3> + +<p>以下の例で、 JavaScript の日時を生成するいくつかの方法を示します。</p> + +<div class="note"> +<p><strong>注:</strong> <code>Date</code> コンストラクター (または同等の <code>Date.parse</code>) で日付文字列を解釈することは、ブラウザーごとに動作が異なり一貫性がないため、避けるように強くすすめます。</p> +</div> + +<pre class="brush: js notranslate">let today = new Date() +let birthday = new Date('December 17, 1995 03:24:00') +let birthday = new Date('1995-12-17T03:24:00') +let birthday = new Date(1995, 11, 17) // 月は 0 起点 +let birthday = new Date(1995, 11, 17, 3, 24, 0) +</pre> + +<h3 id="Two_digit_years_map_to_1900_–_1999" name="Two_digit_years_map_to_1900_–_1999">2桁の年は1900–1999年に対応付けられる</h3> + +<p>西暦 0 年から 99 年までの間の年を生成および取得するには、{{jsxref("Date.prototype.setFullYear()")}} メソッドと {{jsxref("Date.prototype.getFullYear()")}} メソッドを使用してください。</p> + +<pre class="brush: js notranslate">var date = new Date(98, 1); // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT) + +// 非推奨のメソッド。この 98 は1998年に対応付けられます。 +date.setYear(98) // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT) + +date.setFullYear(98) // Sat Feb 01 0098 00:00:00 GMT+0000 (BST) +</pre> + +<h3 id="Calculating_elapsed_time" name="Calculating_elapsed_time">経過時間の計算</h3> + +<p>以下の例で、2 つの JavaScript の日付の間で経過した時間を計る方法を示します。</p> + +<p>日 (サマータイム切り替えによる)、月、年の長さが異なるため、経過時間を時、分、秒以上の単位で表現するには、いくつかの問題に対処する必要がありますので、事前によく調べて使用してください。</p> + +<pre class="brush: js notranslate">// Date オブジェクトを使用 +let start = Date.now() + +// 時間を計りたいイベントをここに置く: +doSomethingForALongTime() +let end = Date.now() +var elapsed = end - start // ミリ秒単位の経過時間 +</pre> + +<pre class="brush: js notranslate">// 組み込みメソッドを使用 +var start = new Date() + +// 時間を計りたいイベントをここに置く +doSomethingForALongTime() +let end = new Date() +let elapsed = end.getTime() - start.getTime() // ミリ秒単位の経過時間 +</pre> + +<pre class="brush: js notranslate">// 関数をテストして戻り値を取得する +function printElapsedTime(fTest) { + let nStartTime = Date.now(), + vReturn = fTest(), + nEndTime = Date.now() + + console.log(`Elapsed time: ${ String(nEndTime - nStartTime) } milliseconds`) + return vReturn +} + +let yourFunctionReturn = printElapsedTime(yourFunction) +</pre> + +<div class="note"> +<p><strong>注:</strong> {{domxref("Window.performance", "Web Performance API", "", 1)}} の高精度時刻機能に対応しているブラウザーでは、 {{domxref("Performance.now()")}} で、 {{jsxref("Date.now()")}} よりも高信頼かつ高精度な経過時間の測定が可能です。</p> +</div> + +<h3 id="Get_the_number_of_seconds_since_the_ECMAScript_Epoch" name="Get_the_number_of_seconds_since_the_ECMAScript_Epoch">ECMAScript Epoch からの経過秒数を取得する</h3> + +<pre class="brush: js notranslate">let seconds = Math.floor(Date.now() / 1000) +</pre> + +<p>この場合、整数だけを返すことが重要です (単純な除算ではできません)。また、実際に経過した秒数を返すことも重要です (ですから、上の例では {{jsxref("Math.round()")}} ではなく {{jsxref("Math.floor()")}} を使っています)。</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date-objects', 'Date')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date", 3)}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date/Date", "Date()")}} constructor</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/now/index.html b/files/ja/web/javascript/reference/global_objects/date/now/index.html new file mode 100644 index 0000000000..d94036a2ad --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/now/index.html @@ -0,0 +1,86 @@ +--- +title: Date.now() +slug: Web/JavaScript/Reference/Global_Objects/Date/now +tags: + - Date + - JavaScript + - Method + - Reference + - polyfill +translation_of: Web/JavaScript/Reference/Global_Objects/Date/now +--- +<div>{{JSRef}}</div> + +<p><strong><code>Date.now()</code></strong> メソッドは、UTC (協定世界時) での 1970 年 1 月 1 日 0 時 0 分 0 秒 から現在までの経過時間をミリ秒単位で返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-now.html")}}</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate">var <var>timeInMs</var> = Date.now();</pre> + +<h3 id="Return_value">Return value</h3> + +<p>UNIX 元期からの経過時間をミリ秒単位で表す{{jsxref("Number", "数値")}}。</p> + +<h2 id="Polyfill" name="Polyfill">Polyfill</h2> + +<p>このメソッドは ECMA-262 第 5 版で標準化されました。このメソッドに対応するよう更新されていないエンジンでは、次の互換コードを使用することにより、実装の欠落を補うことができます。</p> + +<pre class="brush: js notranslate">if (!Date.now) { + Date.now = function now() { + return new Date().getTime(); + }; +} +</pre> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Reduced_time_precision" name="Reduced_time_precision">時刻の低精度化</h3> + +<p>ブラウザーの設定によっては、タイミング攻撃と Fingerprinting に対する保護を提供するために <code>new Date().getTime()</code> の精度が落とされていることがあります。<br> + Firefox では、<code>privacy.reduceTimerPrecision</code> が既定で有効になっています。既定値は Firefox 59 では 20 マイクロ秒で、 Firefox 60 では 2 ミリ秒です。</p> + +<pre class="brush: js notranslate">// Firefox 60 での時刻の精度の低下（2 ミリ秒） +Date.now() +// 1519211809934 +// 1519211810362 +// 1519211811670 +// ... + + +// `privacy.resistFingerprinting` が有効な場合の時刻の精度の低下 +Date.now(); +// 1519129853500 +// 1519129858900 +// 1519129864400 +// ... +</pre> + +<p>Firefox では、 <code>privacy.resistFingerprinting</code> も有効にできます。この場合、精度は 100 ミリ秒と <code>privacy.resistFingerprinting.reduceTimerPrecision.microseconds</code> 値のうち大きい方になります。</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.now', 'Date.now')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.now")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{domxref("Performance.now()")}} — ウェブページのパフォーマンス測定のための、ミリ秒以下の分解能を持つタイムスタンプを提供</li> + <li>{{domxref("console.time()")}} / {{domxref("console.timeEnd()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/parse/index.html b/files/ja/web/javascript/reference/global_objects/date/parse/index.html new file mode 100644 index 0000000000..5de3118e54 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/parse/index.html @@ -0,0 +1,199 @@ +--- +title: Date.parse() +slug: Web/JavaScript/Reference/Global_Objects/Date/parse +tags: + - Date + - JavaScript + - Method + - Reference + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/Date/parse +--- +<div>{{JSRef}}</div> + +<p><strong><code>Date.parse()</code></strong> メソッドは、日時を表す文字列を解釈し、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からの経過時間を表すミリ秒単位の数値を返します。または、文字列を解釈できなかったり不正な日付 (例えば 2015-02-31) が指定された場合 <code>NaN</code> を返します。</p> + +<p>ES5 に準拠して実装されるまで <code>Date.parse</code> の使用は推奨されません。文字列の解釈は全体的に実装依存です。これらには多くの異なる実装があり、文字列の解釈が異なることがあるため、日付の文字列は手動で解釈するべきです (多くの異なる書式に対応したライブラリの使用が助けになるでしょう)。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-parse.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<p>直接呼び出し:</p> + +<pre class="syntaxbox">Date.parse(<var>dateString</var>) +</pre> + +<p>暗黙の呼び出し:</p> + +<pre class="syntaxbox">new Date(<var>dateString</var>) +</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>dateString</var></code></dt> + <dd><a href="http://tools.ietf.org/html/rfc2822#section-3.3">RFC2822</a> または (派生の) ISO 8601 の日付を表す文字列。 (他の書式も使用することができますが、結果は実装依存になります。)</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 UTC からの経過時間をミリ秒単位で表す数値。このメソッドに与えられた日付を表す文字列の解釈により取得される日付。引数に正しい値が与えられない場合、 {{jsxref("NaN")}} を返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>parse()</code> メソッドは、日時の文字列 (例えば "<code>2011-10-10T14:48:00</code>") を取り、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からのミリ秒単位の経過時間を表す数値を返します。</p> + +<p>この関数は、例えば {{jsxref("Date.prototype.setTime()", "setTime()")}} メソッドと {{jsxref("Global_Objects/Date", "Date")}} オブジェクトを組み合わせて使う場合など、文字列値を基にして日時の値を設定するときに有用です。。</p> + +<h3 id="Date_Time_String_Format" name="Date_Time_String_Format">日付と時刻の文字列書式</h3> + +<p>日時文字列の標準的な文字列表現は、 ISO 8601 のカレンダー日付拡張形式を簡略化したものです。 (詳しくは、 ECMAScript 仕様書の <a href="https://tc39.github.io/ecma262/#sec-date-time-string-format">Date Time String Format</a> の章を参照してください。)</p> + +<p>例えば, "<code>2011-10-10</code>" (<em>日付のみ</em>の形式), "<code>2011-10-10T14:48:00</code>" (<em>日時</em>形式), "<code>2011-10-10T14:48:00.000+09:00</code>" (<em>日時</em>形式にミリ秒とタイムゾーンがついたもの) を渡し、解釈することができます。タイムゾーンのオフセットがない場合は、日付のみの形式では UTC 時刻と解釈され、日時形式では地方時として解釈されます。</p> + +<p>タイムゾーン指定子は、日付文字列の解析中に引数を解釈するために使用されますが、返される値は常に、 1970 年 1 月 1 日 00:00:00:00 UTC と、引数で表される時点との間のミリ秒数または <code>NaN</code> です。</p> + +<p><code>parse()</code> は {{jsxref("Date")}} の静的メソッドですので、 {{jsxref("Date")}} のメソッドとしてではなく <code>Date.parse()</code> として呼び出されます。</p> + +<h3 id="Fall-back_to_implementation-specific_date_formats" name="Fall-back_to_implementation-specific_date_formats">実装依存の日付形式へのフォールバック</h3> + +<div class="blockIndicator note"> +<p>この節では実装依存の動作を説明しており、実装間で一貫性がない可能性があります。</p> +</div> + +<p>ECMAScript 仕様書は、文字列が標準の書式に準拠していない場合、この関数は実装固有の検出方法や実装固有の解析アルゴリズムにフォールバックすることがあり、解釈できない文字列や ISO 書式文字列における不正な要素値を含む日付を渡すと、 <code>Date.parse()</code> が {{jsxref("NaN")}} を返すと既定しています。</p> + +<p>しかし、 ECMA-262 で定義されている簡略化 ISO 書式として解釈できない日付文字列の無効な値は、ブラウザーや与えられた値に依存して、 {{jsxref("NaN")}} を返したり返さなかったりすることがあります。次の例を参照してください。</p> + +<pre class="brush: js">// 不正な値を持つ 非 ISO 文字列 +new Date('23/25/2014'); +</pre> + +<p>これは、 Firefox 30 では、地方時の 2015 年 11 月 25 日として扱われ、 Safari 7 では不正な値として処理されます。</p> + +<p>しかし、文字列が ISO 書式の文字列として解釈され、不正な値を含む場合、 ES5 以降の仕様に準拠するすべてのブラウザーが {{jsxref("NaN")}} を返します。</p> + +<pre class="brush: js">// 不正な値を持つ ISO 文字列 +new Date('2014-25-23').toISOString(); +// ES5 準拠のすべてのブラウザーが "RangeError: invalid date" を返す +</pre> + +<p>SpiderMonkey の実装特有のヒューリスティックは、<a href="https://dxr.mozilla.org/mozilla-central/source/js/src/jsdate.cpp?rev=64553c483cd1#889"><code>jsdate.cpp</code></a> にあります。 "<code>10 06 2014</code>" の文字列は、非 ISO 書式の例として挙げられており、このようにカスタム処理にフォールバックされます。この解釈の動作を説明する<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1023155#c6">およそのアウトライン</a> も参照してください。</p> + +<pre class="brush: js">new Date('10 06 2014'); +</pre> + +<p>これは、2014 年 6 月 10 日ではなく、地方時の 2014 年 10 月 6 日 として扱われます。</p> + +<p>他の例です。</p> + +<pre class="brush: js">new Date('foo-bar 2014').toString(); +// 返値: "Invalid Date" + +Date.parse('foo-bar 2014'); +// 返値: NaN +</pre> + +<h3 id="Differences_in_assumed_time_zone" name="Differences_in_assumed_time_zone">想定されるタイムゾーンの違い</h3> + +<div class="blockIndicator note"> +<p>この節では実装依存の動作を説明しており、実装間で一貫性がない可能性があります。</p> +</div> + +<p>標準外の日付文字列である "<code>March 7, 2014</code>" を渡すと、 <code>parse()</code> はタイムゾーンとして地方時を想定しますが、 "<code>2014-03-07</code>" のような ISO 書式を与えると UTC をタイムゾーンとして想定します (ES5 および ECMAScript 2015 の仕様)。したがって、これらの文字列を使用して生成される {{jsxref("Date")}}} オブジェクトは、システムが UTC の地方時に設定されていない限り、対応している ECMAScript のバージョンによって異なる時刻を表す可能性があります。つまり、同じように見える 2 つの日付文字列が、変換される文字列の形式によって 2 つの異なる値になる可能性があるということです。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_Date.parse" name="Using_Date.parse">Using <code>Date.parse()</code> の使用</h3> + +<p>以下の呼び出しはすべて <code>1546300800000</code> を返します。最初のものは ES5 によれば UTC 時刻を意味し、それ以外は ISO 日付仕様 (<code>Z</code> および <code>+00:00</code>) に従って UTC をタイムゾーンを指定しています。</p> + +<pre class="brush: js">Date.parse("2019-01-01") +Date.parse("2019-01-01T00:00:00.000Z") +Date.parse("2019-01-01T00:00:00.000+00:00") +</pre> + +<p>以下の呼び出しではタイムゾーンを指定していないので、システムの地方時で 2019-01-01 の 00:00:00 に設定されます。</p> + +<pre class="brush: js">Date.parse("2019-01-01T00:00:00") +</pre> + +<h3 id="Non-standard_date_strings" name="Non-standard_date_strings">標準外の日付文字列</h3> + +<div class="blockIndicator note"> +<p>この節では実装依存の動作を説明しており、実装間で一貫性がない可能性があります。</p> +</div> + +<p><code>IPOdate</code> が既存の {{jsxref("Date")}} オブジェクトならば、次のようにして、これを 1995 年 8 月 9 日 (地方時) にセットできます:</p> + +<pre class="brush: js">IPOdate.setTime(Date.parse('Aug 9, 1995')); +</pre> + +<p>それ以外の標準外の日付文字列の解釈の例を示します。</p> + +<pre class="brush: js">Date.parse('Aug 9, 1995'); +</pre> + +<p>GMT-0300 のタイムゾーンでは <code>807937200000</code> を返し、他のタイムゾーンでは他の値を返します。タイムゾーンが指定されておらず ISO 書式でないため、既定で地方時のタイムゾーンが使用されます。</p> + +<pre class="brush: js">Date.parse('Wed, 09 Aug 1995 00:00:00 GMT'); +</pre> + +<p>GMT (UTC) が指定されているため、地方時のタイムゾーンに関係なく <code>807926400000</code> を返します。</p> + +<pre class="brush: js">Date.parse('Wed, 09 Aug 1995 00:00:00'); +</pre> + +<p>GMT-0300 のタイムゾーンでは <code>807937200000</code> を返し、他のタイムゾーンでは他の値を返します。引数にタイムゾーンが指定されておらず、 ISO 書式ではないため、地方時として扱われます。</p> + +<pre class="brush: js">Date.parse('Thu, 01 Jan 1970 00:00:00 GMT'); +</pre> + +<p>GMT (UTC) のタイムゾーンが指定されているため、地方時のタイムゾーンに関係なく <code>0</code> を返します。</p> + +<pre class="brush: js">Date.parse('Thu, 01 Jan 1970 00:00:00'); +</pre> + +<p>GMT-0400 のタイムゾーンでは <code>14400000</code> を返し、他のタイムゾーンでは他の値を返します。タイムゾーンが指定されておらず、 ISO 書式ではないため、地方時のタイムゾーンが使用されます。</p> + +<pre class="brush: js">Date.parse('Thu, 01 Jan 1970 00:00:00 GMT-0400'); +</pre> + +<p>GMT (UTC) のタイムゾーンが指定されているため、地方時のタイムゾーンに関係なく <code>14400000</code> を返します。</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.parse', 'Date.parse')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.parse")}}</p> + +<h3 id="Compatibility_notes" name="Compatibility_notes">互換性ノート</h3> + +<ul> + <li>Firefox 49 {{geckoRelease(49)}} で、2 桁の「年」の解釈が、 Internet Explorer に代わって Google Chrome ブラウザーに準拠するように変更されました。現在、 <code>50</code> 以下の 2 桁の「年」は 21 世紀の年として解釈されます。例えば <code>04/16/17</code> は、以前は 1917 年 4 月 16 日と解釈されていましたが、 2017 年 4 月 16 日と解釈されるようになりました。相互運用性の問題や年があいまいになることを回避するには、 ISO 8601 書式 ("<code>2017-04-16</code>" など) の使用が推奨されます (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1265136">bug 1265136</a>)。</li> + <li>Google Chrome は数値の文字列を有効な <code><em>dateString</em></code> 引数として受け付けます。これは、すなわち、 <code>!!Date.parse("42")</code> は Firefox では <code>false</code> として評価されるのに対して、 Google Chrome では <code>true</code> として評価されます。 "<code>42</code>" は 2042 年 1 月 1 日と解釈されるからです。</li> +</ul> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.UTC()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setdate/index.html b/files/ja/web/javascript/reference/global_objects/date/setdate/index.html new file mode 100644 index 0000000000..9042106ce6 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setdate/index.html @@ -0,0 +1,82 @@ +--- +title: Date.prototype.setDate() +slug: Web/JavaScript/Reference/Global_Objects/Date/setDate +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setDate +--- +<div>{{JSRef}}</div> + +<p><strong><code>setDate()</code></strong> メソッドは、現在設定されている月から始まる {{jsxref("Date")}} オブジェクトの「日」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setdate.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setDate(<var>dayValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>dayValue</var></code></dt> + <dd>「日」を表す整数の値です。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から与えられた日付までの間のミリ秒単位の数値 ({{jsxref("Date")}} オブジェクトも適切に変更されます)。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>dayValue</var></code> がその月の日付の範囲外の値の場合、それに応じて <code>setDate()</code> が {{jsxref("Date")}} オブジェクトを更新します。</p> + +<p>例えば、<code><var>dayValue</var></code> に 0 を与えた場合、日付は前月の最終日に設定されます。</p> + +<p><code><var>dayValue</var></code> に負の数を指定すると、前月の最終日から逆算して日付が設定されます。 -1の場合、日付は前月の最終日の1日前に設定されます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setDate" name="Using_setDate">setDate() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(1962, 6, 7); // 1962-07-07 (7th of July 1962) +theBigDay.setDate(24); // 1962-07-24 (24th of July 1962) +theBigDay.setDate(32); // 1962-08-01 (1st of August 1962) +theBigDay.setDate(22); // 1962-08-22 (22th of August 1962) +theBigDay.setDate(0); // 1962-07-31 (31th of July 1962) +theBigDay.setDate(98); // 1962-10-06 (6th of October 1962) +theBigDay.setDate(-50); // 1962-08-11 (11th of August 1962) +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setdate', 'Date.prototype.setDate')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setDate")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getDate()")}}</li> + <li>{{jsxref("Date.prototype.setUTCDate()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setfullyear/index.html b/files/ja/web/javascript/reference/global_objects/date/setfullyear/index.html new file mode 100644 index 0000000000..5c4a299589 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setfullyear/index.html @@ -0,0 +1,80 @@ +--- +title: Date.prototype.setFullYear() +slug: Web/JavaScript/Reference/Global_Objects/Date/setFullYear +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setFullYear +--- +<div>{{JSRef}}</div> + +<p><strong><code>setFullYear()</code></strong> メソッドは、地方時に基づき、指定された日付の「年」を設定します。新しいタイムスタンプを返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setfullyear.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setFullYear(<var>yearValue</var>[, <var>monthValue</var>[, <var>dateValue</var>]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>yearValue</var></code></dt> + <dd>「年」の数字を指定する整数値。例えば、1995。</dd> + <dt><code><var>monthValue</var></code></dt> + <dd>任意。1 月から 12 月を表す 0 から 11 までの間の整数値。</dd> + <dt><code><var>dateValue</var></code></dt> + <dd>「日」を表す 1 から 31 までの間の整数値。<code><var>dateValue</var></code> 引数を指定した場合、<code><var>monthValue</var></code> も指定しなければなりません。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日付までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>monthValue</var></code> 引数と <code><var>dateValue</var></code> 引数を指定しない場合、{{jsxref("Date.prototype.getUTCMonth()", "getUTCMonth()")}} メソッドと {{jsxref("Date.prototype.getUTCDate()", "getUTCDate()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setFullYear()</code> が他の引数と {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>monthValue</var></code> に 15 を指定した場合、年に 1 が加算 (<code><var>yearValue</var> + 1</code>) され、月が 3 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setFullYear" name="Using_setFullYear">setFullYear() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setFullYear(1997); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setfullyear', 'Date.prototype.setFullYear')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setFullYear")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setYear()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/sethours/index.html b/files/ja/web/javascript/reference/global_objects/date/sethours/index.html new file mode 100644 index 0000000000..d66c6dfeb3 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/sethours/index.html @@ -0,0 +1,85 @@ +--- +title: Date.prototype.setHours() +slug: Web/JavaScript/Reference/Global_Objects/Date/setHours +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setHours +--- +<div>{{JSRef}}</div> + +<p><strong><code>setHours()</code></strong> メソッドは、地方時に基づき、指定された日付の「時」を設定し、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された {{jsxref("Date")}} インスタンスが表す時刻までの間のミリ秒単位の数値を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-sethours.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setHours(<var>hoursValue</var>[, <var>minutesValue</var>[, <var>secondsValue</var>[, <var>msValue</var>]]])</pre> + +<h3 id="JavaScript_1.3_以前">JavaScript 1.3 以前</h3> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setHours(<var>hoursValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>hoursValue</var></code></dt> + <dd>理想的には、「時」を表す 0 から 23 までの間の整数値です。23よりも大きな値が指定された場合は、日時は追加の時間数だけ増加します。</dd> + <dt><code><var>minutesValue</var></code></dt> + <dd>任意。理想的には、「分」を表す 0 から 59 までの間の整数値です。59よりも大きな値が指定された場合は、日時は追加の分数だけ増加します。</dd> + <dt><code><var>secondsValue</var></code></dt> + <dd>任意。理想的には、「秒」を表す 0 から 59 までの間の整数値です。59より大きな値が指定された場合は、日時は追加の秒数だけ増加します。<code><var>secondsValue</var></code> 引数を指定した場合は、<code><var>minutesValue</var></code> も指定しなければなりません。</dd> + <dt><code><var>msValue</var></code></dt> + <dd>任意。理想的には、ミリ秒を表す 0 から 999 までの間の整数値です。999よりも大きな値が指定された場合は、日時は追加のミリ秒数だけ増加します。<code><var>msValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> と <code><var>secondsValue</var></code> も指定しなければなりません。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>minutesValue</var></code>, <code><var>secondsValue</var></code> および <code><var>msValue</var></code> 引数を指定しなかった場合、{{jsxref("Date.prototype.getMinutes()", "getMinutes()")}} と {{jsxref("Date.prototype.getSeconds()", "getSeconds()")}}、{{jsxref("Date.prototype.getMilliseconds()", "getMilliseconds()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setHours()</code> が他の引数と {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>secondsValue</var></code> に 100 を指定した場合、分に 1 加算 (<code><var>minutesValue</var> + 1</code>) され、秒が 40 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setHours" name="Using_setHours">setHours() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setHours(7); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.sethours', 'Date.prototype.setHours')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setHours")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getHours()")}}</li> + <li>{{jsxref("Date.prototype.setUTCHours()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setmilliseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/setmilliseconds/index.html new file mode 100644 index 0000000000..4596840365 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setmilliseconds/index.html @@ -0,0 +1,73 @@ +--- +title: Date.prototype.setMilliseconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/setMilliseconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMilliseconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>setMilliseconds()</code></strong> メソッドは、地方時に基づき、指定された日時の「ミリ秒」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setmilliseconds.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setMilliseconds(<var>millisecondsValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>millisecondsValue</var></code></dt> + <dd>「ミリ秒」を表す 0 から 999 までの間の整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、1005 を指定した場合、秒の数値が 1 加算され、ミリ秒に 5 が使用されます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setMilliseconds" name="Using_setMilliseconds">setMilliseconds() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setMilliseconds(100); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setmilliseconds', 'Date.prototype.setMilliseconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setMilliseconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMilliseconds()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setminutes/index.html b/files/ja/web/javascript/reference/global_objects/date/setminutes/index.html new file mode 100644 index 0000000000..b1763e6d23 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setminutes/index.html @@ -0,0 +1,83 @@ +--- +title: Date.prototype.setMinutes() +slug: Web/JavaScript/Reference/Global_Objects/Date/setMinutes +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMinutes +--- +<div>{{JSRef}}</div> + +<p><strong><code>setMinutes()</code></strong> メソッドは、地方時に基づき、指定された日時の「分」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setminutes.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setMinutes(<var>minutesValue</var>[, <var>secondsValue</var>[, <var>msValue</var>]])</pre> + +<h3 id="Versions_prior_to_JavaScript_1.3" name="Versions_prior_to_JavaScript_1.3">JavaScript 1.3 より前のバージョン</h3> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setMinutes(<var>minutesValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>minutesValue</var></code></dt> + <dd>「分」を表す 0 から 59 までの間の整数値。</dd> + <dt><code><var>secondsValue</var></code></dt> + <dd>任意。「秒」を表す 0 から 59 までの間の整数値。<code><var>secondsValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> も指定しなければなりません。</dd> + <dt><code><var>msValue</var></code></dt> + <dd>任意。ミリ秒を表す 0 から 999 までの間の整数値。<code><var>msValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> と <code><var>secondsValue</var></code> も指定しなければなりません。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>secondsValue</var></code> および <code><var>msValue</var></code> 引数を指定しない場合、{{jsxref("Date.prototype.getSeconds()", "getSeconds()")}} と {{jsxref("Date.prototype.getMilliseconds()", "getMilliseconds()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日時の範囲外の場合、それに応じて <code>setMinutes()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>secondsValue</var></code> に 100 を指定した場合、分に 1 が加算 (<code><var>minutesValue</var> + 1</code>) され、秒が 40 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setMinutes" name="Using_setMinutes">setMinutes() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setMinutes(45); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setminutes', 'Date.prototype.setMinutes')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setMinutes")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMinutes()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMinutes()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setmonth/index.html b/files/ja/web/javascript/reference/global_objects/date/setmonth/index.html new file mode 100644 index 0000000000..81caf3b8ec --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setmonth/index.html @@ -0,0 +1,86 @@ +--- +title: Date.prototype.setMonth() +slug: Web/JavaScript/Reference/Global_Objects/Date/setMonth +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setMonth +--- +<div>{{JSRef}}</div> + +<p><strong><code>setMonth()</code></strong> メソッドは、現在設定されている年に基づき、指定された日付の「月」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setmonth.html")}}</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setMonth(<var>monthValue</var>[, <var>dayValue</var>])</pre> + +<h3 id="Versions_prior_to_JavaScript_1.3" name="Versions_prior_to_JavaScript_1.3">JavaScript 1.3 より前のバージョン</h3> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setMonth(<var>monthValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>monthValue</var></code></dt> + <dd>0から始まる整数値で、年の始まりからの月のオフセットを表します。そのため、0 は 1 月を表し、 11 は 12 月を表し、 12 は次の年の 1 月を表します。</dd> + <dt><code>dayValue</code></dt> + <dd>任意。「日」を表す 1 から 31 までの間の整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>dayValue</var></code> 引数を指定しなかった場合、{{jsxref("Date.prototype.getDate()", "getDate()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setMonth()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>monthValue</var></code> に 15 を指定した場合、年に 1 が加算され、月が 3 になります。</p> + +<p>このメソッドの動作は、ある特定の月の日にちに影響を与えます。概念上は、その月の日数を、引数として与えた新しい月の初日に加え、新しい日付を返します。例えば、現在の値が 2016 年 8 月 31 日である場合、1 を引数として setMonth を呼び出すと 2016 年 3 月 2 日が返ってきます。これは、2016 年の 2 月が 29 日間しかないからです。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setMonth" name="Using_setMonth">setMonth() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setMonth(6); + +//Watch out for end of month transitions +var endOfMonth = new Date(2016, 7, 31); +endOfMonth.setMonth(1); +console.log(endOfMonth); //Wed Mar 02 2016 00:00:00 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setmonth', 'Date.prototype.setMonth')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setMonth")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getMonth()")}}</li> + <li>{{jsxref("Date.prototype.setUTCMonth()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/setseconds/index.html new file mode 100644 index 0000000000..ec0a67f989 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setseconds/index.html @@ -0,0 +1,81 @@ +--- +title: Date.prototype.setSeconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/setSeconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setSeconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>setSeconds()</code></strong> メソッドは、地方時に基づき、指定された日時の「秒」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setseconds.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setSeconds(<var>secondsValue</var>[, <var>msValue</var>])</pre> + +<h3 id="Versions_prior_to_JavaScript_1.3" name="Versions_prior_to_JavaScript_1.3">JavaScript 1.3 より前のバージョン</h3> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setSeconds(<var>secondsValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>secondsValue</var></code></dt> + <dd>日付の「秒」を表す 0 から 59 までの間の整数値。</dd> + <dt><code><var>msValue</var></code> {{Optional_inline}}</dt> + <dd>日付の「ミリ秒」を表す 0 から 999 までの間の整数。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>msValue</var></code> 引数を指定しなかった場合、{{jsxref("Date.prototype.getMilliseconds()", "getMilliseconds()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setSeconds()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、 <code><var>secondsValue</var></code> に 100 を指定した場合、分に 1 が加算され、秒が 40 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setSeconds" name="Using_setSeconds">setSeconds() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setSeconds(30); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setseconds', 'Date.prototype.setSeconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setSeconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getSeconds()")}}</li> + <li>{{jsxref("Date.prototype.setUTCSeconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/settime/index.html b/files/ja/web/javascript/reference/global_objects/date/settime/index.html new file mode 100644 index 0000000000..0c4ffa06f9 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/settime/index.html @@ -0,0 +1,74 @@ +--- +title: Date.prototype.setTime() +slug: Web/JavaScript/Reference/Global_Objects/Date/setTime +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setTime +--- +<div>{{JSRef}}</div> + +<p><strong><code>setTime()</code></strong> メソッドは、{{jsxref("Date")}} オブジェクトを協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からの経過時間をミリ秒単位で表す時刻に設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-settime.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setTime(<var>timeValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>timeValue</var></code></dt> + <dd>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からの経過時間をミリ秒単位で表す整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値 (更新された日時は、引数の値になります)。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>setTime()</code> メソッドは、日付と時刻を別の {{jsxref("Date")}} オブジェクトに代入するのに役立ちます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setTime" name="Using_setTime">setTime() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date('July 1, 1999'); +var sameAsBigDay = new Date(); +sameAsBigDay.setTime(theBigDay.getTime()); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.settime', 'Date.prototype.setTime')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setTime")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getTime()")}}</li> + <li>{{jsxref("Date.prototype.setUTCHours()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutcdate/index.html b/files/ja/web/javascript/reference/global_objects/date/setutcdate/index.html new file mode 100644 index 0000000000..649ca500a7 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutcdate/index.html @@ -0,0 +1,73 @@ +--- +title: Date.prototype.setUTCDate() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCDate +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCDate +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCDate()</code></strong> メソッドは、協定世界時に基づき、指定された日付の「日」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutcdate.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCDate(<var>dayValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>dayValue</var></code></dt> + <dd>任意。「日」を表す 1 から 31 までの間の整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setUTCDate()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code>dayValue</code> に 40 を指定し、{{jsxref("Date")}} に格納された「月」が 6 月の場合、「日」は 10 に変更され、「月」が繰り上がって 7 月になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCDate" name="Using_setUTCDate">setUTCDate() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCDate(20); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcdate', 'Date.prototype.setUTCDate')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCDate")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCDate()")}}</li> + <li>{{jsxref("Date.prototype.setDate()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutcfullyear/index.html b/files/ja/web/javascript/reference/global_objects/date/setutcfullyear/index.html new file mode 100644 index 0000000000..c2d2f205df --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutcfullyear/index.html @@ -0,0 +1,79 @@ +--- +title: Date.prototype.setUTCFullYear() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCFullYear +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCFullYear +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCFullYear()</code></strong> メソッドは、協定世界時に基づき、指定された日付の年を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutcmonth.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCFullYear(<var>yearValue</var>[, <var>monthValue</var>[, <var>dayValue</var>]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>yearValue</var></code></dt> + <dd>「年」の数字を指定する整数値。例えば、1995。</dd> + <dt><code><var>monthValue</var></code></dt> + <dd>任意。1 月から 12 月を表す 0 から 11 までの間の整数値。</dd> + <dt><code><var>dayValue</var></code></dt> + <dd>任意。「日」を表す 1 から 31 までの間の整数値。<code><var>dayValue</var></code> 引数を指定した場合、<code><var>monthValue</var></code> も指定しなければなりません。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>monthValue</var></code> 引数と <code><var>dayValue</var></code> 引数を指定しない場合、{{jsxref("Date.prototype.getUTCMonth()", "getUTCMonth()")}} メソッドと {{jsxref("Date.prototype.getUTCDate()", "getUTCDate()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setUTCFullYear()</code> が他の引数と {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>monthValue</var></code> に 15 を指定した場合、年に 1 が加算 (<code><var>yearValue</var> + 1</code>) され、月が 3 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCFullYear" name="Using_setUTCFullYear">setUTCFullYear() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCFullYear(1997); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcfullyear', 'Date.prototype.setUTCFullYear')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCFullYear")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setFullYear()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutchours/index.html b/files/ja/web/javascript/reference/global_objects/date/setutchours/index.html new file mode 100644 index 0000000000..9b6fce0056 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutchours/index.html @@ -0,0 +1,81 @@ +--- +title: Date.prototype.setUTCHours() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCHours +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCHours +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCHours()</code></strong> メソッドは、協定世界時に基づき、指定された日付の「時」を設定し、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された {{jsxref("Date")}} インスタンスが表す時刻までの間のミリ秒単位の数値を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutchours.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCHours(<var>hoursValue</var>[, <var>minutesValue</var>[, <var>secondsValue</var>[, <var>msValue</var>]]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>hoursValue</var></code></dt> + <dd>「時」を表す 0 から 23 までの間の整数値。</dd> + <dt><code><var>minutesValue</var></code></dt> + <dd>任意。「分」を表す 0 から 59 までの間の整数値。</dd> + <dt><code><var>secondsValue</var></code></dt> + <dd>任意。「秒」を表す 0 から 59 までの間の整数値。<code><var>secondsValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> も指定しなければなりません。</dd> + <dt><code><var>msValue</var></code></dt> + <dd>任意。ミリ秒を表す 0 から 999 までの間の整数値。<code><var>msValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> と <code><var>secondsValue</var></code> も指定しなければなりません。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>minutesValue</var></code>, <code><var>secondsValue</var></code> および <code><var>msValue</var></code> 引数を指定しない場合、{{jsxref("Date.prototype.getUTCMinutes()", "getUTCMinutes()")}} と {{jsxref("Date.prototype.getUTCSeconds()", "getUTCSeconds()")}}、{{jsxref("Date.prototype.getUTCMilliseconds()", "getUTCMilliseconds()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setUTCHours()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>secondsValue</var></code> に 100 を指定した場合、分に 1 が加算 (<code><var>minutesValue</var> + 1</code>) され、秒が 40 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCHours" name="Using_setUTCHours">setUTCHours() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCHours(8); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutchours', 'Date.prototype.setUTCHours')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCHours")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCHours()")}}</li> + <li>{{jsxref("Date.prototype.setHours()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutcmilliseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/setutcmilliseconds/index.html new file mode 100644 index 0000000000..268babe40a --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutcmilliseconds/index.html @@ -0,0 +1,73 @@ +--- +title: Date.prototype.setUTCMilliseconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCMilliseconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMilliseconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCMilliseconds()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「ミリ秒」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutcmilliseconds.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCMilliseconds(<var>millisecondsValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>millisecondsValue</var></code></dt> + <dd>「ミリ秒」を表す 0 から 999 までの間の整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>指定した値が期待される日付の範囲外の場合、それに応じて <code>setUTCMilliseconds()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>millisecondsValue</var></code> に 1100 を指定した場合、{{jsxref("Date")}} オブジェクトに格納された秒の数値に 1 が加算され、ミリ秒に 100 が使用されます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCMilliseconds" name="Using_setUTCMilliseconds">setUTCMilliseconds() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCMilliseconds(500); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcmilliseconds', 'Date.prototype.setUTCMilliseconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCMilliseconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</li> + <li>{{jsxref("Date.prototype.setMilliseconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutcminutes/index.html b/files/ja/web/javascript/reference/global_objects/date/setutcminutes/index.html new file mode 100644 index 0000000000..37d4c845f9 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutcminutes/index.html @@ -0,0 +1,79 @@ +--- +title: Date.prototype.setUTCMinutes() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCMinutes +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMinutes +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCMinutes()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「分」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutcminutes.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCMinutes(<var>minutesValue</var>[, <var>secondsValue</var>[, <var>msValue</var>]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>minutesValue</var></code></dt> + <dd>「分」を表す 0 から 59 までの間の整数値。</dd> + <dt><code><var>secondsValue</var></code></dt> + <dd>任意。「秒」を表す 0 から 59 までの間の整数値。<code><var>secondsValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> も指定しなければなりません。</dd> + <dt><code><var>msValue</var></code></dt> + <dd>任意。ミリ秒を表す 0 から 999 までの間の整数値。<code><var>msValue</var></code> 引数を指定した場合、<code><var>minutesValue</var></code> と <code><var>secondsValue</var></code> も指定しなければなりません。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>secondsValue</var></code> および <code><var>msValue</var></code> 引数を指定しない場合、{{jsxref("Date.prototype.getUTCSeconds()", "getUTCSeconds()")}} と {{jsxref("Date.prototype.getUTCMilliseconds()", "getUTCMilliseconds()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日時の範囲外の場合、それに応じて <code>setUTCMinutes()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>secondsValue</var></code> に 100 を指定した場合、分に 1 が加算 (<code><var>minutesValue</var> + 1</code>) され、秒が 40 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCMinutes" name="Using_setUTCMinutes">setUTCMinutes() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCMinutes(43); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcminutes', 'Date.prototype.setUTCMinutes')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCMinutes")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCMinutes()")}}</li> + <li>{{jsxref("Date.prototype.setMinutes()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutcmonth/index.html b/files/ja/web/javascript/reference/global_objects/date/setutcmonth/index.html new file mode 100644 index 0000000000..671b969014 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutcmonth/index.html @@ -0,0 +1,77 @@ +--- +title: Date.prototype.setUTCMonth() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCMonth +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCMonth +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCMonth()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「月」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutcseconds.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCMonth(<var>monthValue</var>[, <var>dayValue</var>])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>monthValue</var></code></dt> + <dd>1 月から 12 月を表す 0 から 11 までの間の整数値。</dd> + <dt><code><var>dayValue</var></code></dt> + <dd>任意。「日」を表す 1 から 31 までの間の整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><var>dayValue</var></code> 引数を指定しない場合、{{jsxref("Date.prototype.getUTCDate()", "getUTCDate()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日時の範囲外の場合、それに応じて <code>setUTCMonth()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code><var>monthValue</var></code> に 15 を指定した場合、年に 1 が加算され、月が 3 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCMonth" name="Using_setUTCMonth">setUTCMonth() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCMonth(11); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcmonth', 'Date.prototype.setUTCMonth')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCMonth")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCMonth()")}}</li> + <li>{{jsxref("Date.prototype.setMonth()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setutcseconds/index.html b/files/ja/web/javascript/reference/global_objects/date/setutcseconds/index.html new file mode 100644 index 0000000000..88cb29dc5b --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setutcseconds/index.html @@ -0,0 +1,77 @@ +--- +title: Date.prototype.setUTCSeconds() +slug: Web/JavaScript/Reference/Global_Objects/Date/setUTCSeconds +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setUTCSeconds +--- +<div>{{JSRef}}</div> + +<p><strong><code>setUTCSeconds()</code></strong> メソッドは、協定世界時に基づき、指定された日時の「秒」を設定します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-setutcseconds.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setUTCSeconds(<var>secondsValue</var>[, <var>msValue</var>])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>secondsValue</var></code></dt> + <dd>「秒」を表す 0 から 59 までの間の整数値。</dd> + <dt><code><var>msValue</var></code></dt> + <dd>任意。ミリ秒を表す 0 から 999 までの間の整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>msValue</code> 引数を指定しない場合、{{jsxref("Date.prototype.getUTCMilliseconds()", "getUTCMilliseconds()")}} メソッドから返される値が使われます。</p> + +<p>指定した値が期待される日時の範囲外の場合、それに応じて <code>setUTCSeconds()</code> が {{jsxref("Date")}} オブジェクトの日付情報の更新を試みます。例えば、<code>secondsValue</code> に 100 を指定した場合、分に 1 加算され、秒が 40 になります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setUTCSeconds" name="Using_setUTCSeconds">setUTCSeconds() の使用</h3> + +<pre class="brush: js notranslate">var theBigDay = new Date(); +theBigDay.setUTCSeconds(20); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setutcseconds', 'Date.prototype.setUTCSeconds')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setUTCSeconds")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getUTCSeconds()")}}</li> + <li>{{jsxref("Date.prototype.setSeconds()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/setyear/index.html b/files/ja/web/javascript/reference/global_objects/date/setyear/index.html new file mode 100644 index 0000000000..18cbf5b5d9 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/setyear/index.html @@ -0,0 +1,77 @@ +--- +title: Date.prototype.setYear() +slug: Web/JavaScript/Reference/Global_Objects/Date/setYear +tags: + - Date + - Deprecated + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/setYear +--- +<div>{{JSRef}} {{deprecated_header}}</div> + +<p><strong><code>setYear()</code></strong> メソッドは、地方時に基づき、指定された日付の「年」を設定します。 <code>setYear()</code> は完全な桁数の値を設定しないため (いわゆる 2000 年問題)、使用されなくなり、{{jsxref("Date.prototype.setFullYear", "setFullYear()")}} メソッドに置き換えられました。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.setYear(<var>yearValue</var>)</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>yearValue</var></code></dt> + <dd>整数値。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>yearValue</code> が 0 から 99 までの値の場合、<code>dateObj</code> の「年」には <code>1900 + yearValue</code> が設定されます。そうでない場合、<code>dateObj</code> の「年」には <code>yearValue</code> が設定されます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_setYear" name="Using_setYear">setYear() の使用</h3> + +<p>最初の 2 行は「年」を 1996 に設定します。3 行目は、「年」を 2000 に設定します。</p> + +<pre class="brush: js notranslate">var theBigDay = new Date(); + +theBigDay.setYear(96); +theBigDay.setYear(1996); +theBigDay.setYear(2000); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.setyear', 'Date.prototype.setYear')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.setYear")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.getFullYear()")}}</li> + <li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setFullYear()")}}</li> + <li>{{jsxref("Date.prototype.setUTCFullYear()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/todatestring/index.html b/files/ja/web/javascript/reference/global_objects/date/todatestring/index.html new file mode 100644 index 0000000000..397ca3a281 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/todatestring/index.html @@ -0,0 +1,84 @@ +--- +title: Date.prototype.toDateString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toDateString +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toDateString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toDateString()</code></strong> メソッドは、 {{jsxref("Date")}} オブジェクトの日付部分を英語の次の書式で空白区切りで返します。</p> + +<ol> + <li>曜日名の最初の3文字</li> + <li>月名の最初の3文字</li> + <li>2桁の日、必要であれば左に0埋め</li> + <li>4桁 (以上) の年、必要であれば左に0埋め</li> +</ol> + +<p>例 "Thu Jan 01 1970".</p> + +<div>{{EmbedInteractiveExample("pages/js/date-todatestring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toDateString()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた {{jsxref("Date")}} オブジェクトの「日付」部を表す文字列を人間が読める英語の表記で返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Date")}} インスタンスは、特定の時点を参照します。{{jsxref("Date.prototype.toString()", "toString()")}} を呼び出すと、人間が読める英語の表記で日付を返します。<a href="/ja/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> では、この文字列は「日付」部 (日、月、年) と続く「時刻」部 (時、分、秒、タイムゾーン) からなります。時々、時刻の文字列を得たいことがあるでしょう。そのような場合は {{jsxref("Date.prototype.toTimeString()", "toTimeString()")}} メソッドが使えます。</p> + +<p><a href="/ja/docs/Web/JavaScript/Language_Resources">ECMA-262</a> に従って実装されたエンジンは、{{jsxref("Date")}} オブジェクトに対して {{jsxref("Date.prototype.toString()", "toString()")}} メソッドから得られる文字列と異なることがあるため、<code>toDateString()</code> メソッドは特に役立ちます。その文字列の表記は実装依存であり、単純に文字列を切り出す方法では、複数のエンジンで一貫した結果を得られない可能性があります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="A_basic_usage_of_toDateString" name="A_basic_usage_of_toDateString">toDateString() の基本的な使い方</h3> + +<pre class="brush: js notranslate">var d = new Date(1993, 5, 28, 14, 39, 7); + +console.log(d.toString()); // logs Mon Jun 28 1993 14:39:07 GMT-0600 (PDT) +console.log(d.toDateString()); // logs Mon Jun 28 1993 +</pre> + +<div class="note"> +<p><strong>注:</strong> {{jsxref("Date")}} の引数として使用する場合、月は 0 から始まります（よって、 0 は 1 月に、 11 は 12 月 に対応します）。</p> +</div> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.todatestring', 'Date.prototype.toDateString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toDateString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/togmtstring/index.html b/files/ja/web/javascript/reference/global_objects/date/togmtstring/index.html new file mode 100644 index 0000000000..c64628399f --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/togmtstring/index.html @@ -0,0 +1,68 @@ +--- +title: Date.prototype.toGMTString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toGMTString +tags: + - Date + - Deprecated + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toGMTString +--- +<div>{{JSRef}} {{deprecated_header}}</div> + +<p><strong><code>toGMTString()</code></strong> メソッドは、インターネットグリニッジ標準時 (GMT) 協定に基づき、日付を文字列へ変換します。<code>toGMTString()</code> が返す値の正確な書式は、プラットフォームやブラウザによって変化しますが、一般に、人間が読める日付の文字列を表します。</p> + +<div class="note"> +<p><strong>注:</strong> <code>toGMTString()</code> は非推奨であり、もはや使われていません。後方互換性のためだけに残されています。代わりに、{{jsxref("Date.prototype.toUTCString()", "toUTCString()")}} を使用してください。</p> +</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toGMTString()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>インターネットグリニッジ標準時 (GMT) 協定に基づき、与えられた日付を表す文字列。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Simple_example" name="Simple_example">簡単な例</h3> + +<p>この例では、<code>toGMTString()</code> メソッドは OS のタイムゾーンオフセットを使って、日付を GMT (UTC) に変換し、次の書式に似た文字列値を返します。正確な書式はプラットフォームに依存します。</p> + +<pre class="brush: js notranslate">var today = new Date(); +var str = today.toGMTString(); // deprecated! use toUTCString() + +console.log(str); // Mon, 18 Dec 1995 17:28:35 GMT +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.togmtstring', 'Date.prototype.toGMTString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toGMTString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toUTCString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/toisostring/index.html b/files/ja/web/javascript/reference/global_objects/date/toisostring/index.html new file mode 100644 index 0000000000..945302e3d9 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/toisostring/index.html @@ -0,0 +1,96 @@ +--- +title: Date.prototype.toISOString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toISOString +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference + - polyfill +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toISOString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toISOString()</code></strong> メソッドは、<em>簡潔な</em>拡張表記の ISO 形式 (<a href="https://ja.wikipedia.org/wiki/ISO_8601">ISO 8601</a>) の文字列を返します。これは、常に 24 文字または 27 文字の長さになります (それぞれ、<code><var>YYYY</var>-<var>MM</var>-<var>DD</var>T<var>HH</var>:<var>mm</var>:<var>ss.sss</var>Z</code> または <code><var>±</var><var>YYYYYY</var>-<var>MM</var>-<var>DD</var>T<var>HH</var>:<var>mm</var>:<var>ss.sss</var>Z</code>)。タイムゾーンは常に 0 UTC オフセットになり、接尾辞 "<code>Z</code>" で表記されます。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-toisostring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toISOString()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時に基づき、与えられた日付を <a href="https://ja.wikipedia.org/wiki/ISO_8601">ISO 8601</a> 形式で表す文字列。</p> + +<h2 id="Polyfill" name="Polyfill">ポリフィル</h2> + +<p>このメソッドは、ECMA-262 第 5 版で標準化されました。このメソッドに対応するため、更新されていないエンジンでは、次のコードを用いてこのメソッドの欠落を補うことができます。</p> + +<pre class="brush: js notranslate">if (!Date.prototype.toISOString) { + (function() { + + function pad(number) { + if (number < 10) { + return '0' + number; + } + return number; + } + + Date.prototype.toISOString = function() { + return this.getUTCFullYear() + + '-' + pad(this.getUTCMonth() + 1) + + '-' + pad(this.getUTCDate()) + + 'T' + pad(this.getUTCHours()) + + ':' + pad(this.getUTCMinutes()) + + ':' + pad(this.getUTCSeconds()) + + '.' + (this.getUTCMilliseconds() / 1000).toFixed(3).slice(2, 5) + + 'Z'; + }; + + })(); +} +</pre> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toISOString" name="Using_toISOString">toISOString() の使用</h3> + +<pre class="brush: js notranslate">let today = new Date('05 October 2011 14:48 UTC') + +console.log(today.toISOString()) // 2011-10-05T14:48:00.000Z を返す +</pre> + +<p>上記の例は、Mozilla 以外のブラウザーでは正しく解析されない、非標準の文字列値を解析するのに使います。</p> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toISOString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toUTCString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/tojson/index.html b/files/ja/web/javascript/reference/global_objects/date/tojson/index.html new file mode 100644 index 0000000000..2370dfc2b7 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/tojson/index.html @@ -0,0 +1,69 @@ +--- +title: Date.prototype.toJSON() +slug: Web/JavaScript/Reference/Global_Objects/Date/toJSON +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toJSON +--- +<div>{{JSRef}}</div> + +<p><strong><code>toJSON()</code></strong> メソッドは、{{jsxref("Date")}} オブジェクトの文字列表現を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-tojson.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toJSON()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた日付を表す文字列。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Date")}} インスタンスは、特定の時点を参照します。<code>toJSON()</code> の呼び出しは、{{jsxref("Date")}} オブジェクトの値を表す文字列 ({{jsxref("Date.prototype.toISOString()", "toISOString()")}} を使用) を返します。このメソッドは、一般的に、{{Glossary("JSON")}} シリアライズを目的として {{jsxref("Date")}} オブジェクトをシリアライズするために使用されます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toJSON" name="Using_toJSON">toJSON() を使う</h3> + +<pre class="brush:js notranslate">var jsonDate = (new Date()).toJSON(); +var backToDate = new Date(jsonDate); + +console.log(jsonDate); //2015-10-26T07:46:36.611Z +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.tojson', 'Date.prototype.toJSON')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toJSON")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toUTCString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/tolocaledatestring/index.html b/files/ja/web/javascript/reference/global_objects/date/tolocaledatestring/index.html new file mode 100644 index 0000000000..04a1278e49 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/tolocaledatestring/index.html @@ -0,0 +1,159 @@ +--- +title: Date.prototype.toLocaleDateString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString +tags: + - Date + - IANA Timezone Format + - Internationalization + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toLocaleDateString()</code></strong> メソッドは、この Date オブジェクトの「日付」部を表す言語に依存した文字列を返します。新しい <code>locales</code> 引数と <code>options</code> 引数により、アプリケーションは、使用される書式変換の言語の指定や、関数の振る舞いのカスタマイズができます。古い実装のアプリケーションは、<code>locales</code> 引数と <code>options</code> 引数を無視します。使用されるロケールや返される文字列の書式は、完全に実装依存です。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toLocaleDateString([<var>locales</var>[, <var>options</var>]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p><code>locales</code> 引数と <code>options</code> 引数をサポートしているブラウザーは、{{anch("Browser compatibility", "ブラウザーの実装状況")}} セクションを確認してください。機能が使用できるかどうかは、{{anch("Checking_for_support_for_locales_and_options_arguments", "locales 引数と options 引数がサポートされているか確認する")}}で確認してください。</p> + +<p>See the <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/DateTimeFormat"><code>Intl.DateTimeFormat()</code> constructor</a> for details on these parameters and how to use them.</p> + +<p>日時のそれぞれの部分ののプロパティにおける既定値は、{{jsxref("undefined")}}です。ただし、<code>weekday</code>、 <code>year</code>、<code>month</code>、<code>day</code> プロパティがすべて {{jsxref("undefined")}} のときは、<code>year</code>、<code>month</code>、<code>day</code> は <code>"numeric"</code> とみなされます。</p> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた {{jsxref("Global_Objects/Date", "Date")}} インスタンスの「日付」部を表す、言語特有の慣習による文字列。</p> + +<h2 id="Performance" name="Performance">性能</h2> + +<p>大量の日付を書式化する場合は、 {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトを生成してその {{jsxref("DateTimeFormat.prototype.format", "format")}} プロパティで提供される関数を使用したほうが得策です。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toLocaleDateString" name="Using_toLocaleDateString">toLocaleDateString() の使用</h3> + +<p>ロケールを指定しない基本的な使い方では、既定のロケールと既定のオプションによる書式の文字列が返されます。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); + +// toLocaleDateString() に引数を与えなければ実装に依存し、 +// 既定のロケールとタイムゾーンを返す +console.log(date.toLocaleDateString()); +// → "12/11/2012" : アメリカ/ロサンゼルスのタイムゾーンの en-US ロケールで実行した場合 +</pre> + +<h3 id="Checking_for_support_for_locales_and_options_arguments" name="Checking_for_support_for_locales_and_options_arguments">locales と options の各引数に対応しているか確認する</h3> + +<p><code>locales</code> および <code>options</code> 引数は、まだすべてのブラウザーが対応しているわけではありません。これらが実装されているかどうかをチェックするには、不適切な言語タグを与えると {{jsxref("RangeError")}} 例外で拒否されるという要件を使用することができます。</p> + +<pre class="brush: js notranslate">function toLocaleDateStringSupportsLocales() { + try { + new Date().toLocaleDateString('i'); + } catch (e) { + return e.name !== 'RangeError'; + } + return true; +} +</pre> + +<h3 id="Using_locales" name="Using_locales">locales の使用</h3> + +<p>この例では、国ごとに異なる日付書式を示します。アプリケーションのユーザーインターフェイスで使用されている言語の書式を得るには、 <code>locales</code> 引数でその言語 (あるいはフォールバック先の言語) を指定してください。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// 以下の書式はその地域のタイムゾーンとロケールを想定 +// 米国のアメリカ大陸/ロサンゼルス + +// 米国英語は月-日-年の順 +console.log(date.toLocaleDateString('en-US')); +// → "12/19/2012" + +// 英国英語は日-月-年の順 +console.log(date.toLocaleDateString('en-GB')); +// → "20/12/2012" + +// 韓国は年-月-日の順 +console.log(date.toLocaleDateString('ko-KR')); +// → "2012. 12. 20." + +// Event for Persian, It's hard to manually convert date to Solar Hijri +console.log(date.toLocaleDateString('fa-IR')); +// → "۱۳۹۱/۹/۳۰" + +// 多くのアラビア語圏ではアラビア数字 +console.log(date.toLocaleDateString('ar-EG')); +// → "<span dir="rtl">٢٠/١٢/٢٠١٢</span>" + +// 日本語では、アプリケーションは元号を用いることがある +// 2012 年は平成 24 年 +console.log(date.toLocaleDateString('ja-JP-u-ca-japanese')); +// → "24/12/20" + +// 対応していない可能性のある言語を要求した場合、例えば +// バリ語とし、フォールバック言語にインドネシア語を指定した場合 +console.log(date.toLocaleDateString(['ban', 'id'])); +// → "20/12/2012" +</pre> + +<h3 id="Using_options" name="Using_options">options の使用</h3> + +<p><code>toLocaleDateString()</code> メソッドから得られる結果は、 <code>options</code> 引数でカスタマイズできます。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// 曜日を加えて月とともに長い書式で表す +var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }; +console.log(date.toLocaleDateString('de-DE', options)); +// → "Donnerstag, 20. Dezember 2012" + +// アプリケーションで UTC を用いてそれを示したい場合 +options.timeZone = 'UTC'; +options.timeZoneName = 'short'; +console.log(date.toLocaleDateString('en-US', options)); +// → "Thursday, December 20, 2012, GMT" +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.tolocaletimestring', 'Date.prototype.toLocaleTimeString')}}</td> + </tr> + <tr> + <td>{{SpecName('ES Int Draft', '#sup-date.prototype.tolocaletimestring', 'Date.prototype.toLocaleTimeString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toLocaleDateString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}</li> + <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> + <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/tolocalestring/index.html b/files/ja/web/javascript/reference/global_objects/date/tolocalestring/index.html new file mode 100644 index 0000000000..4de5f6bf2e --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/tolocalestring/index.html @@ -0,0 +1,180 @@ +--- +title: Date.prototype.toLocaleString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleString +tags: + - Date + - Internationalization + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toLocaleString()</code></strong> メソッドは、言語に合わせた日時の文字列を返します。</p> + +<p>新しい <code><var>locales</var></code> と <code><var>options</var></code> の引数により、アプリケーションは使用される書式変換の言語の指定や、関数の振る舞いのカスタマイズをすることができます。</p> + +<p>古い実装のアプリケーションは、 <code><var>locales</var></code> と <code><var>options</var></code> の引数を無視します。使用されるロケールや返される文字列の書式は、完全に実装依存です。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-tolocalestring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toLocaleString([<var>locales</var>[, <var>options</var>]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p>どのブラウザーが <code><var>locales</var></code> と <code><var>options</var></code> に対応しているのかは、<a href="#Browser_Compatibility">ブラウザーの互換性</a>をご覧ください。 <code><var>locales</var></code> と <code><var>options</var></code> を無視する実装では、使用されるロケールや返される文字列の書式は、完全に実装依存です。</p> + +<p>これらの引数の詳細やその使用方法は、 {{jsxref("DateTimeFormat/DateTimeFormat", "Intl.DateTimeFormat()")}} コンストラクターを確認してください。</p> + +<p>日時のそれぞれの部分のプロパティにおける既定値は {{jsxref("undefined")}} です。ただし、 <code>weekday</code>, <code>year</code>, <code>month</code>, <code>day</code> の各プロパティがすべて {{jsxref("undefined")}} のときは、 <code>year</code>, <code>month</code>, <code>day</code> は <code>"numeric"</code> とみなされます。</p> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた文字列を言語特有の慣習によって表した文字列です。</p> + +<h2 id="Performance" name="Performance">性能</h2> + +<p>大量の日付を書式化する場合は、 {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトを生成してその {{jsxref("DateTimeFormat.prototype.format", "format")}} プロパティで提供される関数を使用したほうが得策です。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toLocaleString" name="Using_toLocaleString">toLocaleString() の使用</h3> + +<p>ロケールを指定しない基本的な使い方では、既定のロケールと既定のオプションによる書式の文字列が返されます。</p> + +<pre class="brush: js notranslate">let date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); + +// toLocaleString() メソッドに引数を与えなければ実装に依存し、 +// 既定のロケールとタイムゾーンを返す +console.log(date.toLocaleString()); +// → "12/11/2012, 7:00:00 PM" : アメリカ/ロサンゼルスのタイムゾーンの en-US ロケールで実行した場合 +</pre> + +<h3 id="Checking_for_support_for_locales_and_options_arguments" name="Checking_for_support_for_locales_and_options_arguments">locales と options に対応しているか確認する</h3> + +<p><code><var>locales</var></code> と <code><var>options</var></code> は、まだすべてのブラウザーが対応している訳ではありません。これらが実装されているかどうかは、不適切な言語タグを与えて {{jsxref("RangeError")}} 例外で拒否されるかどうかで確かめられます。</p> + +<pre class="brush: js notranslate">function toLocaleStringSupportsLocales() { + try { + new Date().toLocaleString('i'); + } catch (e) { + return e instanceof RangeError; + } + return false; +} +</pre> + +<h3 id="Using_locales" name="Using_locales">locales の使用</h3> + +<p>この例では、国ごとに異なる日時の書式を示します。ご使用のアプリケーションのユーザーインターフェイスで使用される言語の書式を得るには、 <code><var>locales</var></code> でその言語 (あるいは代替言語) を指定してください。</p> + +<pre class="brush: js notranslate">let date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// 以下の書式はその地域のタイムゾーンとロケールを想定 +// 米国のアメリカ大陸/ロサンゼルス + +// 米国英語は月-日-年の順で AM/PM 表記の 12 時間制 +console.log(date.toLocaleString('en-US')); +// → "12/19/2012, 7:00:00 PM" + +// 英国英語は日-月-年の順で AM/PM 表記なしの 24 時間制 +console.log(date.toLocaleString('en-GB')); +// → "20/12/2012 03:00:00" + +// 韓国は年-月-日の順で AM/PM 表記の 12 時間制 +console.log(date.toLocaleString('ko-KR')); +// → "2012. 12. 20. 오후 12:00:00" + +// 多くのアラビア語圏ではアラビア数字を使用 +console.log(date.toLocaleString('ar-EG')); +// → "<span dir="rtl">٢٠/١٢/٢٠١٢ ٥:٠٠:٠٠ ص</span>" + +// 日本のアプリケーションでは元号を用いることがある +// 2012 年は平成 24 年 +console.log(date.toLocaleString('ja-JP-u-ca-japanese')); +// → "24/12/20 12:00:00" + +// 対応していない可能性のある言語を要求した場合、たとえば +// ここではバリ語とし、代替言語にインドネシア語 +console.log(date.toLocaleString(['ban', 'id'])); +// → "20/12/2012 11.00.00" +</pre> + +<h3 id="Using_options" name="Using_options">options の使用</h3> + +<p><code>toLocaleString()</code> メソッドから得られる結果は、<code><var>options</var></code> でカスタマイズできます。</p> + +<pre class="brush: js notranslate">let date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// 曜日を加えて月とともに長い書式で表す +let options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }; + +console.log(date.toLocaleString('de-DE', options)); +// → "Donnerstag, 20. Dezember 2012" + +// アプリケーションで UTC を用いてそれを示したい場合 +options.timeZone = 'UTC'; +options.timeZoneName = 'short'; + +console.log(date.toLocaleString('en-US', options)); +// → "Thursday, December 20, 2012, GMT" + +// 米国でも 24 時間制を使うことがある +console.log(date.toLocaleString('en-US', { hour12: false })); +// → "12/19/2012, 19:00:00" +</pre> + +<h3 id="Avoid_comparing_formatted_date_values_to_static_values" name="Avoid_comparing_formatted_date_values_to_static_values">書式化した日付値を固定値と比較しないでください</h3> + +<p>たいていの場合、 <code>toLocaleString()</code> が返す書式は一貫しています。しかし、これは将来的に変更される可能性があり、すべての言語で保証されているわけではありません。</p> + +<p>特に注目すべきは、IE および Edge ブラウザーは日付の周りに書字方向の制御文字を挿入するため、出力テキストが他のテキストと連結されたときに適切に流れるようになっています。</p> + +<p>このことから、 <code>toLocaleString()</code> を固定値と比較できると期待してはいけません。</p> + +<pre class="brush: js; example-bad notranslate">"1/1/2019, 01:00:00" === new Date("2019-01-01T01:00:00Z").toLocaleString("en-US"); +// true in Firefox and others +// false in IE and Edge</pre> + +<div class="blockIndicator note"> +<p><strong>注</strong>: 詳細および例についてはこの <a href="https://stackoverflow.com/questions/25574963/ies-tolocalestring-has-strange-characters-in-results">StackOverflow のスレッド</a>をご覧ください。</p> +</div> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.tolocalestring', 'Date.prototype.toLocaleString')}}</td> + </tr> + <tr> + <td>{{SpecName('ES Int Draft', '#sup-date.prototype.tolocalestring', 'Date.prototype.toLocaleString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toLocaleString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}</li> + <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> + <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/tolocaletimestring/index.html b/files/ja/web/javascript/reference/global_objects/date/tolocaletimestring/index.html new file mode 100644 index 0000000000..c26afc5c19 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/tolocaletimestring/index.html @@ -0,0 +1,155 @@ +--- +title: Date.prototype.toLocaleTimeString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleTimeString +tags: + - Date + - Internationalization + - JavaScript + - Method + - Prototype + - Reference + - メソッド + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toLocaleTimeString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toLocaleTimeString()</code></strong> メソッドは、この Date オブジェクトの「時刻」部を表す言語に依存した文字列を返します。新しい <code>locales</code> 引数と <code>options</code> 引数により、アプリケーションは、使用される書式変換の言語の指定や、関数の振る舞いのカスタマイズができます。古い実装のアプリケーションは、<code>locales</code> 引数と <code>options</code> 引数を無視します。使用されるロケールや返される文字列の書式は、完全に実装依存です。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-tolocaletimestring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toLocaleTimeString([<var>locales</var>[, <var>options</var>]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p><code>locales</code> および <code>options</code> 引数は、関数の動作をカスタマイズし、使用される書式の慣習を言語で指定することができるににします。 <code>locales</code> および <code>options</code> 引数を無視する実装では、使用されるロケールおよび返される文字列の書式は完全に実装依存になります。</p> + +<p>これらの引数やその使い方についての詳細は、 {{jsxref("Intl/DateTimeFormat/DateTimeFormat", "Intl.DateTimeFormat()")}} コンストラクターを参照してください。</p> + +<p>時刻のそれぞれの部分のプロパティにおける既定値は {{jsxref("undefined")}} ですが、 <code>hour</code>、 <code>minute</code>、<code>second</code> プロパティがすべて {{jsxref("undefined")}} のときは、<code>hour</code>、<code>minute</code>、<code>second</code> は <code>"numeric"</code> とみなされます。</p> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた {{jsxref("Global_Objects/Date", "Date")}} インスタンスの「時刻」部を表す、言語特有の慣習による文字列。</p> + +<h2 id="Performance" name="Performance">性能</h2> + +<p>大量の日付を書式化する場合は、 {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} オブジェクトを生成してその {{jsxref("DateTimeFormat.prototype.format", "format")}} プロパティで提供される関数を使用したほうが得策です。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toLocaleTimeString" name="Using_toLocaleTimeString">toLocaleTimeString() の使用</h3> + +<p>ロケールを指定しない基本的な使い方では、既定のロケールと既定のオプションによる書式の文字列が返されます。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0)); + +// toLocaleTimeString() に引数を与えなければ実装に依存し、 +// 既定のロケールとタイムゾーンを返す +console.log(date.toLocaleTimeString()); +// → "7:00:00 PM" アメリカ/ロサンゼルスのタイムゾーンの en-US ロケールで実行した場合 +</pre> + +<h3 id="Checking_for_support_for_locales_and_options_arguments" name="Checking_for_support_for_locales_and_options_arguments">locales と options の各引数に対応しているか確認する</h3> + +<p><code>locales</code> および <code>options</code> 引数は、まだすべてのブラウザーが対応しているわけではありません。これらが実装されているかどうかをチェックするには、不適切な言語タグを与えると {{jsxref("RangeError")}} 例外で拒否されるという要件を使用することができます。</p> + +<pre class="brush: js notranslate">function toLocaleTimeStringSupportsLocales() { + try { + new Date().toLocaleTimeString('i'); + } catch (e) { + return e.name === 'RangeError'; + } + return false; +} +</pre> + +<h3 id="Using_locales" name="Using_locales">locales の使用</h3> + +<p>この例では、国ごとに異なる時刻書式を示します。アプリケーションのユーザーインターフェイスで使用されている言語の書式を得るには、 <code>locales</code> 引数でその言語 (あるいはフォールバック先の言語) を指定してください。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// 以下の書式はその地域のタイムゾーンとロケールを想定 +// 米国のアメリカ大陸/ロサンゼルス + +// 米国英語は AM/PM 表記の 12 時間制 +console.log(date.toLocaleTimeString('en-US')); +// → "7:00:00 PM" + +// 英国英語は AM/PM 表記なしの 24 時間制 +console.log(date.toLocaleTimeString('en-GB')); +// → "03:00:00" + +// 韓国は AM/PM 表記の 12 時間制 +console.log(date.toLocaleTimeString('ko-KR')); +// → "오후 12:00:00" + +// 多くのアラビア語圏ではアラビア数字を使用 +console.log(date.toLocaleTimeString('ar-EG')); +// → "<span dir="rtl">٧:٠٠:٠٠ م</span>" + +// 対応していない可能性のある言語を要求した場合、例えば +// バリ語とし、フォールバック言語にインドネシア語を指定した場合 +console.log(date.toLocaleTimeString(['ban', 'id'])); +// → "11.00.00" +</pre> + +<h3 id="Using_options" name="Using_options">options の使用</h3> + +<p><code>toLocaleTimeString()</code> メソッドから得られる結果は、 <code>options</code> 引数でカスタマイズできます。</p> + +<pre class="brush: js notranslate">var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0)); + +// アプリケーションで UTC を用い、それを表示したい場合 +var options = { timeZone: 'UTC', timeZoneName: 'short' }; +console.log(date.toLocaleTimeString('en-US', options)); +// → "3:00:00 AM GMT" + +// 米国でも 24 時間制を使うことがある +console.log(date.toLocaleTimeString('en-US', { hour12: false })); +// → "19:00:00" + +// 既定のロケールのオプション - 空の配列を使用して時と分のみを表示 +console.log(date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })); +// → "20:01" + +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.tolocaletimestring', 'Date.prototype.toLocaleTimeString')}}</td> + </tr> + <tr> + <td>{{SpecName('ES Int Draft', '#sup-date.prototype.tolocaletimestring', 'Date.prototype.toLocaleTimeString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toLocaleTimeString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}</li> + <li>{{jsxref("Date.prototype.toLocaleDateString()")}}</li> + <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/tosource/index.html b/files/ja/web/javascript/reference/global_objects/date/tosource/index.html new file mode 100644 index 0000000000..8d9b5bc578 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/tosource/index.html @@ -0,0 +1,50 @@ +--- +title: Date.prototype.toSource() +slug: Web/JavaScript/Reference/Global_Objects/Date/toSource +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toSource +--- +<div>{{JSRef}} {{obsolete_header}}</div> + +<p><strong><code>toSource()</code></strong> メソッドは、オブジェクトのソースコードを表す文字列を返します。</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toSource() +Date.toSource()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた {{jsxref("Global_Objects/Date", "Date")}} オブジェクトのソースコードを表す文字列。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Native_function" name="Native_function">ネイティブ関数</h3> + +<p>組み込まれた {{jsxref("Date")}} オブジェクトについて、<code>toSource()</code> は、ソースコードが利用できないことを示す次の文字列を返します。</p> + +<pre class="brush: js notranslate">function Date() { + [native code] +} +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<p>仕様の一部ではありません。</p> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toSource")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Object.prototype.toSource()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/tostring/index.html b/files/ja/web/javascript/reference/global_objects/date/tostring/index.html new file mode 100644 index 0000000000..72c5042eac --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/tostring/index.html @@ -0,0 +1,113 @@ +--- +title: Date.prototype.toString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toString +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toString()</code></strong> メソッドは、指定した {{jsxref("Date")}} オブジェクトを表す文字列を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-tostring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toString()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>与えられた日付を表す文字列。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Date")}} のインスタンスは <code>toString()</code> メソッドを {{jsxref("Date.prototype")}} から継承しており、 {{jsxref("Object.prototype")}} から継承しているわけではありません。 <code>Date.prototype.toString()</code> は Date を表す文字列を、 ECMA-262 で指定された以下のような書式で返します。</p> + +<ul> + <li>曜日: 3文字の英語の曜日名。例 "Sat"</li> + <li>空白</li> + <li>月名: 3文字の英語の月名。例 "Sep"</li> + <li>空白</li> + <li>日: 2桁の日。例 "01"</li> + <li>空白</li> + <li>年: 4桁の年。例 "2018"</li> + <li>空白</li> + <li>時: 2桁の時。例 "14"</li> + <li>コロン</li> + <li>分: 2桁の分。例 "53"</li> + <li>コロン</li> + <li>秒: 2桁の秒。例 "26"</li> + <li>空白</li> + <li>文字列 "GMT"</li> + <li>タイムゾーンのオフセット記号。以下のどちらかです。 + <ul> + <li>"+" 正のオフセット (0以上)</li> + <li>"-" 負のオフセット (0未満)</li> + </ul> + </li> + <li>2桁の時間のオフセット。例 "14"</li> + <li>2桁の分のオフセット。例 "00"</li> + <li>任意で、以下の形のタイムゾーン名。 + <ul> + <li>空白</li> + <li>左括弧、すなわち "("</li> + <li>タイムゾーンを表す実装依存の文字列で、省略形の場合も完全な名前の場合もあります (タイムゾーンに名前や省略形の標準はありません。例 "Line Islands Time" または "LINT"</li> + <li>右括弧、すなわち ")"</li> + </ul> + </li> +</ul> + +<p>例 "Sat Sep 01 2018 14:53:26 GMT+1400 (LINT)"</p> + +<p>ECMAScript 2018 (第9編) まで、 <code>Date.prototype.toString</code> が返す文字列の書式は実装に依存していました。したがって、指定された書式通りであることに頼ってはいけません。</p> + +<p><code>toString()</code> メソッドは、日付がテキスト値で表現されるとき、例えば <code>console.log(new Date())</code>、または日付が文字列に強制変換されるとき、例えば <code>var today = 'Today is ' + new Date()</code> などで自動的に呼び出されます。</p> + +<p><code>toString()</code> は汎用メソッドです。 <code>this</code> が {{jsxref("Date")}} インスタンスある必要はありません。しかし、ネイティブの JavaScript を使用して構築することができない内部の <code>[[TimeValue]]</code> プロパティを持っている必要があるため、事実上は {{jsxref("Date")}} インスタンスでの使用に限定されています。日付でないインスタンスで呼び出された場合、 {{jsxref("TypeError")}} が発生します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toString" name="Using_toString">toString() の使用</h3> + +<p>次の例は、{{jsxref("Date")}} オブジェクトの <code>toString()</code> 値を <code>myVar</code> に代入します。</p> + +<pre class="brush: js notranslate">var x = new Date(); +var myVar = x.toString(); // 次のような値を myVar に代入します: + // Mon Sep 08 1998 14:36:22 GMT-0700 (PDT) +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.tostring', 'Date.prototype.toString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Object.prototype.toString()")}}</li> + <li>{{jsxref("Date.prototype.toDateString()")}}</li> + <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> + <li>{{jsxref("Date.prototype.toTimeString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/totimestring/index.html b/files/ja/web/javascript/reference/global_objects/date/totimestring/index.html new file mode 100644 index 0000000000..67928ed7a8 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/totimestring/index.html @@ -0,0 +1,71 @@ +--- +title: Date.prototype.toTimeString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toTimeString +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toTimeString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toTimeString()</code></strong> メソッドは、英語の人間が読める形式で {{jsxref("Date")}} オブジェクトの「時刻」部を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-totimestring.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toTimeString()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>英語の人間が読める形式で、与えられた日付の「時刻」部を表す文字列を返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Date")}} インスタンスは特定の時点を参照します。{{jsxref("Date.prototype.toString()", "toString()")}} を呼び出すと、英語の人間が読める形式の日付を返します。<a href="/ja/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> では、この文字列は「日付」部 (日、月、年) と続く「時刻」部 (時、分、秒、タイムゾーン) から成ります。時々、時刻の文字列を得たいことがあるでしょう。そのような場合に、<code>toTimeString()</code> メソッドが使えます。</p> + +<p><a href="/ja/docs/Web/JavaScript/Language_Resources">ECMA-262</a> に従って実装されたエンジンは、{{jsxref("Date")}} オブジェクトに対して {{jsxref("Date.prototype.toString()", "toString()")}} メソッドから得られる文字列と異なることがあるため、<code>toTimeString()</code> メソッドは特に役立ちます。その文字列の表記は実装依存であり、単純に文字列を切り出す方法では、複数のエンジンで一貫した結果を得られない可能性があります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="A_basic_usage_of_toTimeString" name="A_basic_usage_of_toTimeString">toTimeString() の基本的な使い方</h3> + +<pre class="brush: js notranslate">var d = new Date(1993, 6, 28, 14, 39, 7); + +console.log(d.toString()); // Wed Jul 28 1993 14:39:07 GMT-0600 (PDT) +console.log(d.toTimeString()); // 14:39:07 GMT-0600 (PDT) +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.totimestring', 'Date.prototype.toTimeString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toTimeString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.toLocaleTimeString()")}}</li> + <li>{{jsxref("Date.prototype.toDateString()")}}</li> + <li>{{jsxref("Date.prototype.toString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/toutcstring/index.html b/files/ja/web/javascript/reference/global_objects/date/toutcstring/index.html new file mode 100644 index 0000000000..38d3f67926 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/toutcstring/index.html @@ -0,0 +1,110 @@ +--- +title: Date.prototype.toUTCString() +slug: Web/JavaScript/Reference/Global_Objects/Date/toUTCString +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/toUTCString +--- +<div>{{JSRef}}</div> + +<p><strong><code>toUTCString()</code></strong> メソッドは、協定世界時 (UTC) のタイムゾーンに基づき、日付を文字列へ変換します。</p> + +<p><a href="https://tools.ietf.org/html/rfc7231#section-7.1.1.1">rfc7231</a> と <a href="https://www.ecma-international.org/ecma-262/10.0/index.html#sec-date.prototype.toutcstring">ecma-262 toUTCString</a> の改訂に基づき、 <a href="https://tc39.es/ecma262/#sec-date.prototype.toutcstring">2021 版</a>では負の数が可能になります。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-toutcstring.html","shorter")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.toUTCString()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>UTC タイムゾーンに基づき、与えられた日付を表す文字列。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>toUTCString()</code> から返される文字列は、 <code><var>Www</var>, <var>dd</var> <var>Mmm</var> <var>yyyy</var> <var>hh</var>:<var>mm</var>:<var>ss</var> GMT</code> の形の文字列です。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">書式文字列</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code><var>Www</var></code></td> + <td>曜日、3文字で表す (例 Sun, Mon, ...)</td> + </tr> + <tr> + <td><code><var>dd</var></code></td> + <td>日、必要に応じて先頭に0が付いた2桁の数字で表す</td> + </tr> + <tr> + <td><code><var>Mmm</var></code></td> + <td>月、3文字で表す (例 Jan, Feb, ...)</td> + </tr> + <tr> + <td><code><var>yyyy</var></code></td> + <td>年、必要に応じて先頭に0が付いた4桁以上の数字で表す</td> + </tr> + <tr> + <td><code><var>hh</var></code></td> + <td>時、必要に応じて先頭に0が付いた2桁の数字で表す</td> + </tr> + <tr> + <td><code><var>mm</var></code></td> + <td>分、必要に応じて先頭に0が付いた2桁の数字で表す</td> + </tr> + <tr> + <td><code><var>ss</var></code></td> + <td>秒、必要に応じて先頭に0が付いた2桁の数字で表す</td> + </tr> + </tbody> +</table> + +<p>ECMAScript 2018 以前では、返値の書式はプラットフォームによって様々です。もっとも一般的な返値は RFC-1123 形式の日付であり、これは RFC-822 形式の日付をわずかに改訂したものでした。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_toUTCString" name="Using_toUTCString">toUTCString() を使う</h3> + +<pre class="brush: js notranslate">let today = new Date('Wed, 14 Jun 2017 00:00:00 PDT'); +let UTCstring = today.toUTCString(); // Wed, 14 Jun 2017 07:00:00 GMT +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.toutcstring', 'Date.prototype.toUTCString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.toUTCString")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.prototype.toLocaleString()")}}</li> + <li>{{jsxref("Date.prototype.toDateString()")}}</li> + <li>{{jsxref("Date.prototype.toISOString()")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/utc/index.html b/files/ja/web/javascript/reference/global_objects/date/utc/index.html new file mode 100644 index 0000000000..bc1dda2191 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/utc/index.html @@ -0,0 +1,124 @@ +--- +title: Date.UTC() +slug: Web/JavaScript/Reference/Global_Objects/Date/UTC +tags: + - Date + - JavaScript + - Method + - Reference + - メソッド +translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC +--- +<div>{{JSRef}}</div> + +<p><strong><code>Date.UTC()</code></strong> メソッドは、コンストラクターと同じ最も長い書式の引数を受け入れ、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からの経過時間を表す {{jsxref("Date")}} オブジェクトのミリ秒単位の数値を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-utc.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<p><strong>ECMAScript 2017 より:</strong></p> + +<pre class="syntaxbox">Date.UTC(<var>year</var>[, <var>month</var>[, <var>day</var>[, <var>hour</var>[, <var>minute</var>[, <var>second</var>[, <var>millisecond</var>]]]]]])</pre> + +<p><strong>ECMAScript 2016 以前:</strong> <em>(<code><var>month</var></code> が必須であった)</em></p> + +<pre class="syntaxbox">Date.UTC(<var>year</var>, <var>month</var>[, <var>day</var>[, <var>hour</var>[, <var>minute</var>[, <var>second</var>[, <var>millisecond</var>]]]]])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>year</var></code></dt> + <dd>完全な形の「年」</dd> + <dt><code><var>month</var></code></dt> + <dd>「月」を表す <code>0</code> (1 月) から <code>11</code> (12 月) までの整数値。 <em>(ECMAScript 2016 まで、 <code><var>month</var></code> は必須の引数でした。 ES2017 では必須ではなくなりました。)</em></dd> + <dt><code><var>day</var></code> {{optional_inline}}</dt> + <dd>「日」を表す <code>1</code> から <code>31</code> までの整数値。省略された場合の既定値は <code>1</code> です。</dd> + <dt><code>hour</code> {{optional_inline}}</dt> + <dd>「時」を表す <code>0</code> から <code>23</code> までの整数値。省略された場合の既定値は <code>0</code> です。</dd> + <dt><code>minute</code> {{optional_inline}}</dt> + <dd>「分」を表す <code>0</code> から <code>59</code> までの整数値。省略された場合の既定値は <code>0</code> です。</dd> + <dt><code>second</code> {{optional_inline}}</dt> + <dd>「秒」を表す <code>0</code> から <code>59</code> までの整数値。省略された場合の既定値は <code>0</code> です。</dd> + <dt><code>millisecond</code> {{optional_inline}}</dt> + <dd>「ミリ秒」を表す <code>0</code> から <code>999</code> までの整数値。省略された場合の既定値は <code>0</code> です。</dd> +</dl> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) の 1970 年 1 月 1 日 00:00:00 から指定された日時までの経過時間を表すミリ秒単位の数値です。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>UTC()</code> はカンマ区切りの日時の引数を取り、世界時の 1970 年 1 月 1 日 00:00:00 から指定した日時までの経過時間を表すミリ秒単位の数値を返します。</p> + +<p><code>0</code> から <code>99</code> までの年は、 20 世紀の年 <code>(1900 + year)</code> に変換されます。例えば、 <code>95</code> は 1995 年に変換されます。</p> + +<p>この <code>UTC()</code> メソッドは {{jsxref("Date")}} コンストラクターと 2 つの点で異なります。</p> + +<ol> + <li><code>Date.UTC()</code> は地方時ではなく、協定世界時を用います。</li> + <li><code>Date.UTC()</code> は <code>Date</code> オブジェクトを生成せず、時刻値を整数で返します。</li> +</ol> + +<p>引数が日時に期待される範囲を超えている場合、 <code>UTC()</code> メソッドは指定した値を受け入れるよう他の引数を更新します。例えば <code>15</code> が <code><var>month</var></code> に使用された場合、年が 1 つ増加し <code>(<var>year</var> + 1)</code>、月には <code>3</code> が使われます。</p> + +<p><code>UTC</code> は {{jsxref("Date")}} の静的メソッドなので、生成した <code>Date</code> オブジェクトのメソッドとしてではなく、常に <code>Date.UTC()</code> のように使用してください。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_Date.UTC" name="Using_Date.UTC">Date.UTC の使用</h3> + +<p>以下の文では、地方時の代わりに UTC を用いて {{jsxref("Date")}} オブジェクトを生成します。</p> + +<pre class="brush:js">let utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0)); +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.utc', 'Date.UTC')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.UTC")}}</p> + +<h3 id="Compatibility_notes" name="Compatibility_notes">互換性ノート</h3> + +<h4 id="Date.UTC_with_fewer_than_two_arguments" name="Date.UTC_with_fewer_than_two_arguments">Date.UTC() の引数が2つ未満であった場合</h4> + +<p><code>Date.UTC()</code> の引数が 2 つ未満の場合、 ECMAScript 2017 では {{jsxref("NaN")}} を返すよう要求しています。この動作に対応していなかったエンジンも対応済みです (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1050755">bug 1050755</a>, <a href="https://github.com/tc39/ecma262/pull/642">ecma-262 #642</a> を参照)。</p> + +<pre class="brush: js">Date.UTC(); +Date.UTC(1); + +// Safari: NaN +// Chrome/Opera/V8: NaN + +// Firefox <54: non-NaN +// Firefox 54+: NaN + +// IE: non-NaN +// Edge: NaN +</pre> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Date.parse()")}}</li> + <li>{{jsxref("Date")}}</li> +</ul> diff --git a/files/ja/web/javascript/reference/global_objects/date/valueof/index.html b/files/ja/web/javascript/reference/global_objects/date/valueof/index.html new file mode 100644 index 0000000000..dc80281505 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/date/valueof/index.html @@ -0,0 +1,68 @@ +--- +title: Date.prototype.valueOf() +slug: Web/JavaScript/Reference/Global_Objects/Date/valueOf +tags: + - Date + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Date/valueOf +--- +<div>{{JSRef}}</div> + +<p><strong><code>valueOf()</code></strong> メソッドは、{{jsxref("Date")}} オブジェクトのプリミティブ値を返します。</p> + +<div>{{EmbedInteractiveExample("pages/js/date-valueof.html")}}</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox notranslate"><var>dateObj</var>.valueOf()</pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から指定された日時までの間のミリ秒単位の数値。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>valueOf()</code> メソッドは、{{jsxref("Date")}} オブジェクトのプリミティブ値を数値型で返します。これは、1970 年 1 月 1 日 00:00:00 (UTC) からのミリ秒単位の数値です。</p> + +<p>このメソッドは、{{jsxref("Date.prototype.getTime()")}} メソッドと機能的に同等です。</p> + +<p>このメソッドは、JavaScript によって内部的に呼ばれ、コード内で明示的に呼ばれることはありません。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Using_valueOf" name="Using_valueOf">valueOf() の使用</h3> + +<pre class="brush: js notranslate">var x = new Date(56, 6, 17); +var myVar = x.valueOf(); // myVar に -424713600000 を代入 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-date.prototype.valueof', 'Date.prototype.valueOf')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Date.valueOf")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Object.prototype.valueOf()")}}</li> + <li>{{jsxref("Date.prototype.getTime()")}}</li> +</ul> |