![]() ![]() |
静的 DateTimeSpan クラスは、2 つの日付または時刻の間の時間量の判別、および時間幅の加算または減算を行うための機能を提供します。2 つの日付の間の差を処理するための機能のセットを提供します。日付の幅は数値のみなので、アプリケーションは乗算、除法、加算、減算などの通常の演算を使用することができます。このクラスは静的です。アプリケーションは、クラスのインスタンスを作成することはできません。
この関数は、年、月、および日の指定数値を開始日に加算した合計である新しい日付を戻します。月は 12 より大きい数値になる場合があり、日付は 1 カ月の日数より大きくなる場合があります。実際の効果には、3 つの異なる操作が行われます。最初に年を加算します。次に、結果の日付を使用して月を加算します。次に、結果の日付を使用して日を加算します。
月を加算すると、結果の日付が有効でない場合があります。例えば、1 月 31 日に 1 カ月を加算すると、2 月 31 日という無効な日付が生成されます。関数は日付が有効になるように調整します。この場合、その年がうるう年でなければ、2 月の日数は 28 日となり、結果の日付は 3 月 3 日になります。
年、月、または日の引数が NULL または未定義となる場合があります。この場合、その値はゼロであるように処理されます。
年、月、または日の引数が負となる場合があります。この場合、結果では、その単位が基本の日付から減算されたようになります。
DateTimeSpan.addDate( startDate, years, months, days )
年、月、および日を開始日に加算した結果の日付。
var startDate = date.parse( "2004-12-31" ); var endDate; endDate = DateTimeSpan( startDate, 1, 0, 0 ); // returns 2005-12-31 endDate = DateTimeSpan( startDate, 0, 1, 0 ); // returns 2005-1-31 endDate = DateTimeSpan( startDate, 0, 0, 1 ); // returns 2005-1-1 endDate = DateTimeSpan( startDate, 1, 1, 1 ); // returns 2005-3-4
この関数は、時間、分、および秒の指定数値を開始日に加算した合計である新しい日付を戻します。時間は 24 より大きい数値になる場合があり、分および秒は 60 より大きい数値になる場合があります。実際の効果には、3 つの異なる操作が行われます。最初に時間を加算します。次に、結果の日付を使用して分を加算します。次に、結果の日付を使用して秒を加算します。
時間、分、および秒の引数が NULL または未定義となる場合があります。この場合、その値はゼロであるように処理されます。
時間、分、および秒の引数が負となる場合があります。この場合、結果では、その単位が基本の日付から減算されたようになります。
DateTimeSpan.addTime( startDate, hours, minutes, seconds )
時間、分、および秒を開始日に加算した結果の日付。
2 つの日付の間の日数を戻します。1 日は、歴日の変化として定義されています。つまり、2 月 27 日午後 11:59:59 から 2 月 28 日 0:00 は、2 月 27 日 0:00 から 2 月 28 日 11:59:59 と同様に 1 日となります。
DateTimeSpan.days( startDate, endDate )
2 つの日付の間の日数を戻します。
この関数は、2 つの時刻の間の時間数を戻します。1 時間は、ある時刻の分から翌時の同じ分までの幅として定義されます。例えば、1:23:00 から 2:23:00 は 1 時間で、1:23:00 から 2:22:59 はゼロ時間です。
DateTimeSpan.hours( startDate, endDate )
2 つの日付の間の時間数。
この関数は、2 つの時刻の間の分数を戻しま。1 分は、ある分の秒から翌分の同じ秒までの幅として定義されます。例えば、1:23:00 から 1:24:00 は 1 分で、1:23:00 から 1:22:59 はゼロ分です。
DateTimeSpan.minutes( startDate, endDate )
2 つの日付の間の秒数。
この関数は、2 つの日付の間の月数を戻します。1 カ月は、ある月の n 日から翌月の n 日までの時間の幅として定義されます。例えば、2 月 28 日から 3 月 28 日は 1 カ月で、2 月 28 日から 3 月 26 日はゼロカ月です。
DateTimeSpan.months( startDate, endDate )
2 つの日付の間の月数を戻します。
この関数は、2 つの時刻の間の秒数を戻します。
DateTimeSpan.seconds( startDate, endDate )
2 つの日付の間の 1 分の数。
この関数は、年、月、および日の指定数値を開始日から減算した結果として得られる新しい日付を戻します。月は 12 より大きい数値になる場合があり、日付は 1 カ月の日数より大きくなる場合があります。実際の効果には、3 つの異なる操作が行われます。最初に年を減算します。次に、結果の日付を使用して月を減算します。次に、結果の日付を使用して日を減算します。
月を減算すると、結果の日付が有効でない場合があります。例えば、3 月 30 日から 1 カ月を減算すると、2 月 30 日という無効な日付が生成されます。関数は、その日付をその月の有効な最終日に調整し、日付を有効になるように調整します。この場合、その年がうるう年でなければ、日付は 2 月 28 日に調整されます。
年、月、または日の引数が NULL または未定義となる場合があります。この場合、値はゼロであるように処理されます。
年、月、または日の引数が負となる場合があります。この場合、結果では、その単位が基本の日付に追加されたようになります。
DateTimeSpan.subDate( startDate, years, months, days )
年、月、および日を開始日から減算した結果の日付。
この関数は、時間、分、および秒の指定数値を開始日から減算した結果として得られる新しい日付を戻します。時間は 24 より大きい数値になる場合があり、分および秒は 60 より大きい数値になる場合があります。実際の効果には、3 つの異なる操作が行われます。最初に時間を減算します。次に、結果の日付を使用して分を減算します。次に、結果の日付を使用して秒を減算します。
時間、分、および秒の引数が NULL または未定義となる場合があります。この場合、値はゼロであるように処理されます。
時間、分、および秒の引数が負となる場合があります。この場合、結果では、その単位が基本の日付に追加されたようになります。
DateTimeSpan.subTime( startDate, hours, minutes, seconds )
時間、分、および秒を開始日から減算した結果として得られる日付。
この関数は、2 つの日付の間の年数を計算します。1 年は、ある年のある月日および時刻から翌年の同じ月日および時刻までとして定義されます。うるう年のため、1 年に 365 日が含まれる場合と、366 日が含まれる場合があります。
いずれかの引数が日付以外である場合、例外がスローされます。いずれかの引数が NULL である場合、結果も NULL になります。
DateTimeSpan.years( startDate, endDate )
2 つの日付の間の年数。
![]() ![]() |