DateTimeクラス
DateTime クラスは、日付・時刻を表すクラスです。また、時刻の種類 (現地時刻, 世界協定時刻 (UTC), どちらでもない)を保持します。
クラスの機能
定数
MaxValue
Static MaxValue As Int64
DateTimeが扱うことの出来る、最大の時刻を表します。最大の時刻は、9999年です。
MinValue
Static MinValue As Int64
DateTimeが扱うことのできる、最小の時刻を表します。最小の時刻は、1年です。
プロパティ
Ticks
Function Ticks() As Int64
このインスタンスで表される時刻を、100ナノ秒単位の時刻で取得します。
Millisecond
Function Millisecond() As Long
このインスタンスで表される時刻の、ミリ秒の部分を取得します。
Second
Function Second() As Long
このインスタンスで表される時刻の、秒の部分を取得します。
Minute
Function Minute() As Long
このインスタンスで表される時刻の、分の部分を取得します。
Hour
Function Hour() As Long
このインスタンスで表される時刻の、時間の部分を取得します。
Day
Function Day() As Long
このインスタンスで表される時刻の、日の部分を取得します。
Month
Function Month() As Long
このインスタンスで表される時刻の、月の部分を取得します。
Year
Function Year() As Long
このインスタンスで表される時刻の、年の部分を取得します。
DayOfWeek
Function DayOfWeek() As DayOfWeek
このインスタンスで表される時刻の、曜日を取得します。
Kind
Function Kind() As DateTimeKind
このインスタンスが、現地時刻,世界協定時刻 (UTC)なのかを取得します。
DayOfYear
Function DayOfYear() As Long
このインスタンスで表される時刻の、その年で通算何日経過しているかを取得します。
Date
Function Date() As DateTime
このインスタンスで表される時刻の、日付部分だけを抜き出した、新しいDateTimeインスタンスを返します。
Now
Static Function Now() As DateTime
現在の現地時刻を表した、新しいDateTimeインスタンスを返します。
Today
Static Function ToDay() As DateTime
現在の現地時刻の日付部分を表した、新しいDateTimeインスタンスを返します。
UtcNow
Static Function UtcNow() As DateTime
現在の世界協定時刻(UTC)を表した、新しいDateTimeインスタンスを返します。
メソッド
コンストラクタ
Sub DateTime(ticks As Int64) Sub DateTime(ticks As Int64, kind As DateTimeKind)
100ナノ秒単位で表した時刻を指定して、DateTimeを初期化します。kindを指定することにより、世界協定時刻か現地時刻なのかを指定することができます。
Sub DateTime(year As Long, month As Long, day As Long) Sub DateTime(year As Long, month As Long, day As Long, kind As DateTimeKind)
年,月,日を指定して、DateTimeを初期化します。kindを指定することにより、世界協定時刻か現地時刻なのかを指定することができます。
Sub DateTime(year As Long, month As Long, day As Long, hour As Long, minute As Long, second As Long) Sub DateTime(year As Long, month As Long, day As Long, hour As Long, minute As Long, second As Long, kind As DateTimeKind)
年,月,日,時間,分,秒を指定して、DateTimeを初期化します。kindを指定することにより、世界協定時刻か現地時刻なのかを指定することができます。
Sub DateTime(year As Long, month As Long, day As Long, hour As Long, minute As Long, second As Long, millisecond As Long) Sub DateTime(year As Long, month As Long, day As Long, hour As Long, minute As Long, second As Long, millisecond As Long, kind As DateTimeKind)
年,月,日,時間,分,秒,ミリ秒を指定して、DateTimeを初期化します。kindを指定することにより、世界協定時刻か現地時刻なのかを指定することができます。
Sub DateTime(ByRef time As SYSTEMTIME) Sub DateTime(ByRef time As SYSTEMTIME, kind As DateTimeKind)
SYSTEMTIME構造体を指定して、DateTimeを初期化します。kindを指定することにより、世界協定時刻か現地時刻なのかを指定することができます。
Operator+
Function Operator+ (value As TimeSpan) As DateTime
このインスタンスの時刻に、valueの時間だけ加算します。valueはTimeSpanで指定します。
Operator-
Function Operator- (value As TimeSpan) As DateTime
このインスタンスの時刻から、valueの時間だけ減算します。valueはTimeSpanで指定します。
Function Operator- (value As DateTime) As TimeSpan
このインスタンスとvalueで指定した時刻の差をTimeSpanで返します。
Operator ==
Function Operator == (ByRef value As DateTime) As Boolean
Equals(value)を返します。
Operator <>
Function Operator <> (value As DateTime) As Boolean
Not Equals(value)を返します。
Operator >
Function Operator > (value As DateTime) As Boolean
このインスタンスとvalueのTicksを比較して、valueより大きければTrueを返します。それ以外はFalseです。
Operator <
Function Operator < (value As DateTime) As Boolean
このインスタンスとvalueのTicksを比較して、valueより小さければTrueを返します。それ以外はFalseです。
Operator =>
Function Operator => (value As DateTime) As Boolean
このインスタンスとvalueのTicksを比較して、value以上ならばTrueを返します。それ以外はFalseです。
Operator <=
Function Operator <= (value As DateTime) As Boolean
このインスタンスとvalueのTicksを比較して、value以下ならばTrueを返します。それ以外はFalseです。
Compare
Static Function Compare(t1 As DateTime, t2 As DateTime) As Int64
t1がt2より小さければ、負の値を返します。t1がt2より大きければ、正の値を返します。また、t1とt2が等しい場合、0を返します。
Equals
Function Equals(value As DateTime) As Boolean
このインスタンスとvalueが、同一の時刻場合Trueを返します。それ以外はFalseです。
AddTicks
Function AddTicks(value As Int64) As DateTime
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueは100ナノ秒単位です。
AddMilliseconds
Sub AddMilliseconds(value As Double)
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueはミリ秒単位です。
AddSeconds
Sub AddSeconds(value As Double)
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueは秒単位です。
AddMinutes
Sub AddMinutes(value As Double)
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueは分単位です。
AddHours
Sub AddHours(value As Double)
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueは時間単位です。
AddDays
Sub AddDays(value As Double)
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueは日単位です。
AddYears
Sub AddYears(value As Double)
このインスタンスの時刻を、valueだけ進めたDateTimeを作成します。valueは年単位です。小数を指定した場合、最初に整数部分だけ時刻を進めた後、そのあと、その年の日数から計算した小数部分の時刻だけ進めます。
DaysInMonth
Static Function DaysInMonth(year As Long, month As Long) As Long
指定した年の月の日数を返します。
IsLeapYear
Static Function IsLeapYear(year As Long) As BOOL
このインスタンスが表す年が、閏年の場合TRUEを返します。それ以外はFALSEです。
GetDateTimeFormats
Function GetDateTimeFormats() As String Function GetDateTimeFormats(format As *Byte) As String
- format
- 書式文字列を指定します。GetDateFormatとGetTimeFormatの書式文字列を、組み合わせて指定します。省略した場合、デフォルトのフォーマット文字列が返ります。
このインスタンスの時刻を、文字列で表した新しいStringインスタンスを返します。
FromBinary
Static Function FromBinary(dateData As Int64) As DateTime
64bit変数で表されたDateTimeから作成した、新しいDateTimeインスタンスを返します。ToBinaryメソッドで作成した64bit変数から、DateTimeクラスを再構築することができます。
ToBinary
Function ToBinary() As Int64
このインスタンスの情報が保存された、64bit変数が返ります。FromBinaryメソッドを使用することにより、64bit変数で表されたDateTimeを、DateTimeクラスに再構築することができます。
FromFileTime
Static Function FromFileTime(fileTime As FILETIME) As DateTime
指定されたWindowsファイル時刻で、現地時刻に初期化した、新しいDateTimeインスタンスが返ります。
ToFileTime
Function ToFileTime() As FILETIME
このインスタンスの時刻で初期化した、FILETIME構造体を返します。
FromFileTimeUtc
Static Function FromFileTimeUtc(fileTime As FILETIME) As DateTime
指定されたWindowsファイル時刻で、世界協定時刻(Utc)に初期化した、新しいDateTimeインスタンスが返ります。
ToFileTimeUtc
Function ToFileTimeUtc() As FILETIME
このインスタンスの時刻の、世界協定時刻 (UTC)で初期化した、FILETIME構造体を返します。このインスタンスの時刻が、現地時刻の場合、世界協定時刻 (UTC)に変換されます。
ToLocalTime
Function ToLocalTime() As DateTime
このインスタンスの時刻を現地時刻で表した、新しいDateTimeインスタンスを返します。
ToUnivarsalTime
Function ToUniversalTime() As DateTime
このインスタンスの時刻を世界協定時刻 (UTC)で表した、新しいDateTimeインスタンスを返します。
