TimeSpanクラス

提供: AB開発Wiki
2007年2月17日 (土) 11:43時点におけるOverTaker (トーク | 投稿記録)による版 (新規追加)
(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
ナビゲーションに移動検索に移動

TimeSpan クラスは、時間の間隔を表すクラスです。DateTime クラスの時刻に対し、TimeSpan クラスは期間を表します。時間の最小単位は、100ナノ秒単位です。

クラスの機能

定数

MaxValue

Static MaxValue = 3162240000000000000 As Int64

TimeSpanが保持できる、最大の時間を表します。単位は100ナノ秒です。

MinValue

Static MinValue = -3162240000000000000 As Int64

TimeSpanが保持できる、最小の時間を表します。単位は100ナノ秒です。

Zero

Static Zero = 0 As Int64

0を返します。

TicksPerMillisecond

Static TicksPerMillisecond = 10000 As Int64

1ミリ秒を、100ナノ秒単位で表します。

TicksPerSecond

Static TicksPerSecond = 10000000 As Int64

1秒を、100ナノ秒単位で表します。

TicksPerMinute

Static TicksPerMinute = 60000000 As Int64

1分を、100ナノ秒単位で表します。

TicksPerHour

Static TicksPerHour = 36000000000 As Int64

1時間を、100ナノ秒単位で表します。

TicksPerDay

Static TicksPerDay = 864000000000 As Int64

1日を、100ナノ秒単位で表します。

プロパティ

Ticks

Function Ticks() As Int64

インスタンスの時間を取得します。単位は100ナノ秒です。

Milliseconds

Function Milliseconds() As Long

インスタンスの時間の、ミリ秒部分を取得します。

Seconds

Function Seconds() As Long

インスタンスの時間の、秒数部分を取得します。

Minutes

Function Minutes() As Long

インスタンスの時間の、分数部分を取得します。

Hours

Function Hours() As Long

インスタンスの時間の、時数部分を取得します。

Days

Function Days() As Long

インスタンスの時間の、日数部分を取得します。

TotalMilliseconds

Function TotalMilliseconds() As Double

インスタンスの時間を、ミリ秒数に換算した値で取得します。

TotalSeconds

Function TotalSeconds() As Double

インスタンスの時間を、秒数に換算した値で取得します。

TotalMinutes

Function TotalMinutes() As Double

インスタンスの時間を、分数に換算した値で取得します。

TotalHours

Function TotalHours() As Double

インスタンスの時間を、時数に換算した値で取得します。

TotalDays

Function TotalDays() As Double

インスタンスの時間を、日数に換算した値で取得します。

メソッド

コンストラクタ

Sub TimeSpan(ticks As Int64)

指定した時間で初期化したTimeSpanを作成します。時間の単位は100ナノ秒です。

Sub TimeSpan(ByRef ts As TimeSpan)

指定したTimeSpanで初期化したTimeSpanを作成します。

Operator+

Function Operator+ (ByRef ts As TimeSpan) As TimeSpan

インスタンスの時間とtsの時間を加算します。

Operator-

Function Operator- (ByRef ts As TimeSpan) As TimeSpan

インスタンスの時間からtsの時間を減算します。

Operator==

Function Operator== (ByRef ts As TimeSpan) As Boolean

インスタンスの時間とtsの時間が等しい場合、Trueが返ります。それ以外はFalseです。

Operator<>

Function Operator<> (ByRef ts As TimeSpan) As Boolean

インスタンスの時間とtsの時間が等しい場合、Trueが返ります。それ以外はFalseです。

Operator>

Function Operator> (ByRef ts As TimeSpan) As Boolean

インスタンスの時間のが、tsより長い場合、Trueが返ります。それ以外はFalseです。

Operator<

Function Operator< (ByRef ts As TimeSpan) As Boolean

インスタンスの時間のが、tsより短い場合、Trueが返ります。それ以外はFalseです。

Operator=>

Function Operator> (ByRef ts As TimeSpan) As Boolean

インスタンスの時間のが、ts長いか等しい場合、Trueが返ります。それ以外はFalseです。

Operator=<

Function Operator=< (ByRef ts As TimeSpan) As Boolean

インスタンスの時間のが、tsより短いか等しい場合、Trueが返ります。それ以外はFalseです。

Add

指定した時間を加算します。

Function Add(ByRef ts As TimeSpan) As TimeSpan
ts
加算する値を指定します。
戻り値
インスタンスの時間とtsの時間を加算した、新しいTimeSpanが返ります。

Compare

指定した2つの時間を比較します。

Static Function Compare(ByRef ts1 As TimeSpan, ByRef ts2 As TimeSpan) As Long
ts1
比較する時間を指定します。
ts2
ts1と比較する時間を指定します。
戻り値
ts1がts2より長い場合1、ts1とts2が等しい場合0、ts1がts2より短い場合-1が返ります。

CompareTo

インスタンスと、指定した時間を比較します。

Function CompareTo(ByRef ts As TimeSpan) As Long
ts
比較する時間を指定します。
戻り値
インスタンスがtsよりも長い場合正の値、等しい場合0、tsよりも短い場合負の値が返ります。

Duration

インスタンスの時間の絶対値を取得します。

Function Duration() As TimeSpan
戻り値
インスタンスの時間の絶対値が返ります。

Equals

インスタンスの時間と、指定した時間が等しいかどうかを調べます。

Function Equals(ByRef ts As TimeSpan) As Boolean
ts
比較する時間を指定します。
戻り値
インスタンスとtsの時間が等しい場合、Trueが返ります。それ以外はFalseです。

指定した2つの時間が等しいかどうかを調べます。

Static Function Equals(ByRef ts1 As TimeSpan, ByRef ts2 As TimeSpan) As Boolean
ts1
時間を指定します。
ts2
ts1と比較する時間を指定します。
戻り値
ts1とts2が等しい場合、Trueが返ります。それ以外はFalseです。

FromTicks

指定した時間で初期化したTimeSpanを作成します。

Static Function FromTicks(ticks As Int64) As TimeSpan
ticks
時間を100ナノ秒単位で指定します。
戻り値
ticksの時間で初期化したTimeSpanを返します。

FromMilliseconds

指定した時間で初期化したTimeSpanを作成します。

Static Function FromMilliseconds(value As Double) As TimeSpan
value
時間をミリ秒単位で指定します。
戻り値
valueの時間で初期化したTimeSpanを返します。

FromSeconds

指定した時間で初期化したTimeSpanを作成します。

Static Function FromSeconds(value As Double) As TimeSpan
value
時間を秒単位で指定します。
戻り値
valueの時間で初期化したTimeSpanを返します。

FromMinutes

指定した時間で初期化したTimeSpanを作成します。

Static Function FromMinutes(value As Double) As TimeSpan
value
時間を分単位で指定します。
戻り値
valueの時間で初期化したTimeSpanを返します。

FromHours

指定した時間で初期化したTimeSpanを作成します。

Static Function FromHours(value As Double) As TimeSpan
value
時間を時単位で指定します。
戻り値
valueの時間で初期化したTimeSpanを返します。

FromDays

指定した時間で初期化したTimeSpanを作成します。

Static Function FromDays(value As Double) As TimeSpan
value
時間を日数単位で指定します。
戻り値
valueの時間で初期化したTimeSpanを返します。

Negate

インスタンスの時間の符号を反転します。

Function Negate() As TimeSpan
戻り値
インスタンスの時間を反転した時間が返ります。例えば、1時間だった場合、-1時間が返ります。

Subtract

インスタンスの時間から、指定した時間を減算します。

Function Subtract(ByRef ts As TimeSpan) As TimeSpan
ts
減算する時間を指定します。
戻り値
インスタンスの時間からtsの時間を減算したTimeSpanが返ります。

備考

TimeSpan クラスは、時間の間隔を表しているクラスなので、負の値も表すことができます。

Double型で時間を指定するところは、小数部分の時間も正しく計算されます。例えば、0.5時間は30分です。

関連項目

DateTime クラス