Module.date オブジェクト

日付データの日情報に対して指定増分を加算するオブジェクト。


メソッドの概要
static Date addDay(Date date ,Number plus)
日付データの日情報に対して指定増分を加算します。
static Date addHour(Date date ,Number plus)
日付データの時間情報に対して指定増分を加算します。
static Date addMinute(Date date ,Number plus)
日付データの分情報に対して指定増分を加算します。
static Date addMonth(Date date ,Number plus)
日付データの月情報に対して指定増分を加算します。
static Date addSecond(Date date ,Number plus)
日付データの秒情報に対して指定増分を加算します。
static Date addYear(Date date ,Number plus)
日付データの年情報に対して指定増分を加算します。
static String dayName(Date date)
曜日を表す文字列を取得します。
static Date get(number year ,number month ,number day ,number hour ,number minute ,numbe second)
変数データの型をチェックします。
static Date getFuture(Date target_a ,Date target_b)
未来を表す日付データを取得します。
static Date getFuture(Date target_a)
未来を表す日付データを取得します。
static Date getPast(Date target_a ,Date target_b)
過去を表す日付データを取得します。
static Date getPast(Date target_a)
過去を表す日付データを取得します。
static Number getYear(Date date)
西暦年を取得します。
static Number interval(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Number intervalDay(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Number intervalHour(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Number intervalMinute(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Number intervalMonth(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Number intervalSecond(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Number intervalYear(Date target_a ,Date target_b)
2つの日付データの時間間隔を取得します。
static Boolean isBetween(Date left ,String l_op ,Date target ,String r_op ,Date right)
日付情報の範囲をチェックします。
static Boolean isBetween(Date left ,String l_op ,Date target)
日付情報の範囲をチェックします。
static Boolean isFuture(Date target)
日付データが未来を示すかどうかをチェックします。
static Boolean isLeapYear(Date target)
閏年チェックをします。
static Boolean isPast(Date target)
日付データが過去を示すかどうかをチェックします。
static Boolean isValid(Number year ,Number month ,Number day)
日付データとしての正当性をチェックします 。
static String monthName(Date target)
月を表す文字列を取得します。
static Date today()
“今日”という日付を表す日付オブジェクトを取得します。

メソッドの詳細
addDay

static Date addDay(Date date ,Number plus)

日付データの日情報に対して指定増分を加算します。

指定日付データの日情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ
plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ

addHour

static Date addHour(Date date ,Number plus)

日付データの時間情報に対して指定増分を加算します。

指定日付データの時間情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ
plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ

addMinute

static Date addMinute(Date date ,Number plus)

日付データの分情報に対して指定増分を加算します。

指定日付データの分情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ
plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ

addMonth

static Date addMonth(Date date ,Number plus)

日付データの月情報に対して指定増分を加算します。

指定日付データの月情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ
plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ

addSecond

static Date addSecond(Date date ,Number plus)

日付データの秒情報に対して指定増分を加算します。

指定日付データの秒情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ
plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ

addYear

static Date addYear(Date date ,Number plus)

日付データの年情報に対して指定増分を加算します。

指定日付データの年情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ
plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ

dayName

static String dayName(Date date)

曜日を表す文字列を取得します。

以下の曜日を表すキーワード文字列を返却します。 Sunday : 日曜日 Monday : 月曜日 Tuesday : 火曜日 Wednesday: 水曜日 Thursday : 木曜日 Friday : 金曜日 Saturday : 土曜日
パラメータ
date Date 対象データ
返却値
String 指定の日付データが表す曜日を示すキーワード文字列

get

static Date get(number year ,number month ,number day ,number hour ,number minute ,numbe second)

変数データの型をチェックします。

指定された日付情報を表す日付型オブジェクトを生成して返却します。 引数 hour, minute, second を省略した場合、0 が適応されます。
パラメータ
year number 年(数字)
month number 月(数字)
day number 日(数字)
hour number 時(数字)
minute number 分(数字)
second numbe 秒(数字)
返却値
Date 指定日付を表す日付型オブジェクト

getFuture

static Date getFuture(Date target_a ,Date target_b)

未来を表す日付データを取得します。

引数に与えられた2つの日付データのうち、より未来を示す日付データを 返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Date 2つの日付データのうち未来を示す方の日付データ

getFuture

static Date getFuture(Date target_a)

未来を表す日付データを取得します。

このメソッドの実行時の“現在”を 表す日付データと引数 target_a との比較が行われ、 より未来を示す日付データを返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa
返却値
Date メソッド実行時の“現在”を表す日付データと引数 target_aのうち未来を示す方の日付データ

getPast

static Date getPast(Date target_a ,Date target_b)

過去を表す日付データを取得します。

引数に与えられた2つの日付データのうち、より過去を示す日付データを 返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Date 2つの日付データのうち過去を示す方の日付データ

getPast

static Date getPast(Date target_a)

過去を表す日付データを取得します。

このメソッドの実行時の“現在”を 表す日付データと引数 target_a との比較が行われ、 より過去を示す日付データを返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa
返却値
Date メソッド実行時の“現在”を表す日付データと引数 target_aのうち過去を示す方の日付データ

getYear

static Number getYear(Date date)

西暦年を取得します。

指定の日付データの表す年情報を4桁で返却します。 このメソッドでは西暦 0 〜 1000 年の間のデータを扱う事はできません。
パラメータ
date Date 対象データ
返却値
Number 指定日付データの表す西暦年

interval

static Number interval(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“年”です。 返却データは、浮動小数点形式で表され、小数点以下は12進法で 表されます。 例)23ヶ月→1.11年
パラメータ
target_a Date チェック対象データ a
target_b Date チェック対象データ b
返却値
Number 2つの日付データの時間的差分

intervalDay

static Number intervalDay(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“日”です。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分

intervalHour

static Number intervalHour(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“時間”です。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分

intervalMinute

static Number intervalMinute(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“分”です。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分

intervalMonth

static Number intervalMonth(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“月”です。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分

intervalSecond

static Number intervalSecond(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“秒”です。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分

intervalYear

static Number intervalYear(Date target_a ,Date target_b)

2つの日付データの時間間隔を取得します。

指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“年”です。
パラメータ
target_a Date チェック対象データa
target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分

isBetween

static Boolean isBetween(Date left ,String l_op ,Date target ,String r_op ,Date right)

日付情報の範囲をチェックします。

チェック対象日付データを左辺および右辺の両境界における範囲チェック を指定のオペレーションでおこないます。
 チェックオペレータは、以下のキーワードにより指定します。
 "<" or ">"  :大小比較1(同値は含まない)
 "<=" or ">=":大小比較2(同値も真とする)
 "= ="       :同値比較(同値の場合を真とする)
 "<>" or "!=":異値比較(値が異なる場合を真とする)
例)var datA = Module.date.get(2000, 1, 1);   var datB = Module.date.get(2001, 1, 1);   var datNow = Module.date.getToday();
Module.date.isBetween(datA, "<=", datNow, "<", datB); この返却値で、“今日”が2000年であるかを判定できる。 注意)このメソッドのチェックは、ミリ秒単位にて判定します。 Module.date.isBetween(new Date() , "= =", new Date()); これは、偽値(false)になる可能性があります。

パラメータ
left Date 左辺境界を表す日付データ
l_op String 左辺チェックオペレータ
target Date チェック対象日付データ
r_op String 右辺チェックオペレータ
right Date 右辺境界を表す日付データ
返却値
Boolean
真値:対象日付データは指定の範囲に合致
偽値:対象日付データは指定の範囲外を表します。

isBetween

static Boolean isBetween(Date left ,String l_op ,Date target)

日付情報の範囲をチェックします。

チェック対象日付データを左辺および右辺の両境界における範囲チェック を指定のオペレーションでおこないます。
 チェックオペレータは、以下のキーワードにより指定します。
 "<" or ">"  :大小比較1(同値は含まない)
 "<=" or ">=":大小比較2(同値も真とする)
 "= ="       :同値比較(同値の場合を真とする)
 "<>" or "!=":異値比較(値が異なる場合を真とする)
例)var datA = Module.date.get(2000, 1, 1);   var datB = Module.date.get(2001, 1, 1);   var datNow = Module.date.getToday();
Module.date.isBetween(datA, "<=", datNow, "<", datB); この返却値で、“今日”が2000年であるかを判定できる。 注意)このメソッドのチェックは、ミリ秒単位にて判定します。 Module.date.isBetween(new Date() , "= =", new Date()); これは、偽値(false)になる可能性があります。

パラメータ
left Date 左辺境界を表す日付データ
l_op String 左辺チェックオペレータ
target Date チェック対象日付データ
返却値
Boolean
真値:対象日付データは指定の範囲に合致
偽値:対象日付データは指定の範囲外を表します。

isFuture

static Boolean isFuture(Date target)

日付データが未来を示すかどうかをチェックします。

指定の日付データが、このメソッド実行時における“現在”時間よりも 未来である場合 true を返却し、過去である場合 false を返却します。 指定の日付データが、このメソッド実行時における“現在”時間と 等しい場合には、false が返却されます。
パラメータ
target Date チェック対象データ
返却値
Boolean
真値:指定の日付データは、現在よりも未来
偽値:指定日付データは、現在よりも過去

isLeapYear

static Boolean isLeapYear(Date target)

閏年チェックをします。

指定日付の年が閏年に該当しているかをチェックしています。 太陽暦(グレゴリオ歴)を基本として計算されています。
パラメータ
target Date チェック対象データ
返却値
Boolean
真値:指定年は閏年
偽値:指定年は閏年ではない

isPast

static Boolean isPast(Date target)

日付データが過去を示すかどうかをチェックします。

指定の日付データが、このメソッド実行時における“現在”時間よりも 過去である場合 true を返却し、未来である場合 false を返却します。 指定の日付データが、このメソッド実行時における“現在”時間と 等しい場合には、false が返却されます。
パラメータ
target Date チェック対象データ
返却値
Boolean
真値:指定の日付データは、現在よりも過去
偽値:指定日付データは、現在よりも未来

isValid

static Boolean isValid(Number year ,Number month ,Number day)

日付データとしての正当性をチェックします 。

指定年月日情報が日付データとして正しい値である事をチェックします。
パラメータ
year Number チェック対象年
month Number チェック対象月
day Number チェック対象日
返却値
Boolean
真値:指定データは日付として正しい値を示している
偽値:指定データは日付データとして正しくない

monthName

static String monthName(Date target)

月を表す文字列を取得します。

以下の月を表すキーワード文字列を返却します。
January : 1月
February : 2月
March : 3月
April : 4月
May : 5月
June : 6月
July : 7月
August : 8月
September : 9月
October : 10月
November : 11月
December : 12月

パラメータ
target Date チェック対象データ
返却値
String 指定日付データの表す月を示すキーワード文字列

today

static Date today()

“今日”という日付を表す日付オブジェクトを取得します。

実行時の日にちを表す日付型データを生成して返却します。
生成された日付型データの表す年月日情報は、メソッド実行時の日付を 表し、時間は 00:00:00:000 を表します。
返却値
Date “今日”を表す日付オブジェクト