10.3.2 DateTimeクラス

ここでは,DateTimeクラスの仕様について説明します。

<この項の構成>
(1) DateTimeクラスの概要
(2) コンストラクタの詳細
(3) メソッドの詳細

(1) DateTimeクラスの概要

継承

java.lang.Object
|
+-- jp.co.Hitachi.interschema2.exitfunc.DateTime

 

形式

public final class DateTime
extends java.lang.Object

 

説明
InterschemaのET_DTM型に対応するJavaクラスです。出口関数の引数及び戻り値に使用します。Interschemaから引数として受け取る場合,日付時刻部分の値が未設定のときは0が設定されます。ゾーン文字列部分の値が未設定のときはnullが設定されます。
コンストラクタの概要
形式機能
public DateTime(int year, int month, int day, int hour, int minute, double second, String timeZone)指定の値を持つ日付時刻を生成します。
public DateTime(Date date, String timeZone)指定の値を持つ日付時刻を生成します。
public DateTime(Date date)指定の値を持つ日付時刻を生成します。
public DateTime()デフォルトの日付時刻を生成します。
メソッドの概要
形式機能
public int getYear()年を取得します。
public void setYear(int year)年を設定します。
public int getMonth()月を取得します。
public void setMonth(int month)月を設定します。
public int getDay()日付を取得します。
public void setDay(int day)日付を設定します。
public int getHour()時を取得します。
public void setHour(int hour)時を設定します。
public int getMinute()分を取得します。
public void setMinute(int minute)分を設定します。
public double getSecond()秒を取得します。
public void setSecond(double second)秒を設定します。
public String getZone()タイムゾーン文字列を取得します。
public void setZone(String timeZone)タイムゾーン文字列を設定します。
public Date getDate()設定された時刻に対応するDateオブジェクトを取得します

(2) コンストラクタの詳細

(a) DateTime
形式

public DateTime(int year,
               int month,
               int day,
               int hour,
               int minute,
               double second,
               String timeZone)
   throws ExitFuncException

 

引数
引数内容
year年を指定します。
month月を指定します。
hour時を指定します。
day日を指定します。
minute分を指定します。
second秒を指定します。
timeZoneタイムゾーン文字列を指定します。
説明
指定の値を持つ日付時刻を生成します。各引数の有効な範囲を次に示します。
  • year(0~9999)
  • month(1~12)
  • day (1~31)
  • hour(0~23)
  • minute(0~59)
  • second(0~59, 小数部可)
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(b) DateTime
形式

public DateTime(Date date, String timeZone)
   throws ExitFuncException

 

引数
引数内容
date日付・時刻を指定します。
timeZoneタイムゾーン文字列です。
説明
指定された値を持つ日付時刻を生成します。年月日分秒に指定の日付・時刻を,タイムゾーン文字列にzoneを指定して,日付時刻を生成する場合と等価です。
例外
例外内容
ExitFuncExceptiondateにnullを指定した場合,又は日付・時刻の設定に失敗した場合に発生します。
(c) DateTime
形式

public DateTime(Date date)
   throws ExitFuncException

 

引数
引数内容
date日付・時刻を指定します。
説明
指定された値を持つ日付時刻を生成します。年月日分秒に指定の日付・時刻を,タイムゾーン文字列に現在のこのホストのデフォルトのタイムゾーン文字列(TimeZone.getDefault().getDisplayName()の値)を指定して,日付時刻を生成する場合と等価です。
例外
例外内容
ExitFuncExceptiondateにnullを指定した場合,又は日付・時刻の設定に失敗した場合に発生します。
(d) DateTime
形式

public DateTime()
   throws ExitFuncException

 

引数
なし
説明
デフォルトの日付時刻を生成します。年月日分秒に現在の日付・時刻を,タイムゾーン文字列に現在のこのホストのデフォルトのタイムゾーン文字列(TimeZone.getDefault().getDisplayName()の値)を指定して,日付時刻を生成する場合と等価です。
例外
例外内容
ExitFuncException日付・時刻の設定に失敗した場合に発生します。

(3) メソッドの詳細

(a) getYear
形式

public int getYear()

 

引数
なし
説明
年を取得します。
戻り値
年が返されます。
(b) setYear
形式

public void setYear(int year)
   throws ExitFuncException

 

引数
引数内容
year年を指定します。
説明
指定の年を設定します。
戻り値
なし
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(c) getMonth
形式

public int getMonth()

 

引数
なし
説明
月を取得します。
戻り値
月が返されます。
(d) setMonth
形式

public void setMonth(int month)
   throws ExitFuncException

 

引数
引数内容
month月を指定します。
説明
指定の月を設定します。
戻り値
なし
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(e) getDay
形式

public int getDay()

 

引数
なし
説明
日付を取得します。
戻り値
日付が返されます。
(f) setDay
形式

public void setDay(int day)
   throws ExitFuncException

 

引数
引数内容
day日付を指定します。
説明
指定の日付を設定します。
戻り値
なし
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(g) getHour
形式

public int getHour()

 

引数
なし
説明
時を取得します。
戻り値
時が返されます。
(h) setHour
形式

public void setHour(int hour)
   throws ExitFuncException

 

引数

引数内容
hour時を指定します。
説明
指定の時を設定します。
戻り値
なし
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(i) getMinute

形式

public int getMinute()

 

引数
なし
説明
分を取得します。
戻り値
分が返されます。
(j) setMinute
形式

public void setMinute(int minute)
   throws ExitFuncException

 

引数
引数内容
minute分を指定します。

説明

指定の分を設定します。

戻り値
なし
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(k) getSecond
形式

public double getSecond()

 

引数
なし
説明
秒を取得します。
戻り値
秒を取得します。
(l) setSecond
形式

public void setSecond(double second)
   throws ExitFuncException

 

引数
引数内容
second秒を指定します。

説明

指定の秒を設定します。

戻り値
なし
例外
例外内容
ExitFuncException引数に範囲外の値を指定した場合に発生します。
(m) getZone
形式

public String getZone()

 

引数
なし
説明
タイムゾーン文字列を取得します。
戻り値
タイムゾーン文字列が返されます。
(n) setZone
形式

public void setZone(String timeZone)

 

引数
引数内容
timeZoneタイムゾーン文字列を指定します。

説明

指定のタイムゾーン文字列を設定します。

戻り値
なし
(o) getDate
形式

public Date getDate()

 

引数
なし
説明
設定済みの日付・時刻を表すDateオブジェクトを取得します。プラットホームデフォルトのロケールとタイムゾーンに従って,java.util.Dateオブジェクトを生成して,その結果を返します。ただし,年に0を指定した場合は,生成されるjava.util.Dateオブジェクトは0001年になります。
戻り値
設定済みの日付・時刻を表すDateオブジェクトが返されます。